移動先: 概要 戻り値 キーワード 関連項目 フラグ MEL の例

概要

referenceQuery [-dagPath] [-editAttrs] [-editNodes] [-editStrings] [-failedEdits boolean] [-filename] [-isNodeReferenced] [-nodes] [-parent] [-referenceNode] [-shortName] [-showDagPath boolean] [-showNamespace boolean] [-successfulEdits boolean] [-topReference] [-unresolvedName] [-withoutCopyNumber]

referenceQuery は「元に戻す」が不可能、「照会」が不可能、「編集」が不可能です。

このコマンドを使用して、リファレンスと参照されたノードに関する情報を検索します。 有効なターゲットは、リファレンス ノード、リファレンス ファイル、参照されたノードのいずれかです。 一部のフラグはターゲットを必要としません。フラグの効果の詳細については、フラグの説明を参照してください。 シーンが複数レベルのファイル リファレンスを含む場合、ネストしたリファレンスに影響する編集は、複数のリファレンス ノードに格納される場合があります。 例:A.ma は B.ma を参照し、B.ma はポリゴン球体（pSphere1）を含む C.ma を参照すると仮定します。 B.ma を開いて球体を移動した場合、編集は「C:pSphere1」という名のノードを参照する CRN に格納されます。 A.ma を開いて球体をペアレント化した場合、編集は「B:C:pSphere1」という名のノードを参照する BRN に格納されます。 ネストしたリファレンスに影響する編集を照会する場合、編集は適用時と同じフォーマットで返されるので、注意してください。上記例では、A.ma を開いて C.ma に影響するすべての編集を照会すると、「B:C:pSphere1」に作用する親編集と「C:pSphere1」に影響する setAttr 編集の 2 つの編集を返します。しかし C:pSphere1 という名前のノードはもう存在しないため（存在するのは B:C:pSphere1）、返された情報の解釈には注意が必要です。 参照された DAG ノードをペアレント化またはインスタンス化した場合にも、同様の注意が必要です。上記例で、A.ma を開き、pSphere1 をペアレント化する代わりにインスタンス化したと仮定します。 A.ma を開いた状態で、紛らわしい「B:C:pSphere1」という名前が、「|B:C:pSphere1」と「group1|B:C:pSphere1」に置換されます。しかし C.ma に影響する編集を照会しても、「C:pSphere1」に影響する setAttr 編集は B:C:pSphere1 のインスタンス化の前に適用されているため、この編集を返します。 ヒント: 1. -topReference フラグを使用して、現在開いているファイルから適用された編集のみを照会します。 2. -onReferenceNode フラグを使用して、結果を特定のリファレンス ノードに格納された編集のみに制限します。文字列の各種操作方法を使用して、影響を受けたノードの現在の名前を補外することができます。

戻り値

string[]照会実行用。

キーワード

reference, attribute, node

関連項目

file, referenceEdit

フラグ

