Public Types | Public Member Functions | Static Public Member Functions | Friends

KFbxControlSet Class Reference

This reference page is linked to from the following overview topics: List of Python FBX classes.


Search for all occurrences

Detailed Description

This class contains all methods to either set-up an exported control rig or query information on an imported control rig.

A Control rig is a character manipulation tool that lets you change the position and orientation of a character to create or alter animation.

This class also contains some methods to manipulate the KFbxEffector and KFbxControlSetLink.

The KFbxControlSet class contains FK rig (Forward Kinematics) and IK rig (Inverse Kinematics) animation. The FK rig is represented by a list of nodes while the IK rig is represented by a list of effectors.

You can access the FK rig with the KFbxControlSetLink class, using the functions KFbxControlSet::SetControlSetLink() and KFbxControlSet::GetControlSetLink().

You can access the IK rig with the KFbxEffector class, using the functions KFbxControlSet::SetEffector() and KFbxControlSet::GetEffector().

See also:
KFbxEffector, KFbxControlSetLink

Definition at line 221 of file kfbxcontrolset.h.

#include <kfbxcontrolset.h>

List of all members.

Public Types

enum   EType { eNone, eFkIk, eIkOnly }
 

Control rig type.

More...

Public Member Functions

KFBXNEW_DECLARE_FRIEND void  Reset ()
  Reset to default values.
void  SetType (EType pType)
  Set type as given.
EType  GetType () const
  Get type.
void  SetUseAxis (bool pUseAxis)
  Set use axis flag as given.
bool  GetUseAxis () const
  Get use axis flag.
void  SetLockTransform (bool pLockTransform)
  Set lock transform flag as given.
bool  GetLockTransform () const
  Get lock transform flag.
void  SetLock3DPick (bool pLock3DPick)
  Set lock 3D pick flag as given.
bool  GetLock3DPick () const
  Get lock 3D pick flag.
bool  SetControlSetLink (ECharacterNodeId pCharacterNodeId, const KFbxControlSetLink &pControlSetLink)
  Set a control set link for a character node ID.
bool  GetControlSetLink (ECharacterNodeId pCharacterNodeId, KFbxControlSetLink *pControlSetLink=NULL) const
  Get the control set link associated with a character node ID.
bool  SetEffector (EEffectorNodeId pEffectorNodeId, KFbxEffector pEffector)
  Set an effector node for an effector node ID.
bool  GetEffector (EEffectorNodeId pEffectorNodeId, KFbxEffector *pEffector=NULL)
  Get the effector associated with an effector node ID.
bool  SetEffectorAux (EEffectorNodeId pEffectorNodeId, KFbxNode *pNode, EEffectorSetId pEffectorSetId=eEffectorSetAux1)
  Set an auxiliary effector node for an effector node ID.
bool  GetEffectorAux (EEffectorNodeId pEffectorNodeId, KFbxNode **pNode=NULL, EEffectorSetId pEffectorSetId=eEffectorSetAux1) const
  Get the auxiliary effector associated with an effector node ID.
void  FromPlug (KFbxControlSetPlug *pPlug)
void  ToPlug (KFbxControlSetPlug *pPlug)

Static Public Member Functions

static char *  GetEffectorNodeName (EEffectorNodeId pEffectorNodeId)
  Get the name associated with an effector node ID.
static EEffectorNodeId  GetEffectorNodeId (char *pEffectorNodeName)
  Get ID associated with an effector node name.

Friends

class  KFbxCharacter
class  KFbxNode

Member Enumeration Documentation

enum EType

Control rig type.

  • eNone No Control rig.
  • eFkIk Both an FK rig and IK rig.
  • eIkOnly Only an IK rig.
Enumerator:
eNone 
eFkIk 
eIkOnly 

Definition at line 236 of file kfbxcontrolset.h.


Member Function Documentation

KFBXNEW_DECLARE_FRIEND void Reset ( )

Reset to default values.

Reset all effector and control set links.

void SetType ( EType  pType )

Set type as given.

Parameters:
pType The given type.
EType GetType ( ) const

Get type.

Returns:
The gotten type.
void SetUseAxis ( bool  pUseAxis )

Set use axis flag as given.

Parameters:
pUseAxis The given use axis flag.
bool GetUseAxis ( ) const

Get use axis flag.

Returns:
The gotten use axis flag.
void SetLockTransform ( bool  pLockTransform )

Set lock transform flag as given.

Parameters:
pLockTransform The given lock transform flag.
bool GetLockTransform ( ) const

Get lock transform flag.

Returns:
The gotten lock transform flag.
void SetLock3DPick ( bool  pLock3DPick )

