A morph target is a single entry slot attached to a DynamicMesh that allows you to specify what Mesh to blend (with the base Mesh attached to its parent DynamicMesh). Additional options can be specified to tell the system what type of vertex data should be blended.

See Also

DynamicMesh, Mesh

Static Variables

Name	Description
`dynamicmesh`	Underlying DynamicMesh that maintains the MorphTarget structure.
Declaration DynamicMesh *dynamicmesh
`mesh`	Reference to the Mesh Asset that will be used for deformation.
Declaration Mesh *mesh

Variables

Name	Description
`weight`	The interpolation between the MorphTarget and the DynamicMesh Mesh.
Declaration float weight Range 0.0 to 1.0
`name`	A unique name to identify the MorphTarget within its parent DynamicMesh.
Declaration char *name
`options`	Bit mask of MorphOptions that tell the internal system what data should be blended.
Declaration int options

Functions

Name Description

SetMesh Assign a Mesh to the active MorphTarget.

Declaration

int SetMesh( Mesh *mesh )

Parameters

mesh: A valid Mesh reference to connect; to disconnect an existing Mesh use nil.

Return Value

0: Success.
-1: The MorphTarget is not connected to a DynamicMesh.
-2: The DynamicMesh does not have any Mesh connected.
-3: The mesh received in parameter is same as the one used by the parent DynamicMesh.
-4: The topology of the two meshes differs (the one received in parameter and the one linked to the parent DynamicMesh of the MorphTarget).
-5: The size of the two meshes vertex cache is inconsistent.

MorphOptions

Define which vertex properties will be blended when the MorphTarget is used by the DynamicMesh.

fPosition: Mix vertex positions.
fTexCoord0: Blend the first texture channel.
fTexCoord1: Blend the second texture channel.
fTexCoord2: Blend the third texture channel.
fTexCoord3: Blend the fourth texture channel.
fColor0: Interpolate the first color channel.
fColor1: Interpolate the second color channel.
fColor2: Interpolate the third color channel.
fColor3: Interpolate the fourth color channel.

Note: Normals, tangents, and bi-normals will be blended and updated automatically in the event the position and/or texture coordinates are mixed.