Unigine.ObjectMeshStatic Class

This class is used for handling static meshes.

ObjectMeshStatic Class

Members

static ObjectMeshStatic(Mesh mesh)

Arguments

• Mesh mesh - A mesh smart pointer.

static ObjectMeshStatic(string name, int unique = 0)

Arguments

• string name - Path to the mesh file.
• int unique - When you create several objects out of a single .mesh file, the instance of the mesh geometry is created. If you then change the source geometry, its instances will be changed as well. To avoid this, set the unique flag to 1, so a copy of the mesh geometry will be created and changes won't be applied.

ObjectMeshStatic cast(Object base)

Arguments

• Object base - Object instance.

Return value

ObjectMeshStatic cast(Node node)

Arguments

• Node node - Node instance.

Return value

void setCIndex(int num, int index, int surface)

Arguments

• int num - Vertex number in the range from 0 to the total number of coordinate indices for the given surface.
  Notice

  To get the total number of coordinate indices for the given surface, use the getNumCIndices() method.
• int index - Coordinate index to be set in the range from 0 to the total number of coordinate vertices for the given surface.
  Notice

  To get the total number of coordinate vertices for the given surface, use the getNumVertex() method.
• int surface - Mesh surface number.

int getCIndex(int num, int surface)

Arguments

• int num - Vertex number in the range from 0 to the total number of coordinate indices for the given surface.
  Notice

  To get the total number of coordinate indices for the given surface, use the getNumCIndices() method.
• int surface - Mesh surface number.

Return value

void setColor(int num, vec4 color, int surface)

Arguments

• int num - Triangle vertex number in the range from 0 to the total number of vertex color entries of the given surface.
  Notice

  To get the total number of vertex color entries for the surface, call the getNumColors() method.
• vec4 color - Vertex color to be set.
• int surface - Mesh surface number.

vec4 getColor(int num, int surface)

Arguments

• int num - Triangle vertex number in the range from 0 to the total number of vertex color entries of the given surface.
  Notice

  To get the total number of vertex color entries for the surface, call the getNumColors() method.
• int surface - Mesh surface number.

Return value

int getMesh(Mesh mesh)

// a static mesh from which geometry will be obtained
ObjectMeshStatic staticMesh = new ObjectMeshStatic("box.mesh");
// create a new mesh
Mesh mesh = new Mesh();
// copy geometry to the created mesh
if (staticMesh.getMesh(mesh) == 1) {
	// do something with the obtained mesh
}
else {
	Log.error("Failed to copy a mesh\n");
}

Arguments

• Mesh mesh - Destination mesh.

Return value

int setMesh(Mesh mesh, int unique = 1)

// create ObjectMeshStatic instances 
ObjectMeshStatic staticMesh = new ObjectMeshStatic("box.mesh");
ObjectMeshStatic staticMesh_2 = new ObjectMeshStatic("capsule.mesh");

// create a Mesh instance
Mesh firstMesh = new Mesh();

// get the mesh of the ObjectMeshStatic and copy it to the Mesh class instance
staticMesh.getMesh(firstMesh);

// put the firstMesh mesh to the staticMesh_2 instance
staticMesh_2.setMesh(firstMesh);

Arguments

• Mesh mesh - Source mesh to be copied.
• int unique - Unique flag used when you create several objects out of a single Mesh instance :
  • 0 - An instance of source mesh geometry is created. If the source geometry is changed at runtime, its instances will be changed as well.
  • 1 - A copy of source mesh geometry is created and changes made to the source geometry do not affect the mesh.

Return value

void setMeshName(string name, int force_load = 0)

Arguments

• string name - Mesh name.
• int force_load - Force flag.
  • If 1 is specified, the mesh with the new name will be created immediately with the unique flag set to 0.
  • If 0 is specified, only the mesh name will be updated.

string getMeshName()

Return value

int getMeshSurface(Mesh mesh, int surface, int target = -1)

Arguments

