com.aspose.threed

Class PolygonModifier

java.lang.Object

com.aspose.threed.PolygonModifier

public class PolygonModifier
extends java.lang.Object

Utilities to modify polygons

Method Summary

Modifier and Type	Method and Description
static void	applyTransform(Node node, Matrix4 transform) Apply transform matrix on control points of all geometries
static void	buildTangentBinormal(Mesh mesh) This will create tangent and binormal on the mesh Normal is required, if normal is not existing on the mesh, it will also create the normal data from position.
static void	buildTangentBinormal(Scene scene) This will create tangent and binormal on all meshes of the scene Normal is required, if normal is not existing on the mesh, it will also create the normal data from position.
static VertexElementNormal	generateNormal(Mesh mesh) Generate normal data from Mesh definition
static VertexElementUV	generateUV(Mesh mesh) Generate UV data from the given input mesh
static VertexElementUV	generateUV(Mesh mesh, VertexElementNormal normals) Generate UV data from the given input mesh and specified normal data.
static Mesh	mergeMesh(java.util.List<Node> nodes) Convert a whole node to a single transformed mesh Vertex elements like normal/texture coordinates are not supported yet
static Mesh	mergeMesh(Node node) Convert a whole node to a single transformed mesh Vertex elements like normal/texture coordinates are not supported yet
static Mesh	mergeMesh(Scene scene) Convert a whole scene to a single transformed mesh Vertex elements like normal/texture coordinates are not supported yet
static void	scale(Node node, Vector3 scale) Scale all geometries(Scale the control points not the transformation matrix) in this node
static Scene	scale(Scene scene, Vector3 scale) Scale all geometries(Scale the control points not the transformation matrix) in this scene
static Mesh[]	splitMesh(Mesh mesh, SplitMeshPolicy policy) Split mesh into sub-meshes by VertexElementMaterial.
static void	splitMesh(Node node, SplitMeshPolicy policy) Split mesh into sub-meshes by VertexElementMaterial.
static void	splitMesh(Node node, SplitMeshPolicy policy, boolean createChildNodes) Split mesh into sub-meshes by VertexElementMaterial.
static void	splitMesh(Node node, SplitMeshPolicy policy, boolean createChildNodes, boolean removeOldMesh) Split mesh into sub-meshes by VertexElementMaterial.
static void	splitMesh(Scene scene, SplitMeshPolicy policy) Split mesh into sub-meshes by VertexElementMaterial.
static void	splitMesh(Scene scene, SplitMeshPolicy policy, boolean removeOldMesh) Split mesh into sub-meshes by VertexElementMaterial.
static int[][]	triangulate(java.util.List<Vector4> controlPoints) Convert a polygon into triangles, the order of the polygon is defined by the controlPoints
static int[][]	triangulate(java.util.List<Vector4> controlPoints, int[] polygon) Convert a polygon into triangles
static int[][]	triangulate(java.util.List<Vector4> controlPoints, java.util.List<int[]> polygons) Convert a polygon-based mesh into triangles
static int[][]	triangulate(java.util.List<Vector4> controlPoints, java.util.List<int[]> polygons, boolean generateNormals, Vector3[][] nor_out) Convert a polygon-based mesh into full triangle mesh
static Mesh	triangulate(Mesh mesh) Convert a polygon-based mesh into full triangle mesh
static void	triangulate(Scene scene) Convert all polygon-based meshes into full triangle mesh

Methods inherited from class java.lang.Object

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

Method Detail

triangulate

public static void triangulate(Scene scene)

Convert all polygon-based meshes into full triangle mesh

Parameters:

scene - The scene to process Example: The following code shows how to merge all objects from a scene into a single mesh.

 
                var mesh = new Cylinder().toMesh();
 
                //Triangulate this quadrangle-based mesh to triangle-based
                mesh = PolygonModifier.triangulate(mesh);
 
                var scene = new Scene(mesh);
 
         scene.save("test.obj");
 

triangulate

public static Mesh triangulate(Mesh mesh)

Convert a polygon-based mesh into full triangle mesh

Parameters:

mesh - The original non-triangle mesh

Returns:

