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

概要

attributeQuery([affectsAppearance=boolean], [affectsWorldspace=boolean], [attributeType=boolean], [cachedInternally=boolean], [categories=boolean], [channelBox=boolean], [connectable=boolean], [enum=boolean], [exists=boolean], [hidden=boolean], [indeterminant=boolean], [indexMatters=boolean], [internal=boolean], [internalGet=boolean], [internalSet=boolean], [keyable=boolean], [listChildren=boolean], [listDefault=boolean], [listEnum=boolean], [listParent=boolean], [listSiblings=boolean], [longName=boolean], [maxExists=boolean], [maximum=boolean], [message=boolean], [minExists=boolean], [minimum=boolean], [multi=boolean], [niceName=boolean], [node=name], [numberOfChildren=boolean], [range=boolean], [rangeExists=boolean], [readable=boolean], [renderSource=boolean], [shortName=boolean], [softMax=boolean], [softMaxExists=boolean], [softMin=boolean], [softMinExists=boolean], [softRange=boolean], [softRangeExists=boolean], [storable=boolean], [type=string], [typeExact=string], [usedAsColor=boolean], [usedAsFilename=boolean], [usesMultiBuilder=boolean], [worldspace=boolean], [writable=boolean])

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

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

attributeQuery は、アトリビュートの構成に関する情報を返します。両方のブーリアン フラグを処理し、他の戻り値と同様に true または false を返します。複数のブーリアン フラグを指定すると、指定したすべてのブーリアン フラグの論理和を返します。両方がブーリアン タイプの戻り値を返すのでなければ、2 つのフラグを指定することはできません。（たとえば、「-internal -hidden」は指定できますが、「-range -hidden」や「-range -softRange」は指定できません）。

戻り値

float[]範囲または既定値を照会する場合
booleanアトリビュート フラグを照会する場合

キーワード

dg, dependency, graph, attribute, query

関連

getClassification, isConnected, isDirty, nodeType, objExists, objectType

フラグ

affectsAppearance, affectsWorldspace, attributeType, cachedInternally, categories, channelBox, connectable, enum, exists, hidden, indeterminant, indexMatters, internal, internalGet, internalSet, keyable, listChildren, listDefault, listEnum, listParent, listSiblings, longName, maxExists, maximum, message, minExists, minimum, multi, niceName, node, numberOfChildren, range, rangeExists, readable, renderSource, shortName, softMax, softMaxExists, softMin, softMinExists, softRange, softRangeExists, storable, type, typeExact, usedAsColor, usedAsFilename, usesMultiBuilder, worldspace, writable
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
affectsAppearance(aa) boolean create
アトリビュートがノードの外観に影響を与える場合は true を返します。
affectsWorldspace(aws) boolean create
ワールド空間に影響を与えるアトリビュートをマークするアトリビュート フラグの状態を返します。
attributeType(at) boolean create
アトリビュート タイプの名前(addAttr コマンドと addExtension コマンドで解説したタイプ名と同じ名前)を返します。
categories(ct) boolean create
アトリビュートが属するカテゴリを返します。アトリビュートがどのカテゴリにも属さない場合は、空のリストを返します。
cachedInternally(ci) boolean create
アトリビュートがノード内の他にデータブロックでもキャッシュされるかどうかを返します。
channelBox(ch) boolean create
アトリビュートが channelBox で表示されるかどうかを返します。
connectable(c) boolean create
アトリビュートの接続可能な状態を返します。
enum(e) boolean create
アトリビュートが enum アトリビュートの場合、true を返します。
exists(ex) boolean create
アトリビュートが存在する場合は true を返します。
hidden(h) boolean create
アトリビュートの非表示ステータスを返します。
indeterminant(idt) boolean create
このアトリビュートが評価で使用されるかどうかが評価時まで不明である場合は true を返します。
indexMatters(im) boolean create
アトリビュートの indexMatters ステータスを返します。
internal(i) boolean create
アトリビュートが internalSet か internalGet のどちらかである場合に true を返します。
internalGet(ig) boolean create
アトリビュートが getCachedValue で取得された場合に true を返します。
internalSet(internalSet) boolean create
アトリビュートを setCachedValue で設定する必要がある場合に true を返します。
keyable(k) boolean create
アトリビュートのキー設定可能な状態を返します。
listChildren(lc) boolean create
指定したアトリビュートの子アトリビュートのリストを返します。
listDefault(ld) boolean create
数値および複合数値型アトリビュートの既定値を返します。
listEnum(le) boolean create
指定したアトリビュートに対する enum 文字列のリストを返します。
listParent(lp) boolean create
指定したアトリビュートの親を返します。
listSiblings(ls) boolean create
指定したアトリビュートの兄弟アトリビュートのリストを返します。
longName(ln) boolean create
アトリビュートのロング ネームを返します。
maxExists(mxe) boolean create
アトリビュートがハード最大値を持つ場合、true を返します。最小値は存在する必要はありません。
maximum(max) boolean create
アトリビュート値のハード最大値を返します。
message(msg) boolean create
アトリビュートがメッセージ アトリビュートの場合、true を返します。
minExists(mne) boolean create
アトリビュートがハード最小値を持つ場合、true を返します。最大値は存在する必要はありません。
minimum(min) boolean create
アトリビュート値のハード最小値を返します。
multi(m) boolean create
アトリビュートがマルチ アトリビュートの場合、true を返します。
niceName(nn) boolean create
アトリビュートのナイス ネーム(または「UI 名」)を返します。
node(n) name create
ノード名が NAME のすべてのアトリビュートを使用します。
numberOfChildren(nc) boolean create
アトリビュートが持つ子の数を返します。
range(r) boolean create
アトリビュート値のハード範囲を返します。
rangeExists(re) boolean create
アトリビュートがハード範囲を持つ場合、true を返します。最小値と最大値の両方とも存在する必要があります。
readable(rd) boolean create
アトリビュートの読み取り可能ステータスを返します。
renderSource(rs) boolean create
このアトリビュートがレンダリング ソースとしてマークされているかどうかを返します。
shortName(sn) boolean create
アトリビュートのショート ネームを返します。
softMin(smn) boolean create
アトリビュート値のソフト最小値(スライダ範囲)を返します。
softMinExists(sme) boolean create
アトリビュートがソフト最小値を持つ場合、true を返します。最大値は存在する必要はありません。
softMax(smx) boolean create
アトリビュート値のソフト最大値(スライダ範囲)を返します。
softMaxExists(sxe) boolean create
アトリビュートがソフト最大値を持つ場合、true を返します。最小値は存在する必要はありません。
softRange(s) boolean create
アトリビュート値のソフト範囲(スライダ範囲)を返します。
softRangeExists(se) boolean create
アトリビュートがソフト範囲を持つ場合、true を返します。最小値と最大値の両方とも存在する必要があります。
storable(st) boolean create
アトリビュートが保存可能の場合、true を返します。
type(typ) string create
タイプが TYPE のノードのスタティック アトリビュートを使用します。親クラスのノードから継承されたアトリビュートを含みます。
typeExact(tex) string create
タイプが TYPE のノードのスタティック アトリビュートのみを使用します。継承されたアトリビュートは含みません。
usedAsColor(uac) boolean create
アトリビュートがカラー ピッカーを起動する場合、true を返します。
usedAsFilename(uaf) boolean create
アトリビュートがファイル ブラウザを起動する場合は、true を返します。
usesMultiBuilder(umb) boolean create
アトリビュートがマルチ アトリビュートであり、マルチビルダを使用してそのデータを処理する場合は、true を返します。
worldspace(ws) boolean create
ワールド空間アトリビュートをマークするアトリビュート フラグの状態を返します。
writable(w) boolean create
アトリビュートの書き込み可能な状態を返します。
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

