pymel.core.modeling.subdCollapse

subdCollapse(*args, **kwargs)

This command converts a takes a subdivision surface, passed as the argument, and produces a subdivision surface with a number of hierarchy levels removed. Returns the name of the subdivision surface created and optionally the DG node that does the conversion.

Flags:
Long name (short name) Argument Types Properties
caching (cch) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Modifies the node caching mode. See the node documentation for more information. Note:For advanced users only.
constructionHistory (ch) bool ../../../_images/create.gif
 
Turn the construction history on or off (where applicable)
level (l) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The level which will now become the base mesh Default:0 Advanced flags
name (n) unicode ../../../_images/create.gif
 
Name the resulting object
nodeState (nds) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Modifies the node state. See the node documentation for more information. Note:For advanced users only. Common flags
object (o) bool ../../../_images/create.gif
 
Create the result, or just the dep. node (where applicable) Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.subdCollapse

Example:

import pymel.core as pm

# To create a new subd surface whose level 0 (base mesh) matches
# the level 3 vertices of the given surface.
pm.subdCollapse( 'subdivShape1', level=3 )