Detailed Description

Represents an element in the scene graph.

A scene graph is a tree of FbxNode objects. The tree management services are self contained in this class.

Note:: The FBX SDK does not test the validity of the constructed scene graph. It is the responsibility of the caller to make sure that it does not generate cyclic graphs in a node hierarchy.

Besides the tree management, this class defines all the properties required to describe the position of the object in the scene. This information include the basic Translation, Rotation and Scaling properties and the more advanced options for pivots, limits, and IK joints attributes such the stiffness and dampening.

When it is first created, the FbxNode object is "empty" (i.e: it is an object without any graphical representation that only contains the position information). In this state, it can be used to represent parents in the node tree structure but not much more. The normal use of this type of objects is to add them an attribute that will specialize the node (see the "Node Attribute Management" section).

The node attribute is an object in itself and is connected to the the FbxNode. This also means that the same node attribute can be shared among multiple nodes. FbxCamera, FbxLight, FbxMesh, etc... are all node attributes and they all derive from the base class FbxNodeAttribute.

Definition at line 72 of file fbxnode.h.

#include <fbxnode.h>

Inheritance diagram for FbxNode:

[legend]

List of all members.

Classes
class	LinkToCharacter
class	Pivot
class	Pivots
Public Types
enum	ECullingType { eCullingOff, eCullingOnCCW, eCullingOnCW }
Public Member Functions
bool	GetAnimationInterval (FbxTimeSpan &pInterval, FbxAnimStack *pAnimStack=NULL, int pAnimLayerId=0)
	Find out start and end time of the animation curves for this node (and its children).
void	AddChildName (char *pChildName)
char *	GetChildName (FbxUInt pIndex) const
FbxUInt	GetChildNameCount () const
FbxTransform &	GetTransform ()
FbxLimits &	GetTranslationLimits ()
FbxLimits &	GetRotationLimits ()
FbxLimits &	GetScalingLimits ()
Pivots &	GetPivots ()
void	UpdatePivotsAndLimitsFromProperties ()
void	UpdatePropertiesFromPivotsAndLimits ()
void	SetRotationActiveProperty (bool pVal)
void	PivotSetToMBTransform (EPivotSet pPivotSet)
int	AddCharacterLink (FbxCharacter *pCharacter, int pCharacterLinkType, int pNodeId, int pNodeSubId)
int	RemoveCharacterLink (FbxCharacter *pCharacter, int pCharacterLinkType, int pNodeId, int pNodeSubId)
FbxNode *	DeepCloneWithNodeAttributes ()
virtual FbxObject &	Copy (const FbxObject &pObject)
	Copy an object content into this object.
virtual const char *	GetTypeName () const
virtual FbxStringList	GetTypeFlags () const
virtual bool	PropertyNotify (EPropertyNotifyType pType, FbxProperty &pProperty)
Node Tree Management
FbxNode *	GetParent ()
	Get the parent node.
FbxNode const *	GetParent () const
bool	AddChild (FbxNode *pNode)
	Add a child node and its underlying node tree.
FbxNode *	RemoveChild (FbxNode *pNode)
	Remove the child node.
int	GetChildCount (bool pRecursive=false) const
	Get the number of children nodes.
FbxNode *	GetChild (int pIndex)
	Get child by index.
FbxNode const *	GetChild (int pIndex) const
	Get child by index.
FbxNode *	FindChild (char const *pName, bool pRecursive=true, bool pInitial=false)
	Finds a child node by name.
Node Target Management
The FbxNode class allows the client to set a "follow" target node. This target forces the node to re-align itself so it points to the target. By default, the node uses its X axis as the aiming constraint. A rotation offset can be added to change this behavior. While the default relative orientation to the target (the X axis) is sufficient for the FBX cameras (with a (0,0,0) rotation vector, they are aiming along the X axis), this rotation offset becomes particularly useful with the lights objects because their default orientation (when they have a 0,0,0 rotation vector) is to point along the -Y axis and they need to be adjusted with a 90-degree offset on the Z axis. The FbxNode class also permits the use of node to define an Up-vector. By default, the node's up vector points towards the Up node. If the Up node is not specified, then the node's Up vector points towards the Y axis. Here too, a rotation offset can be added to change the default behavior. Of course, these offsets can be applied to anything, not only the cameras and lights. Note: Objects in the FBX SDK are always created in the right handed, Y-Up system and need to be adjusted for any other axis system by explicitly convert them (the class FbxAxisSystem can help in that process).
void	SetTarget (FbxNode *pNode)
	The target must be part of the same scene and it cannot be itself.
FbxNode *	GetTarget () const
	Get the target for this node.