The generated new triangle mesh Example: The following code shows how to merge all objects from a scene into a single mesh.

 
                var mesh = new Cylinder().toMesh();
 
                //Triangulate this quadrangle-based mesh to triangle-based
                mesh = PolygonModifier.triangulate(mesh);
 
                var scene = new Scene(mesh);
 
         scene.save("test.obj");
 

triangulate

public static int[][] triangulate(java.util.List<Vector4> controlPoints,
                                  java.util.List<int[]> polygons,
                                  boolean generateNormals,
                                  Vector3[][] nor_out)

Convert a polygon-based mesh into full triangle mesh

Parameters:

controlPoints - Control points of the mesh

polygons - Polygon faces

generateNormals - Generate normals

nor_out - Generated Per-control point normal

Returns:

A set of triangles Example: The following code shows how to merge all objects from a scene into a single mesh.

 
                var mesh = new Cylinder().toMesh();
 
                //Triangulate this quadrangle-based mesh to triangle-based
                mesh = PolygonModifier.triangulate(mesh);
 
                var scene = new Scene(mesh);
 
         scene.save("test.obj");
 

triangulate

public static int[][] triangulate(java.util.List<Vector4> controlPoints,
                                  java.util.List<int[]> polygons)

Convert a polygon-based mesh into triangles

Parameters:

controlPoints - Control points of the mesh

polygons - Polygon faces

Returns:

A set of triangles Example: The following code shows how to merge all objects from a scene into a single mesh.

 
                var mesh = new Cylinder().toMesh();
 
                //Triangulate this quadrangle-based mesh to triangle-based
                mesh = PolygonModifier.triangulate(mesh);
 
                var scene = new Scene(mesh);
 
         scene.save("test.obj");
 

triangulate

public static int[][] triangulate(java.util.List<Vector4> controlPoints,
                                  int[] polygon)

Convert a polygon into triangles

Parameters:

controlPoints - Control points of the mesh

polygon - Polygon face

Returns:

A set of triangles Example: The following code shows how to merge all objects from a scene into a single mesh.

 
                var mesh = new Cylinder().toMesh();
 
                //Triangulate this quadrangle-based mesh to triangle-based
                mesh = PolygonModifier.triangulate(mesh);
 
                var scene = new Scene(mesh);
 
         scene.save("test.obj");
 

triangulate

public static int[][] triangulate(java.util.List<Vector4> controlPoints)

Convert a polygon into triangles, the order of the polygon is defined by the controlPoints

Parameters:

controlPoints - Control points of the mesh

Returns:

A set of triangles Example: The following code shows how to merge all objects from a scene into a single mesh.

 
                var mesh = new Cylinder().toMesh();
 
                //Triangulate this quadrangle-based mesh to triangle-based
                mesh = PolygonModifier.triangulate(mesh);
 
                var scene = new Scene(mesh);
 
         scene.save("test.obj");
 

mergeMesh

public static Mesh mergeMesh(Scene scene)

Convert a whole scene to a single transformed mesh Vertex elements like normal/texture coordinates are not supported yet

Parameters:

scene - The scene to merge

Returns:

The merged mesh Example: The following code shows how to merge all objects from a scene into a single mesh.

 
         //Input file may contains multiple objects
         var scene = Scene.fromFile("input.fbx");
         //now merge them into a single mesh
         Mesh merged = PolygonModifier.mergeMesh(scene);
         //then we save it to a file with only one mesh
         var newScene = new Scene(merged);
         newScene.save("test.obj");
 

mergeMesh

public static Mesh mergeMesh(java.util.List<Node> nodes)

Convert a whole node to a single transformed mesh Vertex elements like normal/texture coordinates are not supported yet

Parameters:

nodes - The nodes to merge

Returns:

Merged mesh Example: The following code shows how to merge all objects from nodes into a single mesh.

 
         //Input file may contains multiple objects
         var scene = Scene.fromFile("input.fbx");
         //now merge them into a single mesh
         Mesh merged = PolygonModifier.mergeMesh(scene.getRootNode().getChildNodes());
         //then we save it to a file with only one mesh
         var newScene = new Scene(merged);
         newScene.save("test.obj");
 

