This reference page is linked to from the following overview topics: MotionBuilder 2013, Your First Python Program, FBProperty - Object Properties, Scene Elements, FBModel - Transformation Data and the Scene Graph, FBMaterial and FBTexture - Materials and Textures.

Detailed Description

Material class.

Definition at line 777 of file fbmodel.h.

#include <fbmodel.h>

Inheritance diagram for FBMaterial:

[legend]

List of all members.

Public Member Functions
	FBMaterial (const char *pName, HIObject pObject=NULL)
	Constructor.
FBMaterial *	Clone ()
	Clone the material.
HFBTexture	GetTexture (FBMaterialTextureType=kFBMaterialTextureDiffuse)
	Retrieve associated texture.
void	SetTexture (FBTexture *pTexture, FBMaterialTextureType pType=kFBMaterialTextureDiffuse)
	Set associated texture.
void	OGLInit ()
	Setup OpenGL fixed pipeline material settings.
virtual const char *	GetMaterialName () const
	Return Material Name.
virtual const char *	GetMaterialDesc () const
	Return Material Desc Name.
virtual bool	FbxStore (HFBFbxObject pFbxObject, kFbxObjectStore pStoreWhat)
	Store and Retrieve function that can be overloaded.
virtual bool	FbxRetrieve (HFBFbxObject pFbxObject, kFbxObjectStore pStoreWhat)
virtual const char *	FbxGetObjectType () override
	Returns the class type inherited by the class of an object, for example: 'Material'.
virtual const char *	FbxGetObjectSubType () override
	Returns the class sub type inherited by the class of an object, for example: 'Default', 'Custom Material'.
Public Attributes
FBPropertyAnimatableColor	Ambient
	Read Write Property: Ambient color.
FBPropertyAnimatableDouble	AmbientFactor
	Read Write Property: Ambient Factor value.
FBPropertyAnimatableColor	Emissive
	Read Write Property: Emissive color.
FBPropertyAnimatableDouble	EmissiveFactor
	Read Write Property: Emissive Factor value.
FBPropertyAnimatableColor	Diffuse
	Read Write Property: Diffuse color.
FBPropertyAnimatableDouble	DiffuseFactor
	Read Write Property: Diffuse Factor value.
FBPropertyAnimatableColor	TransparentColor
	Read Write Property: Transparent color.
FBPropertyAnimatableDouble	TransparencyFactor
	Read Write Property: Transparency Factor value.
FBPropertyAnimatableColor	Bump
	Read Write Property: Bump.
FBPropertyAnimatableColor	NormalMap
	Read Write Property: Normal Map.
FBPropertyAnimatableDouble	BumpFactor
	Read Write Property: Bump Factor value.
FBPropertyAnimatableColor	Specular
	Read Write Property: Specular color.
FBPropertyAnimatableDouble	SpecularFactor
	Read Write Property: Specular Factor value.
FBPropertyAnimatableDouble	Shininess
	Read Write Property: Shininess value.
FBPropertyAnimatableColor	Reflection
	Read Write Property: Reflection color.
FBPropertyAnimatableDouble	ReflectionFactor
	Read Write Property: Reflection Factor value.
FBPropertyAnimatableColor	DisplacementColor
	Read Write Property: Displacement color.
FBPropertyAnimatableDouble	DisplacementFactor
	Read Write Property: Displacement Factor value.
Protected Member Functions
HFBProperty	CreateTextureConnectableUserProperty (const char pName, FBPropertyType pType, const char pDataType, bool pAnimatable)
	Create user custom texture connect property for custom material derived from FBMaterial only.

Constructor & Destructor Documentation

FBMaterial	(	const char *	pName,
		HIObject	pObject = `NULL`
	)

Constructor.

Parameters:

pName	Name of material.
pObject	For internal use only(default=NULL).

Member Function Documentation

FBMaterial* Clone ( )

Search for all occurrences

Clone the material.

This will duplicated the current material.

Returns:: Newly created material.

HFBTexture GetTexture ( FBMaterialTextureType = kFBMaterialTextureDiffuse )

Search for all occurrences

Retrieve associated texture.

Parameters:

pType MaterialTextureType to get connected texture from (default is Diffuse is not specified).

void SetTexture	(	FBTexture *	pTexture,
		FBMaterialTextureType	pType = `kFBMaterialTextureDiffuse`
	)

Search for all occurrences

Set associated texture.

Parameters:

pTexture	texture to be connected.
pType	MaterialTextureType to set connected texture to.

void OGLInit ( )

Search for all occurrences

Setup OpenGL fixed pipeline material settings.

virtual const char* GetMaterialName ( ) const [virtual]

Search for all occurrences

Return Material Name.

Need to be same with FBMaterialLayout

virtual const char* GetMaterialDesc ( ) const [virtual]

Search for all occurrences

Return Material Desc Name.

Need to be same with FBMaterialLayout

virtual bool FbxStore	(	HFBFbxObject	pFbxObject,
		kFbxObjectStore	pStoreWhat
	)		`[virtual]`

Search for all occurrences

Store and Retrieve function that can be overloaded.

Parameters:

pFbxObject	FBX Object that is used to communicate I/O operations.
pStoreWhat	Which attributes are currently stored/retrieved.

virtual bool FbxRetrieve	(	HFBFbxObject	pFbxObject,
		kFbxObjectStore	pStoreWhat
	)		`[virtual]`

Search for all occurrences

virtual const char* FbxGetObjectType ( ) [override, virtual]

Search for all occurrences

Returns the class type inherited by the class of an object, for example: 'Material'.

Reimplemented from FBBox.

virtual const char* FbxGetObjectSubType ( ) [override, virtual]

Search for all occurrences

Returns the class sub type inherited by the class of an object, for example: 'Default', 'Custom Material'.

Reimplemented from FBBox.

HFBProperty CreateTextureConnectableUserProperty	(	const char *	pName,
		FBPropertyType	pType,
		const char *	pDataType,
		bool	pAnimatable
	)		`[protected]`

Search for all occurrences

Create user custom texture connect property for custom material derived from FBMaterial only.

Parameters:

pName	The name of the property.
pType	Type of the property. See enum FBPropertyType.
pDataType	DataType of the property.
pAnimatable	To specify if the property can be animated..