内容表

• 关于
• Creation
• 特性
• Multi-Instances
• 延伸阅读

关于

InstanceObject represents an instance object in Cinema 4D . Such an instance object references another scene object. Additionally, it can store multiple matrices for multi-instances.

InstanceObject objects are an instance of Oinstance .

Creation

InstanceObject objects are created with the usual tools ( Entity Creation and Destruction Manual (Classic) ):

• InstanceObject::Alloc() : Creates a new InstanceObject .
• InstanceObject::Free() : Deletes the given InstanceObject .

特性

The parameters of an InstanceObject are edited as usual using C4DAtom::GetParameter() and C4DAtom::SetParameter() . The parameter IDs are defined in Oinstance.h .

The referenced object can be accessed with the INSTANCEOBJECT_LINK parameter or with these functions:

• InstanceObject::GetReferenceObject() : Returns the referenced BaseObject .
• InstanceObject::SetReferenceObject() : Sets the referenced BaseObject .

Multi-Instances

An InstanceObject can store multiple instance positions. So it can represent not only one but many instances. To turn on the multi-instance mode set the parameter INSTANCEOBJECT_RENDERINSTANCE_MODE to INSTANCEOBJECT_RENDERINSTANCE_MODE_MULTIINSTANCE .

• InstanceObject::IsMultiInstance() : Returns true if the object is in multi-instance mode.

// This example creates an intance object that uses the given reference object and matrix object.

// create instance object InstanceObject * const instance = InstanceObject::Alloc (); if (instance == nullptr ) return maxon::OutOfMemoryError( MAXON_SOURCE_LOCATION );

// insert object into the scene doc-> InsertObject (instance, nullptr , nullptr );

// use the given reference object instance-> SetReferenceObject (reference) iferr_return ;

// use position data provided by the given matrix object

if (!instance-> SetParameter ( INSTANCEOBJECT_MULTIPOSITIONINPUT , matrix, DESCFLAGS_SET::NONE )) return maxon::UnexpectedError( MAXON_SOURCE_LOCATION ); if (!instance-> SetParameter ( INSTANCEOBJECT_RENDERINSTANCE_MODE , INSTANCEOBJECT_RENDERINSTANCE_MODE_MULTIINSTANCE , DESCFLAGS_SET::NONE )) return maxon::UnexpectedError( MAXON_SOURCE_LOCATION );