This reference page is linked to from the following overview topics: Scene Axis and Unit Conversion, List of Python FBX classes.

Detailed Description

This class describes the units of measurement used within a particular scene.

Examples:: ViewScene/main.cxx.

Definition at line 57 of file kfbxsystemunit.h.

#include <kfbxsystemunit.h>

List of all members.

Classes
struct	KFbxUnitConversionOptions
	Struct to define various options that you can use to convert the system unit of a scene. More...
Public Member Functions
	KFbxSystemUnit (double pScaleFactor, double pMultiplier=1.0)
	Constructor.
	~KFbxSystemUnit ()
	Destructor.
void	ConvertScene (KFbxScene *pScene, const KFbxUnitConversionOptions &pOptions=DefaultConversionOptions) const
	Converts a scene from its system units to this system unit.
void	ConvertChildren (KFbxNode *pRoot, const KFbxSystemUnit &pSrcUnit, const KFbxUnitConversionOptions &pOptions=DefaultConversionOptions) const
	Converts the child (or children) of the given node from the system unit to this system unit.
void	ConvertScene (KFbxScene pScene, KFbxNode pFbxRoot, const KFbxUnitConversionOptions &pOptions=DefaultConversionOptions) const
	Converts a scene from its system unit to this system unit, using the specified Fbx_Root node.
double	GetScaleFactor () const
	Returns the system unit's scale factor, relative to centimeters.
KString	GetScaleFactorAsString (bool pAbbreviated=true) const
	Returns a unit label for the current scale factor.
KString	GetScaleFactorAsString_Plurial () const
	Returns a unit label for the current scale factor.
double	GetMultiplier () const
	Returns the multiplier factor of the system unit.
bool	operator== (const KFbxSystemUnit &pOther) const
	Equivalence operator.
bool	operator!= (const KFbxSystemUnit &pOther) const
	Non-equivalence operator.
double	GetConversionFactorTo (const KFbxSystemUnit &pTarget) const
	Returns the conversion factor from this system unit to the target system unit, excluding the multiplier factor.
double	GetConversionFactorFrom (const KFbxSystemUnit &pSource) const
	Returns the conversion factor from the source system unit to this system unit, excluding the multiplier factor.
Static Public Attributes
static const KFbxSystemUnit	mm
	Predefined system unit for millimeters.
static const KFbxSystemUnit	dm
	Predefined system unit for decimeters.
static const KFbxSystemUnit	cm
	Predefined system unit for centimeters.
static const KFbxSystemUnit	m
	Predefined system unit for meters.
static const KFbxSystemUnit	km
	Predefined system unit for kilometers.
static const KFbxSystemUnit	Inch
	Predefined system unit for inches.
static const KFbxSystemUnit	Foot
	Predefined system unit for feet.
static const KFbxSystemUnit	Mile
	Predefined system unit for miles.
static const KFbxSystemUnit	Yard
	Predefined system unit for yards.
static const KFbxSystemUnit *	sPredefinedUnits
	Points to a KFbxSystemUnit array to store the predefined system units. The array size is KFbxSystemUnit_sPredefinedUnitCount.
static const KFbxUnitConversionOptions	DefaultConversionOptions
	Stores the default conversion options.
Protected Member Functions
void	ApplyMultiplier (KFbxNode *pRoot, bool pSubChildrenOnly) const
void	ConvertSTProperties (KArrayTemplate< KFbxNode * > &pNodes, double pConversionFactor) const
void	ConvertSProperty (KArrayTemplate< KFbxNode * > &pNodes, double pConversionFactor) const
void	ConvertAnimCurveNode (KArrayTemplate< KFbxAnimCurveNode * > &pFCurves, double pConversionFactor) const
double	GetConversionFactor (double pTargetScaleFactor, double pSourceScaleFactor) const
void	AdjustPivots (KFbxNode *pNode, double pConversionFactor, KFbxXMatrix &pOriginalGlobalM) const
void	AdjustLimits (KFbxNode *pNode, double pConversionFactor) const
void	AdjustPoses (KFbxScene *pScene, double pConversionFactor) const
void	AdjustCluster (KFbxNode *pNode, double pConversionFactor) const
void	AdjustLightIntensity (KFbxNode *pNode, const double pConversionFactor) const
void	AdjustPhotometricLightProperties (KFbxNode *pNode, const double pConversionFactor) const
void	AdjustCameraClipPlanes (KFbxNode *pNode, const double pConversionFactor) const
void	ConvertChildren (KFbxNode *pRoot, const KFbxSystemUnit &pSrcUnit, bool pSubChildrenOnly, const KFbxUnitConversionOptions &pOptions) const
Protected Attributes
double	mScaleFactor
double	mMultiplier
Friends
class	KFbxGlobalSettings

Constructor & Destructor Documentation

KFbxSystemUnit	(	double	pScaleFactor,
		double	pMultiplier = `1.0`
	)		`[explicit]`

Constructor.

Parameters:

pScaleFactor	The equivalent number of centimeters in the new system unit. For example, an inch unit uses a scale factor of 2.54.
pMultiplier	A multiplier factor of pScaleFactor.

~KFbxSystemUnit ( )

Destructor.

Member Function Documentation

void ConvertScene	(	KFbxScene *	pScene,
		const KFbxUnitConversionOptions &	pOptions = `DefaultConversionOptions`
	)		const

Search for all occurrences

Converts a scene from its system units to this system unit.

