ConvertToRefModel

Introduced

v6.0

Description

Saves the current model as a reference model and saves the information in a file on disk. This is a convenience function for using ExportModel to save a reference model.

Tip: If you do not specify any parameters, the currently selected model is used and a file browser appears, prompting the user for the file name and location of the new .emdl file.

Scripting Syntax

ConvertToRefModel( [Model], [FileName], [ShareOptions] );

Parameters

Parameter Type Description
Model String The model to convert.

Default Value: Current selection

FileName String Location of new .emdl to save.

Default Value: User is prompted to specify where to save the file.

ShareOptions siImportShareOptions Bit field values of type Integer that specify the different options for sharing objects when converting a model to a referenced model.

Sharing image clips: Image clips are identical if they refer to the same image source and all their parameters are equal, therefore FCurves on the parameters are ignored for the comparaison.

Note that the image sources are always shared when importing a model.

Referenced models share only image clips that are locked by referenced models, or if the image clip is unused. Standard models share only imageclips that are not locked at all.

Default Value: siImportShareOptionsAll

See Also

CommitToReference CreateRefModel MakeModelLocal ToggleReferencedModel