# Determine the hidden status of the "selector" attribute on choice nodes.
#
cmds.attributeQuery( 'selector', typ='choice', h=True )
# Result: 0
# Determine the hidden status of the "selector" attribute on this choice node.
# (Usually the same but you can do this for dynamic attributes too.)
#
cmds.createNode( 'choice', n='whoIsIt' )
# Result: choice1
cmds.attributeQuery( 'selector', n='whoIsIt', h=True )
# Result: 0
# Determine the range of the selector value on choice nodes.
# In this case there is no range.
# Note, if there is only a minimum or only a maximum range will not set.
#
cmds.attributeQuery( 'selector', typ='choice', range=True )
# For the next several examples create a poly cube and add extra attributes.
cmds.polyCube( cuv=4, ch=1, w=1, h=1, d=1, sx=1, sy=1, sz=1, ax=(0, 1, 0) )
cmds.addAttr( '|pCube1', ln='egRange', at='long', min=0, max=5, dv=2 )
cmds.setAttr( '|pCube1.egRange', e=True, keyable=False )
# Determine if an attribute is keyable
#
cmds.attributeQuery( 'egRange', node='pCube1', k=True )
# Result: 0
# Determine the minimum and maximum values of the added attribute egRange
#
cmds.attributeQuery( 'egRange', node='pCube1', range=True )
# Result: [0.0, 5.0]
# Determine if there is a minimum for the attribute.
# Note, having a minimum or maximum value does not imply the attribute has a range.
cmds.addAttr( '|pCube1', ln='egMin', at='long', min=2 )
cmds.attributeQuery( 'egMin', node='pCube1', minExists=True )
# Result: 1
cmds.attributeQuery( 'egMin', node='pCube1', maxExists=True )
# Result: 0
cmds.attributeQuery( 'egMin', node='pCube1', min=True )
# Result: [2.0]
# Determine if an attribute is an enum
# List the enum strings. This will use ':' as a separator like the attr is written in
# an .ma file.
cmds.addAttr( '|pCube1', ln='myEnum', at='enum', en='chicken:turkey:duck:', ct='fowl' )
cmds.attributeQuery( 'myEnum', node='pCube1', listEnum=True )
# Result: [u'chicken:turkey:duck'] #
# Secondary way to find an attribute's type directly
cmds.attributeQuery( 'myEnum', node='pCube1', attributeType=True )
# Result: ['enum'] #
# See to which categories and attribute belongs
cmds.attributeQuery( 'myEnum', node='pCube1', categories=True )
# Result: ['fowl'] #