mergeMesh

public static Mesh mergeMesh(Node node)

Convert a whole node to a single transformed mesh Vertex elements like normal/texture coordinates are not supported yet

Parameters:

node - The node to merge

Returns:

Merged mesh Example: The following code shows how to merge all objects from nodes into a single mesh.

 
          //Input file may contains multiple objects
          var scene = Scene.fromFile("input.fbx");
          //now merge them into a single mesh
          Mesh merged = PolygonModifier.mergeMesh(scene.getRootNode());
          //then we save it to a file with only one mesh
          var newScene = new Scene(merged);
          newScene.save("test.obj");
 

scale

public static Scene scale(Scene scene,
                          Vector3 scale)

Scale all geometries(Scale the control points not the transformation matrix) in this scene

Parameters:

scene - The scene to scale

scale - The scale factor Example: The following code shows how to scale all geometries in scene by 10 times.

 
                //Load a test file for scaling
                var scene = Scene.fromFile("input.fbx");
                //scale all geometries 10 times.
                PolygonModifier.scale(scene, new Vector3(10, 10, 10));
                scene.save("test.obj");
 

scale

public static void scale(Node node,
                         Vector3 scale)

Scale all geometries(Scale the control points not the transformation matrix) in this node

Parameters:

node - The node to scale

scale - The scale factor Example: The following code shows how to scale all geometries in scene by 10 times.

 
                 //Load a test file for scaling
                 var scene = Scene.fromFile("input.fbx");
                 //scale all geometries 10 times.
                 PolygonModifier.scale(scene.getRootNode(), new Vector3(10, 10, 10));
                 scene.save("test.obj");
 

applyTransform

public static void applyTransform(Node node,
                                  Matrix4 transform)

Apply transform matrix on control points of all geometries

Parameters:

node - Which node's geometries will be applied with given transform

transform - The transformation matrix that will be applied to control points.

generateNormal

public static VertexElementNormal generateNormal(Mesh mesh)

Generate normal data from Mesh definition

Returns:

VertexElementNormal instance with normal data.

generateUV

public static VertexElementUV generateUV(Mesh mesh,
                                         VertexElementNormal normals)

Generate UV data from the given input mesh and specified normal data.

Parameters:

mesh - The input mesh

normals - The normal data

Returns:

Generated UV data

generateUV

public static VertexElementUV generateUV(Mesh mesh)

Generate UV data from the given input mesh

Parameters:

mesh - The input mesh

Returns:

Generated UV data

splitMesh

public static void splitMesh(Node node,
                             SplitMeshPolicy policy,
                             boolean createChildNodes,
                             boolean removeOldMesh)

Split mesh into sub-meshes by VertexElementMaterial. Each sub-mesh will use only one material. Perform mesh splitting on a node

Parameters:

createChildNodes - Create child nodes for each sub-mesh.

removeOldMesh - Remove the old mesh after split, if this parameter is false, the old and new meshes will co-exists. Example: The following code shows how to split a box into sub meshes using material indices.

 
                        // Create a mesh of box(A box is composed by 6 planes)
                        Mesh box = (new Box()).toMesh();
                        // Create a material element on this mesh
                        VertexElementMaterial mat = (VertexElementMaterial)box.createElement(VertexElementType.MATERIAL, MappingMode.POLYGON, ReferenceMode.INDEX);
                        // And specify different material index for each plane
                        mat.setIndices(new int[] { 0, 1, 2, 3, 4, 5 });
                        // Now split it into 6 sub meshes, we specified 6 different materials on each plane, each plane will become a sub mesh.
                        // We used the CloneData policy, each plane will has the same control point information or control point-based vertex element information.
                        Mesh[] planes = PolygonModifier.splitMesh(box, SplitMeshPolicy.CLONE_DATA);
 
                        // Now split it into 2 sub meshes, first mesh will contains 0/1/2 planes, and second mesh will contains the 3/4/5th planes.
                        mat.setIndices(new int[] { 0, 0, 0, 1, 1, 1 });
                        // We used the CompactData policy, each plane will has its own control point information or control point-based vertex element information.
                        planes = PolygonModifier.splitMesh(box, SplitMeshPolicy.COMPACT_DATA);
 

