v3.5

Reconnects all operators in a model that have connections outside the model and are not yet connected.

Usually, exporting a model strips away all objects that have connections outside the model. But there are some operators that are exported anyway (for example, enveloping operators). When importing a model the connections to objects outside the model are not established due to a lack of information concerning the targets. But when importing referenced models the connections are established automatically.

As of v6.5, the command takes an extra, optional parameter, ConnectDuplicateObjects, specifying whether or not duplicate objects are allowed. The previous behaviour was to always allow them, but now this command only duplicates objects when this parameter is passed in with a value of True.

ReconnectModel( Model, ExternalCnxMappingTemplate, [DeleteUnconnectedObjects], [AllowDuplicateObjects] );

Parameter	Type	Description
Model	String	Name of the model to reconnect.
ExternalCnxMappingTemplate	String	This parameter contains a list of models separated by a comma, used to resolved the objects that we try to reconnect.
DeleteUnconnectedObjects	Boolean	True to delete operators that were unable to be connected due to missing targets. Default Value: True
AllowDuplicateObjects	Boolean	True to allow duplicate objects to be connected. Default Value: False

VBScript Example

'

' This example demonstrates exporting a model, importing it back without the envelope 

' being connected and then using the ReconnectModel command to reconnect the envelope

'

NewScene , false

' Create a sphere in a model

CreatePrim "Sphere", "MeshSurface"

CreateModel

' Create a chain 

Create2DSkeleton -1.17507494684892E-02, 4.06772293980565, 0, -3.52522484054694E-02, 2.35128493630388E-02, 0, 0, 0, 0, 4

AppendBone "eff", -1.17507494684892E-02, -3.99718439171653, 0

' Envelope the sphere on the chain.

SelectObj "Model.sphere"

ApplyFlexEnv "Model.sphere;root,bone,bone1,eff", False

' Export the model and delete it.

SelectObj "Model"

ExportModel "Model", Application.InstallationPath( siFactoryPath ) & "/Data/XSI_SAMPLES/Models/mymodel.emdl"

SelectObj "Model", "BRANCH"

DeleteObj "B:Model"

' Import the model back, the envelope will not be reconnected

ImportModel Application.InstallationPath( siFactoryPath ) + "/Data/XSI_SAMPLES/Models/mymodel.emdl"

SelectObj "eff", , True

Translate , 1.83679023666235, 4.14069033985075, -0.414069033985075, siRelative, siView, siObj, siXYZ

' Reconnect the envelope in the model on the chain on the scene root.

ReconnectModel "eff", "Scene_Root"

ImportModel