Go to:
Return value. Related commands. Flags. Examples.
Synopsis
attributeQuery
[-type string]
[-node select]
[-exists toggle]
[-internal toggle]
[-internalSet toggle]
[-internalGet toggle]
[-keyable toggle]
[-connectable toggle]
[-message toggle]
[-enum toggle]
[-hidden toggle]
[-indexMatters toggle]
[-readable toggle]
[-storable toggle]
[-writable toggle]
[-multi toggle]
[-minimum toggle]
[-maximum toggle]
[-range toggle]
[-usedAsColor toggle]
[-softRange toggle]
[-softMin toggle]
[-softMax toggle]
[-numberOfChildren toggle]
[-listSiblings toggle]
[-listChildren toggle]
[-listParent toggle]
[-listEnum toggle]
[-listDefault toggle]
[-minExists toggle]
[-maxExists toggle]
[-rangeExists toggle]
[-softMinExists toggle]
[-softMaxExists toggle]
[-softRangeExists toggle]
attributeQuery is
NOT undoable, NOT queryable, and NOT editable
.
attributeQuery returns information about the configuration of an attribute.
It handles both boolean flags, returning true or false, as well as other return values.
Specifying more than one boolean flag will return the logical "and"
of all the specified boolean flags. You may not specify any two flags when both do not
provide a boolean return type. (eg. "-internal -hidden" is okay but "-range -hidden" or
"-range -softRange" is not.)
Return value
[float
array] when querying ranges or default values
Keywords
dg, dependency, graph, attribute, queryRelated commands
isConnected, isDirty, objExists, nodeType, objectType, getClassificationFlags
connectable, enum, exists, hidden, indexMatters, internal, internalGet, internalSet, keyable, listChildren, listDefault, listEnum, listParent, listSiblings, maxExists, maximum, message, minExists, minimum, multi, node, numberOfChildren, range, rangeExists, readable, softMax, softMaxExists, softMin, softMinExists, softRange, softRangeExists, storable, type, usedAsColor, writable
| Long name (short name) | [argument types] | Properties |
|---|
-type
(-typ)
| string |  |
|
Use static attributes from nodes of type TYPE
|
|
-node
(-n)
| select | |
|
Use all attributes from node named NAME
|
|
-exists
(-ex)
| | |
|
Return true if the attribute exists
|
|
-internal
(-i)
| | |
|
Return true if the attribute is either internalSet or internalGet
|
|
-internalSet
(-is)
| | |
|
Return true if the attribute must be set through setCachedValue
|
|
-internalGet
(-ig)
| | |
|
Return true if the attribute come from getCachedValue
|
|
-keyable
(-k)
| | |
|
Return the keyable status of the attribute
|
|
-connectable
(-c)
| | |
|
Return the connectable status of the attribute
|
|
-message
(-msg)
| | |
|
Return true if the attribute is a message attribute
|
|
-enum
(-e)
| | |
|
Return true if the attribute is a enum attribute
|
|
-hidden
(-h)
| | |
|
Return the hidden status of the attribute
|
|
-indexMatters
(-im)
| | |
|
Return the indexMatters status of the attribute
|
|
-readable
(-rd)
| | |
|
Return the readable status of the attribute
|
|
-storable
(-st)
| | |
|
Return true if the attribute is storable
|
|
-writable
(-w)
| | |
|
Return the writable status of the attribute
|
|
-multi
(-m)
| | |
|
Return true if the attribute is a multi-attribute
|
|
-minimum
(-min)
| | |
|
Return the hard minimum of the attribute's value
|
|
-maximum
(-max)
| | |
|
Return the hard maximum of the attribute's value
|
|
-range
(-r)
| | |
|
Return the hard range of the attribute's value
|
|
-usedAsColor
(-uac)
| | |
|
Return true if the attribute should bring up a color picker
|
|
-softRange
(-s)
| | |
|
Return the soft range (slider range) of the attribute's value
|
|
-softMin
(-smn)
| | |
|
Return the soft min (slider range) of the attribute's value
|
|
-softMax
(-smx)
| | |
|
Return the soft max (slider range) of the attribute's value
|
|
-numberOfChildren
(-nc)
| | |
|
Return the number of children the attribute has
|
|
-listSiblings
(-ls)
| | |
|
Return the list of sibling attributes of the given attribute.
|
|
-listChildren
(-lc)
| | |
|
Return the list of children attributes of the given attribute.
|
|
-listParent
(-lp)
| | |
|
Return the parent of the given attribute.
|
|
-listEnum
(-le)
| | |
|
Return the list of enum strings for the given attribute.
|
|
-listDefault
(-ld)
| | |
|
Return the default values of numeric and compound numeric attributes.
|
|
-minExists
(-mne)
| | |
|
Return true if the attribute has a hard minimum. A max does not have to be present.
|
|
-maxExists
(-mxe)
| | |
|
Return true if the attribute has a hard maximum. A min does not have to be present.
|
|
-rangeExists
(-re)
| | |
|
Return true if the attribute has a hard range. Both min and max must be present.
|
|
-softMinExists
(-sme)
| | |
|
Return true if the attribute has a soft minimum. A max does not have to be present.
|
|
-softMaxExists
(-sxe)
| | |
|
Return true if the attribute has a soft maximum. A min does not have to be present.
|
|
-softRangeExists
(-se)
| | |
|
Return true if the attribute has a soft range. Both min and max must be present.
|
|
|
Flag can appear in Create mode of command
| 
Flag can appear in Edit mode of command
|
Flag can appear in Query mode of command
| 
Flag can be used more than once in a command
|
Examples
// Determine the hidden status of the "selector" attribute on choice nodes.
//
attributeQuery -typ choice -h selector;
// 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.)
//
createNode choice -n whoIsIt;
// Result: choice1
attributeQuery -n whoIsIt -h selector;
// 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.
//
attributeQuery -typ choice -range selector;
// For the next several examples create a poly cube and add extra attributes.
polyCube -w 1 -h 1 -d 1 -sx 1 -sy 1 -sz 1 -ax 0 1 0 -cuv 4 -ch 1;
addAttr -ln egRange -at long -min 0 -max 5 -dv 2 |pCube1;
setAttr -e -keyable false |pCube1.egRange;
// Determine if an attribute is keyable
//
attributeQuery -node "pCube1" -k "egRange";
// Result: 0
// Determine the minimum and maximum values of the added attribute egRange
//
attributeQuery -node "pCube1" -range "egRange";
// Result: 0 5
// Determine if there is a minimum for the attribute.
// Note, having a minimum or maximum value does not imply the attribute has a range.
addAttr -ln egMin -at long -min 2 |pCube1;
attributeQuery -node "pCube1" -minExists "egMin";
// Result: 1
attributeQuery -node "pCube1" -maxExists "egMin";
// Result: 0
attributeQuery -node "pCube1" -min "egMin";
// Result: 2
// 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.
addAttr -ln myEnum -at "enum" -en "chicken:turkey:duck:" |pCube1;
attributeQuery -node "pCube1" -listEnum "myEnum";
// Result: chicken:turkey:duck //