dagPath, editAttrs, editNodes, editStrings, failedEdits, filename, isNodeReferenced, nodes, parent, referenceNode, shortName, showDagPath, showNamespace, successfulEdits, topReference, unresolvedName, withoutCopyNumber
ロング ネーム（ショート ネーム） 引数型 プロパティ
-filename(-f) create
文字列を返します。 ターゲット リファレンスにコネクトされたファイル名を照会するための主要フラグです。
-shortName(-shn) create
-f/-filename フラグを修正し、ファイル名をショート ネーム（ディレクトリ パスを含まないファイル名）で返すことを示します。このフラグが存在しない場合、フル ネームとディレクトリ パスを返します。
-unresolvedName(-un) create
-f/-filename フラグを修正し、返されるファイル名は解決されません（ファイルをロードしたときに指定したパスになります。このパスは環境変数を含み、ディスクに存在しない場合があります）。このフラグが存在しない場合、解決済みの名前を返します。
-withoutCopyNumber(-wcn) create
-f/-filename フラグを修正し、返されるファイル名の最後にコピー番号（たとえば {1}）をアペンドしません。このフラグが存在しない場合、返されたファイル名の最後にコピー番号がアペンドされることがあります。
-dagPath(-dp) create
-n/-nodes フラグを修正し、返される DAD オブジェクト名には、名前を固有するために必要な DAG パスが含まれます。このフラグが存在しない場合、DAG パスが含まれない名前が返されます。
-isNodeReferenced(-inr) create
ブーリアンを返します。 ターゲット ノードがリファレンス ファイル由来かどうかを調べるための主要フラグです。 ターゲット ノードがリファレンス ファイル由来の場合は true、そうでない場合は false を返します。
-referenceNode(-rfn) create
文字列を返します。 ターゲット リファレンスにコネクトされたリファレンス ノードを照会するための主要フラグです。
-nodes(-n) create
文字配列を返します。 ターゲット リファレンスのコンテンツを照会するための主要フラグです。
-parent(-p) create
-rfn/-referenceNode と -f/-filename フラグを修正し、ターゲット リファレンスの親を返すことを示します。
-topReference(-tr) create
-rfn/-referenceNode フラグを修正し、ターゲット リファレンスの、最上位の先祖リファレンスを返すことを示します。
-editStrings(-es) create
文字配列を返します。 ターゲットに適用された編集を照会するための主要フラグです。編集は有効な MEL コマンドとして返されます。有効なターゲットは、リファレンス ノード、リファレンス ファイル、参照されたノードのいずれかです。 参照されたノードノードを指定すると、このノードに影響する編集のみを返します。リファレンス ファイルまたはリファレンス ノードを指定すると、そのリファレンスのノードに影響するすべての編集を返します。ターゲットを指定しない場合、すべての編集を返します。このコマンドはロードしたリファレンスとアンロードしたリファレンスの両方に使用できます。デフォルトでは、ターゲットに適用する MEL コマンドとしてフォーマットされたすべての編集を返します。 このフラグは、-en/-editNodes や -ea/-editAttrs フラグとは併用できません。
-editNodes(-en) create
文字配列を返します。 ターゲットに適用された編集を照会するための主要フラグです。リファレンスの編集に関与するノードの名前のみを返します。connectAttr 編集など、複数のノードに影響する編集の場合、ノードは、文字配列に含まれる、個別の連続したエントリとして返されます。有効なターゲットは、リファレンス ノード、リファレンス ファイル、参照されたノードのいずれかです。 参照されたノードノードを指定すると、このノードに影響する編集のみを返します。リファレンス ファイルまたはリファレンス ノードを指定すると、そのリファレンスのノードに影響するすべての編集を返します。ターゲットを指定しない場合、すべての編集を返します。このコマンドはロードしたリファレンスとアンロードしたリファレンスの両方に使用できます。デフォルトでは、ターゲットに適用する MEL コマンドとしてフォーマットされたすべての編集を返します。 -ea/-editAttrsフラグと併用し、関与するノードとアトリビュートの両方の名前を node.attribute 形式で返すことを示します。
-editAttrs(-ea) create
文字配列を返します。 ターゲットに適用された編集を照会するための主要フラグです。リファレンスの編集に関与するアトリビュートの名前のみを返します。connectAttr 編集など、複数のアトリビュートに影響する編集の場合、ノードは、文字配列に含まれる、個別の連続したエントリとして返されます。有効なターゲットは、リファレンス ノード、リファレンス ファイル、参照されたノードのいずれかです。 参照されたノードノードを指定すると、このノードに影響する編集のみを返します。リファレンス ファイルまたはリファレンス ノードを指定すると、そのリファレンスのノードに影響するすべての編集を返します。ターゲットを指定しない場合、すべての編集を返します。このコマンドはロードしたリファレンスとアンロードしたリファレンスの両方に使用できます。デフォルトでは、ターゲットに適用する MEL コマンドとしてフォーマットされたすべての編集を返します。 -ea/-editAttrsフラグと併用し、関与するノードとアトリビュートの両方の名前を node.attribute 形式で返すことを示します。
-failedEdits(-fld) boolean create
失敗した編集（照会、削除など）を実行するべきかどうかを示す二次フラグです。失敗した編集とは、リファレンスを前回ロードしたときに、正常に適用されなかった編集を指します。 編集はさまざまな理由で失敗することがあります（適用するリファレンス ノードがリファレンス ファイルから削除された、など）。 デフォルトでは、失敗した編集を実行しません。
-successfulEdits(-scs) boolean create
成功した編集（照会、削除など）を実行すべきかどうかを示す二次フラグです。成功した編集とは、リファレンスを前回ロードしたときに、正常に適用された編集を指します。 デフォルトでは、成功した編集を実行します。
-showDagPath(-sdp) boolean create
編集時に、完全な DAG パスを表示/非表示にします。false の場合、リファレンス編集のノード名のみが表示されます。-editNodes、-editStrings、または -editAttrs フラグと併用する必要があります。
-showNamespace(-sns) boolean create
参照編集内のノード上のネームスペースを表示/非表示にします。 -editNodes、-editStrings、または -editAttrs フラグと併用する必要があります。
: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : 1 つのコマンドで複数回使用可能なフラグ

MEL の例

// Build a sample scene:
// main scene contains a reference to mid.ma.
// mid.ma contains a reference to bot.ma.
// Create bot.ma with a poly sphere.
//
polySphere;
file -rename "bot.ma";
file -f -type "mayaAscii" -save;
// Create mid.ma with a poly cone.
// Reference bot.ma into mid.ma and group
// the sphere in bot.ma
//
file -f -new;
file -r -ns "bot" "bot.ma";
polyCone;
group bot:pSphere1;
file -rename "mid.ma";
file -f -type "mayaAscii" -save;
// Create a poly plane.
// Reference mid.ma into the main scene,
// move the cone in mid.ma, and connect
// the plane to the sphere in bot.ma.
//
file -f -new;
file -r -ns "mid" "mid.ma";
select -r mid:pCone1;
move -r 5 5 5;
polyPlane;
connectAttr pPlane1.ty mid:bot:polySphere1.radius;
// Now perform some queries:
//
referenceQuery -filename midRN;
// Result: C:/Documents and Settings/user/My Documents/maya/projects/default/scenes/mid.ma
referenceQuery -filename -shortName mid:pCone1;
// Result: mid.ma
referenceQuery -filename -parent mid:botRN;
// Result: C:/Documents and Settings/user/My Documents/maya/projects/default/scenes/mid.ma
referenceQuery -referenceNode mid.ma;
// Result: midRN
referenceQuery -referenceNode "C:/Documents and Settings/user/My Documents/maya/projects/default/scenes/bot.ma";
// Result: mid:botRN
referenceQuery -referenceNode -parent bot.ma;
// Result: midRN
referenceQuery -referenceNode -topReference bot.ma;
// Result: midRN
referenceQuery -nodes mid:botRN;
// Result: mid:bot:pSphere1 mid:bot:pSphereShape1 mid:bot:lightLinker1 mid:bot:layerManager mid:bot:defaultLayer mid:bot:renderLayerManager mid:bot:defaultRenderLayer mid:bot:polySphere1 mid:bot:uiConfigurationScriptNode mid:bot:sceneConfigurationScriptNode
referenceQuery -isNodeReferenced pPlane1;
// Result: 0
referenceQuery -isNodeReferenced mid:pCone1;
// Result: 1