Parameters:

pScene	The scene to convert.
pOptions	Conversion options, see:KFbxSystemUnit::KFbxUnitConversionOptions.

void ConvertChildren	(	KFbxNode *	pRoot,
		const KFbxSystemUnit &	pSrcUnit,
		const KFbxUnitConversionOptions &	pOptions = `DefaultConversionOptions`
	)		const

Search for all occurrences

Converts the child (or children) of the given node from the system unit to this system unit.

Unlike the ConvertScene() method, this method does not set the axis system of the scene to which the pRoot node belongs. It also does not adjust KFbxPoses as they are not stored under the scene, and not under a particular node.

Parameters:

pRoot	The given node.
pSrcUnit	The source system unit.
pOptions	Conversion options, see:KFbxSystemUnit::KFbxUnitConversionOptions.

void ConvertScene	(	KFbxScene *	pScene,
		KFbxNode *	pFbxRoot,
		const KFbxUnitConversionOptions &	pOptions = `DefaultConversionOptions`
	)		const

Search for all occurrences

Converts a scene from its system unit to this system unit, using the specified Fbx_Root node.

This method is provided for backwards compatibility only and instead you should use ConvertScene( KFbxScene* , const KFbxUnitConversionOptions& ) whenever possible.

Parameters:

pScene	The scene to convert.
pFbxRoot	The Fbx_Root node to use for conversion.
pOptions	Conversion options, see:KFbxSystemUnit::KFbxUnitConversionOptions

double GetScaleFactor ( ) const

Search for all occurrences

Returns the system unit's scale factor, relative to centimeters.

This factor scales system unit values to centimeters. If you want to scale values to centimeters, use this value. Ignore the "multiplier" (returned by GetMultiplier()) value.

Returns:: The the system unit's scale factor, relative to centimeters.

Examples:: ViewScene/main.cxx.

KString GetScaleFactorAsString ( bool pAbbreviated = true ) const

Search for all occurrences

Returns a unit label for the current scale factor.

Parameters:

pAbbreviated If true, returns abbreviated string.

Returns:: The unit label for the current scale factor.

KString GetScaleFactorAsString_Plurial ( ) const

Search for all occurrences

Returns a unit label for the current scale factor.

The first letter of the label is in upper case and the label should be pluralized.

Returns:: The unit label for the current scale factor.

double GetMultiplier ( ) const

Search for all occurrences

Returns the multiplier factor of the system unit.

bool operator== ( const KFbxSystemUnit & pOther ) const

Equivalence operator.

Parameters:

pOther Another system unit compared with this system unit.

Returns:: True if equal, false otherwise.

bool operator!= ( const KFbxSystemUnit & pOther ) const

Non-equivalence operator.

Parameters:

pOther Another system unit compared with this system unit.

Returns:: True if unequal, false otherwise.

double GetConversionFactorTo ( const KFbxSystemUnit & pTarget ) const

Search for all occurrences

Returns the conversion factor from this system unit to the target system unit, excluding the multiplier factor.

Parameters:

pTarget The target system unit.

double GetConversionFactorFrom ( const KFbxSystemUnit & pSource ) const

Search for all occurrences

Returns the conversion factor from the source system unit to this system unit, excluding the multiplier factor.

Parameters:

pSource The source system unit.

void ApplyMultiplier	(	KFbxNode *	pRoot,
		bool	pSubChildrenOnly
	)		const `[protected]`

Search for all occurrences

void ConvertSTProperties	(	KArrayTemplate< KFbxNode * > &	pNodes,
		double	pConversionFactor
	)		const `[protected]`

Search for all occurrences

void ConvertSProperty	(	KArrayTemplate< KFbxNode * > &	pNodes,
		double	pConversionFactor
	)		const `[protected]`

Search for all occurrences

void ConvertAnimCurveNode	(	KArrayTemplate< KFbxAnimCurveNode * > &	pFCurves,
		double	pConversionFactor
	)		const `[protected]`

Search for all occurrences

double GetConversionFactor	(	double	pTargetScaleFactor,
		double	pSourceScaleFactor
	)		const `[protected]`

Search for all occurrences

void AdjustPivots	(	KFbxNode *	pNode,
		double	pConversionFactor,
		KFbxXMatrix &	pOriginalGlobalM
	)		const `[protected]`

Search for all occurrences

void AdjustLimits	(	KFbxNode *	pNode,
		double	pConversionFactor
	)		const `[protected]`

Search for all occurrences

void AdjustPoses	(	KFbxScene *	pScene,
		double	pConversionFactor
	)		const `[protected]`

Search for all occurrences

void AdjustCluster	(	KFbxNode *	pNode,
		double	pConversionFactor
	)		const `[protected]`

Search for all occurrences

void AdjustLightIntensity	(	KFbxNode *	pNode,
		const double	pConversionFactor
	)		const `[protected]`

Search for all occurrences

void AdjustPhotometricLightProperties	(	KFbxNode *	pNode,
		const double	pConversionFactor
	)		const `[protected]`

Search for all occurrences

void AdjustCameraClipPlanes	(	KFbxNode *	pNode,
		const double	pConversionFactor
	)		const `[protected]`

Search for all occurrences

void ConvertChildren	(	KFbxNode *	pRoot,
		const KFbxSystemUnit &	pSrcUnit,
		bool	pSubChildrenOnly,
		const KFbxUnitConversionOptions &	pOptions
	)		const `[protected]`