Syntax

Result = dbInstanceObject(SourceID, ObjectID)

Description

If #PB_Any is used as the ObjectID parameter, the new ID will be returned as 'Result'. Otherwise the value of 'Result' is the same value passed as the ObjectID parameter.

This command will create an instance copy of the object. Unlike dbCloneObject, this instance will share most of the original objects data and be dependent on the original object remaining in existence to hold such data. Instanced objects do have the ability to hide/show both their limbs and hide/show the object, independent of the original object. This command is ideally suited to copying large numbers of primarily static objects such as trees and rocks where the original model data is to remaing largely unchanged.

See Also

dbAppendObject, dbCloneObject, dbDeleteObject, dbDeleteObjects, dbObjectExist, dbSaveObject