Go to: Synopsis. Return value. Keywords.
Related. Flags.
Python examples.
clipMatching([clipDst=[string, float]], [clipSrc=[string, float]], [matchRotation=uint], [matchTranslation=uint])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
clipMatching is undoable, NOT queryable, and NOT
editable.
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 element. For this command to work, an offset object
must be specified for the character.
character, clip, animation
bakeClip, character, clip,
clipEditor, clipSchedule
clipDst, clipSrc, matchRotation, matchTranslation
Long name (short name) |
Argument types |
Properties |
clipSrc(cs) |
[string, 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. |
|
clipDst(cd) |
[string, 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. |
|
matchTranslation(mt) |
uint |
|
|
This flag sets the translation match type. By default, it is
set to not match the translation. 0 - None 1 - Match full
translation 2 - Match projected translation on ground plane |
|
matchRotation(mr) |
uint |
|
|
This flag sets the rotation match type. By default, it is set
to not match the rotation. 0 - None 1 - Match full rotation 2 -
Match projected rotation on ground plane |
|
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
# 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 = 1.
#
cmds.select( 'character', 'LeftAnkle' )
cmds.clipMatching( mt=1, cs=("walk",0.0), cd=("tornadoKick",1.0) )