referenceQuery

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

概要

referenceQuery([child=boolean], [dagPath=boolean], [editAttrs=boolean], [editCommand=string], [editNodes=boolean], [editStrings=boolean], [failedEdits=boolean], [filename=boolean], [isExportEdits=boolean], [isLoaded=boolean], [isNodeReferenced=boolean], [isPreviewOnly=boolean], [liveEdits=boolean], [namespace=boolean], [nodes=boolean], [onReferenceNode=string], [parent=boolean], [parentNamespace=boolean], [referenceNode=boolean], [shortName=boolean], [showDagPath=boolean], [showNamespace=boolean], [successfulEdits=boolean], [topReference=boolean], [unresolvedName=boolean], [withoutCopyNumber=boolean])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

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

戻り値

キーワード

関連

フラグ

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

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

# 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.
#
cmds.polySphere()
cmds.file( rename='bot.ma' )
cmds.file( f=True, s=True, type='mayaAscii')
# Create mid.ma with a poly cone.
# Reference bot.ma into mid.ma and group
# the sphere in bot.ma
#
cmds.file( f=True, new=True )
cmds.file( 'bot.ma', r=True,ns='bot' )
cmds.polyCone()
cmds.group( 'bot:pSphere1' )
cmds.file( rename='mid.ma' )
cmds.file( f=True, s=True, type='mayaAscii')
# 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.
#
cmds.file( f=True, new=True )
cmds.file( 'mid.ma', r=True, ns='mid' )
cmds.select( 'mid:pCone1', r=True )
cmds.move( 5, 5, 5, r=True )
cmds.polyPlane()
cmds.connectAttr( 'pPlane1.ty', 'mid:bot:polySphere1.radius' )
# Now perform some queries:
#
cmds.referenceQuery( 'midRN',filename=True )
# Result: C:/Documents and Settings/user/My Documents/maya/projects/default/scenes/mid.ma
cmds.referenceQuery( 'mid:pCone1', filename=True, shortName=True )
# Result: mid.ma
cmds.referenceQuery( 'mid:botRN', filename=True, parent=True )
# Result: C:/Documents and Settings/user/My Documents/maya/projects/default/scenes/mid.ma
cmds.referenceQuery( 'mid.ma', referenceNode=True )
# Result: midRN
cmds.referenceQuery( 'C:/Documents and Settings/user/My Documents/maya/projects/default/scenes/bot.ma', referenceNode=True)
# Result: mid:botRN
cmds.referenceQuery( 'bot.ma', referenceNode=True, parent=True )
# Result: midRN
cmds.referenceQuery( 'bot.ma', referenceNode=True, topReference=True )
# Result: midRN
cmds.referenceQuery( 'mid:botRN',nodes=True )
# Result:[u'mid:bot:pPlane1', u'mid:bot:pPlaneShape1', u'mid:bot:outputCloth1', u'mid:bot:nCloth1', u'mid:bot:nClothShape1', u'mid:bot:dynamicConstraint1', u'mid:bot:dynamicConstraintShape1', u'mid:bot:nurbsSphere1', u'mid:bot:nurbsSphereShape1', u'mid:bot:pSphere1', u'mid:bot:pSphereShape1', u'mid:bot:lightLinker1', u'mid:bot:layerManager', u'mid:bot:defaultLayer', u'mid:bot:renderLayerManager', u'mid:bot:defaultRenderLayer', u'mid:bot:polyPlane1', u'mid:bot:nucleus1', u'mid:bot:nComponent1', u'mid:bot:uiConfigurationScriptNode', u'mid:bot:sceneConfigurationScriptNode', u'mid:bot:nClothShape1Cache1Start', u'mid:bot:cacheBlend1', u'mid:bot:nClothShape1Cache2', u'mid:bot:nClothShape1Cache1End', u'mid:bot:makeNurbSphere1', u'mid:bot:polySphere1'] #
cmds.referenceQuery( 'pPlane1', isNodeReferenced=True )
# Result: 0
cmds.referenceQuery( 'mid:pCone1', isNodeReferenced=True )
# Result: 1
cmds.referenceQuery( 'mid:botRN', parentNamespace=True )
# Result: mid
cmds.referenceQuery( 'mid:bot:pSphere1', parentNamespace=True )
# Result: mid
cmds.referenceQuery( 'C:/Documents and Settings/user/My Documents/maya/projects/default/scenes/bot.ma', parentNamespace=True )
# Result: mid
print cmds.referenceQuery( 'bot.ma', namespace=True )
# Result: :mid:bot
print cmds.referenceQuery( 'mid:botRN', namespace=True )
# Result: :mid:bot
print cmds.referenceQuery( 'bot.ma', namespace=True, shortName=True )
# Result: bot
print cmds.referenceQuery( 'mid.ma', namespace=True )
# Result: :mid
print cmds.referenceQuery( 'mid.ma', namespace=True, shortName=True )
# Result: mid