I

ImportAction

Introduced

1.0

Description

Imports an action from a file. The imported action is added to the animation source list of the specified model.

The file formats accepted by this command are:

- External Softimage Native Binary Action (".eani") files.

- dotXSI Action (".xsi") files.

- Softimage Preset Action(".Preset") files.

- Soft3D Animation (".ani,.key,.exp") files (when located within the Animation directory of a Soft3D database).

This command supports downloading most file types off the internet. If the filename specified is a URL then the file will be downloaded locally before the command is executed. However URL arguments are not supported for Soft3D animation files.

Scripting Syntax

    ImportAction( Model, [FileName], [Name], [ActionStorage] )

Parameters

Parameter | Type | Description
Model | String or Model | Model into which the action is imported.
FileName | String | Full path to the file to import. Default Value: User is prompted to select a file
Name | String | Name of the new action. Default Value: The file name
ActionStorage | Integer based on the values listed in siAssetStorageType | Whether the imported action will be saved internally or externally. If you specify -1 it will automatically detect what kind of file it is and set it. Default Value: 0 (saved in the scene)

Return Value

Returns the action as an ActionSource.

Examples

JScript Example

    /*
    This example demonstrates how to export and import an action. It also
    shows how to create an action source from a static source and then
    how to access the static source from the imported action.
    */

    NewScene( null, false );
    var root = ActiveSceneRoot;

    // Create a static action
    var obj = root.AddGeometry( "Cone", "MeshSurface" );
    var targets = new Array( obj.rotx.FullName, obj.roty.FullName, obj.rotz.FullName );
    var statics = new Array( 22.5, 90, 45 );
    var actives = new Array( true, true, true );
    var src = root.AddActionSource( "StoredAnimStaticAction", targets, statics, actives );

    // Export the action
    var path = Application.InstallationPath( siProjectPath ) + "\\Actions";
    var filepath = path + "\\TestImportAction.eani";
    ExportAction( src, filepath );

    // Import the action into a new scene but this time in a different model
    NewScene( null, false );
    var mdl = ActiveSceneRoot.AddModel();
    mdl.Name = "TestActionModel";
    var newsrc = ImportAction( mdl, filepath, "ImportedAction4Test", -1 );
    if ( newsrc.SourceItems.Count > 0 ) {
       LogMessage( "Imported action contains these items: " );
       for ( var s=0; s<newsrc.SourceItems.Count; s++ ) {
           var datasrc = newsrc.SourceItems(s).Source;
           LogMessage( "\t" + datasrc );
       }
    } else {
       LogMessage( "Imported action is a(n) " + ClassName(newsrc) );
    }

    // Expected results:
    //INFO : Imported action contains these items:
    //INFO :  StaticSource
    //INFO :  StaticSource
    //INFO :  StaticSource

See Also

ExportAction | LoadActionPreset | ImportMixer

Autodesk Softimage v7.5