Scripting: ImportDelta

ImportDelta

Introduced

v6.0

Description

Imports a model delta object from a specific file. The file must be in a delta format previously exported using the ExportDelta command or it can be an external storage file from an existing model delta.

A Delta is basically a 'diff' or list of modifications made to the components of a reference model. You can specify which modifications should be tracked in each delta (eg., track only expressions and constraints vs. tracking all animation, etc.). Each model can only have one delta associated to it and each delta contains the name of the model to which it is associated. When importing a delta while there is already a model delta for the model, the user is prompted to chose whether to use the new delta instead of the old one, or just to load the model delta with no target.

Scripting Syntax

oReturn = ImportDelta( FileName, Model, [Reference], [Interactive] );

Return Value

The imported Delta

Parameters

Parameter	Type	Description
FileName	String	The filename where to import the model delta.
Model	String	Indicate for which model the delta will be imported. Note that deltas are always nested under the referenced model head, which is the topmost referenced model.
Reference	Boolean	True to set the model delta object storage to external and use the input filename. Otherwise, the storage of the model delta will be set to internal. Tip: You can also use the ImportReferencedDelta command. directly. Default Value: False
Interactive	Boolean	True to enable (display) any dialog when importing a delta onto a model. Default Value: True

Examples

JScript Example

/*
        This example demonstrates how to import a model delta.
*/
NewScene(null, false);
CreatePrim("Sphere", "MeshSurface", null, null);
CreateModel(null, null, null, null);
var sPath = Application.InstallationPath(siFactoryPath) + "\\Data\\XSI_SAMPLES\\Models\\Test.emdl";
ConvertToRefModel ("Model", sPath);
SelectObj("Model.sphere", null, true);
Translate(null, -8.21651117203418, 4.54207454997213, -0.454207454997213, siRelative, siView, siObj, siXYZ, 
        null, null, null, null, null, null, null, null, null, 0);
var sPath2 = Application.InstallationPath(siFactoryPath) + "\\Deltas\\Test.delta";
ExportDelta("Model.Delta", sPath2);
var oDelta = ImportDelta(sPath2, "Model");
Logmessage( oDelta );