アトリビュートパターンを使用してアトリビュートを作成する

アトリビュートパターン を使用して、ダイナミックまたは拡張子アトリビュートを作成することができます。アトリビュートパターンとは、特定のノード、あるいはノードタイプに追加することができるダイナミックまたは拡張子アトリビュートについて記述したものです。この機能を使用すると、addAttr または addExtension コマンドを個別に使用して各アトリビュートを作成する必要がなくなます。

この機能は pyJsonAttrPatternFactory.py プラグインによってサポートされます。

アトリビュートパターンファイル

この機能を使用するには、まずパターンファイルを作成します。パターンファイルは、ノードまたはノードタイプに追加されるアトリビュートをリストし、使用するプラグインによって定義されるどのフォーマットにも対応しています。 Maya プラグイン pyJsonAttrPatternFactory.py は、.json フォーマットをサポートします。オプションとして、パターンファイルの構文を記述するスキーマファイルを含めることもできます。

パターンは、applyAttrPattern コマンドを通じてノードまたはノードタイプにコピーされるアトリビュートを単に記述したものです。

パターンタイプにはプラグインによって定義されるものがあり、それらはプラグインがアンロードされない限り削除されません。

1 つのパターンファイルは複数のパターンを含むことができ、パターンはそれぞれ複数のアトリビュートを含むことができます。パターンを適用する場合は、サブセットではなくそのアトリビュートのすべてが適用されます。サンプルスキーマファイルについては attrPatternSchema.json を、<maya installation directory>/devkit/plug-ins/scripted ディレクトリのサンプルパターンファイルについては sampleAttrPatterns.json を参照してください。

アトリビュートパターンコマンド

パターンファイルにリストされたパターンのセットを作成するには createAttrPatterns コマンドを使用します。続いて、applyAttrPattern コマンドを使用し、パターンファイルのいずれかのパターンにリストされたアトリビュートをノードまたはノードタイプにアタッチします。 applyAttrPattern コマンドを使用すると、ダイナミックアトリビュートまたは拡張子アトリビュートのどちらを作成するかを決定することができます。コマンドの後にノード名をリストすると、ダイナミックアトリビュートが作成されます。 -nt フラグを使用してノードタイプをリストすると、拡張子アトリビュートが作成されます。

利用可能なパターンインスタンスおよびパターンタイプをリストするには listAttrPatterns コマンドを使用します。

パターンを使用してノードにアトリビュートを適用した後、アトリビュートはパターンに関連付けされなくなり、deleteAttrPattern コマンドではなく deleteAttr または deleteExtension コマンドによってのみ削除することができます。

アトリビュートパターンを使用してダイナミックまたは拡張子アトリビュートを作成するためのワークフローアウトライン

ノードまたはノードタイプに追加されるアトリビュートをリストするパターンファイルを json フォーマットで作成します。
ヒント: 既定値をとらないフラグの値のみを設定します。明示的に設定されないフラグは、その既定値をとります。
格納場所 <maya directory>/devkit/plug-ins/scripted/ を PYTHONPATH 環境変数に追加します。
ウィンドウ > 設定/プリファレンス > プラグインマネージャ(Window > Settings/Preferences > Plug-in Manager)を選択して、pyJsonAttrPatternFactory.py プラグインをロードします。
注: 代わりに、loadPlugin pyJsonAttrPatternFactory.py; コマンドを使用することもできます。
パターンファイルにパターンのセットを作成するには createAttrPatterns コマンドを使用します。
注: パターンファイルを必要としない単純なアトリビュートの場合、createAttrPatterns コマンドを使用し、-patternDefinition フラグと、パターンの記述を含むハードコードされた文字列を指定してパターンを作成することができます。
パターンの中で概説されたアトリビュートを特定のノード(ダイナミックアトリビュート)またはノードタイプ(拡張子アトリビュート)にアタッチするには applyAttrPattern コマンドを使用します。

注: また、MPxAttributePatternFactory クラスを使用して新しいアトリビュートパターンタイプを定義することもできます。ファクトリは、新しいアトリビュートの記述を含む MAttributePattern を作成します。

例

この機能の簡単なサンプルアプリケーションを以下に示します。

パターンファイルを以下のように作成し、.json ファイルとして保存します。

[
    {
        "name" : "samplePattern",
        "attributes" : [
            {
                "name" : "sampleAttr",
                "defaultValue" : 0.0,
                "attributeType": "float"
            }
        ]
    }
]

プラグインマネージャ(Plug-in Manager)を介して、またはコマンドラインで loadPlugin を使用して pyJsonAttrPatternFactory.py プラグインをロードします。
```
loadPlugin pyJsonAttrPatternFactory.py;
```
samplePattern を以下のように作成します。
```
createAttrPatterns –pt “json” –pf “yourfile.json”;
```
注: これで、listAttrPatterns; コマンドを入力すると、samplePattern がリストされます。

ノードを作成し、そのアトリビュートをリストします。

createNode addMatrix;
// Result: addMatrix1 //
listAttrs;
// Result: [the addMatrix attributes] //

applyAttrPattern コマンドを使用してパターン(すなわち、そのアトリビュート)をパターンファイルからノードにアタッチします。
```
applyAttrPattern –pn “samplePattern” “addMatrix1”;
```
ダイナミックアトリビュート sampleAttr が追加されます。
listAttrs コマンドを使用して、ダイナミックアトリビュートが追加されたことを確認します。
```
listAttrs;
// Result: [the addMatrix attributes] sampleAttr //
```

アトリビュート パターンを使用してアトリビュートを作成する

アトリビュート パターン ファイル

アトリビュート パターン コマンド

例

アトリビュートパターンを使用してアトリビュートを作成する

アトリビュートパターンファイル

アトリビュートパターンコマンド