CopyInstanceTree

This function copies the instance tree towards a new model.
In case model is empty a new model will be created (the handle to this new model can be retrieved through
the call GetModel() based on the return value of this call).
The model can be amy opem model, it can be zero (a new model will be created on-the-fly) and it can be
the same model as the model owlInstance is defined within, in this case just a perfect copy of the
original instance tree.

The return value is the handle to the copied owlInstance in the model of choice.

Syntax

//   Visual Studio for Windows
public:
__int64 __declspec(dllexport) __stdcall CopyInstanceTree(
            __int64             owlInstance,
            __int64             model
        );

//   Linux, OS-X and non-Visual Studio Windows solutions
public:
int64_t CopyInstanceTree(
            int64_t             owlInstance,
            int64_t             model
        );    

Property owlInstance

Size: 64 bit / 8 byte (value)
The handle to the specific instance in the design tree. The instance handle is static within one open model but is most probably different when the same instance is opened in another model. The instance is always exactly of one unique class.

Property model

Size: 64 bit / 8 byte (value)
The handle to the model. The model handle is static during its existance. Several models can be opened simultaniously within one session. Different models are always independent, threads are allowed to be running on different models simultaniously.