ジャンプ先: 概要. 戻り値.
関連項目. フラグ. Python 例.
setKeyframe( [objects] , [animLayer=string], [attribute=string], [breakdown=boolean], [clip=string], [controlPoints=boolean], [float=float], [hierarchy=string], [identity=boolean], [inTangentType=string], [insert=boolean], [insertBlend=boolean], [minimizeRotation=boolean],
[noResolve=boolean], [outTangentType=string], [shape=boolean], [time=time], [useCurrentLockedWeights=boolean],
[value=float])
注意:
オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。
setKeyframe は 「元に戻す」が可能、「照会」が可能、「編集」が可能 です。
このコマンドは、指定したオブジェクト （コマンド ラインでオブジェクトが指定されていない場合は、
アクティブなオブジェクト）にキーフレームを作成します。 新しいキーフレームのデフォルトの時間はカレント タイムです。
この動作は、コマンド ラインで「-t」フラグを使用するとオーバーライドされます。
キーフレームのデフォルト値はキーフレームを設定するアトリビュートのカレント値です。この動作は、コマンド
ラインで「-v」フラグを使用するとオーバーライドされます。 入力アトリビュートとして「time」を持たないアニメーション
カーブ（すなわち単位がないアニメーション
カーブ）にキーフレームを設定するときは、「-f/-float」を使用して、キーフレームを設定する値を単位なしで指定します。 -time
および -float フラグは、1 つのコマンドに統合される場合もあります。
このコマンドは、特定の時間の特定のアトリビュートを適切に評価するために、ディペンデンシー グラフのリレーションを設定します。
| int |
このコマンドで設定されたキーフレームの数。 |
戻り値の型は照会モードでは照会フラグが基になります。
autoKeyframe, findKeyframe, setDrivenKeyframe, setKeyPath
animLayer, attribute, breakdown, clip,
controlPoints, float, hierarchy,
identity, inTangentType, insert, insertBlend, minimizeRotation, noResolve, outTangentType, shape, time, useCurrentLockedWeights,
value
| ロング ネーム（ショート ネーム） |
引数型 |
プロパティ |
attribute(at) |
string |
  |
|
|
insert(i) |
boolean |
|
|
所定の時間にキーを挿入し、アニメーション カーブのシェイプを保持します。注: 挿入されたキーの接線のタイプは固定されるため、
カーブ シェイプを保持できます。 |
|
inTangentType(itt) |
string |
|
|
このコマンドによって設定されるキーフレームのイン接線タイプです。
有効な値は、「spline」、「linear」、「fast」、「slow」、「flat」、「stepped」、「step
next」、「fixed」、「clamped」、「plateau」です。 デフォルトは「keyTangent -q -g
-inTangentType」です。 |
|
outTangentType(ott) |
string |
|
|
このコマンドによって設定されるキーフレームのアウト接線タイプです。
有効な値は、「spline」、「linear」、「fast」、「slow」、「flat」、「stepped」、「step
next」、「fixed」、「clamped」、「plateau」です。 デフォルトは「keyTangent -q -g
-outTangentType」です。 |
|
hierarchy(hi) |
string |
|
|
このコマンドが作用するオブジェクトを、 指定した（またはアクティブな）ターゲット
オブジェクトからの相対位置に基づいて制御します。 有効な値は、「above」、「below」、「both」、「none」です。
デフォルトは「hierarchy -query」です。 |
|
shape(s) |
boolean |
|
|
トランスフォームの下にあるシェイプのアトリビュート（「controlPoints」以外）も考慮します。デフォルト:
true |
|
controlPoints(cp) |
boolean |
|
|
アトリビュートのリストにシェイプの制御点を含めるかどうかを 明示的に指定します（「-s」フラグを参照）。 デフォルト:
false |
|
insertBlend(ib) |
boolean |
|
|
true の場合、pairBlend ノードは、チャンネルをドライブする アニメーション
カーブ以外のノードを持つチャンネルに挿入されるので、 そのチャンネルでアニメーションがブレンドされるようにできます。false
の場合、これらのチャンネルではキーが挿入されません。このフラグを指定しないと、アニメーションのブレンド用の グローバル
プリファレンスに基づいて、ブレンドが挿入されます。 |
|
time(t) |
time |
|
|
時間ベースのアニメーション カーブ上でキーフレームを設定する時間。 |
|
float(f) |
float |
|
|
浮動小数点数ベースのアニメーション カーブ上でキーフレームを設定する時間（float）。 |
|
value(v) |
float |
|
|
キーフレームを設定する値。値フラグを使用しても、シーンが再評価されるまではキー設定されたアトリビュートは指定した値に変更されません。したがって、アトリビュートの値を直ちに新しい値に更新したい場合は、キー設定に加えて
setAttr コマンドを使用します。 |
|
breakdown(bd) |
boolean |
  |
|
キーのブレークダウン状態を設定します。デフォルトは false です。 |
|
clip(c) |
string |
|
|
新しいキーが指定したクリップに配置されるよう指定します。
キーフレーム設定されるオブジェクトがすでにクリップの一部である場合は、このフラグは無視されます。 |
|
animLayer(al) |
string |
|
|
新しいキーが指定したアニメーション レイヤに配置されるよう指定します。
キーフレーム設定されるオブジェクトがすでにレイヤの一部ではない場合、このフラグは無視されます。 |
|
minimizeRotation(mr) |
boolean |
|
|
回転の場合は、設定されたキーが必ず以前のキーから最短距離になるようにします。デフォルトは false です。 |
|
identity(id) |
boolean |
|
|
アニメーション レイヤに ID キーを設定します。ID キーはアニメーション
レイヤのエフェクトを無効にするものです。このフラグは、キー設定されるアトリビュートがアニメーション
レイヤによりドライブされているときのみに効果を持ちます。 |
|
noResolve(nr) |
boolean |
|
|
-value フラグを一緒に使用すると、アニメーション レイヤ全体の値を解決しようとせず、指定した値をアニメーション
カーブに直接設定します。 |
|
useCurrentLockedWeights(
lw) |
boolean |
|
|
既存のキーにキーを設定する場合、新しいロックされたウェイト値に、そのキー接線のロックされたウェイト値を使用します。デフォルトは
false です。 |
|
| : コマンドの作成モードで使用可能なフラグ |
: コマンドの編集モードで使用可能なフラグ |
| : コマンドの照会モードで使用可能なフラグ |
: タプルまたはリストとして渡された複数の引数を持てるフラグ |
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'] )