void	SetPostTargetRotation (FbxVector4 pVector)
	Set rotation offset from default relative orientation to target.
FbxVector4	GetPostTargetRotation () const
	Get rotation offset from default relative orientation to target.
void	SetTargetUp (FbxNode *pNode)
	The target up node must be part of the same scene and it cannot be itself.
FbxNode *	GetTargetUp () const
	Get the target up node.
void	SetTargetUpVector (FbxVector4 pVector)
	Set up vector offset from default relative target up vector.
FbxVector4	GetTargetUpVector () const
	Get up vector offset from default relative target up vector.
Node Attribute Management
FbxNodeAttribute *	SetNodeAttribute (FbxNodeAttribute *pNodeAttribute)
	Set the node attribute.
FbxNodeAttribute *	GetNodeAttribute ()
	Get the default node attribute.
FbxNodeAttribute const *	GetNodeAttribute () const
	Get the default node attribute.
int	GetNodeAttributeCount () const
	Get the number of node attribute(s) connected to this node.
int	GetDefaultNodeAttributeIndex () const
	Get the index, in the list of connected node attributes, of the node attribute that is set to be the default one.
bool	SetDefaultNodeAttributeIndex (int pIndex, FbxStatus *pStatus=NULL)
	Set index of the default node attribute.
FbxNodeAttribute *	GetNodeAttributeByIndex (int pIndex)
	Get the connected node attribute by specifying its index in the connection list.
FbxNodeAttribute const *	GetNodeAttributeByIndex (int pIndex) const
	Get the connected node attribute by specifying its index in the connection list.
int	GetNodeAttributeIndex (FbxNodeAttribute pNodeAttribute, FbxStatus pStatus=NULL) const
	Get the connection index of the specified node attribute.
bool	AddNodeAttribute (FbxNodeAttribute pNodeAttribute, FbxStatus pStatus=NULL)
	Add the new node attribute to this node.
FbxNodeAttribute *	RemoveNodeAttribute (FbxNodeAttribute *pNodeAttribute)
	Remove the node attribute from the connection list of this node.
FbxNodeAttribute *	RemoveNodeAttributeByIndex (int pIndex)
	Remove the node attribute, specified by the connection index, from the connection list of this node.
FbxCachedEffect *	GetCachedEffect ()
	Get the default node attribute casted to a FbxCachedEffect pointer.
FbxLODGroup *	GetLodGroup ()
	Get the default node attribute casted to a FbxLODGroup pointer.
FbxNull *	GetNull ()
	Get the default node attribute casted to a FbxNull pointer.
FbxMarker *	GetMarker ()
	Get the node attribute casted to a FbxMarker pointer.
FbxSkeleton *	GetSkeleton ()
	Get the node attribute casted to a FbxSkeleton pointer.
FbxGeometry *	GetGeometry ()
	Get the node attribute casted to a FbxGeometry pointer.
FbxMesh *	GetMesh ()
	Get the node attribute casted to a FbxMesh pointer.
FbxNurbs *	GetNurbs ()
	Get the node attribute casted to a FbxNurbs pointer.
FbxNurbsSurface *	GetNurbsSurface ()
	Get the node attribute casted to a FbxNurbsSurface pointer.
FbxNurbsCurve *	GetNurbsCurve ()
	Get the node attribute casted to a FbxNurbsCurve pointer.
FbxLine *	GetLine ()
	Get the node attribute casted to a FbxLine pointer.
FbxTrimNurbsSurface *	GetTrimNurbsSurface ()
	Get the node attribute casted to a FbxTrimNurbsSurface pointer.
FbxSubDiv *	GetSubdiv ()
	Get the node attribute casted to a FbxSubDiv pointer.
FbxPatch *	GetPatch ()
	Get the node attribute casted to a FbxPatch pointer.
FbxCamera *	GetCamera ()
	Get the node attribute casted to a FbxCamera pointer.
const FbxCamera *	GetCamera () const
FbxCameraStereo *	GetCameraStereo ()
	Get the node attribute casted to a FbxCameraStereo pointer.
FbxCameraSwitcher *	GetCameraSwitcher ()
	Get the node attribute casted to a FbxCameraSwitcher pointer.
FbxLight *	GetLight ()
	Get the node attribute casted to a FbxLight pointer.
const FbxLight *	GetLight () const
FbxOpticalReference *	GetOpticalReference ()
	Get the node attribute casted to a FbxOpticalReference pointer.
