Show frames
Go to: Synopsis. Return value. Flags. Python examples.
delete(
objects
, [all=boolean], [attribute=string], [channels=boolean], [constraints=boolean], [constructionHistory=boolean], [controlPoints=boolean], [expressions=boolean], [hierarchy=string], [inputConnectionsAndNodes=boolean], [motionPaths=boolean], [shape=boolean], [staticChannels=boolean], [timeAnimationCurves=boolean], [unitlessAnimationCurves=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
delete is undoable, NOT queryable, and NOT editable.
This command is used to delete selected objects, or all objects, or
objects specified along with the command. Flags are available to
filter the type of objects that the command acts on.
At times, more than just specified items will be deleted. For
example, deleting two CVs in the same "row" on a NURBS surface
will delete the whole row.
None
all, attribute, channels, constraints, constructionHistory, controlPoints, expressions, hierarchy, inputConnectionsAndNodes, motionPaths, shape, staticChannels, timeAnimationCurves, unitlessAnimationCurves
Long name (short name) |
Argument types |
Properties |
|
all(all)
|
boolean
|
|
|
Remove all objects of specified kind, in the scene. This flag
is to be used in conjunction with the following flags.
|
|
attribute(at)
|
string
|

|
|
List of attributes to select
In query mode, this flag needs a value.
|
|
channels(c)
|
boolean
|
|
|
Remove animation channels in the scene. Either all channels
can be removed, or the scope can be narrowed down by specifying
some of the above mentioned options.
|
|
constraints(cn)
|
boolean
|
|
|
Remove selected constraints and constraints attached to the
selected nodes, or remove all constraints in the scene.
|
|
constructionHistory(ch)
|
boolean
|
|
|
Remove the construction history on the objects specified or
selected.
|
|
controlPoints(cp)
|
boolean
|
|
|
This flag explicitly specifies whether or not to include the
control points of a shape (see "-s" flag) in the list of attributes.
Default: false. (Not valid for "pasteKey" cmd.)
In query mode, this flag needs a value.
|
|
expressions(e)
|
boolean
|
|
|
Remove expressions in the scene. Either all expressions
can be removed, or the scope can be narrowed down by specifying
some of the above mentioned options.
|
|
hierarchy(hi)
|
string
|
|
|
Hierarchy expansion options. Valid values are "above,"
"below," "both," and "none." (Not valid for "pasteKey" cmd.)
In query mode, this flag needs a value.
|
|
inputConnectionsAndNodes(icn)
|
boolean
|
|
|
Break input connection to specified attribute and delete all
unconnected nodes that are left behind. The graph will be
traversed until a node that cannot be deleted is encountered.
|
|
motionPaths(mp)
|
boolean
|
|
|
Remove motion paths in the scene. Either all
motion paths can be removed, or the scope can be narrowed down
by specifying some of the above mentioned options.
|
|
shape(s)
|
boolean
|
|
|
Consider attributes of shapes below transforms as well,
except "controlPoints". Default: true. (Not valid for "pasteKey" cmd.)
In query mode, this flag needs a value.
|
|
staticChannels(sc)
|
boolean
|
|
|
Remove static animation channels in the scene. Either all
static channels can be removed, or the scope can be narrowed down
by specifying some of the above mentioned options.
|
|
timeAnimationCurves(tac)
|
boolean
|
|
|
Modifies the -c/channels and -sc/staticChannels flags.
When true, only channels connected to time-input
animation curves (for instance, those created by
'setKeyframe' will be deleted. When false, no
time-input animation curves will be deleted.
Default: true.
|
|
unitlessAnimationCurves(uac)
|
boolean
|
|
|
Modifies the -c/channels and -sc/staticChannels flags.
When true, only channels connected to
unitless-input animation curves (for instance,
those created by 'setDrivenKeyframe' will be
deleted. When false, no unitless-input
animation curves will be deleted. Default:
true.
|
|
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 delete selected objects use:
cmds.delete()
# To delete a few specific objects like surfaceShape1, surface1 and
# paramCurve1 use:
cmds.delete( 'surfaceShape1', 'surface1', 'paramCurve1' )
# To delete all channels in the scene:
cmds.delete( all=True, c=True )
# To delete static channels connected to selected nodes:
cmds.delete( sc=True )
# To delete motion path nodes connected to selected nodes:
cmds.delete( mp=True )
# To delete all expressions in the scene:
cmds.delete( all=True, e=True )
# To delete selected constraints and constraints attached to selected nodes:
cmds.delete( cn=True )
# Notes:
# The at, h, s and cp flags only apply when either c/channels
# or sc/staticChannels or e/expressions options are specified.