Go to: Synopsis. Return value. Related.
Flags. Python
examples.
subdCollapse( [string] , [caching=boolean], [constructionHistory=boolean],
[level=int], [name=string], [nodeState=int], [object=boolean])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
subdCollapse is undoable, queryable, and editable.
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.
| string[] |
The subd surface and optionally the dependency node name |
In query mode, return type is based on queried flag.
changeSubdivComponentDisplayLevel,
changeSubdivRegion, createSubdivRegion, nurbsToSubdiv, polyToSubdiv, querySubdiv, refineSubdivSelectionList,
subdToBlind, subdToPoly, subdiv,
subdivCrease, subdivDisplaySmoothness
caching, constructionHistory, level, name, nodeState, object
| Long name (short name) |
Argument types |
Properties |
level(l) |
int |
   |
|
The level which will now become the base mesh
Default: 0 |
|
| Advanced flags |
caching(cch) |
boolean |
|
|
Modifies the node caching mode. See the node documentation for
more information.
Note: For advanced users only. |
|
nodeState(nds) |
int |
|
|
Modifies the node state. See the node documentation for more
information.
Note: For advanced users only. |
|
| Common flags |
name(n) |
string |
|
|
Name the resulting object |
|
constructionHistory(ch) |
boolean |
|
|
Turn the construction history on or off (where applicable) |
|
object(o) |
boolean |
|
|
Create the result, or just the dep. node (where
applicable) |
|
| 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. |
import maya.cmds as cmds
# To create a new subd surface whose level 0 (base mesh) matches
# the level 3 vertices of the given surface.
cmds.subdCollapse( 'subdivShape1', level=3 )