pymel.core.modeling.subdiv

subdiv(*args, **kwargs)

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. In query mode, return type is based on queried flag.

Flags:
Long name (short name) Argument Types Properties
currentLevel (cl) bool ../../../_images/create.gif ../../../_images/query.gif
 

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) bool ../../../_images/create.gif ../../../_images/query.gif
 

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 ../../../_images/create.gif ../../../_images/query.gif
 
When queried, this flag returns an integer representing the deepest level to which the queried subdiv surface has been subdivided.
displayLoad (dsl) bool ../../../_images/create.gif ../../../_images/query.gif
 
When queried, this flag prints the display load of selected subdiv
edgeStats (est) bool ../../../_images/create.gif ../../../_images/query.gif
 
When queried, this flag prints stats on the current subd.
faceStats (fst) bool ../../../_images/create.gif ../../../_images/query.gif
 
When queried, this flag prints stats on the current subd.
maxPossibleLevel (mpl) int ../../../_images/create.gif ../../../_images/query.gif
 
When queried, this flag returns an integer representing the maximum possible level to which the queried subdiv surface can been subdivided.
proxyMode (pm) int ../../../_images/create.gif ../../../_images/query.gif
 

When queried, this flag returns an integer representing whether or not the subdivision surface is in polygon proxymode. Proxymode 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 proxymode. Returns 0, if the surface is not currently in proxymode, but could be put into proxymode since it has no construction history. (This state is also known as standardmode.) Returns 2, if the surface is not in proxymode and cannot be put into proxy mode, as it has construction history. Flag can have multiple arguments, passed either as a tuple or a list.

smallOffsets (so) bool ../../../_images/create.gif ../../../_images/query.gif
 
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

Derived from mel command maya.cmds.subdiv

Example:

import pymel.core as pm

# To find the deepest subdivided level of polyToSubdShape1
#
pm.subdiv( 'polyToSubdShape1', query=True, deepestLevel=True )
# To find the level of the  selected subdiv CV
#
pm.select( 'polyToSubdShape1.smp[2][67108865]', r=True)
pm.subdiv( currentLevel=True )
1

Previous topic

pymel.core.modeling.subdTransferUVsToCache

Next topic

pymel.core.modeling.subdivCrease

Core

Core Modules

Other Modules

This Page