インタフェース: LoadSaveAnimation

インタフェース > コア インタフェース > LoadSaveAnimation

 

   

コア インタフェース - クイック ナビゲーション

LoadSaveAnimation コア インタフェースでは、アニメーション クリップのロード機能と保存機能を利用できます。

3ds Max 8 以降 で使用可能です。

    

Interface: LoadSaveAnimation

メソッド: 

<filename>LoadSaveAnimation.loadAnimationDlg()

[アニメーションをロード](Load Animation)ダイアログ ボックスを開きます。

選択されているファイルのファイル名を返します。ダイアログ ボックスがキャンセルされた場合は undefined を返します。

    

<filename>LoadSaveAnimation.saveAnimationDlg()

[アニメーションを保存](Save Animation)ダイアログ ボックスを開きます。

選択されているファイルのファイル名を返します。ダイアログ ボックスがキャンセルされた場合は undefined を返します。

    

<boolean>LoadSaveAnimation.saveAnimation <filename>fileName <&node array>nodes <&string array>userAttributes <&string array>userValues animatedTracks:<boolean> includeConstraints:<boolean> keyableTracks:<boolean> saveSegment:<boolean> segInterval:<interval by value> segKeyPerFrame:<boolean> 

nodes is In and Out parameter 
userAttributes is In and Out parameter 
userValues is In and Out parameter 
animatedTracks default value: true 
includeConstraints default value: true 
keyableTracks default value: false 
saveSegment default value: false 
segInterval default value: (interval 0f 0f) 
segKeyPerFrame default value: false

参照文字列配列から指定されたユーザ アトリビュートおよびユーザ値を追加し、nodes 参照配列によって指定されるノードのアニメーションを、指定されたファイル名に保存します。

オプションのキーワード パラメータは、[アニメーションを保存](Save Animation)ダイアログ ボックスのオプションに対応します。

    

<boolean>LoadSaveAnimation.saveAnimationNodeAnim <filename>fileName <&Interface array>nodeAnims <&string array>userAttributes <&string array> userValues animatedTracks: <boolean> includeConstraints:<boolean> keyableTracks:<boolean> saveSegment:<boolean> segInterval:<inteval by value> segKeyPerFrame:<boolean> 

nodeAnims is In and Out parameter 
userAttributes is In and Out parameter 
userValues is In and Out parameter 
animatedTracks default value: true 
includeConstraints default value: true 
keyableTracks default value: false 
saveSegment default value: false 
segInterval default value: (interval 0f 0f) 
segKeyPerFrame default value: false

参照文字列配列から指定されたユーザ アトリビュートおよびユーザ値を追加し、インタフェースの参照配列によって指定される node anims のアニメーションを、指定されたファイル名に保存します。

オプションのキーワード パラメータは、[アニメーションを保存](Save Animation)ダイアログ ボックスのオプションに対応します。

    

<boolean>LoadSaveAnimation.loadAnimation <filename>fileName <&node array>nodes relative:<boolean> insert:<boolean> insertTime:<time> stripLayers:<boolean> useMapFile:<boolean> mapFileName:<filename> 

nodes is In and Out parameter 
relative default value: true 
insert default value: false 
insertTime default value: 0f 
useMapFile default value: false 
mapFileName default value: undefined

nodeTab 参照配列によって指定されるノードに、指定されたファイル名からアニメーションをロードします。

オプションのキーワード パラメータは、[アニメーションをロード](Load Animation)ダイアログ ボックスのオプションに対応します。

    

<boolean>LoadSaveAnimation.loadAnimationNodeAnim <filename>fileName <&Interface array>nodeAnims relative:<boolean> insert:<boolean> insertTime:<time> useMapFile:<boolean> mapFileName:<filename> 

nodeAnims is In and Out parameter 
relative default value: true 
insert default value: false 
insertTime default value: 0f 
stripLayers default value: false 
useMapFile default value: false 
mapFileName default value: undefined

参照配列によって指定される nodeAnims に、指定されたファイル名からアニメーションをロードします。

オプションのキーワード パラメータは、[アニメーションをロード](Load Animation)ダイアログ ボックスのオプションに対応します。

    

<boolean>LoadSaveAnimation.createMapFile <filename>fileName <&node array>nodes <filename>incomingAnimationFile <&string array>userAttributes <&string array>userValues <&Interface array>retargetData nodeMapType:<enum> matchControllerExactName:<boolean> matchControllerType:<boolean> stripLayers:<boolean> 

