Detailed Description

This class contains the description of a 3D scene.

It contains the nodes (including the root node) (FbxNode), materials, textures, videos, gobos, poses, characters, character poses, control set plugs, generic nodes, scene information, global settings, and a global evaluator. The nodes are structured in a tree under the scene's root node.

When an object is created using the FBX SDK, a scene is usually passed as argument to the object creation function to specify that the object belongs to this scene. At this point, a connection is made with the object as source and the scene as destination.

All objects in the scene can be queried by connection index. In addition, generic nodes, materials, and textures can also be queried by name. In this latter case, the first object with the queried name will be returned.

The global evaluator (FbxAnimEvaluator) is used to compute animation values for animated scenes.

Definition at line 61 of file fbxscene.h.

#include <fbxscene.h>

Inheritance diagram for FbxScene:

[legend]

List of all members.

Public Member Functions
void	FillPoseArray (FbxArray< FbxPose * > &pPoseArray)
	Clear then fill a pose array with all existing pose included in the scene.
virtual FbxObject *	Clone (FbxObject::ECloneType pCloneType=eDeepClone, FbxObject *pContainer=NULL) const
	Clone this scene object (and everything else it contains if clone type is eDeepClone)
virtual FbxObject &	Copy (const FbxObject &pObject)
	Copy an object content into this object.
void	ConnectMaterials ()
void	BuildMaterialLayersDirectArray ()
void	ReindexMaterialConnections ()
FbxSet *	AddTakeTimeWarpSet (char *pTakeName)
FbxSet *	GetTakeTimeWarpSet (char *pTakeName)
void	ForceKill ()
void	ConvertNurbsSurfaceToNurbs ()
void	ConvertMeshNormals ()
void	ConvertNurbsCurvesToNulls ()
void	ConnectTextures ()
void	BuildTextureLayersDirectArray ()
void	FixInheritType (FbxNode *pNode)
void	UpdateScaleCompensate (FbxNode *pNode, FbxIOSettings &pIOS)
FbxClassId	ConvertAttributeTypeToClassID (FbxNodeAttribute::EType pAttributeType)
FbxGlobalLightSettings &	GlobalLightSettings ()
FbxGlobalCameraSettings &	GlobalCameraSettings ()
Clear scene
void	Clear ()
	Delete the node tree below the root node and restore default settings.
Node Tree Access
FbxNode *	GetRootNode () const
	Get the root node of the scene.
Texture Material and Video Access
void	FillTextureArray (FbxArray< FbxTexture * > &pTextureArray)
	Clear, then fill, a texture array with all existing textures included in the scene.
void	FillMaterialArray (FbxArray< FbxSurfaceMaterial * > &pMaterialArray)
	Clear, then fill, a material array with all existing materials included in the scene.
Generic Node Access
int	GetGenericNodeCount () const
	Get number of generic nodes in the scene.
FbxGenericNode *	GetGenericNode (int pIndex)
	Get generic node at given index.
FbxGenericNode *	GetGenericNode (char *pName)
	Access a generic node from its name.
bool	AddGenericNode (FbxGenericNode *pGenericNode)
	Add a generic node to this scene.
bool	RemoveGenericNode (FbxGenericNode *pGenericNode)
	Remove the generic node from this scene.
Character Management
int	GetCharacterCount () const
	Get number of characters.
FbxCharacter *	GetCharacter (int pIndex)
	Get character at given index.
int	CreateCharacter (const char *pName)
	Create a new character.
void	DestroyCharacter (int pIndex)
	Destroy character.
ControlSetPlug Management
int	GetControlSetPlugCount () const
	Get number of ControlSetPlugs.
FbxControlSetPlug *	GetControlSetPlug (int pIndex)
	Get ControlSetPlug at given index.
int	CreateControlSetPlug (char *pName)
	Create a new ControlSetPlug.
void	DestroyControlSetPlug (int pIndex)
	Destroy ControlSetPlug.
Character Pose Management
int	GetCharacterPoseCount () const
	Get number of character poses.
FbxCharacterPose *	GetCharacterPose (int pIndex)
	Get character pose at given index.
int	CreateCharacterPose (char *pName)
	Create a new character pose.
void	DestroyCharacterPose (int pIndex)
	Destroy character pose.
Pose Management
int	GetPoseCount () const
	Get number of poses.
FbxPose *	GetPose (int pIndex)
	Get pose at given index.
bool	AddPose (FbxPose *pPose)
	Add a pose to this scene.
