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.
In query mode, return type is based on queried flag.
Long name (short name) |
Argument types |
Properties |
|
-adjustTangent(-adt)
|
boolean
|
|
|
Adjsut tangent if insert keys
|
|
-animLayer(-al)
|
string
|
|
|
Specifies that the new key should be placed in the specified animation layer.
Note that if the objects being keyframed are not already part of the
layer, this flag will be ignored.
|
|
-animated(-an)
|
boolean
|
|
|
Add the keyframe only to the attribute(s) that have already a keyframe on. Default: false
|
|
-attribute(-at)
|
string
|
|
|
Attribute name to set keyframes on.
|
|
-breakdown(-bd)
|
boolean
|
|
|
Sets the breakdown state for the key. Default is false
|
|
-clip(-c)
|
string
|
|
|
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.
|
|
-controlPoints(-cp)
|
boolean
|
|
|
Explicitly specify whether or not to include the
control points of a shape (see "-s" flag) in the list of attributes.
Default: false.
|
|
-dirtyDG(-dd)
|
boolean
|
|
|
Allow dirty messages to be sent out when a keyframe is set.
|
|
-float(-f)
|
float
|
|
|
Float time at which to set a keyframe on float-based
animation curves.
|
|
-hierarchy(-hi)
|
string
|
|
|
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"
|
|
-identity(-id)
|
|
|
|
Sets an identity key on an animation layer. An identity key is one that
nullifies the effect of the anim layer. This flag has effect only when the
attribute being keyed is being driven by animation layers.
|
|
-inTangentType(-itt)
|
string
|
|
|
The in tangent type for keyframes set by this command.
Valid values are: "auto", clamped", "fast", "flat", "linear", "plateau", "slow", "spline", and "stepnext"
Default is "keyTangent -q -g -inTangentType"
|
|
-insert(-i)
|
|
|
|
Insert keys at the given time(s) and preserve
the shape of the animation curve(s). Note: the tangent
type on inserted keys will be fixed so that the
curve shape can be preserved.
|
|
-insertBlend(-ib)
|
boolean
|
|
|
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.
|
|
-minimizeRotation(-mr)
|
boolean
|
|
|
For rotations, ensures that the key that is set is a minimum distance
away from the previous key. Default is false
|
|
-noResolve(-nr)
|
boolean
|
|
|
When used with the -value flag, causes the specified value to be set
directly onto the animation curve, without attempting to resolve the value
across animation layers.
|
|
-outTangentType(-ott)
|
string
|
|
|
The out tangent type for keyframes set by this command.
Valid values are: "auto", "clamped", "fast", "flat", "linear", "plateau", "slow", "spline", "step", and "stepnext".
Default is "keyTangent -q -g -outTangentType"
|
|
-preserveCurveShape(-pcs)
|
boolean
|
|
|
Sets the preserve curve shape when inserting keys.
Default value depend on your keySetPreserveCurveShape option.
|
|
-respectKeyable(-rk)
|
boolean
|
|
|
When used with the -attribute flag, prevents the keying of the non keyable attributes.
|
|
-shape(-s)
|
boolean
|
|
|
Consider attributes of shapes below transforms as well,
except "controlPoints". Default: true
|
|
-time(-t)
|
time
|
|
|
Time at which to set a keyframe on time-based
animation curves.
|
|
-useCurrentLockedWeights(-lw)
|
boolean
|
|
|
If we are setting a key over an existing key, use that key tangent's locked weight value for the new
locked weight value. Default is false
|
|
-value(-v)
|
float
|
|
|
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.
|
|