splitMesh

public static void splitMesh(Node node,
                             SplitMeshPolicy policy)

Split mesh into sub-meshes by VertexElementMaterial. Each sub-mesh will use only one material. Perform mesh splitting on a node Example: The following code shows how to split a box into sub meshes using material indices.

 
                        // Create a mesh of box(A box is composed by 6 planes)
                        Mesh box = (new Box()).toMesh();
                        // Create a material element on this mesh
                        VertexElementMaterial mat = (VertexElementMaterial)box.createElement(VertexElementType.MATERIAL, MappingMode.POLYGON, ReferenceMode.INDEX);
                        // And specify different material index for each plane
                        mat.setIndices(new int[] { 0, 1, 2, 3, 4, 5 });
                        // Now split it into 6 sub meshes, we specified 6 different materials on each plane, each plane will become a sub mesh.
                        // We used the CloneData policy, each plane will has the same control point information or control point-based vertex element information.
                        Mesh[] planes = PolygonModifier.splitMesh(box, SplitMeshPolicy.CLONE_DATA);
 
                        // Now split it into 2 sub meshes, first mesh will contains 0/1/2 planes, and second mesh will contains the 3/4/5th planes.
                        mat.setIndices(new int[] { 0, 0, 0, 1, 1, 1 });
                        // We used the CompactData policy, each plane will has its own control point information or control point-based vertex element information.
                        planes = PolygonModifier.splitMesh(box, SplitMeshPolicy.COMPACT_DATA);
 

splitMesh

public static void splitMesh(Node node,
                             SplitMeshPolicy policy,
                             boolean createChildNodes)

Split mesh into sub-meshes by VertexElementMaterial. Each sub-mesh will use only one material. Perform mesh splitting on a node

Parameters:

createChildNodes - Create child nodes for each sub-mesh. Example: The following code shows how to split a box into sub meshes using material indices.

 
                        // Create a mesh of box(A box is composed by 6 planes)
                        Mesh box = (new Box()).toMesh();
                        // Create a material element on this mesh
                        VertexElementMaterial mat = (VertexElementMaterial)box.createElement(VertexElementType.MATERIAL, MappingMode.POLYGON, ReferenceMode.INDEX);
                        // And specify different material index for each plane
                        mat.setIndices(new int[] { 0, 1, 2, 3, 4, 5 });
                        // Now split it into 6 sub meshes, we specified 6 different materials on each plane, each plane will become a sub mesh.
                        // We used the CloneData policy, each plane will has the same control point information or control point-based vertex element information.
                        Mesh[] planes = PolygonModifier.splitMesh(box, SplitMeshPolicy.CLONE_DATA);
 
                        // Now split it into 2 sub meshes, first mesh will contains 0/1/2 planes, and second mesh will contains the 3/4/5th planes.
                        mat.setIndices(new int[] { 0, 0, 0, 1, 1, 1 });
                        // We used the CompactData policy, each plane will has its own control point information or control point-based vertex element information.
                        planes = PolygonModifier.splitMesh(box, SplitMeshPolicy.COMPACT_DATA);
 

splitMesh

public static void splitMesh(Scene scene,
                             SplitMeshPolicy policy,
                             boolean removeOldMesh)

Split mesh into sub-meshes by VertexElementMaterial. Each sub-mesh will use only one material. Perform mesh splitting on all nodes of the scene. Example: The following code shows how to split a box into sub meshes using material indices.

 
                        // Create a mesh of box(A box is composed by 6 planes)
                        Mesh box = (new Box()).toMesh();
                        // Create a material element on this mesh
                        VertexElementMaterial mat = (VertexElementMaterial)box.createElement(VertexElementType.MATERIAL, MappingMode.POLYGON, ReferenceMode.INDEX);
                        // And specify different material index for each plane
                        mat.setIndices(new int[] { 0, 1, 2, 3, 4, 5 });
                        // Now split it into 6 sub meshes, we specified 6 different materials on each plane, each plane will become a sub mesh.
                        // We used the CloneData policy, each plane will has the same control point information or control point-based vertex element information.
                        Mesh[] planes = PolygonModifier.splitMesh(box, SplitMeshPolicy.CLONE_DATA);
 
                        // Now split it into 2 sub meshes, first mesh will contains 0/1/2 planes, and second mesh will contains the 3/4/5th planes.
                        mat.setIndices(new int[] { 0, 0, 0, 1, 1, 1 });
                        // We used the CompactData policy, each plane will has its own control point information or control point-based vertex element information.
                        planes = PolygonModifier.splitMesh(box, SplitMeshPolicy.COMPACT_DATA);
 

