pymel.core.animation.clip

clip(*args, **kwargs)

This command is used to create, edit and query character clips.

Flags:
  • absolute : abs (bool) [create]

    This flag is now deprecated. Use aa/allAbsolute, ar/allRelative, ra/rotationsAbsolute, or da/defaultAbsolute instead. This flag controls whether the clip follows its keyframe values or whether they are offset by a value to maintain a smooth path. Default is true.

  • absoluteRotations : abr (bool) [create]

    This flag is now deprecated. Use aa/allAbsolute, ar/allRelative, ra/rotationsAbsolute, or da/defaultAbsolute instead. If true, this overrides the -absolute flag so that rotation channels are always calculated with absolute offsets. This allows you to have absolute offsets on rotations and relative offsets on all other channels.

  • active : a (unicode) [query,edit]

    Query or edit the active clip. This flag is not valid in create mode. Making a clip active causes its animCurves to be hooked directly to the character attributes in addition to being attached to the clip library node. This makes it easier to access the animCurves if you want to edit, delete or add additional animCruves to the clip.

  • addTrack : at (bool) []

    This flag is now obsolete. Use the insertTrack flag on the clipSchedule command instead.

  • allAbsolute : aa (bool) [create]

    Set all channels to be calculated with absolute offsets. This flag cannot be used in conjunction with the ar/allRelative, ra/rotationsAbsolute or da/defaultAbsolute flags.

  • allClips : ac (bool) [query]

    This flag is used to query all the clips in the scene. Nodes of type animClipthat are storing poses, are not returned by this command.

  • allRelative : ar (bool) [create]

    Set all channels to be calculated with relative offsets. This flag cannot be used in conjunction with the aa/allAbsolute, ra/rotationsAbsolute or da/defaultAbsolute flags.

  • allSourceClips : asc (bool) [query]

    This flag is used to query all the source clips in the scene. Nodes of type animClipthat are storing poses or clip instances, are not returned by this command.

  • animCurveRange : acr (bool) [create]

    This flag can be used at the time you create the clip instead of the startTime and endTime flags. It specifies that you want the range of the clip to span the range of keys in the clips associated animCurves.

  • character : ch (bool) [query]

    This is a query only flag which operates on the specified clip. It returns the names of any characters that a clip is associated with.

  • constraint : cn (bool) [create]

    This creates a clip out of any constraints on the character. The constraint will be moved off of the character and into the clip, so that it is only active for the duration of the clip, and its value can be scaled/offset/cycled according to the clip attributes.

  • copy : c (bool) [create,query]

    This flag is used to copy a clip or clips to the clipboard. It should be used in conjunction with the name flag to copy the named clips on the specified character and its subcharacters. In query mode, this flag allows you to query what, if anything, has been copied into the clip clipboard.

  • defaultAbsolute : da (bool) [create]

    Sets all top-level channels except rotations in the clip to relative, and the remaining channels to absolute. This is the default during clip creation if no offset flag is specified. This flag cannot be used in conjunction with the aa/allAbsolute, ar/allRelative, or ra/rotationsAbsolute flags.

  • duplicate : d (bool) [query]

    Duplicate the clip specified by the name flag. The start time of the new clip should be specified with the startTime flag.

  • endTime : end (time) [create,query,edit]

    Specify the clip end

  • expression : ex (bool) [create]

    This creates a clip out of any expressions on the character. The expression will be moved off of the character and into the clip, so that it is only active for the duration of the clip, and its value can be scaled/offset/cycled according to the clip attributes. Flag can have multiple arguments, passed either as a tuple or a list.

  • ignoreSubcharacters : ignoreSubcharacters (bool) [create]

    During clip creation, duplication and isolation, subcharacters are included by default. If you want to create a clip on the top level character only, or you want to duplicate the clip on the top level character without including subCharacters, use the ignoreSubcharacters flag.

  • isolate : i (bool) [create]

    This flag should be used in conjunction with the name flag to specify that a clip or clips should be copied to a new clip library. The most common use of this flag is for export, when you want to only export certain clips from the character, without exporting all of the clips.

  • leaveOriginal : lo (bool) [create]

    This flag is used when creating a clip to specify that the animation curves should be copied to the clip library, and left on the character.

  • mapMethod : mm (unicode) [create]

    This is is valid with the paste and pasteInstance flags only. It specifies how the mapping should be done. Valid options are: byNodeName, byAttrName, byCharacterMap, byAttrOrder, byMapOrAttrNameand byMapOrNodeName. byAttrNameis the default. The flags mean the following: byAttrOrdermaps using the order that the character stores the attributes internally, byAttrNameuses the attribute name to find a correspondence, byNodeNameuses the node name *and* the attribute name to find a correspondence, byCharacterMapuses the existing characterMap node to do the mapping. byMapOrAttrNameuses a character map if one exists, otherwise uses the attribute name. byMapOrNodeNameuses a character map if one exists, otherwise uses the attribute name.

  • name : n (unicode) [create,query]

    In create mode, specify the clip name. In query mode, return a list of all the clips. In duplicate mode, specify the clip to be duplicated. In copy mode, specify the clip to be copied. This flag is multi-use, but multiple use is only supported with the copy flag. For use during create and with all other flags, only the first instance of the name flag will be utilized. In query mode, this flag can accept a value.

  • newName : nn (unicode) [create]

    Rename a clip. Must be used in conjunction with the clip name flag, which is used to specify the clip to be renamed.

  • paste : p (bool) [create]

    This flag is used to paste a clip or clips from the clipboard to a character. Clips are added to the clipboard using the c/copy flag.

  • pasteInstance : pi (bool) [create]

    This flag is used to paste an instance of a clip or clips from the clipboard to a character. Unlike the p/paste flag, which duplicates the animCurves from the original source clip, the pi/pasteInstance flag shares the animCurves from the source clip.

  • remove : rm (bool) [query]

    Remove the clip specified by the name flag. The clip will be permanently removed from the library and deleted from any times where it has been scheduled.

  • removeTrack : rt (bool) [create]

    This flag is now obsolete. Use removeTrack flag on the clipSchedule command instead.

  • rotationsAbsolute : ra (bool) [create]

    Set all channels except rotations to be calculated with relative offsets. Rotation channels will be calculated with absolute offsets. This flag cannot be used in conjunction with the aa/allAbsolute, ar/allRelative or da/defaultAbsolute flags.

  • scheduleClip : sc (bool) [create]

    This flag is used when creating a clip to specify whether or not the clip should immediately be scheduled at the current time. If the clip is not scheduled, the clip will be placed in the library for future use, but will not be placed on the timeline. This flag is for use only when creating a new clip or duplicating an existing. The default is true.

  • sourceClipName : scn (bool) [query]

    This flag is for query only. It returns the name of the source clip that controls an instanced clip.

  • split : sp (time) [create,edit]

    Split an existing clip into two clips. The split occurs around the specified time.

  • startTime : s (time) [create,query,edit]

    Specify the clip start

  • useChannel : uc (unicode) [create]

    Specify which channels should be acted on. This flag is valid only in conjunction with clip creation, and the isolate flag. The specified channels must be members of the character.

Derived from mel command maya.cmds.clip

Previous topic

pymel.core.animation.choice

Next topic

pymel.core.animation.clipEditor

Core

Core Modules

Other Modules

This Page