Go to: Synopsis. Return value. Keywords. Related. Flags. MEL examples.
querySubdiv [-action int] [-level int] [-relative boolean]
querySubdiv is undoable, NOT queryable, and NOT editable.
Queries a subdivision surface based on a set of query parameters and updates the selection list with the results.
subdivision, surface, query
changeSubdivComponentDisplayLevel, changeSubdivRegion, createSubdivRegion, nurbsToSubdiv, polyToSubdiv, refineSubdivSelectionList, subdCollapse, subdToBlind, subdToPoly, subdiv, subdivCrease, subdivDisplaySmoothness
action, level, relative
| Long name (short name) |
Argument types |
Properties |
-action(-a)
|
int
|
|
|
Specifies the query parameter:
1 = find all tweaked verticies at level
2 = find all sharpened vertices at level
3 = find all sharpened edges at level
4 = find all faces at level
If the attribute "level" is not specified then the query is applied to
the current component display level. If the attribute level is
specified then the query is applied to that level, either absolute or
relative to the current level based on the "relative" flag state.
|
|
-level(-l)
|
int
|
|
|
Specify the level of the subdivision surface on which to perform the operation.
|
|
-relative(-r)
|
boolean
|
|
|
If set, level flag refers to the level relative to the current component display level.
|
|
|
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.
|
// find all tweaked verticies at current level
querySubdiv -a 1;
// find all tweaked verticies one level finer than current level
querySubdiv -a 1 -l 1 -r on;
// find all creased verticies at current level
querySubdiv -a 2;
// find all creased edges at current level
querySubdiv -a 3;
// find all faces at current level.
// You should work with the subdivision surface shape.
//
querySubdiv -a 4 subdivShape1;
// find all faces at level 1.
//
querySubdiv -a 4 -level 1 -relative off subdivShape1;
// find all faces at the next finest level from the current one.
//
querySubdiv -a 4 -level 1 -relative on subdivShape1;