Go to: Synopsis. Return value. Flags. MEL examples.
directKeyCtx [-exists] [-history
boolean] [-image1 string]
[-image2 string] [-image3 string] [-name string] [-option string] [-selectedOnly boolean]
contextName
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) |
|
|
|
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. |
|
-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 be used more than once in a
command. |
// Create a directKeyCtx which works in insert mode
//
directKeyCtx -option insert specialDirectKeyContext;