Go to: Synopsis. Return value. Keywords. Related. Flags. Python examples.
polyQueryBlindData([associationType=string], [binaryData=string], [booleanData=boolean], [doubleData=float], [intData=int], [longDataName=string], [maxValue=float], [minValue=float], [shortDataName=string], [showComp=boolean], [stringData=string], [subString=string], [typeId=int])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
polyQueryBlindData is NOT undoable, NOT queryable, and NOT editable.
Command query's blindData associated with particular polygonal components.
So, the command will require the following to be specified:
- selection list to query
Optional are the:
- typeId
- associationType
- longDataName or shortDataName of data being queried.
- The actual data being specified.
- showComponent flag
Note that for object level blind data, the showComponent flag will be ignored.
If no components are selected, the assocation flag will be ignored and
object level data will be queried.
query, blind, data
blindDataType, polyBlindData
associationType, binaryData, booleanData, doubleData, intData, longDataName, maxValue, minValue, shortDataName, showComp, stringData, subString, typeId
Long name (short name) |
Argument types |
Properties |
associationType(at)
|
string
|
|
|
Specifies the dataTypes that are part of BlindData node being queried.
Allowable associations are "object" for any object, and "vertex" "edge" and
"face" for mesh objects.
|
|
binaryData(bnd)
|
string
|
|
|
Specifies the binary string value to search for
|
|
booleanData(bd)
|
boolean
|
|
|
Specifies the string value to search for
|
|
doubleData(dbd)
|
float
|
|
|
Specifies the double/float value to search for
|
|
intData(ind)
|
int
|
|
|
Specifies the integer value to search for
|
|
longDataName(ldn)
|
string
|
|
|
Specifies the long name of the data that is being queried by this command.
|
|
maxValue(max)
|
float
|
|
|
Specifies the maximum value to search for. This option will query float,
double, and integer types of blind data.
|
|
minValue(min)
|
float
|
|
|
Specifies the minimum value to search for. This option will query float,
double and integer types of blind data.
|
|
shortDataName(sdn)
|
string
|
|
|
Specifies the short name of the data that is being queried by this command.
|
|
showComp(sc)
|
boolean
|
|
|
The showComponent option controls whether the object.[component].attribute
name is output preceeding the actual value. If the showComponent option
is used then the restriction of only returning 1 type of blind data (i.e.
one of integer, float, double... is removed, as the return for all are
strings.
If the association is object and not component, then this option will
still cause all the attribute names to be printed
|
|
stringData(sd)
|
string
|
|
|
Specifies the string value to search for
|
|
subString(ss)
|
string
|
|
|
Specifies the substring that should be checked against a STRING type blind
data. If the sub string is found query is successful. Will not look at non
String type blind data elements.
|
|
typeId(id)
|
int
|
|
|
Specifies the typeId of the BlindData type being queried. If the typeId
is not specified, then all of the components that match the query will be
output. The typeId of the elements found will be output if the ShowComponents
option is used. Will be in the format "object.component.attribute::typeId".
If the typeId is specifed then the "::typeId" portion will not be output with
the ShowComponents option.
|
|
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 have multiple arguments, passed either as a tuple or a list.
|
import maya.cmds as cmds
cmds.polyQueryBlindData( 'pPlane1.vtx[2]', 'pPlane1.vtx[8]', id=9001, associationType='vertex', ldn='bdFloat', dbd=234 )
cmds.polyQueryBlindData( id=9005, sc='pPlane1.vtx[0:100]' )
cmds.polyQueryBlindData( 'pPlane1.f[0:10]', sc='pPlane1.vtx[0:100]' )