Transformation propagation
This set of functions provides direct access to the transformation propagations settings of the FbxNode. These settings determine how transformations must be applied when evaluating a node's transformation matrix. The possible values are: eInheritRrSs : Scaling of parent is applied in the child world after the local child rotation. eInheritRSrs : Scaling of parent is applied in the parent world. eInheritRrs : Scaling of parent does not affect the scaling of children.
void	SetTransformationInheritType (FbxTransform::EInheritType pInheritType)
	Sets how child transforms are inherited from parent transforms.
void	GetTransformationInheritType (FbxTransform::EInheritType &pInheritType) const
	Get transformation inherit type.
Node Transform Evaluation
FbxAMatrix &	EvaluateGlobalTransform (FbxTime pTime=FBXSDK_TIME_INFINITE, FbxNode::EPivotSet pPivotSet=FbxNode::eSourcePivot, bool pApplyTarget=false, bool pForceEval=false)
	Returns this node's global transformation matrix at the specified time.
FbxAMatrix &	EvaluateLocalTransform (FbxTime pTime=FBXSDK_TIME_INFINITE, FbxNode::EPivotSet pPivotSet=FbxNode::eSourcePivot, bool pApplyTarget=false, bool pForceEval=false)
	Returns this node's local transformation matrix at the specified time.
FbxVector4 &	EvaluateLocalTranslation (FbxTime pTime=FBXSDK_TIME_INFINITE, FbxNode::EPivotSet pPivotSet=FbxNode::eSourcePivot, bool pApplyTarget=false, bool pForceEval=false)
	Returns this node's LclTranslation property at the specified time.
FbxVector4 &	EvaluateLocalRotation (FbxTime pTime=FBXSDK_TIME_INFINITE, FbxNode::EPivotSet pPivotSet=FbxNode::eSourcePivot, bool pApplyTarget=false, bool pForceEval=false)
	Returns this node's LclRotation property at the specified time.
FbxVector4 &	EvaluateLocalScaling (FbxTime pTime=FBXSDK_TIME_INFINITE, FbxNode::EPivotSet pPivotSet=FbxNode::eSourcePivot, bool pApplyTarget=false, bool pForceEval=false)
	Returns this node's LclScaling property at the specified time.
Character Link
int	GetCharacterLinkCount () const
	Get number of character links.
bool	GetCharacterLink (int pIndex, FbxCharacter *pCharacter, int pCharacterLinkType, int pNodeId, int pNodeSubId)
	Get character link at given index.
int	FindCharacterLink (FbxCharacter *pCharacter, int pCharacterLinkType, int pNodeId, int pNodeSubId) const
	Looks if the given character link exists on this node.
Material Management
int	AddMaterial (FbxSurfaceMaterial *pMaterial)
	Add a material to this node.
bool	RemoveMaterial (FbxSurfaceMaterial *pMaterial)
	Remove a material from this node.
int	GetMaterialCount () const
FbxSurfaceMaterial *	GetMaterial (int pIndex) const
	Access a material on this node.
void	RemoveAllMaterials ()
	Remove all materials applied to this node.
int	GetMaterialIndex (char const *pName) const
	Find an applied material with the given name.
Public Attributes
ECullingType	mCullingType
bool	mCorrectInheritType
Public and fast access Properties
FbxPropertyT< FbxDouble3 >	LclTranslation
	This property contains the translation information of the node.
FbxPropertyT< FbxDouble3 >	LclRotation
	This property contains the rotation information of the node.
FbxPropertyT< FbxDouble3 >	LclScaling
	This property contains the scaling information of the node.
FbxPropertyT< FbxDouble >	Visibility
	This property contains the visibility information of the node.
FbxPropertyT< FbxBool >	VisibilityInheritance
	This property contains the visibility inheritance flag that allow applications to modify the Visibility property interpretation.
FbxPropertyT< EFbxQuatInterpMode >	QuaternionInterpolate
	This property contains the quaternion interpolate flag of the node.
FbxPropertyT< FbxDouble3 >	RotationOffset
	This property contains the rotation offset information of the node.
FbxPropertyT< FbxDouble3 >	RotationPivot
	This property contains the rotation pivot information of the node.
FbxPropertyT< FbxDouble3 >	ScalingOffset
	This property contains the scaling offset information of the node.
FbxPropertyT< FbxDouble3 >	ScalingPivot
	This property contains the scaling pivot information of the node.
FbxPropertyT< FbxBool >	TranslationActive
	This property enables or disables the limit on translation.
FbxPropertyT< FbxDouble3 >	TranslationMin
	This property sets the minimum translation values the object can occupy on each individual axis.
FbxPropertyT< FbxDouble3 >	TranslationMax
	This property sets the maximum translation values the object can occupy on each individual axis.
FbxPropertyT< FbxBool >	TranslationMinX
	This property enables or disables the limit on translation X.