bool	RemovePose (FbxPose *pPose)
	Remove the specified pose from the scene.
bool	RemovePose (int pIndex)
	Remove the pose at the given index from the scene.
Scene information
FbxDocumentInfo *	GetSceneInfo ()
	Get the scene information.
void	SetSceneInfo (FbxDocumentInfo *pSceneInfo)
	Set the scene information.
Global Settings
FbxGlobalSettings &	GetGlobalSettings ()
	Access global settings.
const FbxGlobalSettings &	GetGlobalSettings () const
	Const access to global settings.
Global Evaluator
The global evaluator is used to compute animation values for animated scenes.A typical usage would be to compute the global transform matrix of a node `lNode` at a given time `lTime`. FbxAMatrix& lGlobalMatrix = lNode->GetScene()->GetEvaluator()->GetNodeGlobalTransform(lNode, lTime); or the exact equivalent: FbxAMatrix& lGlobalMatrix = lNode->EvaluateGlobalTransform(lTime); The user can create one or more evaluators in the scene. The default evaluator is set using SetEvaluator. When GetEvaluator is called, if the scene has no evaluator, an evaluator is created with default values.
void	SetEvaluator (FbxAnimEvaluator *pEvaluator)
	Set the global evaluator used by this scene evaluation engine.
FbxAnimEvaluator *	GetEvaluator ()
	Get the global evaluator used by this scene evaluation engine.
Material Access
int	GetMaterialCount () const
	Get number of materials.
FbxSurfaceMaterial *	GetMaterial (int pIndex)
	Get the material at the given index.
FbxSurfaceMaterial *	GetMaterial (char *pName)
	Get the material by its name.
bool	AddMaterial (FbxSurfaceMaterial *pMaterial)
	Add the material to this scene.
bool	RemoveMaterial (FbxSurfaceMaterial *pMaterial)
	Remove the material from this scene.
Texture Access
int	GetTextureCount () const
	Get number of textures (type FbxTexture).
FbxTexture *	GetTexture (int pIndex)
	Get the texture at the given index.
FbxTexture *	GetTexture (char *pName)
	Get the texture by its name.
bool	AddTexture (FbxTexture *pTexture)
	Add the texture to this scene.
bool	RemoveTexture (FbxTexture *pTexture)
	Remove the texture from this scene.
Node Access
int	GetNodeCount () const
	Get number of nodes.
FbxNode *	GetNode (int pIndex)
	Get the node at the given index.
bool	AddNode (FbxNode *pNode)
	Add the node to this scene.
bool	RemoveNode (FbxNode *pNode)
	Remove the node from this scene.
int	GetCurveOnSurfaceCount ()
	Helper method for determining the number of nodes that have curves on surface attributes in the scene.
FbxNode *	FindNodeByName (const FbxString &pName)
	Get the first node with this name.
Geometry Access
int	GetGeometryCount () const
	Get number of geometries.
FbxGeometry *	GetGeometry (int pIndex)
	Get the geometry at the given index.
bool	AddGeometry (FbxGeometry *pGeometry)
	Add the geometry to this scene.
bool	RemoveGeometry (FbxGeometry *pGeometry)
	Remove the geometry from this scene.
Video Access
int	GetVideoCount () const
	Get number of videos.
FbxVideo *	GetVideo (int pIndex)
	Get the video at the given index.
bool	AddVideo (FbxVideo *pVideo)
	Add the video to this scene.
bool	RemoveVideo (FbxVideo *pVideo)
	Remove the video from this scene.
Utilities
void	SyncShowPropertyForInstance ()
	Synchronize all the Show properties of node instances.

Member Function Documentation

void Clear ( ) [virtual]

virtual FbxObject* Clone	(	FbxObject::ECloneType	pCloneType = `eDeepClone`,
		FbxObject *	pContainer = `NULL`
	)		const `[virtual]`

pCloneType	The type of clone to be created. By default, the clone type is eDeepClone.
pContainer	An optional parameter to specify which object will "contain" the new object. By contain, we mean the new object will become a source to the container, connection-wise.

void UpdateScaleCompensate	(	FbxNode *	pNode,
		FbxIOSettings &	pIOS
	)

FbxScene Class Reference

Detailed Description

Public Member Functions

Clear scene

Node Tree Access

Texture Material and Video Access

Generic Node Access

Character Management

ControlSetPlug Management

Character Pose Management

Pose Management

Scene information

Global Settings

Global Evaluator

Material Access

Texture Access

Node Access

Geometry Access

Video Access

Utilities

Member Function Documentation