Create a new instance of a previously defined object referenced by objecthandle. The lists of surfaces and subobjects in the object are not copied, but a new reference with its own transformation matrix is created.
If the object is changed, i.e. if one of its subobjects or surfaces are transformed, one is deleted or added, the change will also be seen in the copy.
The following optional flags may be specified:
Clearing the transformation matrix has the affect of undoing all rotate, move and scale operations on the object. This repositions the object to the world center, which often makes moving the object to another location easier. The transformations on subobjects are not cleared, leaving the structure of composite objects intact.
See the documentation on the interaction of SippObjectAncestor and instance objects if you plan to search for ancestors or pick objects based on image location.