FbxPropertyT< FbxBool >	TranslationMinY
	This property enables or disables the limit on translation Y.
FbxPropertyT< FbxBool >	TranslationMinZ
	This property enables or disables the limit on translation Z.
FbxPropertyT< FbxBool >	TranslationMaxX
	This property enables or disables the limit on translation X.
FbxPropertyT< FbxBool >	TranslationMaxY
	This property enables or disables the limit on translation Y.
FbxPropertyT< FbxBool >	TranslationMaxZ
	This property enables or disables the limit on translation Z.
FbxPropertyT< EFbxRotationOrder >	RotationOrder
	This property contains the rotation order information of the node.
FbxPropertyT< FbxBool >	RotationSpaceForLimitOnly
	This property contains the rotation space for limit only flag of the node.
FbxPropertyT< FbxDouble >	RotationStiffnessX
	This property contains the x value of the rotation stiffness of the node.
FbxPropertyT< FbxDouble >	RotationStiffnessY
	This property contains the y value of the rotation stiffness of the node.
FbxPropertyT< FbxDouble >	RotationStiffnessZ
	This property contains the z value of the rotation stiffness of the node.
FbxPropertyT< FbxDouble >	AxisLen
	This property contains axis length information of the node.
FbxPropertyT< FbxDouble3 >	PreRotation
	This property contains pre-rotation information of the node.
FbxPropertyT< FbxDouble3 >	PostRotation
	This property contains post-rotation information of the node.
FbxPropertyT< FbxBool >	RotationActive
	This property enables or disables the limit on rotation.
FbxPropertyT< FbxDouble3 >	RotationMin
	This property sets the minimum rotation values the object can occupy on each individual axis.
FbxPropertyT< FbxDouble3 >	RotationMax
	This property sets the maximum rotation values the object can occupy on each individual axis.
FbxPropertyT< FbxBool >	RotationMinX
	This property enables or disables the limit on rotation X.
FbxPropertyT< FbxBool >	RotationMinY
	This property enables or disables the limit on rotation Y.
FbxPropertyT< FbxBool >	RotationMinZ
	This property enables or disables the limit on rotation Z.
FbxPropertyT< FbxBool >	RotationMaxX
	This property enables or disables the limit on rotation X.
FbxPropertyT< FbxBool >	RotationMaxY
	This property enables or disables the limit on rotation Y.
FbxPropertyT< FbxBool >	RotationMaxZ
	This property enables or disables the limit on rotation Z.
FbxPropertyT < FbxTransform::EInheritType >	InheritType
	This property contains inherit type information of the node.
FbxPropertyT< FbxBool >	ScalingActive
	This property enables or disables the limit on scaling.
FbxPropertyT< FbxDouble3 >	ScalingMin
	This property sets the minimum scaling values the object can occupy on each individual axis.
FbxPropertyT< FbxDouble3 >	ScalingMax
	This property sets the maximum scaling values the object can occupy on each individual axis.
FbxPropertyT< FbxBool >	ScalingMinX
	This property activates or disables the limit on scaling X.
FbxPropertyT< FbxBool >	ScalingMinY
	This property enables or disables the limit on scaling Y.
FbxPropertyT< FbxBool >	ScalingMinZ
	This property enables or disables the limit on scaling Z.
FbxPropertyT< FbxBool >	ScalingMaxX
	This property enables or disables the limit on scaling X.
FbxPropertyT< FbxBool >	ScalingMaxY
	This property enables or disables the limit on scaling Y.
FbxPropertyT< FbxBool >	ScalingMaxZ
	This property enables or disables the limit on scaling Z.
FbxPropertyT< FbxDouble3 >	GeometricTranslation
	This property contains geometric translation information of the node.
FbxPropertyT< FbxDouble3 >	GeometricRotation
	This property contains geometric rotation information of the node.
FbxPropertyT< FbxDouble3 >	GeometricScaling
	This property contains geometric scaling information of the node.
FbxPropertyT< FbxDouble >	MinDampRangeX
	This property contains the x component of the minimum damp range angles of the node.
FbxPropertyT< FbxDouble >	MinDampRangeY
	This property contains the y component of the minimum damp range angles of the node.
FbxPropertyT< FbxDouble >	MinDampRangeZ
	This property contains the z component of the minimum damp range angles of the node.
FbxPropertyT< FbxDouble >	MaxDampRangeX
	This property contains the x component of the maximum damp range angles of the node.
FbxPropertyT< FbxDouble >	MaxDampRangeY
	This property contains the y component of the maximum damp range angles of the node.
