com.aspose.threed

Class Mesh

java.lang.Object

com.aspose.threed.A3DObject

com.aspose.threed.SceneObject

com.aspose.threed.Entity

com.aspose.threed.Geometry

com.aspose.threed.Mesh

All Implemented Interfaces:

IMeshConvertible, INamedObject, java.lang.Iterable<int[]>

public class Mesh
extends Geometry
implements java.lang.Iterable<int[]>, IMeshConvertible

A mesh is made of many n-sided polygons. Example: To add a polygon in mesh:

  Mesh mesh = new Mesh();
  int[] indices = new int[] {0, 1, 2};
  mesh.createPolygon(indices);
 

Travel through all polygons in mesh:

  Mesh mesh = new Mesh();
  for(int[] polygon : mesh)
  {
      //deal with polygon
  }
 

Field Summary

Fields inherited from class com.aspose.threed.A3DObject

name, properties

Constructor Summary

Constructors

Constructor and Description
Mesh() Initializes a new instance of the Mesh class.
Mesh(java.lang.String name) Initializes a new instance of the Mesh class.

Method Summary

Modifier and Type	Method and Description
void	addControlPoint(double x, double y, double z) Add a new control point to the mesh, this is more efficient.
void	addControlPoint(double x, double y, double z, double w) Add a new control point to the mesh, this is more efficient.
Mesh	clone()
void	createPolygon(int[] indices) Creates a new polygon with all vertices defined in indices.
void	createPolygon(int[] indices, int offset, int length) Creates a new polygon with all vertices defined in indices.
void	createPolygon(int v1, int v2, int v3) Create a polygon with 3 vertices(triangle)
void	createPolygon(int v1, int v2, int v3, int v4) Create a polygon with 4 vertices(quad)
static Mesh	difference(Mesh a, Mesh b) Calculate the difference of two meshes
static Mesh	doBoolean(BooleanOperation op, Mesh a, Matrix4 transformA, Mesh b, Matrix4 transformB) Perform Boolean operation on two meshes
java.util.List<java.lang.Integer>	getEdges() Gets edges of the Mesh.
int	getPolygonCount() Gets the count of polygons
java.util.List<int[]>	getPolygons() Gets the polygons definition of the mesh
int	getPolygonSize(int index) Gets the vertex count of the specified polygon.
static Mesh	intersect(Mesh a, Mesh b) Calculate the intersection of two meshes
boolean	isManifold() Check if current mesh is a manifold mesh.
java.util.Iterator<int[]>	iterator() Gets the enumerator for each inner polygons.
Mesh	optimize(boolean vertexElements) Optimize the mesh's memory usage by eliminating duplicated control points
Mesh	optimize(boolean vertexElements, float toleranceControlPoint) Optimize the mesh's memory usage by eliminating duplicated control points
Mesh	optimize(boolean vertexElements, float toleranceControlPoint, float toleranceNormal) Optimize the mesh's memory usage by eliminating duplicated control points
Mesh	optimize(boolean vertexElements, float toleranceControlPoint, float toleranceNormal, float toleranceUV) Optimize the mesh's memory usage by eliminating duplicated control points
Mesh	optimize2(boolean vertexElements) Optimize the mesh's memory usage by eliminating duplicated control points
Mesh	toMesh() Gets the Mesh instance from current entity.
Mesh	triangulate() Return triangulated mesh
static Mesh	union(Mesh a, Mesh b) Calculate the union of two meshes

Methods inherited from class com.aspose.threed.Geometry

addElement, createElement, createElement, createElementUV, createElementUV, getCastShadows, getControlPoints, getDeformers, getDeformers2, getElement, getReceiveShadows, getVertexElementOfUV, getVertexElements, getVisible, setCastShadows, setReceiveShadows, setVisible

Methods inherited from class com.aspose.threed.Entity

getBoundingBox, getExcluded, getParentNode, getParentNodes, setExcluded, setParentNode

Methods inherited from class com.aspose.threed.SceneObject

