pymel.core.context.moveKeyCtx

static context.moveKeyCtx(*args, **kwargs)

This command creates a context which may be used to move keyframes within the graph editor

Flags:
Long name (short name) Argument Types Properties
exists (ex) bool ../../../_images/create.gif
 
Returns true or false depending upon whether the specified object exists. Other flags are ignored.
history (ch) bool ../../../_images/create.gif
 
If this is a tool command, turn the construction history on for the tool in question.
image1 (i1) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
   
image2 (i2) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
   
image3 (i3) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Contexts support up to three icons that represent the tool associated with the context.
moveFunction (mf) unicode ../../../_images/query.gif ../../../_images/edit.gif
 

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 have multiple arguments, passed either as a tuple or a list.

name (n) unicode ../../../_images/create.gif
 
If this is a tool command, name the tool appropriately.
option (o) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

Valid values are move,insert,over,and segmentOver.When you movea key, the key will not cross over (in time) any keys before or after it. When you inserta key, all keys before or after (depending upon the -timeChange value) will be moved an equivalent amount. When you overa key, the key is allowed to move to any time (as long as a key is not there already). When you segmentOvera 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.

Derived from mel command maya.cmds.moveKeyCtx

Example:

import pymel.core as pm

# Create a move key context which works in insert mode
# for the graph editor
#
newCtx = pm.moveKeyCtx(option='insert')

# Edit the context to over mode
#
pm.moveKeyCtx( newCtx, e=True, option='over' )
# Result: u'moveKeyCtx1' #

Previous topic

pymel.core.context.modelCurrentTimeCtx

Next topic

pymel.core.context.mpBirailCtx

Core

Core Modules

Other Modules

This Page