FbxPropertyT< FbxDouble >	MaxDampRangeZ
	This property contains the z component of the maximum damp range angles of the node.
FbxPropertyT< FbxDouble >	MinDampStrengthX
	This property contains the x component of the minimum damp strength of the node.
FbxPropertyT< FbxDouble >	MinDampStrengthY
	This property contains the y component of the minimum damp strength of the node.
FbxPropertyT< FbxDouble >	MinDampStrengthZ
	This property contains the z component of the minimum damp strength of the node.
FbxPropertyT< FbxDouble >	MaxDampStrengthX
	This property contains the x component of the maximum damp strength of the node.
FbxPropertyT< FbxDouble >	MaxDampStrengthY
	This property contains the y component of the maximum damp strength of the node.
FbxPropertyT< FbxDouble >	MaxDampStrengthZ
	This property contains the z component of the maximum damp strength of the node.
FbxPropertyT< FbxDouble >	PreferedAngleX
	This property contains the x component of the preferred angle of the node.
FbxPropertyT< FbxDouble >	PreferedAngleY
	This property contains the y component of the preferred angle of the node.
FbxPropertyT< FbxDouble >	PreferedAngleZ
	This property contains the z component of the preferred angle of the node.
FbxPropertyT< FbxReference >	LookAtProperty
	This property contains lookat property of the node.
FbxPropertyT< FbxReference >	UpVectorProperty
	This property contains the up vector property of the node.
FbxPropertyT< FbxBool >	Show
	This property contains the show information of the node.
FbxPropertyT< FbxBool >	NegativePercentShapeSupport
	This property contains negative percent shape support information of the node.
FbxPropertyT< FbxInt >	DefaultAttributeIndex
	This property contains default attribute index information of the node.
FbxPropertyT< FbxBool >	Freeze
	This property contains manipulation state information of the node.
FbxPropertyT< FbxBool >	LODBox
	This property contains level of detail mode information of the node.
Protected Member Functions
virtual void	Construct (const FbxNode *pFrom)
virtual void	ConstructProperties (bool pForceSet)
	Optional property constructor override, automatically called by default constructor.
virtual void	Destruct (bool pRecursive)
	Optional destructor override, automatically called by default destructor.
void	Reset ()
bool	GetAnimationIntervalRecursive (FbxTimeSpan &pTimeInterval, FbxAnimLayer *pAnimLayer)
Node Display Parameters
enum	EShadingMode { eHardShading, eWireFrame, eFlatShading, eLightShading, eTextureShading, eFullShading }
	Shading modes. More...
void	SetVisibility (bool pIsVisible)
	Set the node Visibility value from the boolean parameter.
bool	GetVisibility () const
	Get the current value of the Visibility property.
void	SetShadingMode (EShadingMode pShadingMode)
	Set the shading mode.
EShadingMode	GetShadingMode () const
	Get the shading mode.
