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
	Modifies the node caching mode. See the node documentation for more information. Note:For advanced users only.
constructionHistory (ch)		bool
	Turn the construction history on or off (where applicable)
level (l)		int
	The level which will now become the base mesh Default:0 Advanced flags
name (n)		unicode
	Name the resulting object
nodeState (nds)		int
	Modifies the node state. See the node documentation for more information. Note:For advanced users only. Common flags
object (o)		bool
	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 )