Go to: Synopsis. Return value. Flags. Python examples.
directKeyCtx(
contextName
, [exists=boolean], [history=boolean], [image1=string], [image2=string], [image3=string], [name=string], [option=string], [selectedOnly=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
directKeyCtx is undoable, queryable, and editable.
This command creates a context which may be used to directly manipulate keyframes
within the graph editor
In query mode, return type is based on queried flag.
exists, history, image1, image2, image3, name, option, selectedOnly
| 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.
|
|
history(ch)
|
boolean
|
|
|
If this is a tool command, turn the construction history on
for the tool in question.
|
|
image1(i1)
|
string
|
 
|
|
First of three possible icons representing the tool
associated with the context.
|
|
image2(i2)
|
string
|
|
|
Second of three possible icons representing the tool
associated with the context.
|
|
image3(i3)
|
string
|
|
|
Third of three possible icons representing the tool
associated with the context.
|
|
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.
|
|
selectedOnly(so)
|
boolean
|
|
|
Controls whether only selected curves/keys can be moved, or
all.
|
|
|
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 directKeyCtx which works in insert mode
#
cmds.directKeyCtx( 'specialDirectKeyContext', option='insert' )