setKeyframe

移動先: 概要 戻り値 関連項目 フラグ 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 つのコマンドに統合される場合もあります。

このコマンドは、特定の時間の特定のアトリビュートを適切に評価するために、ディペンデンシー グラフのリレーションを設定します。

戻り値

戻り値の型は照会モードでは照会フラグが基になります。

関連項目

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
-attribute(-at)	string
キーフレームを設定するアトリビュート名です。
-insert(-i)
所定の時間にキーを挿入し、アニメーション カーブのシェイプを保持します。注: 挿入されたキーの接線のタイプは固定されるため、 カーブ シェイプを保持できます。
-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)
アニメーション レイヤに 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;