IFXAnimationModifier |
The IFXAnimationModifier interface gets and sets bone information used for bones-based character animation. It includes three interfaces: IFXModifier, IFXSkeleton, and IFXAnimationModifier.
Modifier Methods
|
Interface Methods |
Description |
|
Attaches a new modifier to the end of the linked list |
|
|
Retrieves a pointer to the next modifier in the list |
|
|
Inserts a new modifier into the list |
|
|
Retrieves a pointer to this modifier's IFXModelData |
|
|
Assigns an IFXModelData pointer to this modifier |
|
|
Executes the rendering actions of this modifier; in effect, have the modifier do its modifications to the object which is associated with this list of modifiers. |
|
|
Gets the scenegraph |
Skeleton Methods (See IFXSkeleton for details)
|
Set BoneInfo data |
|
|
Get BoneInfo data |
|
|
Set the total number of vertices with weights and the total of weights for all the vertices |
|
|
Get the total number of vertices with weights and the total of weights for all the vertices |
|
|
Set the weights for a particular vertex on a specified mesh |
|
|
Get the number of weights for a particular vertex on a specified mesh |
|
|
Get the weights for a particular vertex on a specified mesh |
Animation Modifier Methods
|
Cleans up weights and sets up bone links |
|
|
Returns the number of bones in the skeleton |
|
|
Returns ID for a named bone |
|
|
Finds a named premix in the modifier cache |
|
|
Calculates the reaching limit |
|
|
Indicates initialize or destruct |
|
|
Gets the number of parameters that notified |
|
|
Gets world time from IFXScheduler and updates IFXBonesManager |
|
|
Gets the IFXBonesManager |
|
|
Selects a mixer for the model |
|
|
Blends to a mixer for the model |
|
|
Cached world time |
|
|
Returns TRUE when operating as single-track |
|
|
Resets state so at Save data is written in initial reference positions |
|
|
Gets IFXNotificationManager and adds a reference |
This method causes the modifier to attach the specified modifier onto the end of the linked list of modifiers.
Parameters:
|
pInModifier |
A pointer to the IFXModifier interface of the modifier to be added to the end of the list |
This method returns a pointer to the interface of the next modifier in the linked list.
Parameters:
None
Return Values:
IFXModifier* - The pointer to the interface of the next modifier. This value can be NULL, if the modifier is at the end of the list.
This method inserts the specified modifier into the list after the modifier that is called. In other words, the modifier makes the specified modifier its NextModifier. The list is not otherwise disrupted. The input modifier, however, is treated as a single element and subsequently has its NextModifier assigned as well. If the input modifier was part of a pre-existing list, that list becomes broken, unless steps are taken to patch the extraction.
Parameters:
|
pInNextModifier |
A pointer to the IFXModifier interface of the modifier to be inserted into the list |
Return Values:
None
This method returns a pointer to the interface of the model data associated with the modifier.
Parameters:
None
Return Values:
IFXModelData* - A pointer to the interface of the model data associated with the modifier.
This method assigns a model data interface to the modifier.
Parameters:
|
pInModelData |
A pointer to the interface of the model data that will be assigned to the modifier |
Return Values:
None
Comments:
A NULL interface pointer can be specified.
This method uses the provided interfaces, along with the modifier's IFXModelData interface, to apply its modifications. Typically, the modifier will query for the IFXShader interface for each mesh in its ModelData's meshgroup and apply the shader to the mesh.
Parameters:
|
pInRenderLayer |
A pointer to the interface of the rendering layer that the modifier will use |
|
pInModel |
A pointer to a model interface |
|
pInModifierParam |
A pointer to the interface of a parameter group that this modifier will use |
|
uInNumberOfLights |
Specifies how many lights this modifier will use |
|
ppInLightList |
An array of pointers to IFXLight interfaces |
|
pInView |
A pointer to the interface of the view that the modifier will use |
This method gets the scenegraph.
Parameters:
|
**ppSceneGraph |
A pointer to a scenegraph |
This method cleans up weights and sets up bone links. It must be called after SetModel() and before Render().
Parameters:
|
pVertexMapGroup |
Pointer to the IFXVertexMapGroup |
|
RegenerateWeights |
Indicates whether weights were regenerated |
|
RemoveRogueWeights |
Indicates whether rogue weights were removed |
|
SmoothWeights |
Indicates whether smoothing was applied |
|
CreateBoneLinks |
Indicates whether bone links were created |
|
DefaultBoneLinks |
Gives the number of bone links |
|
SmoothThreshold |
Gives the smoothing threshold amount |
|
WeldMax |
Gives the WeldMax amount |
|
ModelSize |
Gives the model size |
This method returns the number of bones in the skeleton.
Parameters:
None
Return Values:
Integer
This method returns the ID for a specific bone.
Parameters:
|
bonename |
Name of a specific bone |
|
pBoneID |
Pointer to the specific bone's ID number |
This method finds a named premix in the modifier cache. If one is not found, and there is a motion with the same name, a new mixer mapped to that motion is created and returned.
Parameters:
|
name |
Name of the skeleton mixer |
|
*pSkeletonMixer |
A pointer to a SkeletonMixer |
This method notifies the Skeleton Modifier Parameter of init or destruct.
Parameters:
|
init |
Init state |
|
*pSkelParm |
Pointer to an IFXSkeletonModifierParam |
Return Values:
None
This method calculates the reaching limit.
Parameters:
None
Return Values:
Integer
This method returns the number of parameters notified.
Parameters:
None
Return Values:
Integer
This method returns the world time from Scheduler and updates the BonesManager.
Parameters:
None
Return Values:
F32
This method accesses and references the IFXBonesManager.
Parameters:
None
Return Values:
IFXBonesManagerInterface*
This method returns True when operating as single-track, also known as "KeyFrame mode." When on, the intention is just to drive the motion of a single non-deformable object instead of the superset of animating a skeleton with deformable skin.
Parameters:
None
Return Values:
BOOL
This method selects a mixer for this model
Parameters:
|
pMotionMixer |
Pointer to the mixer for the model |
This method blends to a mixer for this model.
Parameters:
|
pMotionMixer |
Pointer to the mixer for the model |
|
pBlendParam |
Pointer to the blend parameter |
For internal use: cached world time.
Parameters:
None
Return Values:
Interger
This method resets the state so that Save or Clone commands will write data in initial reference positions.
Parameters:
|
*pMesh |
Pointer to an IFXMeshGroup |
Return Values:
None
This method accesses and references the IFXNotificationManager.
Parameters:
None
Return Values:
IFXNotificationManager*
§See asterisked (*) statement at Legal Information © 2001 Intel Corporation.