Go to: Synopsis. Return value. Keywords. Related. Flags. Python examples.

Synopsis

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.

Return value

none

Keywords

character, clip, animation

Related

bakeClip, character, clip, clipEditor, clipSchedule

Flags

clipDst, clipSrc, matchRotation, matchTranslation
Long name (short name) Argument types Properties
clipSrc(cs) [string, float] create
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] create
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 create
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 create
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.

Python examples

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) )