pymel.core.animation.clipMatching

clipMatching(*args, **kwargs)

This command is used to compute an offset to apply on a source clip in order to automatically align it to a destination clip at a specified match pose element. For this command to work, the character must have an offset object specified.

Flags:

Long name (short name)		Argument Types	Properties
clipDst (cd)		unicode, float
	The clip to match so that the source clip can be offsetted correctly. This flag takes in a clip name and the percentage value ranging from 0.0 to 1.0 in order to have the source clip match at a certain time in the destination clip.
clipSrc (cs)		unicode, float
	The clip to offset so that it aligns with the destination clip. This flag takes in a clip name and the percentage value ranging from 0.0 to 1.0 in order to have it match at a certain time in the clip.
matchType (mt)		int
	This flag sets the matching type. Translation is the default match type. 0 - Match translation 1 - Match rotation 2 - Match translation and rotation 3 - Match projected translation on ground plane 4 - Match projected rotation on ground plane 5 - Match projected translation and rotation on ground planeFlag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.clipMatching

Example:

import pymel.core as pm

import maya.cmds as cmds

# Compute and set the offset on the "walk" clip in order to have it's start
# pose align to the end of the "tornadoKick" clip at the LeftAnkle match
# element.  Note that here we are matching the translation by specifying
# with mt = 0.
#
pm.select( 'character', 'LeftAnkle' )
pm.clipMatching( mt=0, cs=("walk",0.0), cd=("tornadoKick",1.0) )