Pivot Management
Pivots are used to specify translation, rotation and scaling centers in coordinates relative to a node's origin.A node has two pivot contexts defined by the EPivotSet enumeration. The node's animation data can be converted from one pivot context to the other. Each context can be set to be either active or passive (reference). By default the two pivot contexts are passive. They need to be active to be processed during the evaluation of the node final transformation matrix. In its passive state, a pivot context can still be accessed to retrieve its content for any other required purpose. Each pivot context stores values (as FbxVector4) for: - Rotation offset (Roff) - Rotation pivot (Rp) - Pre-rotation (Rpre) - Post-rotation (Rpost) - Scaling offset (Soff) - Scaling pivot (Sp) - Geometric translation (Gt) - Geometric rotation (Gr) - Geometric scaling (Gs) These values combine in the matrix form to compute the World transform of the node using the formula: World = ParentWorld * T * Roff * Rp * Rpre * R * Rpost * Rp-1 * Soff * Sp * S * Sp-1 The geometric transformation (Gt * Gr * Gs) is applied only to the node attribute and after the node transformations. This transformation is not inherited across the node hierarchy. Note: Please refer to the FBX SDK programmers guide for more details. The application of the pivots is performed by calling the method ConvertPivotAnimation(). Typically, you set-up the eDestinationPivot context to match what your system can directly support and leave at (0,0,0) the attributes that are not supported by your system. When the values of a specific attribute in the two contexts (source and destination) are identical, the system considers that no adjustment is required because the attribute is directly supported in the destination world.Below is an example of code that shows how the pivot information could be setup before calling ConvertPivotAnimation(). FbxVector4 lZero(0,0,0); FbxVector4 lOne(1,1,1); pNode->SetPivotState(FbxNode::eSourcePivot, FbxNode::ePivotActive); pNode->SetPivotState(FbxNode::eDestinationPivot, FbxNode::ePivotActive); EFbxRotationOrder lRotationOrder; pNode->GetRotationOrder(FbxNode::eSourcePivot , lRotationOrder); pNode->SetRotationOrder(FbxNode::eDestinationPivot , lRotationOrder); //For cameras and lights (without targets) let's compensate the postrotation. if( pNode->GetCamera() \|\| pNode->GetLight() ) { if( !pNode->GetTarget() ) { FbxVector4 lRV(90, 0, 0); if( pNode->GetCamera() ) lRV.Set(0, 90, 0); FbxVector4 prV = pNode->GetPostRotation(FbxNode::eSourcePivot); FbxAMatrix lSourceR; FbxAMatrix lR(lZero, lRV, lOne); FbxVector4 res = prV; // Rotation order don't affect post rotation, so just use the default XYZ order FbxRotationOrder rOrder; rOrder.V2M(lSourceR, res); lR = lSourceR * lR; rOrder.M2V(res, lR); prV = res; pNode->SetPostRotation(FbxNode::eSourcePivot, prV); pNode->SetRotationActive(true); } // Point light do not need to be adjusted (since they radiate in all the directions). if( pNode->GetLight() && pNode->GetLight()->LightType.Get() == FbxLight::ePoint ) { pNode->SetPostRotation(FbxNode::eSourcePivot, FbxVector4(0,0,0,0)); } } // apply Pre rotations only on bones / end of chains if( pNode->GetNodeAttribute() && pNode->GetNodeAttribute()->GetAttributeType() == FbxNodeAttribute::eSkeleton \|\| (pNode->GetMarker() && pNode->GetMarker()->GetType() == FbxMarker::eEffectorFK) \|\| (pNode->GetMarker() && pNode->GetMarker()->GetType() == FbxMarker::eEffectorIK) ) { if( pNode->GetRotationActive() ) { pNode->SetPreRotation(FbxNode::eDestinationPivot, pNode->GetPreRotation(FbxNode::eSourcePivot)); } // No pivots on bones pNode->SetRotationPivot(FbxNode::eDestinationPivot, lZero); pNode->SetScalingPivot(FbxNode::eDestinationPivot, lZero); pNode->SetRotationOffset(FbxNode::eDestinationPivot,lZero); pNode->SetScalingOffset(FbxNode::eDestinationPivot, lZero); } else { // any other type: no pre-rotation support but... pNode->SetPreRotation(FbxNode::eDestinationPivot, lZero); // support for rotation and scaling pivots. pNode->SetRotationPivot(FbxNode::eDestinationPivot, pNode->GetRotationPivot(FbxNode::eSourcePivot)); pNode->SetScalingPivot(FbxNode::eDestinationPivot, pNode->GetScalingPivot(FbxNode::eSourcePivot)); // Rotation and scaling offset are supported pNode->SetRotationOffset(FbxNode::eDestinationPivot, pNode->GetRotationOffset(FbxNode::eSourcePivot)); pNode->SetScalingOffset(FbxNode::eDestinationPivot, pNode->GetScalingOffset(FbxNode::eSourcePivot)); // // If we don't "support" scaling pivots, we can simply do: // pNode->SetRotationPivot(FbxNode::eDestinationPivot, lZero); // pNode->SetScalingPivot(FbxNode::eDestinationPivot, lZero); }
enum	EPivotSet { eSourcePivot, eDestinationPivot }
	Pivot context identifier. More...
enum	EPivotState { ePivotActive, ePivotReference }
	Pivot context state. More...
void	SetPivotState (EPivotSet pPivotSet, EPivotState pPivotState)
	Change the state of the pivot context.
void	GetPivotState (EPivotSet pPivotSet, EPivotState &pPivotState) const
	Get the pivot context state.
void	SetRotationOrder (EPivotSet pPivotSet, EFbxRotationOrder pRotationOrder)
	Set rotation space Determine the rotation space (Euler or Spheric) and the rotation order.
void	GetRotationOrder (EPivotSet pPivotSet, EFbxRotationOrder &pRotationOrder) const
	Get rotation order.
void	SetUseRotationSpaceForLimitOnly (EPivotSet pPivotSet, bool pUseForLimitOnly)
	Set rotation space for limit only.
bool	GetUseRotationSpaceForLimitOnly (EPivotSet pPivotSet) const
	Get rotation space for limit only.
void	SetRotationActive (bool pVal)
	Set the RotationActive state.
bool	GetRotationActive () const
	Get the RotationActive state.