nodes is In and Out parameter 
userAttributes is In and Out parameter 
userValues is In and Out parameter 
retargetData is In and Out parameter 
nodeMapType enums: {#matchExactNodeName|#matchClosestNodeName|#matchNodeHierarchy} 
nodeMapType default value: #matchClosestNodeName 
matchControllerExactName default value: true 
matchControllerType default value: false 
stripLayers default value: false

nodes 参照配列によって指定されるノードを使用し、指定されたファイル名でマップ ファイルを作成します。

    

<boolean>LoadSaveAnimation.createMapFileNodeAnim <filename>fileName <&Interface array>nodeAnims <filename>incomingAnimationFile <&string array>userAttributes <&string array>userValues <&Interface array>retargetData nodeMapType:<enum> matchControllerExactName:<boolean> matchControllerType:<boolean> 

nodeAnims is In and Out parameter 
userAttributes is In and Out parameter 
userValues is In and Out parameter 
retargetData is In and Out parameter 
nodeMapType enums: {#matchExactNodeName|#matchClosestNodeName|#matchNodeHierarchy} 
nodeMapType default value: #matchClosestNodeName 
matchControllerExactName default value: true 
matchControllerType default value: false

インタフェースの参照配列によって指定される nodeAnims を使用し、指定されたファイル名でマップ ファイルを作成します。

    

<Interface>LoadSaveAnimation.makeRetargetData()

LoadSaveAnimation.createMapFile() メソッドで使用できる retargetData [Mixin インタフェース](Mixin Interface)を返します。詳細については、このページの最下部を参照してください。

    

<boolean>LoadSaveAnimation.getUserAttributes <filename>fileName <&TSTR array>userAttributes <&TSTR array>userValues 

userAttributes is In and Out parameter 
userValues is In and Out parameter

指定された XAF ファイルからユーザ アトリビュートとユーザ値を読み取り、userAttributes と userValues の参照文字列配列に書き込みます。成功した場合は true、失敗した場合は false を返します。

    

<string>LoadSaveAnimation.getAnimFileExtension()

アニメーション形式のファイル拡張子を文字列として返します。戻り値の既定値は「xaf」です。

    

<string>LoadSaveAnimation.getAnimMapFileExtension()

マップ形式のファイル拡張子を文字列として返します。戻り値の既定値は「xmm」です。

    

<filename>LoadSaveAnimation.getAnimFileDirectory()

アニメーション ファイルのパスをファイル名として返します。

    

<void>LoadSaveAnimation.setAnimFileDirectory <filename>fileName

指定されたファイル名にアニメーション ファイルのパスを設定します。

    

<filename>LoadSaveAnimation.getAnimMapFile()

アニメーション マップ ファイルをファイル名として返します。戻り値の既定値は「Default」です。

    

<void>LoadSaveAnimation.setAnimMapFile <filename>fileName

指定されたファイル名にアニメーション マップ ファイルを設定します。

    

<Interface by value array>LoadSaveAnimation.setUpAnimsForSave <&node array>nodesToSetup animatedTracks:<boolean> includeContraints:<boolean> keyable:<boolean> 

nodesToSetup is In and Out parameter 
animatedTracks default value: true 
includeContraints default value: true 
keyable default value: false

指定されたノードをアニメーション保存用に準備します。

    

<Interface by value array>LoadSaveAnimation.setUpAnimsForLoad <&node array>nodesToSetup includePB2s:<boolean> stripLayers:<boolean> 

nodesToSetup is In and Out parameter 
includePB2s default value: false 
stripLayers default value: false

指定されたノードをアニメーション ロード用に準備します。

    

<Interface by value array>LoadSaveAnimation.setUpAnimsForMap <&node array>nodesToSetup stripLayers:<boolean> 

nodesToSetup is In and Out parameter 
stripLayers default value: false

指定されたノードをマッピング用に準備します。

    

<boolean>LoadSaveAnimation.replaceAttributesInMapFile <filename>mapFileName <filename>newMapFileName <&TSTR array>oldStrings <&TSTR array>newStrings <boolean>mapName 

oldStrings is In and Out parameter 
newStrings is In and Out parameter

oldStrings で指定された mapFileName のアトリビュートを newStrings で指定されたアトリビュートに置き換え、newMapFileName に基づいた名前のファイルを作成します。

3ds Max 2008 以降 で使用可能です。

    

<boolean>LoadSaveAnimation.createDefaultMapFile <&node array>nodes <filename>mapFileName 

nodes is In and Out parameter

1 番目の引数で指定されたノードから、2 番目の引数で指定された名前を使用して既定値のマップを作成します。

3ds Max 2008 以降 で使用可能です。

    

<void>LoadSaveAnimation.createNodeAnimsForLoad <&maxObject array>anims <&maxObject array>clients <&maxObject array>subNums <&Interface array>nodeAnims 

anims is In and Out parameter 
clients is In and Out parameter 
subNums is In and Out parameter 
nodeAnims is In and Out parameter

ロード用の nodeAnims を作成します。3ds Max 2008 以降 で使用可能です。

    

<void>LoadSaveAnimation.createNodeAnimsForSave <&maxObject array>anims <&maxObject array>clients <&maxObject array>subNums <&Interface array>nodeAnims 

anims is In and Out parameter 
clients is In and Out parameter 
subNums is In and Out parameter 
nodeAnims is In and Out parameter

保存用の nodeAnims を作成します。3ds Max 2008 以降 で使用可能です。

    

<void>LoadSaveAnimation.createNodeAnimsForMap <&maxObject array>anims <&maxObject array>clients <&maxObject array>subNums <&Interface array>nodeAnims 

anims is In and Out parameter 
clients is In and Out parameter 
subNums is In and Out parameter 
nodeAnims is In and Out parameter

マッピング用の NodeAnims を作成します。3ds Max 2008 以降 で使用可能です。

    

<filename>LoadSaveAnimation.loadAnimationDlgFromAnims <&maxObject array>anims <&maxObject array>clients <&integer array>subNums 

anims is In and Out parameter 
clients is In and Out parameter 
subNums is In and Out parameter

指定された anims を使用して[アニメーションをロード](Load Animation)ダイアログ ボックスを開きます。3ds Max 2008 以降 で使用可能です。

    

<filename>LoadSaveAnimation.saveAnimationDlgFromAnims <&maxObject array>anims <&maxObject array>clients <&integer array>subNums 

anims is In and Out parameter 
clients is In and Out parameter 
subNums is In and Out parameter

指定された anims を使用して[アニメーションを保存](Save Animation)ダイアログ ボックスを開きます。3ds Max 2008 以降 で使用可能です。

次の[Mixin インタフェース](Mixin Interface)を使用すると、 LoadSaveAnimation.createMapFile() メソッドによって要求される再ターゲット データ配列の要素を作成できます。

<MixinInterface:retargetData> 

Interface: retargetData

プロパティ: 

<MixinInterface:retargetData>.currentNodeName : string : Read|Write

現在のノードの名前を取得/設定します。

    

<MixinInterface:retargetData>.incomingNodeName : string : Read|Write

受信ノードの名前を取得/設定します。

    

<MixinInterface:retargetData>.absolute : boolean : Read|Write

絶対か相対の再ターゲットを有効/無効にします。

    

<MixinInterface:retargetData>.scale : point3 : Read|Write

再ターゲット スケールを取得/設定します。

    

<MixinInterface:retargetData>.currentBaseNodeName : string : Read|Write

現在のベース ノードの名前を取得/設定します。

    

<MixinInterface:retargetData>.incomingBaseNodeName : string : Read|Write

受信ベース ノードの名前を取得/設定します。

    

<MixinInterface:retargetData>.currentBaseChainNodeName : string : Read|Write

現在のベース チェーン ノードの名前を取得/設定します。

    

<MixinInterface:retargetData>.currentEndChainNodeName : string : Read|Write

現在のエンド チェーン ノードの名前を取得/設定します。

    

<MixinInterface:retargetData>.incomingBaseChainNodeName : string : Read|Write

受信ベース チェーン ノードの名前を取得/設定します。

    

<MixinInterface:retargetData>.incomingEndChainNodeName : string : Read|Write

受信エンド チェーン ノードの名前を取得/設定します。

    

<MixinInterface:retargetData>.FKRetargetingEnabled : boolean : Read|Write

FK 再ターゲットを有効/無効にします。true に設定した場合、FK 再ターゲットが有効になります。

    

<MixinInterface:retargetData>.FKBaseChainNodeName : string : Read|Write

FK ベース チェーン ノードの名前を取得/設定します。

   

このトピックについてのコメントをお送りください

Creative Commons License 特に明記されている場合以外は、この作業は、Creative Commons 表示 - 非営利 - 継承 3.0 非移植ライセンス のもと認可を受けています。 Autodesk Creative Commons FAQ (英語版) を参照してください。