移動先: 概要 戻り値 関連項目 フラグ 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], [outTangentType=string], [shape=boolean], [time=time], [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, outTangentType, shape, time, value
| ロング ネーム（ショート ネーム） |
引数型 |
プロパティ |
attribute(at)
|
string
|
 
|
|
|
insert(i)
|
boolean
|
|
|
所定の時間にキーを挿入し、アニメーション カーブのシェイプを保持します。注: 挿入されたキーの接線のタイプは固定されるため、
カーブ シェイプを保持できます。
|
|
inTangentType(itt)
|
string
|
|
|
このコマンドによって設定されるキーフレームのイン接線タイプです。
有効な値は 「spline」、「linear」、「fast」、「slow」、「flat」、「step」、「clamped」です。デフォルトは「keyTangent -q -g -inTangentType」です。
|
|
outTangentType(ott)
|
string
|
|
|
このコマンドによって設定されるキーフレームのアウト接線タイプです。
有効な値は 「spline」、「linear」、「fast」、「slow」、「flat」、「step」、「clamped」です。デフォルトは「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 キーはアニメーション レイヤのエフェクトを無効にするものです。このフラグは、キー設定されるアトリビュートがアニメーション レイヤによりドライブされているときのみに効果を持ちます。
|
|
|
: コマンドの作成モードで使用可能なフラグ
|
: コマンドの編集モードで使用可能なフラグ
|
|
: コマンドの照会モードで使用可能なフラグ
|
: タプルまたはリストとして渡された複数の引数を持てるフラグ
|
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'] )