• Mesh mesh - Destination mesh to copy the surface into.
• int surface - Number of the mesh surface to be copied.
• int target - Number of the surface target to be copied. The default value is -1 (all targets).

Return value

vec3 getNormal(int num, int surface, int target = 0)

Arguments

• int num - Triangle vertex number in the range from 0 to the total number of vertex tangent entries of the given surface target.
  Notice

  Vertex normals are calculated using vertex tangents. To get the total number of vertex tangent entries for the surface target, call the getNumTangents() method.
• int surface - Mesh surface number.
• int target - Surface target number. The default value is 0.

Return value

int getNumCIndices(int surface)

Arguments

• int surface - Mesh surface number.

Return value

int getNumColors(int surface)

Arguments

• int surface - Surface number.

Return value

int getNumSurfaceTargets(int surface)

Arguments

• int surface - Mesh surface number.

Return value

int getNumTangents(int surface)

Arguments

• int surface - Mesh surface number.

Return value

void setNumTexCoords0(int num, int surface)

Arguments

• int num - Number of the first UV map texture coordinates to be set.
• int surface - Mesh surface number.

int getNumTexCoords0(int surface)

Arguments

• int surface - Mesh surface number.

Return value

void setNumTexCoords1(int num, int surface)

Arguments

• int num - Number of the second UV map texture coordinates to be set.
• int surface - Mesh surface number.

int getNumTexCoords1(int surface)

Arguments

• int surface - Mesh surface number.

Return value

int getNumTIndices(int surface)

Arguments

• int surface - Mesh surface number.

Return value

int getNumVertex(int surface)

Arguments

• int surface - Mesh surface number.

Return value

int getSplineMesh(Mesh mesh)

Arguments

• Mesh mesh - Destination mesh.

Return value

string getSurfaceTargetName(int surface, int target)

Arguments

• int surface - Mesh surface number.
• int target - Number of the surface target.

Return value

void setSurfaceTransform(mat4 transform, int surface, int target = -1)

Arguments

• mat4 transform - Transformation matrix.
• int surface - Mesh surface number.
• int target - Number of the surface target. The default value is -1 (all targets).

void setTangent(int num, quat tangent, int surface, int target = 0)

Arguments

• int num - Triangle vertex number in the range from 0 to the total number of vertex tangent entries of the given surface.
  Notice

  To get the total number of vertex tangent entries for the surface, call the getNumTangents() method.
• quat tangent - Tangent to be set.
• int surface - Mesh surface number.
• int target - Surface target number. The default value is 0.

quat getTangent(int num, int surface, int target = 0)

Arguments

• int num - Triangle vertex number in the range from 0 to the total number of vertex tangent entries of the given surface.
  Notice

  To get the total number of vertex tangent entries for the surface, call the getNumTangents() method.
• int surface - Mesh surface number.
• int target - Surface target number. The default value is 0.

Return value

void setTexCoord0(int num, vec2 texcoord, int surface)

Arguments

• int num - Triangle vertex number in the range from 0 to the total number of first UV map texture coordinate entries of the given surface.
  Notice

  To get the total number of first UV map texture coordinate entries for the surface, call the getNumTexCoords0() method.
• vec2 texcoord - First UV map texture coordinates to be set.
• int surface - Mesh surface number.

vec2 getTexCoord0(int num, int surface)

Arguments

• int num - Triangle vertex number in the range from 0 to the total number of first UV map texture coordinate entries of the given surface.
  Notice

  To get the total number of first UV map texture coordinate entries for the surface, call the getNumTexCoords0() method.
• int surface - Mesh surface number.

Return value

void setTexCoord1(int num, vec2 texcoord, int surface)

Arguments

• int num - Triangle vertex number in the range from 0 to the total number of second UV map texture coordinate entries of the given surface.
  Notice

  To get the total number of second UV map texture coordinate entries for the surface, call the getNumTexCoords1() method.
• vec2 texcoord - Second UV map texture coordinates to be set.
• int surface - Mesh surface number.

vec2 getTexCoord1(int num, int surface)

Arguments