Set lock 3D pick flag as given.

Parameters:
pLock3DPick The given lock 3D pick flag.
bool GetLock3DPick ( ) const

Get lock 3D pick flag.

Returns:
The gotten lock 3D pick flag.
bool SetControlSetLink ( ECharacterNodeId  pCharacterNodeId,
const KFbxControlSetLink pControlSetLink 
)

Set a control set link for a character node ID.

Parameters:
pCharacterNodeId Character node ID.
pControlSetLink Control set link to be associated with the Character node ID.
Returns:
true if successful, false otherwise.
Remarks:
You should avoid setting a control set link for eCharacterLeftFloor, eCharacterRightFloor, eCharacterLeftHandFloor, eCharacterRightHandFloor, eCharacterProps0, eCharacterProps1, eCharacterProps2, eCharacterProps3 or eCharacterProps4. None of these nodes are part of a control set.
bool GetControlSetLink ( ECharacterNodeId  pCharacterNodeId,
KFbxControlSetLink pControlSetLink = NULL 
) const

Get the control set link associated with a character node ID.

Parameters:
pCharacterNodeId Requested character node ID.
pControlSetLink Optional pointer that returns the control set link if the function succeeds.
Returns:
true if successful, false otherwise.
Remarks:
You should avoid getting a control set link for eCharacterLeftFloor, eCharacterRightFloor, eCharacterLeftHandFloor, eCharacterRightHandFloor, eCharacterProps0, eCharacterProps1, eCharacterProps2, eCharacterProps3 or eCharacterProps4. None of these nodes are part of a control set.
bool SetEffector ( EEffectorNodeId  pEffectorNodeId,
KFbxEffector  pEffector 
)

Set an effector node for an effector node ID.

Parameters:
pEffectorNodeId Effector node ID.
pEffector Effector to be associated with the effector node ID.
Returns:
true if successful, false otherwise.
bool GetEffector ( EEffectorNodeId  pEffectorNodeId,
KFbxEffector pEffector = NULL 
)

Get the effector associated with an effector node ID.

Parameters:
pEffectorNodeId ID of requested effector node.
pEffector Optional pointer that returns the effector if the function succeeds.
Returns:
true if successful, false otherwise.
bool SetEffectorAux ( EEffectorNodeId  pEffectorNodeId,
KFbxNode pNode,
EEffectorSetId  pEffectorSetId = eEffectorSetAux1 
)

Set an auxiliary effector node for an effector node ID.

Parameters:
pEffectorNodeId Effector node ID.
pNode Auxiliary effector node to be associated with the effector node ID.
pEffectorSetId Effector set ID. Set to eEffectorSetAux1 by default.
Returns:
true if successful, false otherwise.
bool GetEffectorAux ( EEffectorNodeId  pEffectorNodeId,
KFbxNode **  pNode = NULL,
EEffectorSetId  pEffectorSetId = eEffectorSetAux1 
) const

Get the auxiliary effector associated with an effector node ID.

Parameters:
pEffectorNodeId ID of requested auxiliary effector node.
pNode Optional pointer that returns the auxiliary effector node if the function succeeds.
pEffectorSetId Effector set ID. Set to eEffectorSetAux1 by default.
Returns:
true if successful, false otherwise.
static char* GetEffectorNodeName ( EEffectorNodeId  pEffectorNodeId ) [static]

Get the name associated with an effector node ID.

Parameters:
pEffectorNodeId Effector node ID.
Returns:
Name associated with the effector node ID.
static EEffectorNodeId GetEffectorNodeId ( char *  pEffectorNodeName ) [static]

Get ID associated with an effector node name.

Parameters:
pEffectorNodeName Effector node name.
Returns:
Effector node ID associated with the given effector node name, or -1 if no effector node with pEffectorNodeName exists.
void FromPlug ( KFbxControlSetPlug pPlug )
void ToPlug ( KFbxControlSetPlug pPlug )

Friends And Related Function Documentation

friend class KFbxCharacter [friend]

Definition at line 374 of file kfbxcontrolset.h.

friend class KFbxNode [friend]

Definition at line 375 of file kfbxcontrolset.h.


The documentation for this class was generated from the following file:

KFbxControlSet KFbxControlSet KFbxControlSet KFbxControlSet KFbxControlSet KFbxControlSet KFbxControlSet KFbxControlSet KFbxControlSet KFbxControlSet
KFbxControlSet KFbxControlSet KFbxControlSet KFbxControlSet KFbxControlSet KFbxControlSet KFbxControlSet KFbxControlSet KFbxControlSet KFbxControlSet