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

Detailed Description

A character pose is a character and an associated hierarchy of nodes.

Only the default position of the nodes is considered, the animation data is ignored.

You can access the content of a character pose, using the functions KFbxCharacterPose::GetOffset(), KFbxCharacterPose::GetLocalPosition(), and KFbxCharacterPose::GetGlobalPosition(). Their source code is provided inline as examples on how to access the character pose data.

To create a character pose, You must first create a hierarchy of nodes under the root node provided by function KFbxCharacterPose::GetRootNode(). Then, feed this hierarchy of nodes into the character returned by function KFbxCharacterPose::GetCharacter(). Offsets are set in the character links. Local positions are set using KFbxNode::SetDefaultT(), KFbxNode::SetDefaultR(), and KFbxNode::SetDefaultS().

To set local positions from global positions:

Declare lCharacterPose as a valid pointer to a KFbxCharacterPose;
Call lCharacterPose->GetRootNode()->SetLocalStateId(0, true);
Call lCharacterPose->GetRootNode()->SetGlobalStateId(1, true);
Call KFbxNode::SetGlobalState() for all nodes found in the hierarchy under lCharacterPose->GetRootNode();
Call lCharacterPose->GetRootNode()->ComputeLocalState(1, true);
Call lCharacterPose->GetRootNode()->SetCurrentTakeFromLocalState(KTIME_ZERO, true).

Examples:: ImportScene/DisplayPose.cxx.

Definition at line 79 of file kfbxcharacterpose.h.

#include <kfbxcharacterpose.h>

Inheritance diagram for KFbxCharacterPose:

[legend]

List of all members.

Public Member Functions
void	Reset ()
	Reset to an empty character pose.
KFbxNode *	GetRootNode () const
	Get the root node.
KFbxCharacter *	GetCharacter () const
	Get the character.
bool	GetOffset (ECharacterNodeId pCharacterNodeId, KFbxXMatrix &pOffset) const
	Get offset matrix for a given character node.
bool	GetLocalPosition (ECharacterNodeId pCharacterNodeId, KFbxVector4 &pLocalT, KFbxVector4 &pLocalR, KFbxVector4 &pLocalS) const
	Get local position for a given character node.
bool	GetGlobalPosition (ECharacterNodeId pCharacterNodeId, KFbxXMatrix &pGlobalPosition) const
	Get global position for a given character node.
virtual KFbxObject &	Copy (const KFbxObject &pObject)
	Copy an object content into this object.
Public Attributes
KFbxScene *	mScene
Friends
class	KFbxScene

Member Function Documentation

void Reset ( )

Search for all occurrences

Reset to an empty character pose.

KFbxNode* GetRootNode ( ) const

Search for all occurrences

Get the root node.

Returns:: Pointer to the root node.

KFbxCharacter* GetCharacter ( ) const

Search for all occurrences

Get the character.

Returns:: Pointer to the character.

Examples:: ImportScene/DisplayPose.cxx.

bool GetOffset	(	ECharacterNodeId	pCharacterNodeId,
		KFbxXMatrix &	pOffset
	)		const `[inline]`

Search for all occurrences

Get offset matrix for a given character node.

Parameters:

pCharacterNodeId	Character Node ID.
pOffset	Receives offset matrix.

Returns:: true if successful, false otherwise.

Definition at line 102 of file kfbxcharacterpose.h.

    {
        KFbxCharacterLink lCharacterLink;

        if (!GetCharacter()) return false;

        if (!GetCharacter()->GetCharacterLink(pCharacterNodeId, &lCharacterLink)) return false;

        pOffset.SetTRS(lCharacterLink.mOffsetT, lCharacterLink.mOffsetR, lCharacterLink.mOffsetS);

        return true;
    }

bool GetLocalPosition	(	ECharacterNodeId	pCharacterNodeId,
		KFbxVector4 &	pLocalT,
		KFbxVector4 &	pLocalR,
		KFbxVector4 &	pLocalS
	)		const `[inline]`

Search for all occurrences

Get local position for a given character node.

Parameters:

pCharacterNodeId	Character Node ID.
pLocalT	Receives local translation vector.
pLocalR	Receives local rotation vector.
pLocalS	Receives local scaling vector.

Returns:: true if successful, false otherwise.

Definition at line 122 of file kfbxcharacterpose.h.

    {
        KFbxCharacterLink lCharacterLink;
        if( !GetCharacter() || !GetCharacter()->GetCharacterLink(pCharacterNodeId, &lCharacterLink) ) return false;

        pLocalT = lCharacterLink.mNode->EvaluateLocalTranslation();
        pLocalR = lCharacterLink.mNode->EvaluateLocalRotation();
        pLocalS = lCharacterLink.mNode->EvaluateLocalScaling();
        return true;
    }

bool GetGlobalPosition	(	ECharacterNodeId	pCharacterNodeId,
		KFbxXMatrix &	pGlobalPosition
	)		const `[inline]`

Search for all occurrences

Get global position for a given character node.

Parameters:

pCharacterNodeId	Character Node ID.
pGlobalPosition	Receives global position.

Returns:: true if successful, false otherwise.

Definition at line 138 of file kfbxcharacterpose.h.

    {
        KFbxCharacterLink lCharacterLink;
        if( !GetCharacter() || !GetCharacter()->GetCharacterLink(pCharacterNodeId, &lCharacterLink) ) return false;

        pGlobalPosition = lCharacterLink.mNode->EvaluateGlobalTransform();
        return true;
    }