コンポーネントレベルのメタデータを追加する

Maya Metadata API を使用して、頂点、フェース、エッジなどの Maya メッシュオブジェクトのコンポーネントにアタッチできる、または、Maya ノードに直接アタッチできる任意の数のメタデータ構造を作成できます。小規模な MEL コマンドセットを使用して、Maya 内からメタデータにアクセスできます。

Metadata クラスを使用すると、コンポーネントレベルのメタデータのデータ構造を作成し、そのデータ構造を 1 つのデータストリームに統合できます。これにより、メタデータを Maya DG のメッシュ操作でフローさせながら、メッシュへのアタッチを維持できます。メタデータは任意に指定された関連付けであらゆるノードにアタッチできるため、メタデータをポイントクラウドのポイント、シミュレーションのパーティクル、または NURBS サーフェス上の頂点にアタッチするなどの目的で、API を拡張することができます。メタデータは、MEL コマンドや API を介して後で調査や修正を行うことが可能であり、セッション全体を通して Maya ファイルに保存されます。adsk::Data::Association クラスリファレンスの例は、頂点の速度と加速データをシミュレーションメッシュに格納する方法を示しています。Maya API マニュアルを参照してください。

Metadata API クラス

Metadata API には、adsk::Data::Association 、adsk::Data::Channel、adsk::Data::Stream、adsk::Data::Structure、adsk::Data::Handle などの一般的によく使用されるクラスが含まれています。

adsk::Data::Association クラスは、コンポーネント単位のデータのデータ構造を作成するために使用します。たとえば、データをメッシュオブジェクトのサーフェス上のあらゆる頂点にアタッチするように定義できます。
adsk::Data::Channel クラスは、データストリームを 1 つのデータブロックに統合するために使用します。
adsk::Data::Stream クラスは、データのインデックスリストを管理し、リストの中央から削除したり、エントリを複製するなどの一般的な操作のために最適化されます。
adsk::Data::Structure クラスは、メタデータのデータ構造を定義および管理します。
adsk::Data::Handle クラスは、adsk::Data::Stream 内のメタデータ値にアクセスするためのインタフェースを提供します。

Metadata MEL コマンド

Maya で次の MEL コマンドを使用することにより、Metadata API から作成されたデータ構造にアクセスし、それらを操作することができます。

アタッチされていないメタデータ構造を作成する場合は、dataStructure を使用します。
Maya のコンポーネントに構造のメンバーを適用する場合は、addMetadata を使用します。
選択したコンポーネントにメタデータストリームのメンバーの値を割り当てる場合は、editMetadata を使用します。
メタデータの値を照会する場合は、getMetadata を使用します。