• int num - Triangle vertex number in the range from 0 to the total number of second UV map texture coordinate entries of the given surface.
  Notice

  To get the total number of second UV map texture coordinate entries for the surface, call the getNumTexCoords1() method.
• int surface - Mesh surface number.

Return value

void setTIndex(int num, int index, int surface)

Arguments

• int num - Vertex number in the range from 0 to the total number of triangle indices for the given surface.
  Notice

  To get the total number of triangle indices, use the getNumTIndices() method.
• int index - Triangle index to be set in the range from 0 to the total number of triangle vertices for the given surface.
  Notice

  To get the total number of triangle vertices for the given surface, use the getNumTVertex() method.
• int surface - Mesh surface number.

int getTIndex(int num, int surface)

Arguments

• int num - Vertex number in the range from 0 to the total number of triangle indices for the given surface.
  Notice

  To get the total number of triangle indices for the given surface, use the getNumTIndices() method.
• int surface - Mesh surface number.

Return value

void setVertex(int num, vec3 vertex, int surface, int target = 0)

Arguments

• int num - Coordinate vertex number in the range from 0 to the total number of coordinate vertices for the given surface.
  Notice

  To get the total number of coordinate vertices for the given surface, use the getNumCVertex() method.
• vec3 vertex - Vertex coordinates to be set.
• int surface - Mesh surface number.
• int target - Surface target number. The default value is 0.

vec3 getVertex(int num, int surface, int target = 0)

Arguments

• int num - Coordinate vertex number in the range from 0 to the total number of coordinate vertices for the given surface.
  Notice

  To get the total number of coordinate vertices for the given surface, use the getNumCVertex() method.
• int surface - Mesh surface number.
• int target - Surface target number. The default value is 0.

Return value

int addEmptySurface(string name, int num_vertex, int num_indices)

Arguments

• string name - The name of the new surface.
• int num_vertex - Number of the new surface vertices.
• int num_indices - Number of the new surface indices.

Return value

int addMeshSurface(int dest_surface, ObjectMeshStatic mesh, int surface, int target = -1)

Arguments

• int dest_surface - Number of the surface to copy the mesh to.
• ObjectMeshStatic mesh - Source ObjectMeshStatic to copy a surface from.
• int surface - Mesh surface number to copy.
• int target - Mesh target number to copy. The default value is -1 (all targets).

Return value

int addMeshSurface(string name, Mesh mesh, int surface, int target = -1)

Arguments

• string name - Name of the new surface of the current mesh.
• Mesh mesh - Mesh pointer to copy a surface from.
• int surface - Mesh surface number to copy.
• int target - Mesh target number to copy. The default value is -1 (all targets).

Return value

int addMeshSurface(string name, ObjectMeshStatic mesh, int surface, int target = -1)

Arguments

• string name - Name of the new surface of the current mesh.
• ObjectMeshStatic mesh - Mesh pointer to copy a surface from.
• int surface - Mesh surface number to copy.
• int target - Mesh target number to copy. The default value is -1 (all targets).

Return value

int addSurfaceTarget(int surface, string name = 0)

Arguments

• int surface - The number of the surface, to which the target will be appended.
• string name - The name of the new target.

Return value

int createMesh(string name, int unique = 0)

Arguments

• string name - Path to the mesh file.
• int unique - Unique flag used when you create several objects out of a single .mesh file :
  • 0 - An instance of source mesh geometry is created. If the source geometry is changed at runtime, its instances will be changed as well.
  • 1 - A copy of source mesh geometry is created and changes made to the source geometry do not affect the mesh.

Return value

int findSurfaceTarget(string name, int surface)

Arguments

• string name - The name of the target.
• int surface - Mesh surface number.

Return value

void flushMesh()

int loadMesh(string name)

Arguments

• string name - The path to the .mesh file.

Return value

int saveMesh(string name)

Arguments

• string name - The path to the file.

Return value

static int type()

Return value

void updateSurfaceBounds(int surface = -1)

Arguments

• int surface - Surface number (use -1 for all surfaces).