ImportDelta

Introduced

6.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

    ImportDelta( FileName, Model, [Reference], [Interactive] )

Parameters

Parameter | Type | Description
FileName [in/out] | 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

Return Value

The imported Delta

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 );

See Also

Delta | ExportDelta | ImportReferencedDelta | CommitToReference
ConvertToRefModel | ImportModel | ExportModel | ApplyDelta
RemoveUnusedDeltas |  |  |

Autodesk Softimage v7.5