ObjectMeshStatic Class

ObjectMeshStatic Class

Members

static ObjectMeshStatic ( string path, variable v, int unique = 0 ) #

Arguments

• string path - Path to the mesh file.
• variable v - A variable of one of the following types:
  • Mesh mesh - The source mesh.
  • string name - The 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.

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)) {
	// 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 ) #

Arguments

• string name - Path to the mesh file.

void setMeshNameForce ( string path ) #

Arguments

• string path - Path to the mesh file.

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, variable v0, variable v1, int surface, int target = -1 ) #

Appends the specified surface of the source mesh to the current mesh. Variables, passed as arguments, can be of the following types:

• string and Mesh.
• string and ObjectMeshStatic.
• int and ObjectMeshStatic.

Arguments

• int dest_surface - Number of the surface to copy the mesh to.
• variable v0 - Argument of one of the following types:
  • string name - The name of the new surface.
  • int dest_surface - The number of the new surface.
• variable v1 - Argument of one of the following types:
  • Mesh mesh - The source mesh to copy the surface from.
  • ObjectMeshStatic mesh - The source mesh to copy the 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 path, int unique = 0 ) #

Arguments

• string path - 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 path ) #

Arguments

• string path - Path to the .mesh file.

Return value

int saveMesh ( string path ) #

// setting mesh name from the desired path
UGUID guid = engine.filesystem.getGUID(path);
object_mesh_static.setMeshName(guid.getFileSystemString());

// saving the mesh to the desired path
object_mesh_static.saveMesh(path);

Arguments

• string path - Path to the file, to which the mesh is to be saved.

Return value

void updateSurfaceBounds ( int surface = -1 ) #

Arguments

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