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

概要

referenceQuery [-child] [-dagPath] [-editAttrs] [-editCommand string] [-editNodes] [-editStrings] [-failedEdits boolean] [-filename] [-isExportEdits] [-isLoaded] [-isNodeReferenced] [-isPreviewOnly] [-liveEdits] [-namespace] [-nodes] [-onReferenceNode string] [-parent] [-parentNamespace] [-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

フラグ

child, dagPath, editAttrs, editCommand, editNodes, editStrings, failedEdits, filename, isExportEdits, isLoaded, isNodeReferenced, isPreviewOnly, liveEdits, namespace, nodes, onReferenceNode, parent, parentNamespace, referenceNode, shortName, showDagPath, showNamespace, successfulEdits, topReference, unresolvedName, withoutCopyNumber
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-filename(-f) create
文字列を返します。ターゲット リファレンスにコネクトされたファイル名を照会するための主要フラグです。
-parentNamespace(-pns) create
ターゲット リファレンスの親のネームスペースを照会して返すために使用される主要フラグです。
-shortName(-shn) create
このフラグによって、「-f/-filename」フラグおよび「-ns/-namespace」フラグが修正されます。「-f/-filename」フラグとともに使用され、ファイル名をショート ネーム(ディレクトリ パスを含まないファイル名)で返すことを示します。このフラグが存在しない場合、フル ネームとディレクトリ パスを返します。「-ns/-namespace」フラグとともに使用され、ネームスペースをベース名で返すことを示します (つまり、フル ネームスペース パス「:AAA:BBB:CCC」のベース名は「CCC」です)。
-unresolvedName(-un) create
-f/-filename フラグを修正し、返されるファイル名は解決されません(ファイルをロードしたときに指定したパスになります。このパスは環境変数を含み、ディスクに存在しない場合があります)。このフラグが存在しない場合、解決済みの名前を返します。
-withoutCopyNumber(-wcn) create
-f/-filename フラグを修正し、返されるファイル名の最後にコピー番号(たとえば )をアペンドしません。このフラグが存在しない場合、返されたファイル名の最後にコピー番号がアペンドされることがあります。
-dagPath(-dp) create
-n/-nodes フラグを修正し、返される DAD オブジェクト名には、名前を固有するために必要な DAG パスが含まれます。このフラグが存在しない場合、DAG パスが含まれない名前が返されます。
-isNodeReferenced(-inr) create
ブーリアンを返します。ターゲット ノードがリファレンス ファイル由来かどうかを調べるための主要フラグです。ターゲット ノードがリファレンス ファイル由来の場合は true、そうでない場合は false を返します。
-isPreviewOnly(-ipo) create
ブーリアンを返します。このフラグは、ターゲット リファレンス ノードがプレビュー リファレンス ノードのみかどうかを調べるために使用されます。
-referenceNode(-rfn) create
文字列を返します。ターゲット リファレンスにコネクトされたリファレンス ノードを照会するための主要フラグです。
-namespace(-ns) create
文字列を返します。このフラグは、ルート ネームスペース「:」から始まるターゲット リファレンスのフル ネームスペース パスを返します。shortName フラグと組み合わせて、ネームスペースのベース名だけを返すことができます。
-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 フラグと一緒に使用する必要があります。
-liveEdits(-le) create
編集は、ライブ編集データベースを基に返される必要があります。editStrings フラグとともに使用する場合のみ有効です。
-child(-ch) create
-rfn/-referenceNode と -f/-filename フラグを修正し、ターゲット リファレンスの子を返すことを示します。文字配列を返します。
-isLoaded(-il) create
指定のリファレンスノードまたはファイル名が参照するリファレンスがロードされているかどうかを示すブーリアンを返します。
-isExportEdits(-iee) create
指定のリファレンスノードまたはファイル名が編集済みファイル(編集済みの書き出し機能で作成した)かどうかを示すブーリアンを返します。
-editCommand(-ec) string createquerymultiuse
コマンドが考慮するべくリファレンスの編集のタイプを示すための二次フラグです。このフラグが指定されない場合、すべてのタイプの編集が含まれます。このフラグには文字列パラメータが必要です。有効な値は、「addAttr」、「connectAttr」、「deleteAttr」、「disconnectAttr」、「parent」、「setAttr」、「lock」、および「unlock」です。状況によっては、このフラグを複数回指定して、複数の編集タイプを考慮するように指定できます。
-onReferenceNode(-orn) string createquerymultiuse
指定したリファレンス ノードに格納された編集のみを考慮することを示すための二次フラグです。このフラグは、「exportEdits」コマンドによる指定時のみ複数使用が可能です。

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

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
referenceQuery -parentNamespace mid:botRN;
// Result: mid
referenceQuery -parentNamespace mid:bot:pSphere1;
// Result: mid
referenceQuery -parentNamespace "C:/Documents and Settings/user/My Documents/maya/projects/default/scenes/bot.ma";
// Result: mid
referenceQuery -namespace bot.ma;
// Result: :mid:bot //
referenceQuery -namespace mid:botRN;
// Result: :mid:bot //
referenceQuery -namespace -shortName bot.ma;
// Result: bot //
referenceQuery -namespace mid.ma;
// Result: :mid //
referenceQuery -namespace -shortName mid.ma;
// Result: mid //