void	SetQuaternionInterpolation (EPivotSet pPivotSet, EFbxQuatInterpMode pQuatIterp)
	Specify which Quaternion interpolation mode is used on the pivot context.
EFbxQuatInterpMode	GetQuaternionInterpolation (EPivotSet pPivotSet) const
	Get the Quaternion interpolation mode of the pivot context.
void	SetRotationStiffness (FbxVector4 pRotationStiffness)
	Set the rotation stiffness.
FbxVector4	GetRotationStiffness () const
	Get the rotation stiffness.
void	SetMinDampRange (FbxVector4 pMinDampRange)
	Set the minimum damp range angles.
FbxVector4	GetMinDampRange () const
	Get the minimum damp range angles.
void	SetMaxDampRange (FbxVector4 pMaxDampRange)
	Set the maximum damp range angles.
FbxVector4	GetMaxDampRange () const
	Get the maximum damp range angles.
void	SetMinDampStrength (FbxVector4 pMinDampStrength)
	Set the minimum damp strength.
FbxVector4	GetMinDampStrength () const
	Get the minimum damp strength.
void	SetMaxDampStrength (FbxVector4 pMaxDampStrength)
	Set the maximum damp strength.
FbxVector4	GetMaxDampStrength () const
	Get the maximum damp strength.
void	SetPreferedAngle (FbxVector4 pPreferedAngle)
	Set the preferred angle.
FbxVector4	GetPreferedAngle () const
	Get the preferred angle.
void	SetRotationOffset (EPivotSet pPivotSet, FbxVector4 pVector)
	Set a translation offset for the rotation pivot.
const FbxVector4 &	GetRotationOffset (EPivotSet pPivotSet) const
	Get the translation offset for the rotation pivot.
void	SetRotationPivot (EPivotSet pPivotSet, FbxVector4 pVector)
	Set rotation pivot.
const FbxVector4 &	GetRotationPivot (EPivotSet pPivotSet) const
	Get rotation pivot.
void	SetPreRotation (EPivotSet pPivotSet, FbxVector4 pVector)
	Set pre-rotation in Euler angles.
const FbxVector4 &	GetPreRotation (EPivotSet pPivotSet) const
	Get pre-rotation in Euler angles.
void	SetPostRotation (EPivotSet pPivotSet, FbxVector4 pVector)
	Set post-rotation in Euler angles.
const FbxVector4 &	GetPostRotation (EPivotSet pPivotSet) const
	Get post-rotation in Euler angles.
void	SetScalingOffset (EPivotSet pPivotSet, FbxVector4 pVector)
	Set a translation offset for the scaling pivot.
const FbxVector4 &	GetScalingOffset (EPivotSet pPivotSet) const
	Get the translation offset for the scaling pivot.
void	SetScalingPivot (EPivotSet pPivotSet, FbxVector4 pVector)
	Set scaling pivot.
const FbxVector4 &	GetScalingPivot (EPivotSet pPivotSet) const
	Get scaling pivot.
void	SetGeometricTranslation (EPivotSet pPivotSet, FbxVector4 pVector)
	Set geometric translation The geometric translation is a local translation that is applied to a node attribute only.
FbxVector4	GetGeometricTranslation (EPivotSet pPivotSet) const
	Get geometric translation.
void	SetGeometricRotation (EPivotSet pPivotSet, FbxVector4 pVector)
	Set geometric rotation The geometric rotation is a local rotation that is applied to a node attribute only.
FbxVector4	GetGeometricRotation (EPivotSet pPivotSet) const
	Get geometric rotation.
void	SetGeometricScaling (EPivotSet pPivotSet, FbxVector4 pVector)
	Set geometric scaling The geometric scaling is a local scaling that is applied to a node attribute only.
FbxVector4	GetGeometricScaling (EPivotSet pPivotSet) const
	Get geometric scaling.
void	ResetPivotSet (FbxNode::EPivotSet pPivotSet)
	Reset a pivot set to the default pivot context.
FBX_DEPRECATED void	ConvertPivotAnimation (EPivotSet pConversionTarget, double pFrameRate, bool pKeyReduce=true)
	Recursively convert the animation data according to pivot settings.
void	ConvertPivotAnimationRecursive (const char *pAnimStackName, EPivotSet pConversionTarget, double pFrameRate, bool pKeyReduce=true)
	This version is an improved version of the ConvertPivotAnimation().
void	ResetPivotSetAndConvertAnimation (double pFrameRate=30.0, bool pKeyReduce=false, bool pToNodeCenter=true, bool pForceResetLimits=false)
	Reset all the pivot sets to the default pivot context and convert the animation.
void	SetRotationPivotAsCenterRecursive (FbxVector4 pParentGeometricOffset=FbxVector4())
	Set rotation pivot as node center recursively.

