ジャンプ先: 概要. 戻り値. フラグ. MEL 例.

概要

attrCompatibility [-addAttr] [-clear] [-dumpTable] [-enable boolean] [-nodeRename string] [-pluginNode string] [-removeAttr] [-renameAttr string] [-type string] [-version string] [string [string]]

attrCompatibility は、取り消し可能、照会不可能、および編集不可能です。

Maya ではこのコマンドを使用して、2 つのバージョン間の差違を記述する仕組みを提供することにより、ファイル フォーマット バージョン間の互換性問題を処理します。プラグイン ライタでこのコマンドを使用して、ファイルへのアトリビュートの互換性変更を処理できます。

最初のオプションのコマンド引数はノード タイプの名前で、2 番目のオプションのコマンド引数はアトリビュートのショート ネームです。

警告: このコマンドは、プラグインとして記述したノードの名前やアトリビュートの変更を記述する場合にのみ使用します。組み込みのディペンデンシー グラフ ノードに関する情報の変更には、このコマンドを使用しないでください。プラグイン ノードでのアトリビュートの除去は、例外的に行われます。attrCompatibility コールを pluginNode フラグとともに個別に使用し、プラグインがロードされなくてもこれらのアトリビュートを追跡できるような名前を付けます。

コマンドの 1 回の呼び出しで使用できるフラグは 1 つのみです。複数のフラグを指定した場合は、任意の 1 つのフラグが実行するアクションとして選択され、それ以外のフラグはユーザ通知なしに無視されます。

戻り値

なし

フラグ

addAttr, clear, dumpTable, enable, nodeRename, pluginNode, removeAttr, renameAttr, type, version
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-addAttr(-a) create
指定したノードに指定したアトリビュートを追加します。
-clear(-clr) create
互換性テーブルをクリアします。これは、デバッグを目的として内部的にのみ使用されます。
-dumpTable(-dmp) create
互換性テーブルの現在のコンテンツをダンプします。これは、デバッグを目的として内部的にのみ使用されます。
-enable(-e) boolean create
互換性テーブルを有効または無効にします。これは、デバッグを目的として内部的にのみ使用されます。
-nodeRename(-nr) string create
すべてのノード タイプ 'nodeName' を、指定した文字列で置き換えます。
-pluginNode(-pn) string create
文字列引数をプラグイン ノード タイプとして登録します。これは、アンロードしたプラグインのノード アトリビュートを参照する後続の attrCompatibility コールに対して必要となります。これは特に、アトリビュートが除去されている場合に有効となります。
-removeAttr(-rm) create
指定したアトリビュートを指定したノードから除去します。
-renameAttr(-r) string create
コマンドの引数で指定されたアトリビュートのショート ネームを、このフラグのパラメータとして指定された新しいショートネームに変更します。ショート ネーム間のマッピングが設定されている場合、Maya はロングネームを自動的に処理します。
-type(-typ) string create
指定したアトリビュートのタイプを、指定したタイプに変更します。
-version(-v) string create
後続コマンドのバージョン ターゲットを、指定した文字列に設定します。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例

// Rename '.x' attributes in old files to '.tx' for all nodes
// of type 'transform'
//
attrCompatibility -r tx transform x;

// Rename the old 'group' node to the new 'transform' node
//
attrCompatibility -nr transform group;

// This will cause all subsequent attrCompatibility calls to translate
// files from older versions to version 1.0.
//
attrCompatibility -v "1.0";