Public Member Functions | Protected Member Functions | Friends

KFbxGlobalSettings Class Reference

This reference page is linked to from the following overview topics: Supported Scene Elements, FBX Scenes, Lights, List of Python FBX classes.


Search for all occurrences

Detailed Description

This class contains functions for accessing global settings.

Examples:

ExportScene03/main.cxx, ImportScene/DisplayGlobalSettings.cxx, ViewScene/main.cxx, and ViewScene/SetCamera.cxx.

Definition at line 34 of file kfbxglobalsettings.h.

#include <kfbxglobalsettings.h>

Inheritance diagram for KFbxGlobalSettings:
Inheritance graph
[legend]

List of all members.

Public Member Functions

void  SetOriginalUpAxis (const KFbxAxisSystem &pAxisSystem)
  Sets the coordinate system's original Up Axis when the scene is created.
int  GetOriginalUpAxis () const
  Returns the coordinate system's original Up Axis.
virtual KFbxObject Copy (const KFbxObject &pObject)
  Copy an object content into this object.

Protected Member Functions

virtual void  Construct (const KFbxGlobalSettings *pFrom)
virtual bool  ConstructProperties (bool pForceSet)

Friends

class  KFbxScene

Axis system

void  SetAxisSystem (const KFbxAxisSystem &pAxisSystem)
  Sets the scene's coordinate system.
KFbxAxisSystem  GetAxisSystem ()
  Returns the scene's current coordinate system.

System Units

void  SetSystemUnit (const KFbxSystemUnit &pOther)
  Sets the unit of measurement used by the system.
KFbxSystemUnit  GetSystemUnit () const
  Returns the unit of measurement used by the system.
void  SetOriginalSystemUnit (const KFbxSystemUnit &pOther)
  Sets the original unit of measurement used by the system.
KFbxSystemUnit  GetOriginalSystemUnit () const
  Returns the original unit of measurement used by the system.

Light Settings

void  SetAmbientColor (KFbxColor pAmbientColor)
  Sets the ambient color.
KFbxColor  GetAmbientColor () const
  Returns the ambient color.

Camera Settings

static const char *  ePRODUCER_PERSPECTIVE
  Defined camera name: PRODUCER_PERSPECTIVE.
static const char *  ePRODUCER_TOP
  Defined camera name: PRODUCER_TOP.
static const char *  ePRODUCER_FRONT
  Defined camera name: PRODUCER_FRONT.
static const char *  ePRODUCER_BACK
  Defined camera name: PRODUCER_BACK.
static const char *  ePRODUCER_RIGHT
  Defined camera name: PRODUCER_RIGHT.
static const char *  ePRODUCER_LEFT
  Defined camera name: PRODUCER_LEFT.
static const char *  ePRODUCER_BOTTOM
  Defined camera name: PRODUCER_BOTTOM.
bool  SetDefaultCamera (const char *pCameraName)
  Sets the default camera.
KString  GetDefaultCamera () const
  Returns the default camera name.

Time Settings

void  SetTimeMode (KTime::ETimeMode pTimeMode)
  Sets the time mode.
KTime::ETimeMode  GetTimeMode () const
  Returns the time mode.
void  SetTimelineDefaultTimeSpan (const KTimeSpan &pTimeSpan)
  Sets the default time span of the time line.
void  GetTimelineDefaultTimeSpan (KTimeSpan &pTimeSpan) const
  Returns the default time span of the time line.
void  SetCustomFrameRate (double pCustomFrameRate)
  Set custom frame rate.
double  GetCustomFrameRate () const
  Return frame rate if the time mode is KTime::eCUSTOM.

Properties

KFbxTypedProperty< fbxInteger1 UpAxis
KFbxTypedProperty< fbxInteger1 UpAxisSign
KFbxTypedProperty< fbxInteger1 FrontAxis
KFbxTypedProperty< fbxInteger1 FrontAxisSign
KFbxTypedProperty< fbxInteger1 CoordAxis
KFbxTypedProperty< fbxInteger1 CoordAxisSign
KFbxTypedProperty< fbxInteger1 OriginalUpAxis
KFbxTypedProperty< fbxInteger1 OriginalUpAxisSign
KFbxTypedProperty< fbxDouble1 UnitScaleFactor
KFbxTypedProperty< fbxDouble1 OriginalUnitScaleFactor
KFbxTypedProperty< fbxDouble3 AmbientColor
KFbxTypedProperty< fbxString DefaultCamera
KFbxTypedProperty< fbxEnum TimeMode
KFbxTypedProperty< fbxTime TimeSpanStart
KFbxTypedProperty< fbxTime TimeSpanStop
KFbxTypedProperty< fbxDouble1 CustomFrameRate

Member Function Documentation

void SetAxisSystem ( const KFbxAxisSystem pAxisSystem )

Sets the scene's coordinate system.

Parameters:
pAxisSystem The coordinate system to set.
KFbxAxisSystem GetAxisSystem ( )

Returns the scene's current coordinate system.

Returns:
The scene's current coordinate system.
Examples:
ViewScene/main.cxx.
void SetOriginalUpAxis ( const KFbxAxisSystem pAxisSystem )

Sets the coordinate system's original Up Axis when the scene is created.

Parameters:
pAxisSystem The coordinate system whose Up Axis is copied.
int GetOriginalUpAxis ( ) const

Returns the coordinate system's original Up Axis.

Returns:
The coordinate system's original Up Axis when the scene is created. 0 is X, 1 is Y, 2 is Z axis.
void SetSystemUnit ( const KFbxSystemUnit pOther )

