Unigine.MeshStatic Class

MeshStatic Class

Members

---

MeshStatic ( ) #

Constructor. Creates an empty static mesh.

int Info ( string path ) #

Returns an information about the given mesh.

Arguments

• string path - Path to the mesh.

Return value

int Load ( string path ) #

Loads the mesh using the specified path.

Arguments

• string path - Path to the mesh.

Return value

1 if the mesh is loaded successfully; otherwise, 0.

int Save ( string path ) #

Saves the mesh to the specified location.

Arguments

• string path - Path to the mesh.

Return value

1 if the mesh is saved successfully; otherwise, 0.

int SetMesh ( Mesh mesh ) #

Copies a given source mesh into the current mesh.

Arguments

• Mesh mesh - Source mesh to be copied.

Return value

1 if the mesh is copied successfully; otherwise, 0.

int GetMesh ( Mesh mesh ) #

Copies the current mesh into the destination mesh.

Arguments

• Mesh mesh - Destination mesh.

Return value

true if the mesh is copied successfully; otherwise, false.

void Clear ( ) #

Clears the mesh (including its surfaces and bounds).

void Destroy ( ) #

Destroys the mesh.

void Flush ( ) #

Flushes the mesh geometry into the video memory.

void AsyncCreate ( ) #

Creates the mesh asynchronously (in anoher thread).

void AsyncDestroy ( ) #

Destroys the mesh asynchronously (in anoher thread).

void Bind ( ) #

Binds static mesh data (index and vertex buffers) to the input assembler stage.

void Unbind ( ) #

Unbinds static mesh data (index and vertex buffers).

int RenderSurface ( int mode, int surface, int target = 0 ) #

Renders the surface.

Arguments

• int mode - Rendering mode. One of the MODE_* variables.
• int surface
• int target - Surface target number. The default value is 0.

Return value

Number of primitives rendered. Primitive type is determined by the rendering mode.

int RenderInstancedSurface ( int mode, int num, int surface, int target = 0 ) #

Renders the specified number of instances of the surface.

Arguments

• int mode - Rendering mode. One of the MODE_* variables.
• int num - Number of instances to be rendered.
• int surface
• int target - Surface target number. The default value is 0.

Return value

Number of primitives rendered. Primitive type is determined by the rendering mode.

int Render ( int mode, int surface = -1, int target = 0 ) #

Renders the static mesh with the specified settings and mode.

Arguments

• int mode - Rendering mode. One of the MODE_* variables.
• int surface - Surface number (use -1 for all surfaces).
• int target - Surface target number. The default value is 0.

int RenderInstanced ( int mode, int num, int surface = -1, int target = 0 ) #

Renders the specified number of instances of the surface.

Arguments

• int mode - Rendering mode. One of the MODE_* variables.
• int num - Number of instances to be rendered.
• int surface - Surface number (use -1 for all surfaces).
• int target - Surface target number. The default value is 0.

Return value

Number of primitives rendered. Primitive type is determined by the rendering mode.

uint GetSystemMemoryUsage ( ) #

Returns the current amount of system memory used by the static mesh, in bytes.

Return value

System memory amount used by the static mesh, in bytes.

uint GetVideoMemoryUsage ( ) #

Returns the current amount of video memory used by the static mesh.

Return value

Video memory amount used by the static mesh, in bytes.

int GetNumSurfaces ( ) #

Returns the total number of mesh surfaces.

Return value

Number of mesh surfaces.

string GetSurfaceName ( int surface ) #

Returns the name of the given surface.

Arguments

• int surface - Mesh surface number.

Return value

Surface name.

void SetSurfaceLightmapUVChannel ( int surface, byte uv_channel ) #

Sets a new UV channel to be used for lightmaps of the surface with the specified number.

Arguments

• int surface - Mesh surface number.
• byte uv_channel - UV channel to be used for lightmaps of the surface with the specified number.

byte GetSurfaceLightmapUVChannel ( int surface ) #

Returns the current UV channel used for lightmaps of the surface with the specified number.

Arguments

• int surface - Mesh surface number.

Return value

UV channel currently used for lightmaps of the surface with the specified number.

void SetSurfaceLightmapResolution ( int surface, Mesh.LIGHTMAP_RESOLUTION resolution ) #

Sets a new lightmap resolution for the surface with the specified number.

Arguments

• int surface - Mesh surface number.
• Mesh.LIGHTMAP_RESOLUTION resolution - Lightmap resolution to be used for the surface with the specified number.

Mesh.LIGHTMAP_RESOLUTION GetSurfaceLightmapResolution ( int surface ) #

Returns the current lightmap resolution for the surface with the specified number.

Arguments

• int surface - Mesh surface number.

Return value

Current lightmap resolution for the surface with the specified number.

int FindSurface ( string name ) #

Searches for the surface number by its name.

Arguments

