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] [-noResolve boolean] [-outTangentType string] [-shape boolean] [-time time] [-useCurrentLockedWeights boolean] [-value float] [objects]

setKeyframe は 「元に戻す」が可能、「照会」が可能、「編集」が可能 です。

戻り値

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

関連項目

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
-attribute(-at)	string
キーフレームを設定するアトリビュート名です。
-insert(-i)
所定の時間にキーを挿入し、アニメーション カーブのシェイプを保持します。注: 挿入されたキーの接線のタイプは固定されるため、 カーブ シェイプを保持できます。
-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)
アニメーション レイヤに ID キーを設定します。ID キーはアニメーション レイヤのエフェクトを無効にするものです。このフラグは、キー設定されるアトリビュートがアニメーション レイヤによりドライブされているときのみに効果を持ちます。
-noResolve(-nr)	boolean
-value フラグを一緒に使用すると、アニメーション レイヤ全体の値を解決しようとせず、指定した値をアニメーション カーブに直接設定します。
-useCurrentLockedWeights( -lw)	boolean
既存のキーにキーを設定する場合、新しいロックされたウェイト値に、そのキー接線のロックされたウェイト値を使用します。デフォルトは false です。

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: 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;