Go to: Synopsis. Return value. Keywords. Related. Flags. MEL examples.

Synopsis

subdiv [-currentLevel] [-currentSubdLevel] [-deepestLevel int] [-displayLoad] [-edgeStats] [-faceStats] [-maxPossibleLevel int] [-proxyMode int] [-smallOffsets]

subdiv is undoable, queryable, and NOT editable.

Provides useful information about the selected subdiv or components, such as the deepest subdivided level, the children or parents of the currently selected components, etc.

Return value

None

In query mode, return type is based on queried flag.

Keywords

subdivision, surface, query, level

Related

changeSubdivComponentDisplayLevel, changeSubdivRegion, createSubdivRegion, nurbsToSubdiv, polyToSubdiv, querySubdiv, refineSubdivSelectionList, subdCollapse, subdToBlind, subdToPoly, subdivCrease, subdivDisplaySmoothness

Flags

currentLevel, currentSubdLevel, deepestLevel, displayLoad, edgeStats, faceStats, maxPossibleLevel, proxyMode, smallOffsets
Long name (short name) Argument types Properties
-currentLevel(-cl) createquery
When queried, this flag returns an integer representing the level of the currently selected subdiv surface component(s). Returns -1, if there are more than one level of CVs are selected, (even if they are from different objects) Returns -2, if there are no input subdiv CVs to process.
-currentSubdLevel(-csl) createquery
When queried, this flag returns an integer representing the level of the currently selected subdiv surface, regardless of whether components are selected or not. Returns -2, if there are no input subdiv CVs to process.
-deepestLevel(-dl) int createquery
When queried, this flag returns an integer representing the deepest level to which the queried subdiv surface has been subdivided.
-displayLoad(-dsl) createquery
When queried, this flag prints the display load of selected subdiv
-edgeStats(-est) createquery
When queried, this flag prints stats on the current subd.
-faceStats(-fst) createquery
When queried, this flag prints stats on the current subd.
-maxPossibleLevel(-mpl) int createquery
When queried, this flag returns an integer representing the maximum possible level to which the queried subdiv surface can been subdivided.
-proxyMode(-pm) int createquery
When queried, this flag returns an integer representing whether or not the subdivision surface is in "polygon proxy" mode. "Proxy" mode allows the base mesh of a subdivision surface without construction history to be edited using the polygonal editing tools. Returns 1, if the subdivision surface is in "polygon proxy" mode. Returns 0, if the surface is not currently in "proxy" mode, but could be put into "proxy" mode since it has no construction history. (This state is also known as "standard" mode.) Returns 2, if the surface is not in "proxy" mode and cannot be put into proxy mode, as it has construction history.
-smallOffsets(-so) createquery
When queried, this flag prints the number of subdiv vertices in the hierarchy that have a small enough offset so that the vertex is not required
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.

MEL examples

// To find the deepest subdivided level of polyToSubdShape1
//
subdiv -query -deepestLevel polyToSubdShape1;
// To find the level of the  selected subdiv CV
//
select -r polyToSubdShape1.smp[2][67108865];
subdiv -currentLevel;
// Result: 1 //