• string name - Mesh surface name.

Return value

Mesh surface number, if it is found; otherwise, -1.

int GetNumSurfaceTargets ( int surface ) #

Returns the number of surface targets for the given surface.

Arguments

• int surface - Mesh surface number.

Return value

Number of surface targets.

string GetSurfaceTargetName ( int surface, int target ) #

Returns the name of the given surface target.

Arguments

• int surface - Mesh surface number.
• int target - Surface target number.

Return value

Surface target name.

int FindSurfaceTarget ( string name, int surface ) #

Searches for the target number by the target name.

Arguments

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

Return value

Target number, if exists; otherwise, -1.

void UpdateSurfaceBounds ( int surface = -1 ) #

Updates mesh bounds. This method is to be called to recalculate bounds after changing a mesh surface (e.g. modifying positions of coordinate vertices).

Arguments

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

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

Sets the transformation matrix for the given surface target.

Arguments

• mat4 transform - Transformation matrix to be set.
• int surface - Mesh surface number.
• int target - Surface target number. The default value is -1 (apply to all of the surface targets).

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

Appends a surface of the source mesh to the current mesh as a new surface.

Arguments

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

Return value

Number of the last added surface.

int AddMeshSurface ( string name, MeshStatic mesh, int surface, int target = -1 ) #

Appends a new mesh surface to the current mesh.

Arguments

• string name - Name of the new surface added to the current mesh.
• MeshStatic mesh - Source mesh to copy a surface from.
• int surface - Number of the source mesh surface to copy.
• int target - Number of the target of the source mesh surface. The default value is -1 (all of the surface targets).

Return value

Number of the last added surface.

int AddMeshSurface ( int dest_surface, MeshStatic mesh, int surface, int target = -1 ) #

Appends a new mesh surface to the current mesh.

Arguments

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

Return value

Number of the last added surface.

int GetMeshSurface ( Mesh mesh, int surface, int target = -1 ) #

Copies the specified mesh surface into the destination mesh.

Arguments

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

Return value

Number of the added mesh surface.

int AddEmptySurface ( string name, int num_vertex, int num_indices ) #

Appends a new empty surface to the current mesh.

Arguments

• string name - Surface name.
• int num_vertex - Number of surface vertices.
• int num_indices - Number of surface indices.

Return value

Number of the mesh surfaces.

int AddSurfaceTarget ( int surface, string name ) #

Appends a target with the given name to the given surface.

Arguments

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

Return value

Number of surface targets.

int GetCollision ( vec3 p0, vec3 p1, int[] surfaces ) #

Performs the search for the collision of the given surfaces with the given traced line.

Arguments

• vec3 p0 - Start point coordinates.
• vec3 p1 - End point coordinates.
• int[] surfaces - Mesh surfaces.

Return value

1 if the collision is found; otherwise, 0.

int GetCollision ( vec3 p0, vec3 p1, int[] triangles, int surface ) #

Arguments

• vec3 p0 - Start point coordinates.
• vec3 p1 - End point coordinates.
• int[] triangles
• int surface - Mesh surface number.

Return value

1 if the collision is found; otherwise, 0.

int GetCollision ( BoundBox bb, int[] surfaces ) #

Performs the search for the collision of the given surfaces with the given bounding box.

Arguments

• BoundBox bb - Bounding box.
• int[] surfaces - Mesh surfaces.

Return value

1 if the collision is found; otherwise, 0.

int GetCollision ( BoundBox bb, int[] triangles, int surface ) #

Arguments

• BoundBox bb - Bounding box.
• int[] triangles
• int surface - Mesh surface number.

Return value

1 if the collision is found; otherwise, 0.

int GetCollision ( BoundFrustum bf, int[] surfaces ) #

Performs the search for the collision of the given surfaces with the given bounding frustum.

Arguments

• BoundFrustum bf - Bounding frustum.
• int[] surfaces - Mesh surfaces.

Return value

1 if the collision is found; otherwise, 0.

int GetCollision ( BoundFrustum bf, int[] triangles, int surface ) #

Arguments

• BoundFrustum bf - Bounding frustum.
• int[] triangles
• int surface - Mesh surface number.

Return value

1 if the collision is found; otherwise, 0.

byte[] GetEdges ( int surface ) #

Returns the edges that are edges of the mesh geometry, i.e. the neighboring triangles that form these edges are lying in different planes.

Arguments

• int surface - Mesh surface number.

Return value

Edges that are edges of the mesh geometry.

int GetIntersection ( vec3 p0, vec3 p1, vec3[] ret_point, vec3[] ret_normal, vec4[] ret_texcoord, int[] ret_index, int surface, int target = 0 ) #

Performs the search for the intersection of the given surface target with the given traced line.

Arguments

