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


changeSubdivComponentDisplayLevel([level=int], [relative=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

changeSubdivComponentDisplayLevel is undoable, queryable, and NOT editable.

Explicitly forces the subdivision surface to display components at a particular level of refinement.

Return value


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


subdivision, surface, display, level, fine, coarse, level


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


level, relative
Long name (short name) Argument types Properties
level(l) int createquery
Specifies the display level of components.
relative(r) boolean createquery
If set, level refers to the relative 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 have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

# change the selected subdivision surface to display level 4 components
cmds.changeSubdivComponentDisplayLevel( l=4 )
# increase the display level of the selected subivision surface by 1
cmds.changeSubdivComponentDisplayLevel( l=1, r=True )