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 that will now become the base mesh.
Default: 0
|
|
| Common flags |
constructionHistory(ch)
|
boolean
|
|
|
Turn the construction history on or off (where applicable).
|
|
name(n)
|
string
|
|
|
Name the resulting object.
|
|
object(o)
|
boolean
|
|
|
Create the result, or just the depend node (where applicable).
|
|
| 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.
|
|
|
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 )