splitMesh

public static void splitMesh(Scene scene,
                             SplitMeshPolicy policy)

Split mesh into sub-meshes by VertexElementMaterial. Each sub-mesh will use only one material. Perform mesh splitting on all nodes of the scene. Example: The following code shows how to split a box into sub meshes using material indices.

 
                        // Create a mesh of box(A box is composed by 6 planes)
                        Mesh box = (new Box()).toMesh();
                        // Create a material element on this mesh
                        VertexElementMaterial mat = (VertexElementMaterial)box.createElement(VertexElementType.MATERIAL, MappingMode.POLYGON, ReferenceMode.INDEX);
                        // And specify different material index for each plane
                        mat.setIndices(new int[] { 0, 1, 2, 3, 4, 5 });
                        // Now split it into 6 sub meshes, we specified 6 different materials on each plane, each plane will become a sub mesh.
                        // We used the CloneData policy, each plane will has the same control point information or control point-based vertex element information.
                        Mesh[] planes = PolygonModifier.splitMesh(box, SplitMeshPolicy.CLONE_DATA);
 
                        // Now split it into 2 sub meshes, first mesh will contains 0/1/2 planes, and second mesh will contains the 3/4/5th planes.
                        mat.setIndices(new int[] { 0, 0, 0, 1, 1, 1 });
                        // We used the CompactData policy, each plane will has its own control point information or control point-based vertex element information.
                        planes = PolygonModifier.splitMesh(box, SplitMeshPolicy.COMPACT_DATA);
 

splitMesh

public static Mesh[] splitMesh(Mesh mesh,
                               SplitMeshPolicy policy)

Split mesh into sub-meshes by VertexElementMaterial. Each sub-mesh will use only one material. The original mesh will not get changed.

Returns:

New splitted meshes Example: The following code shows how to split a box into sub meshes using material indices.

 
                        // Create a mesh of box(A box is composed by 6 planes)
                        Mesh box = (new Box()).toMesh();
                        // Create a material element on this mesh
                        VertexElementMaterial mat = (VertexElementMaterial)box.createElement(VertexElementType.MATERIAL, MappingMode.POLYGON, ReferenceMode.INDEX);
                        // And specify different material index for each plane
                        mat.setIndices(new int[] { 0, 1, 2, 3, 4, 5 });
                        // Now split it into 6 sub meshes, we specified 6 different materials on each plane, each plane will become a sub mesh.
                        // We used the CloneData policy, each plane will has the same control point information or control point-based vertex element information.
                        Mesh[] planes = PolygonModifier.splitMesh(box, SplitMeshPolicy.CLONE_DATA);
 
                        // Now split it into 2 sub meshes, first mesh will contains 0/1/2 planes, and second mesh will contains the 3/4/5th planes.
                        mat.setIndices(new int[] { 0, 0, 0, 1, 1, 1 });
                        // We used the CompactData policy, each plane will has its own control point information or control point-based vertex element information.
                        planes = PolygonModifier.splitMesh(box, SplitMeshPolicy.COMPACT_DATA);
 

buildTangentBinormal

public static void buildTangentBinormal(Scene scene)

This will create tangent and binormal on all meshes of the scene Normal is required, if normal is not existing on the mesh, it will also create the normal data from position. UV is also required, the mesh will be ignored if no UV is defined.

buildTangentBinormal

public static void buildTangentBinormal(Mesh mesh)

This will create tangent and binormal on the mesh Normal is required, if normal is not existing on the mesh, it will also create the normal data from position. UV is also required, an exception will be raised if no UV found.