This reference page is linked to from the following overview topics: List of Python FBX classes.
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().
Definition at line 221 of file kfbxcontrolset.h.
#include <kfbxcontrolset.h>
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 |
enum EType |
Control rig type.
Definition at line 236 of file kfbxcontrolset.h.
KFBXNEW_DECLARE_FRIEND void Reset | ( | ) |
void SetType | ( | EType | pType | ) |
EType GetType | ( | ) | const |
void SetUseAxis | ( | bool | pUseAxis | ) |
Set use axis flag as given.
pUseAxis | The given use axis flag. |
bool GetUseAxis | ( | ) | const |
void SetLockTransform | ( | bool | pLockTransform | ) |
Set lock transform flag as given.
pLockTransform | The given lock transform flag. |
bool GetLockTransform | ( | ) | const |
void SetLock3DPick | ( | bool | pLock3DPick | ) |
Set lock 3D pick flag as given.
pLock3DPick | The given lock 3D pick flag. |
bool GetLock3DPick | ( | ) | const |
bool SetControlSetLink | ( | ECharacterNodeId | pCharacterNodeId, |
const KFbxControlSetLink & | pControlSetLink | ||
) |
Set a control set link for a character node ID.
pCharacterNodeId | Character node ID. |
pControlSetLink | Control set link to be associated with the Character node ID. |
true
if successful, false
otherwise.bool GetControlSetLink | ( | ECharacterNodeId | pCharacterNodeId, |
KFbxControlSetLink * | pControlSetLink =
NULL |
||
) | const |
Get the control set link associated with a character node ID.
pCharacterNodeId | Requested character node ID. |
pControlSetLink | Optional pointer that returns the control set link if the function succeeds. |
true
if successful, false
otherwise.bool SetEffector | ( | EEffectorNodeId | pEffectorNodeId, |
KFbxEffector | pEffector | ||
) |
Set an effector node for an effector node ID.
pEffectorNodeId | Effector node ID. |
pEffector | Effector to be associated with the effector node ID. |
true
if successful, false
otherwise.bool GetEffector | ( | EEffectorNodeId | pEffectorNodeId, |
KFbxEffector * | pEffector =
NULL |
||
) |
Get the effector associated with an effector node ID.
pEffectorNodeId | ID of requested effector node. |
pEffector | Optional pointer that returns the effector if the function succeeds. |
true
if successful, false
otherwise.bool SetEffectorAux | ( | EEffectorNodeId | pEffectorNodeId, |
KFbxNode * | pNode, | ||
EEffectorSetId | pEffectorSetId =
eEffectorSetAux1 |
||
) |
Set an auxiliary effector node for an effector node ID.
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. |
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.
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. |
true
if successful, false
otherwise.static char* GetEffectorNodeName | ( | EEffectorNodeId | pEffectorNodeId | ) | [static] |
Get the name associated with an effector node ID.
pEffectorNodeId | Effector node ID. |
static EEffectorNodeId GetEffectorNodeId | ( | char * | pEffectorNodeName | ) | [static] |
Get ID associated with an effector node name.
pEffectorNodeName | Effector node name. |
void FromPlug | ( | KFbxControlSetPlug * | pPlug | ) |
void ToPlug | ( | KFbxControlSetPlug * | pPlug | ) |
friend class KFbxCharacter
[friend] |
Definition at line 374 of file kfbxcontrolset.h.
friend class KFbxNode [friend] |
Definition at line 375 of file kfbxcontrolset.h.