Sets the unit of measurement used by the system.

Parameters:
pOther The system unit to set.
KFbxSystemUnit GetSystemUnit ( ) const

Returns the unit of measurement used by the system.

Returns:
The unit of measurement used by the system.
Examples:
ViewScene/main.cxx.
void SetOriginalSystemUnit ( const KFbxSystemUnit pOther )

Sets the original unit of measurement used by the system.

Parameters:
pOther The original system unit to set.
KFbxSystemUnit GetOriginalSystemUnit ( ) const

Returns the original unit of measurement used by the system.

Returns:
The original unit of measurement used by the system.
void SetAmbientColor ( KFbxColor  pAmbientColor )

Sets the ambient color.

Parameters:
pAmbientColor The ambient color to set.
Remarks:
The ambient color only uses the RGB channels.
Examples:
ExportScene04/main.cxx.
KFbxColor GetAmbientColor ( ) const

Returns the ambient color.

Returns:
The ambient color.
Examples:
ImportScene/DisplayGlobalSettings.cxx.
bool SetDefaultCamera ( const char *  pCameraName )

Sets the default camera.

Parameters:
pCameraName Name of the default camera.
Returns:
true if camera name is valid, returns false if the camera does not have a valid name.
Remarks:
A valid camera name can be either one of the defined tokens (PRODUCER_PERSPECTIVE, PRODUCER_TOP, PRODUCER_FRONT, PRODUCER_BACK, PRODUCER_RIGHT, PRODUCER_LEFT and PRODUCER_BOTTOM) or the name of a camera inserted in the node tree under the scene's root node.
Examples:
ExportScene04/main.cxx, UIExamples/CubeCreator/SDK_Utility.cxx, and ViewScene/main.cxx.
KString GetDefaultCamera ( ) const

Returns the default camera name.

Returns:
The default camera name, or an empty string if no camera name has been set.
Examples:
ImportScene/DisplayGlobalSettings.cxx, and ViewScene/SetCamera.cxx.
void SetTimeMode ( KTime::ETimeMode  pTimeMode )

Sets the time mode.

Parameters:
pTimeMode One of the defined modes in class KTime.
KTime::ETimeMode GetTimeMode ( ) const

Returns the time mode.

Returns:
The currently set TimeMode.
Examples:
ExportScene03/main.cxx, ImportScene/DisplayGlobalSettings.cxx, and ViewScene/main.cxx.
void SetTimelineDefaultTimeSpan ( const KTimeSpan pTimeSpan )

Sets the default time span of the time line.

Parameters:
pTimeSpan The default time span of the time line.
void GetTimelineDefaultTimeSpan ( KTimeSpan pTimeSpan ) const

Returns the default time span of the time line.

Parameters:
pTimeSpan The default time span of the time line.
Examples:
ImportScene/DisplayGlobalSettings.cxx, and ViewScene/main.cxx.
void SetCustomFrameRate ( double  pCustomFrameRate )

Set custom frame rate.

This is meaningless if the time mode is not KTime::eCUSTOM.

double GetCustomFrameRate ( ) const

Return frame rate if the time mode is KTime::eCUSTOM.

If the time mode is not KTime::eCUSTOM, return -1.

virtual KFbxObject& Copy ( const KFbxObject pObject ) [virtual]

Copy an object content into this object.

Parameters:
pObject The source object to copy data from.
Returns:
Returns the destination object being modified by the source.
Remarks:
This function replace the assignment operator (operator=). It will copy all property values and the name. Connections are NOT copied.

Reimplemented from KFbxObject.

virtual void Construct ( const KFbxGlobalSettings pFrom ) [protected, virtual]
virtual bool ConstructProperties ( bool  pForceSet ) [protected, virtual]

Friends And Related Function Documentation

friend class KFbxScene [friend]

Reimplemented from KFbxObject.

Definition at line 241 of file kfbxglobalsettings.h.


Member Data Documentation

const char* ePRODUCER_PERSPECTIVE [static]

Defined camera name: PRODUCER_PERSPECTIVE.

Definition at line 117 of file kfbxglobalsettings.h.

const char* ePRODUCER_TOP [static]

Defined camera name: PRODUCER_TOP.

Definition at line 120 of file kfbxglobalsettings.h.

const char* ePRODUCER_FRONT [static]

Defined camera name: PRODUCER_FRONT.

Definition at line 123 of file kfbxglobalsettings.h.

const char* ePRODUCER_BACK [static]

Defined camera name: PRODUCER_BACK.

Definition at line 126 of file kfbxglobalsettings.h.

const char* ePRODUCER_RIGHT [static]

Defined camera name: PRODUCER_RIGHT.

Definition at line 129 of file kfbxglobalsettings.h.

const char* ePRODUCER_LEFT [static]

Defined camera name: PRODUCER_LEFT.

Definition at line 132 of file kfbxglobalsettings.h.

const char* ePRODUCER_BOTTOM [static]

Defined camera name: PRODUCER_BOTTOM.

Definition at line 135 of file kfbxglobalsettings.h.


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

KFbxGlobalSettings KFbxGlobalSettings KFbxGlobalSettings KFbxGlobalSettings KFbxGlobalSettings KFbxGlobalSettings KFbxGlobalSettings KFbxGlobalSettings KFbxGlobalSettings KFbxGlobalSettings
KFbxGlobalSettings KFbxGlobalSettings KFbxGlobalSettings KFbxGlobalSettings KFbxGlobalSettings KFbxGlobalSettings KFbxGlobalSettings KFbxGlobalSettings KFbxGlobalSettings KFbxGlobalSettings