getScene

Methods inherited from class com.aspose.threed.A3DObject

findProperty, getName, getProperties, getProperty, removeProperty, removeProperty, setName, setProperty

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

Mesh

public Mesh()

Initializes a new instance of the Mesh class.

Mesh

public Mesh(java.lang.String name)

Initializes a new instance of the Mesh class.

Parameters:

name - Name.

Method Detail

clone

public Mesh clone()

Overrides:

clone in class java.lang.Object

getEdges

public java.util.List<java.lang.Integer> getEdges()

Gets edges of the Mesh. Edge is optional in mesh, so it can be empty.

Returns:

edges of the Mesh. Edge is optional in mesh, so it can be empty.

getPolygonSize

public int getPolygonSize(int index)

Gets the vertex count of the specified polygon.

Parameters:

index - Index.

Returns:

The polygon size.

getPolygonCount

public int getPolygonCount()

Gets the count of polygons

Returns:

the count of polygons Example: The following code shows how to get the number of mesh' polygons.

      Mesh mesh = (new Sphere()).toMesh();
      System.out.println("Mesh's polygon count = " + mesh.getPolygonCount());
 

getPolygons

public java.util.List<int[]> getPolygons()

Gets the polygons definition of the mesh

Returns:

the polygons definition of the mesh

addControlPoint

public void addControlPoint(double x,
                            double y,
                            double z)

Add a new control point to the mesh, this is more efficient.

Parameters:

x - The x component of the control point

y - The y component of the control point

z - The z component of the control point

addControlPoint

public void addControlPoint(double x,
                            double y,
                            double z,
                            double w)

Add a new control point to the mesh, this is more efficient.

Parameters:

x - The x component of the control point

y - The y component of the control point

z - The z component of the control point

w - The w component of the control point

createPolygon

public void createPolygon(int[] indices,
                          int offset,
                          int length)

Creates a new polygon with all vertices defined in indices. To create polygon vertex by vertex, please use PolygonBuilder.

Parameters:

indices - Array of the polygon indices, each index points to a control point that forms the polygon.

offset - The offset of the first polygon index

length - The length of the indices Example: The following code shows how to create a new polygon with control point's indices.

  Mesh mesh = new Mesh();
  int[] indices = new int[] {0, 1, 2};
  mesh.createPolygon(indices);
 

createPolygon

public void createPolygon(int[] indices)

Creates a new polygon with all vertices defined in indices. To create polygon vertex by vertex, please use PolygonBuilder.

Parameters:

indices - Array of the polygon indices, each index points to a control point that forms the polygon. Example:

  Mesh mesh = new Mesh();
  int[] indices = new int[] {0, 1, 2};
  mesh.createPolygon(indices);
 

createPolygon

public void createPolygon(int v1,
                          int v2,
                          int v3,
                          int v4)

Create a polygon with 4 vertices(quad)

Parameters:

v1 - Index of the first vertex

v2 - Index of the second vertex

v3 - Index of the third vertex

v4 - Index of the fourth vertex Example: The following code shows how to create a new polygon with control point's indices.

  Mesh mesh = new Mesh();
  mesh.createPolygon(0, 1, 2, 3);
 

createPolygon

public void createPolygon(int v1,
                          int v2,
                          int v3)

Create a polygon with 3 vertices(triangle)

Parameters:

v1 - Index of the first vertex

v2 - Index of the second vertex

v3 - Index of the third vertex Example: The following code shows how to create a new polygon with control point's indices.

  Mesh mesh = new Mesh();
  mesh.createPolygon(0, 1, 2);
 

toMesh

public Mesh toMesh()

Gets the Mesh instance from current entity.

Specified by:

toMesh in interface IMeshConvertible

Returns:

Returns current instance.

doBoolean

public static Mesh doBoolean(BooleanOperation op,
                             Mesh a,
                             Matrix4 transformA,
                             Mesh b,
                             Matrix4 transformB)

