ImportAction

導入

v1.0

カテゴリ

animmixer

詳細

ファイルからアクションを読み込みします。 読み込まれたアクションは、指定されたモデルのアニメーション ソース リストに追加されます。

このコマンドで使用できるファイル形式は次のとおりです。

- 外部の Softimage ネイティブ バイナリ アクション(".eani")ファイル

- dotXSI アクション(".xsi")ファイル

- Softimage プリセット アクション(".Preset")ファイル

このコマンドは、インターネットからのほとんどのファイル タイプのダウンロード ファイルに対応しています。 ファイル名に URL を指定すると、コマンドが実行される前にそのファイルがローカルにダウンロードされます。 ただし、URL 引数は Soft3D のアニメーション ファイルではサポートされていません。

スクリプト構文

oReturn = ImportAction( Model, [FileName], [Name], [ActionStorage] );

戻り値

アクションをActionSourceとして戻します。

パラメータ

パラメータ タイプ 詳細
Model 文字列またはモデル アクションの読み込み先モデル
FileName 文字列 読み込みするファイルの完全パス

デフォルト値:ユーザがファイルを指定します。

Name 文字列 新しいアクションの名前

デフォルト値: ファイル名

ActionStorage 整数(siAssetStorageType にリストされている値に基づく) 読み込まれたアクションを内部に保存するか、外部に保存するか。

-1 を指定すると、コマンドは自動的にファイルの種類を検出して設定します。

デフォルト値:0(シーンに保存)

JScript の例

/*
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

関連項目

ExportAction LoadActionPreset ImportMixer