pymel.core.general.delete

delete(*args, **kwargs)

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 rowon a NURBS surface will delete the whole row.

Modifications:
  • the command will not fail on an empty list
Flags:
  • all : all (bool) [create]

    Remove all objects of specified kind, in the scene. This flag is to be used in conjunction with the following flags.

  • attribute : at (unicode) [create]

    List of attributes to select

  • channels : c (bool) [create]

    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 (bool) [create]

    Remove selected constraints and constraints attached to the selected nodes, or remove all constraints in the scene. Flag can have multiple arguments, passed either as a tuple or a list.

  • constructionHistory : ch (bool) [create]

    Remove the construction history on the objects specified or selected.

  • controlPoints : cp (bool) [create]

    This flag explicitly specifies whether or not to include the control points of a shape (see -sflag) in the list of attributes. Default: false. (Not valid for pasteKeycmd.)

  • expressions : e (bool) [create]

    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 (unicode) [create]

    Hierarchy expansion options. Valid values are above,below,both,and none.(Not valid for pasteKeycmd.)

  • inputConnectionsAndNodes : icn (bool) [create]

    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 (bool) []

  • shape : s (bool) [create]

    Consider attributes of shapes below transforms as well, except controlPoints. Default: true. (Not valid for pasteKeycmd.)

  • staticChannels : sc (bool) [create]

    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 (bool) [create]

    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 (bool) [create]

    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.

Derived from mel command maya.cmds.delete

Previous topic

pymel.core.general.cycleCheck

Next topic

pymel.core.general.deleteAttr

Core

Core Modules

Other Modules

This Page