• vec3 p0 - Start point coordinates.
• vec3 p1 - End point coordinates.
• vec3[] ret_point - Return array to write the intersection point coordinates into.
• vec3[] ret_normal - Return array to write the intersection point normal into.
• vec4[] ret_texcoord - Return array to write the texture coordinates into.
• int[] ret_index - Return array to write the intersection point indices into.
• int surface - Mesh surface number.
• int target - Surface target number. The default value is 0.

Return value

1 if the intersection is found; otherwise, 0.

int GetIntersection ( dvec3 p0, dvec3 p1, dvec3[] ret_point_, vec3[] ret_normal, vec4[] ret_texcoord, int[] ret_index, int surface, int target = 0 ) #

Performs the search for the intersection of the given surface target with the given traced line.

Arguments

• dvec3 p0 - Start point coordinates.
• dvec3 p1 - End point coordinates.
• dvec3[] ret_point_ - Return array to write the intersection point coordinates into.
• vec3[] ret_normal - Return array to write the intersection point normal into.
• vec4[] ret_texcoord - Return array to write the texture coordinates into.
• int[] ret_index - Return array to write the intersection point indices into.
• int surface - Mesh surface number.
• int target - Surface target number. The default value is 0.

Return value

1 if the intersection is found; otherwise, 0.

void SetBoundBox ( BoundBox bb ) #

Sets the bounding box for the mesh.

Arguments

• BoundBox bb - Bounding box to be set.

void SetBoundBox ( BoundBox bb, int surface ) #

Sets the bounding box for the given mesh surface.

Arguments

• BoundBox bb - Bounding box to be set.
• int surface - Mesh surface number.

BoundBox GetBoundBox ( ) #

Returns the bounding box of the mesh.

Return value

Bounding box.

BoundBox GetBoundBox ( int surface ) #

Returns the bounding box of the given mesh surface.

Arguments

• int surface - Mesh surface number.

Return value

Bounding box.

void SetBoundSphere ( BoundSphere bs ) #

Sets the bounding sphere for the mesh.

Arguments

• BoundSphere bs - Bounding sphere to be set.

void SetBoundSphere ( BoundSphere bs, int surface ) #

Sets the bounding sphere for the given mesh surface.

Arguments

• BoundSphere bs - Bounding sphere to be set.
• int surface - Mesh surface number.

BoundSphere GetBoundSphere ( ) #

Returns the bounding sphere of the mesh.

Return value

Bounding sphere.

BoundSphere GetBoundSphere ( int surface ) #

Returns the bounding sphere of the given mesh surface.

Arguments

• int surface - Mesh surface number.

Return value

Bounding sphere.

vec3[] GetVertex ( int surface, int target = 0 ) #

Returns coordinates of the given coordinate vertex of the given surface target.

Arguments

• int surface - Mesh surface number.
• int target - Surface target number. The default value is 0.

Return value

Vertex coordinates.

hvec4[] GetTangents ( int surface, int target = 0 ) #

Returns tangents for the given surface target.

Arguments

• int surface - Mesh surface number.
• int target - Surface target number. The default value is 0.

Return value

Tangents of the surface target.

vec2[] GetTexCoords0 ( int surface ) #

Returns the first UV map texture coordinates of the given surface.

Arguments

• int surface - Mesh surface number.

Return value

First UV map texture coordinates.

vec2[] GetTexCoords1 ( int surface ) #

Returns the second UV map texture coordinates of the given surface.

Arguments

• int surface - Mesh surface number.

Return value

Second UV map texture coordinates.

bvec4[] GetColors ( int surface ) #

Returns the vertex colors of the given surface.

Arguments

• int surface - Mesh surface number.

Return value

Vertex colors.

int[] GetCIndices ( int surface ) #

Returns the coordinate indices of all vertices of the given surface.

Arguments

• int surface - Mesh surface number.

Return value

Coordinate indices.

int[] GetTIndices ( int surface ) #

Returns the triangle indices of the given surface.

Arguments

• int surface - Mesh surface number.

Return value

Triangle indices.

void SetDebugName ( string name ) #

Sets a friendly name for GPU debugging (RenderDoc, NVIDIA Nsight). It can be used to help you determine if the corresponding object interface pointer caused the leak. Memory leaks are reported by the debug software layer by outputting a list of object interface pointers along with their friendly names.

Arguments

• string name - Friendly debug name to be set.

string GetDebugName ( ) #

Returns the currently used friendly name for GPU debugging (RenderDoc, NVIDIA Nsight). It can be used to help you determine if the corresponding object interface pointer caused the leak. Memory leaks are reported by the debug software layer by outputting a list of object interface pointers along with their friendly names.

Return value

Friendly debug name.

void UpdateDebugName ( ) #

Updates the friendly name for GPU debugging (RenderDoc, NVIDIA Nsight).

void CreateNodes ( ) #

Forced creation of the Mesh Static internal tree for quick calculation of collisions and intersections.