addMetadata

ジャンプ先: 概要. 戻り値. キーワード. 関連. フラグ. MEL 例.

概要

addMetadata [-channelName string] [-channelType string] [-indexType string] [-scene] [-streamName string] [-structure string]

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

1 つまたは複数の選択したオブジェクトに対するメタデータ ストラクチャのアタッチメントを定義します。これにより、後で editMetadata コマンドを使用して設定するプレースホルダと空のメタデータ ストリームが作成されます。これは、ノードにおける addAttr コマンド(データ説明が追加されるが、データは実際に設定されない)と同様の概念です。

メタデータ ストラクチャを割り当てるときは、次のフラグを指定する必要があります。channelName はメタデータのチャネル タイプ(「vertex」など)、streamName は作成するメタデータ ストリームの名前、structure はメタデータの内容を定義するストラクチャ タイプの名前です。indexType フラグはオプションです。このフラグを指定しない場合、インデックスは標準の数値と推測されます。

メタデータの情報は、さまざまなレベルで照会できます。照会可能なすべての引数の一覧については以下の表を参照してください。それぞれの場合において、非照会引数のいずれかを指定すると、照会中に調べるメタデータの一覧がフィルタされます。すべての照会で、照会する単一のオブジェクトを選択する必要があります。

たとえば、他の引数を指定せずに channelName フラグを照会すると、メタデータを含む選択されたオブジェクトのすべてのチャネル タイプの一覧が返されます。indexType フラグを指定して channelName フラグを照会すると、その特定のタイプのインデックスを使用するメタデータ ストリームを含むチャネル タイプのみ返されます。

• メタデータを持つチャネル タイプのリストを返すには、channelName フラグを照会します。
• 指定したストリームに割り当てられているストラクチャ(存在する場合)の名前を返すには、channelName フラグと streamName フラグを指定し、structure フラグを照会します。
• 特定のチャネル タイプに割り当てられているすべてのストリームのリストを返すには、channelName を指定し、streamName を照会します。
• 特定の channelName を指定せずに streamName を照会した場合、すべてのメタデータ ストリームにおける(channelName、streamName)のペアのリストが返されます。

フラグの組み合わせ:

ChannelName ndexType StreamName Structure   Create   Can Query
     0          0          0         0         X        ChannelName, StreamName, Structure
     0          0          0         1         X        ChannelName, StreamName, IndexType
     0          0          1         0         X        ChannelName, Structure, IndexType
     0          0          1         1         X        ChannelName, IndexType
     0          1          0         0         X        ChannelName, StreamName, Structure
     0          1          0         1         X        ChannelName, StreamName
     0          1          1         0         X        ChannelName, Structure
     0          1          1         1         X        ChannelName
     1          0          0         0         X        StreamName, Structure, IndexType
     1          0          0         1         X        StreamName, IndexType
     1          0          1         0         X        Structure, IndexType
     1          0          1         1        (a)       IndexType
     1          1          0         0         X        StreamName, Structure
     1          1          0         1         X        StreamName
     1          1          1         0         X        Structure
     1          1          1         1        (b)       X
    (a) 既定のインデックス タイプの空のメタデータ ストリームを割り当てる
    (b) 指定したインデックス タイプの空のメタデータ ストリームを割り当てる

戻り値

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

キーワード

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-channelName(-cn)	string
ストラクチャが追加されるチャネルのチャネル タイプの名前(「vertex」など)。 照会モードでは、このフラグは値を受け入れることができます。
-channelType(-cht)	string
現在サポートしていません: 代わりに 'channelName' フラグを使用してください。 照会モードでは、このフラグは値を受け入れることができます。
-indexType(-idt)	string
新しいチャネルが使用するインデックス タイプの名前。指定しない場合、既定で単純な数値インデックスに設定されます。ネイティブ タイプの中で、メッシュの「vertexFace」チャネルのみ異なり、「pair」インデックス タイプを使用します。 照会モードでは、このフラグは値を受け入れることができます。
-scene(-scn)
個々のノードにではなくシーン全体にメタデータを追加したい場合は、このフラグを使用します。このフラグを使用してノードを選択すると、ノードは無視され、警告が表示されます。
-streamName(-stn)	string
作成する空のストリームの名前。値を指定しない照会モードでは、名前を指定したチャネル タイプのストリームのリストが返されます。 照会モードでは、このフラグは値を受け入れることができます。
-structure(-str)	string
オブジェクトにアタッチするメタデータを定義するストラクチャの名前。照会モードでは、指定したストリームでアタッチされたストラクチャの名前が返されます。 照会モードでは、このフラグは値を受け入れることができます。

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

MEL 例

polyPlane -n p -ch off;
select -r "pShape";
dataStructure -format "raw" -asString "name=IdStruct:int32=ID";
dataStructure -format "raw" -asString "name=OffStruct:float=Offset";
dataStructure -format "raw" -asString "name=OrgStruct:float[3]=Origin Point";
addMetadata -streamName "IdStream" -channelName "vertex" -structure "IdStruct";
addMetadata -streamName "OffStream" -channelName "vertex" -structure "OffStruct";
addMetadata -streamName "OrgStream" -channelName "edge" -structure "OrgStruct";
addMetadata -streamName "VFStream" -channelName "vertexFace" -indexType "pair" -structure "OrgStruct";
// Query for the list of all channel types possessing metadata
addMetadata -query -channelName;
// Return: edge vertex vertexFace //
// Note that in Mel to query by name you can use an argument of "True" as
// the channelName to indicate that it is the flag being queried. (Otherwise
// the MEL interpreter would think that your object name is the channelName.)
addMetadata -query -channelName "True" "pShape";
// Return: edge vertex vertexFace //
// Query for the structure assigned to a specific stream
addMetadata -channelName "vertex" -streamName "OffStream" -query -structure;
// Return: OffStruct //
// Query for the list of all streams on a specific channel type
addMetadata -channelName "vertex" -query -streamName;
// Return: IdStream OffStream //
// Query for the list of all streams
addMetadata -query -streamName;
// Return: IdStream OffStream OrgStream VFStream //
// You can combine queries to answer more general questions about the
// metadata on an object. For example suppose you wanted to know the
// index type used by all Streams on the "vertex" Channel.
// First extract the list of Streams on the Channel
string $streams[] = `addMetadata -channelName "vertex" -query -streamName`;
int $i;
// Loop through each Stream, querying the IndexType only for that Stream
for( $i=0; $i < size( $streams ); ++$i )
{
	string $indexType = `addMetadata -channelName "vertex" -streamName $streams[$i] -query -indexType`;
	print ( "Index type on " + $streams[$i] + " is " + $indexType + "\n" );
}