移動先: 概要 戻り値 関連項目 フラグ MEL の例

概要

setKeyframe [-animLayer string] [-attribute string] [-breakdown boolean] [-clip string] [-controlPoints boolean] [-float float] [-hierarchy string] [-identity] [-inTangentType string] [-insert] [-insertBlend boolean] [-minimizeRotation boolean] [-outTangentType string] [-shape boolean] [-time time] [-value float] [objects]

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 createmultiuse
キーフレームを設定するアトリビュート名です。
-insert(-i) create
所定の時間にキーを挿入し、アニメーション カーブのシェイプを保持します。注: 挿入されたキーの接線のタイプは固定されるため、 カーブ シェイプを保持できます。
-inTangentType(-itt) string create
このコマンドによって設定されるキーフレームのイン接線タイプです。 有効な値は 「spline」、「linear」、「fast」、「slow」、「flat」、「step」、「clamped」です。デフォルトは「keyTangent -q -g -inTangentType」です。
-outTangentType(-ott) string create
このコマンドによって設定されるキーフレームのアウト接線タイプです。 有効な値は 「spline」、「linear」、「fast」、「slow」、「flat」、「step」、「clamped」です。デフォルトは「keyTangent -q -g -outTangentType」です。
-hierarchy(-hi) string create
このコマンドが作用するオブジェクトを、 指定した(またはアクティブな)ターゲット オブジェクトからの相対位置に基づいて制御します。 有効な値は、「above」、「below」、「both」、「none」です。 デフォルトは「hierarchy -query」です。
-shape(-s) boolean create
トランスフォームの下にあるシェイプのアトリビュート(「controlPoints」以外)も考慮します。デフォルト: true
-controlPoints(-cp) boolean create
アトリビュートのリストにシェイプの制御点を含めるかどうかを 明示的に指定します(「-s」フラグを参照)。 デフォルト: false
-insertBlend(-ib) boolean create
true の場合、pairBlend ノードは、チャンネルをドライブする アニメーション カーブ以外のノードを持つチャンネルに挿入されるので、 そのチャンネルでアニメーションがブレンドされるようにできます。false の場合、これらのチャンネルではキーが挿入されません。このフラグを指定しないと、アニメーションのブレンド用の グローバル プリファレンスに基づいて、ブレンドが挿入されます。
-time(-t) time createmultiuse
時間ベースのアニメーション カーブ上でキーフレームを設定する時間。
-float(-f) float createmultiuse
浮動小数点数ベースのアニメーション カーブ上でキーフレームを設定する時間(float)。
-value(-v) float create
キーフレームを設定する値。値フラグを使用しても、シーンが再評価されるまではキー設定されたアトリビュートは指定した値に変更されません。したがって、アトリビュートの値を直ちに新しい値に更新したい場合は、キー設定に加えて setAttr コマンドを使用します。
-breakdown(-bd) boolean createqueryedit
キーのブレークダウン状態を設定します。デフォルトは false です。
-clip(-c) string create
新しいキーが指定したクリップに配置されるよう指定します。 キーフレーム設定されるオブジェクトがすでにクリップの一部である場合は、このフラグは無視されます。
-animLayer(-al) string create
新しいキーが指定したアニメーション レイヤに配置されるよう指定します。 キーフレーム設定されるオブジェクトがすでにレイヤの一部ではない場合、このフラグは無視されます。
-minimizeRotation(-mr) boolean create
回転の場合は、設定されたキーが必ず以前のキーから最短距離になるようにします。デフォルトは false です。
-identity(-id) create
アニメーション レイヤに ID キーを設定します。ID キーはアニメーション レイヤのエフェクトを無効にするものです。このフラグは、キー設定されるアトリビュートがアニメーション レイヤによりドライブされているときのみに効果を持ちます。

: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : 1 つのコマンドで複数回使用可能なフラグ

MEL の例

// Set a keyframe at the current time on all "keyable"
// attributes of the selected objects.
//
setKeyframe;

// Set a keyframe so that translateX has a value of 10
// at the current time, regardless of its current position
//
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.)
//
setKeyframe -attribute "translateX" -t 0sec -t 10sec nurbsSphere1 mysteryObject;