eHardShading	Solid geometries rendered with smooth surfaces - using the system light. Search for all occurrences
eWireFrame	Geometries displayed in wire frame. Search for all occurrences
eFlatShading	Solid geometries rendered faceted - using the system light. Search for all occurrences
eLightShading	Solid geometries rendered with the scene lights. Search for all occurrences
eTextureShading	Solid geometries rendered with smooth textured surfaces - using system light. Search for all occurrences
eFullShading	Solid geometries rendered with smooth textured surfaces and scene lights. Search for all occurrences

eSourcePivot	The source pivot context. Search for all occurrences
eDestinationPivot	The destination pivot context. Search for all occurrences

ePivotActive	The pivot context with this state is affecting the node's transform computation. Search for all occurrences
ePivotReference	The pivot context with this state is not used during the node transform computation but can be accessed for reference purposes. Search for all occurrences

eCullingOff	Search for all occurrences
eCullingOnCCW	Search for all occurrences
eCullingOnCW	Search for all occurrences

FbxNode* FindChild	(	char const *	pName,
		bool	pRecursive = `true`,
		bool	pInitial = `false`
	)

pName	Name of the searched child node.
pRecursive	Flag to request recursive calls.
pInitial	If set to `true`, the search compares the initial name of the node (see the FbxObject class)

bool SetDefaultNodeAttributeIndex	(	int	pIndex,
		FbxStatus *	pStatus = `NULL`
	)

pIndex	Identifies which of the connected node attributes is becoming the default one. This value represent the connection number of the node.
pStatus	The FbxStatus object to hold error codes.

int GetNodeAttributeIndex	(	FbxNodeAttribute *	pNodeAttribute,
		FbxStatus *	pStatus = `NULL`
	)		const

pNodeAttribute	The pointer to the node attribute.
pStatus	The FbxStatus object to hold error codes.

bool AddNodeAttribute	(	FbxNodeAttribute *	pNodeAttribute,
		FbxStatus *	pStatus = `NULL`
	)

pNodeAttribute	The pointer to a node attribute.
pStatus	The FbxStatus object to hold error codes.

void SetPivotState	(	EPivotSet	pPivotSet,
		EPivotState	pPivotState
	)

pPivotSet	Specify which pivot context is manipulated.
pPivotState	The new state of the pivot context.

void GetPivotState	(	EPivotSet	pPivotSet,
		EPivotState &	pPivotState
	)		const

pPivotSet	Specify which pivot context is queried.
pPivotState	The current state of the pivot set.

void SetRotationOrder	(	EPivotSet	pPivotSet,
		EFbxRotationOrder	pRotationOrder
	)

pPivotSet	Specify which pivot context is manipulated.
pRotationOrder	The new value for the pivot rotation order.

void GetRotationOrder	(	EPivotSet	pPivotSet,
		EFbxRotationOrder &	pRotationOrder
	)		const

void SetUseRotationSpaceForLimitOnly	(	EPivotSet	pPivotSet,
		bool	pUseForLimitOnly
	)

FbxNode Class Reference

Detailed Description

Classes

Public Types

Public Member Functions

Public Attributes

Protected Member Functions

Node Display Parameters

Pivot Management

Member Enumeration Documentation

Member Function Documentation

Member Data Documentation

pPivotSet	Specify which pivot context is manipulated.
pUseForLimitOnly	When set to `true`, the current rotation space (set with SetRotationOrder) define the rotation space for the limit only; leaving the rotation animation in Euler XYZ space. When set to `false`, the current rotation space defines the rotation space for both the limits and the rotation animation data.

void SetQuaternionInterpolation	(	EPivotSet	pPivotSet,
		EFbxQuatInterpMode	pQuatIterp
	)

pPivotSet	Specify which pivot context is manipulated.
pQuatIterp	The new value.

void SetRotationOffset	(	EPivotSet	pPivotSet,
		FbxVector4	pVector
	)

pPivotSet	Specify which pivot set to modify.
pVector	The X,Y and Z translation values (the 4th component of the FbxVector4 is ignored).

void SetRotationPivot	(	EPivotSet	pPivotSet,
		FbxVector4	pVector
	)

void SetPreRotation	(	EPivotSet	pPivotSet,
		FbxVector4	pVector
	)

void SetPostRotation	(	EPivotSet	pPivotSet,
		FbxVector4	pVector
	)

void SetScalingOffset	(	EPivotSet	pPivotSet,
		FbxVector4	pVector
	)

void SetScalingPivot	(	EPivotSet	pPivotSet,
		FbxVector4	pVector
	)