All Frameworks Class Hierarchy This Framework Indexes Previous Next

CATMatInterfaces Interface CATIMatNewMaterialInstance

Usage: an implementation of this interface is supplied and you must use it as is. You should not reimplement it.

interface CATIMatNewMaterialInstance

Interface to manage applied-materials.
Role: Interface designed to provide information about the Material Instance.

See also:: ,

Method Index

o GetMaterial(CATIMaterialReference*&): Returns the material reference object.
o GetPosition(): Returns the position matrix of an applied-material.
o SetPosition(CATMathTransformation&): Sets the position matrix of an applied-material.

Methods

o GetMaterial

public virtual GetMaterial( opiMat)

Returns the material reference object. If the connection points toward a single material reference then this reference is returned. If the connection points toward a material vector the the default material of this vector is returned. If you want to retrieve the whole vector use GetMaterialVector method.

Parameters:

opiMat: [out , CATBaseUnknown#Release] The returned material reference object.
You have to release the pointer after use.

Returns:

An HRESULT
Legal values:

S_OK: The material reference was successfully returned.
E_FAIL: The operation failed. Nothong returned.

o GetPosition

public virtual GetPosition(

)

Returns the position matrix of an applied-material.

Returns:: The position matrix of an applied-material.

o SetPosition

public virtual SetPosition( const iMatrix)

Sets the position matrix of an applied-material.

Parameters:

iMatrix: The position matrix of the applied-material.

Returns:

An HRESULT
Legal values:

S_OK: The position matrix was successfully set.
E_FAIL: The operation failed.

This object is included in the file: CATIMatNewMaterialInstance.h
If needed, your Imakefile.mk should include the module: CATMatInterfaces