Go to: Synopsis. Return value. Flags. Python examples.
moveKeyCtx( contextName , [exists=boolean], [history=boolean], [image1=string], [image2=string], [image3=string], [moveFunction=string], [name=string], [option=string])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
moveKeyCtx is undoable, queryable, and editable.
This command creates a context which may be used to move keyframes
within the graph editor
In query mode, return type is based on queried flag.
exists, history, image1,
image2, image3,
moveFunction, name, option
| Long name (short name) |
Argument types |
Properties |
exists(ex) |
boolean |
 |
|
Returns true or false depending upon whether the specified
object exists. Other flags are ignored. |
|
image1(i1) |
string |
  |
|
|
image2(i2) |
string |
|
|
|
image3(i3) |
string |
|
|
Contexts support up to three icons that represent the tool
associated with the context. |
|
history(ch) |
boolean |
|
|
If this is a tool command, turn the construction history on for
the tool in question. |
|
name(n) |
string |
|
|
If this is a tool command, name the tool appropriately. |
|
option(o) |
string |
|
|
Valid values are "move," "insert," "over," and "segmentOver."
When you "move" a key, the key will not cross over (in time) any
keys before or after it. When you "insert" a key, all keys before
or after (depending upon the -timeChange value) will be moved an
equivalent amount. When you "over" a key, the key is allowed to
move to any time (as long as a key is not there already). When you
"segmentOver" a set of keys (this option only has a noticeable
effect when more than one key is being moved) the first key (in
time) and last key define a segment (unless you specify a time
range). That segment is then allowed to move over other keys, and
keys will be moved to make room for the segment. |
|
moveFunction(mf) |
string |
|
|
linear | power | constant. Specifies how the keys are dragged.
The default move type is constant where all keys move the same
amount as controlled by user movement. Power provides a fall-off
function where the center of the drag moves the most and the keys
around the drag move less. |
|
| 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
# Create a move key context which works in insert mode
# for the graph editor
#
newCtx = cmds.moveKeyCtx(option='insert')
# Edit the context to over mode
#
cmds.moveKeyCtx( newCtx, e=True, option='over' )