referenceQuery

ジャンプ先: 概要. 戻り値. キーワード. 関連. フラグ. 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 は、取り消し不可能、照会不可能、および編集不可能です。

戻り値

キーワード

関連

フラグ

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