Perform Boolean operation on two meshes

Parameters:

op - The Boolean operation type.

a - First mesh to operate.

transformA - Transformation matrix of the first mesh

b - Second mesh to operate

transformB - Transformation matrix of the second mesh

Returns:

The result mesh Example: The following code shows how to calculate the union of two meshes:

isManifold

public boolean isManifold()

Check if current mesh is a manifold mesh. This function will not cache the manifold calculation result.

Returns:

true if the mesh is a manifold mesh.

union

public static Mesh union(Mesh a,
                         Mesh b)

Calculate the union of two meshes

Parameters:

a - First mesh

b - Second mesh

Returns:

Result mesh Example: The following code shows how to union two meshes into one mesh:

difference

public static Mesh difference(Mesh a,
                              Mesh b)

Calculate the difference of two meshes

Parameters:

a - First mesh

b - Second mesh

Returns:

Result mesh Example: The following code shows how to calculate the difference of two meshes:

intersect

public static Mesh intersect(Mesh a,
                             Mesh b)

Calculate the intersection of two meshes

Parameters:

a - First mesh

b - Second mesh

Returns:

Result mesh Example: The following code shows how to calculate the difference of two meshes:

optimize

public Mesh optimize(boolean vertexElements)

Optimize the mesh's memory usage by eliminating duplicated control points

Parameters:

vertexElements - Optimize duplicated vertex element data

Returns:

New mesh instance with compact memory usage Example: The following code shows how to eliminate duplicated control points from an unoptimized mesh:

  //Sphere.ToMesh generates 117 control points
  Mesh mesh = (new Sphere()).toMesh();
  //After optimized, there're only 86 control points, polygon indices are also remapped.
  Mesh optimized = mesh.optimize(true);
 

triangulate

public Mesh triangulate()

Return triangulated mesh

Returns:

Current mesh if current mesh is already triangulated, otherwise a new triangulated mesh will be calculated and returned Example: The following code shows how to triangulate a mesh:

  //The plane mesh has only one polygon with 4 control points
  var mesh = (new Plane()).ToMesh();
  //After triangulated, the new mesh's rectangle will become 2 triangles.
  var triangulated = mesh.Triangulate();
 

optimize

public Mesh optimize(boolean vertexElements,
                     float toleranceControlPoint,
                     float toleranceNormal,
                     float toleranceUV)

Optimize the mesh's memory usage by eliminating duplicated control points

Parameters:

vertexElements - Optimize duplicated vertex element data

toleranceControlPoint - The tolerance for control point, default value is 1e-9

toleranceNormal - The tolerance for normal/tangent/binormal default value is 1e-9

toleranceUV - The tolerance for uv, default value is 1e-9

Returns:

New mesh instance with compact memory usage

optimize

public Mesh optimize(boolean vertexElements,
                     float toleranceControlPoint)

Optimize the mesh's memory usage by eliminating duplicated control points

Parameters:

vertexElements - Optimize duplicated vertex element data

toleranceControlPoint - The tolerance for control point, default value is 1e-9

Returns:

New mesh instance with compact memory usage

optimize

public Mesh optimize(boolean vertexElements,
                     float toleranceControlPoint,
                     float toleranceNormal)

Optimize the mesh's memory usage by eliminating duplicated control points

Parameters:

vertexElements - Optimize duplicated vertex element data

toleranceControlPoint - The tolerance for control point, default value is 1e-9

toleranceNormal - The tolerance for normal/tangent/binormal default value is 1e-9

Returns:

New mesh instance with compact memory usage

iterator

public java.util.Iterator<int[]> iterator()

Gets the enumerator for each inner polygons.

Specified by:

iterator in interface java.lang.Iterable<int[]>

Returns:

The enumerator.

optimize2

public Mesh optimize2(boolean vertexElements)

Optimize the mesh's memory usage by eliminating duplicated control points

Parameters:

vertexElements - Optimize duplicated vertex element data

Returns:

New mesh instance with compact memory usage