Your Ad Here

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

Synopsis

setKeyframe( [objects] , [attribute=string], [breakdown=boolean], [clip=string], [controlPoints=boolean], [float=float], [hierarchy=string], [inTangentType=string], [insert=boolean], [insertBlend=boolean], [minimizeRotation=boolean], [outTangentType=string], [shape=boolean], [time=time], [value=double])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

setKeyframe is undoable, queryable, and editable.

This command creates keyframes for the specified objects, or the active objects if none are specified on the command line. The default time for the new keyframes is the current time. Override this behavior with the "-t" flag on the command line. The default value for the keyframe is the current value of the attribute for which a keyframe is set. Override this behavior with the "-v" flag on the command line. When setting keyframes on animation curves that do not have "time" as an input attribute (ie, they are unitless animation curves), use "-f/-float" to specify the unitless value at which to set a keyframe. The -time and -float flags may be combined in one command. This command sets up Dependency Graph relationships for proper evaluation of a given attribute at a given time.

Flags

attribute, breakdown, clip, controlPoints, float, hierarchy, inTangentType, insert, insertBlend, minimizeRotation, outTangentType, shape, time, value
Long name (short name) [argument types] Properties
attribute(at) string createmultiuse
Attribute name to set keyframes on.
insert(i) boolean create
Insert keys at the given time(s) and preserve the shape of the animation curve(s).
inTangentType(itt) string create
The in tangent type for keyframes set by this command. Valid values are "spline," "linear," "fast," "slow," "flat," "step," and "clamped." Default is "keyTangent -q -g -inTangentType"
outTangentType(ott) string create
The out tangent type for keyframes set by this command. Valid values are "spline," "linear," "fast," "slow," "flat," "step," and "clamped." Default is "keyTangent -q -g -outTangentType"
hierarchy(hi) string create
Controls the objects this command acts on, relative to the specified (or active) target objects. Valid values are "above," "below," "both," and "none." Default is "hierarchy -query"
shape(s) boolean create
Consider attributes of shapes below transforms as well, except "controlPoints". Default: true
controlPoints(cp) boolean create
Explicitly specify whether or not to include the control points of a shape (see "-s" flag) in the list of attributes. Default: false.
insertBlend(ib) boolean create
If true, a pairBlend node will be inserted for channels that have nodes other than animCurves driving them, so that such channels can have blended animation. If false, these channels will not have keys inserted. If the flag is not specified, the blend will be inserted based on the global preference for blending animation.
time(t) time createmultiuse
Time at which to set a keyframe on time-based animation curves.
float(f) float createmultiuse
Float time at which to set a keyframe on float-based animation curves.
value(v) double create
Value at which to set the keyframe. Using the value flag will not cause the keyed attribute to change to the specified value until the scene re-evaluates. Therefore, if you want the attribute to update to the new value immediately, use the setAttr command in addition to setting the key.
breakdown(bd) boolean createqueryedit
Sets the breakdown state for the key. Default is false

In query mode, this flag needs a value.
clip(c) string create
Specifies that the new key should be placed in the specified clip. Note that if the objects being keyframed are not already part of the clip, this flag will be ignored.
minimizeRotation(mr) boolean create
For rotations, ensures that the key that is set is a minimum distance away from the previous key. Default is false
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.

Return value


int Number of keyframes set by this command.

Related

autoKeyframe, findKeyframe, setDrivenKeyframe, setKeyPath

Python examples

import maya.cmds as cmds

# Set a keyframe at the current time on all "keyable"
# attributes of the selected objects.
#
cmds.setKeyframe()

# Set a keyframe so that translateX has a value of 10
# at the current time, regardless of its current position
#
cmds.setKeyframe( v=10, at='translateX' )

# Set keyframes for translateX on two objects at t=0 and
# t=10 seconds.  (Note that if mysteryObject has no
# attribute named translateX, no keyframe is set for mysteryObject.)
#
cmds.setKeyframe( 'nurbsSphere1', 'mysteryObject', attribute='translateX', t=['0sec','10sec'] )

Return to Autodesk Index


Your Ad Here