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).
frozen / fzn		bool
level / l		int
	The level that will now become the base mesh. Default:0 Common 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. Flag can have multiple arguments, passed either as a tuple or a list.
object / o		bool
	Create the result, or just the depend node (where applicable). Advanced flags

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 )