keyframe

ジャンプ先: 概要. 戻り値. 関連. フラグ. MEL 例.

概要

keyframe [-absolute] [-adjustBreakdown boolean] [-animation string] [-attribute string] [-breakdown boolean] [-clipTime time time float] [-controlPoints boolean] [-eval] [-float floatrange] [-floatChange float] [-hierarchy string] [-includeUpperBound boolean] [-index uint] [-indexValue] [-keyframeCount] [-lastSelected] [-name] [-option string] [-relative] [-selected] [-shape boolean] [-tickDrawSpecial boolean] [-time timerange] [-timeChange time] [-valueChange float] [objects]

keyframe は、取り消し可能、照会可能、および編集可能です。

キーセットを構成するアニメーション カーブは、「-animation」フラグの値に依存します。

• keysOrObjects:
  1. コマンド ラインにターゲット オブジェクトまたは -attribute フラグが表示されていない場合は任意のアクティブ キー
  2. アクティブ キーが存在しない場合は、コマンド ラインの targetList として指定されているオブジェクトのキーフレーム可能なすべてのアトリビュートに接続されたすべてのアニメーション カーブ
• keys: アクティブなキーまたは接線のみに作用します。アクティブなキーまたは接線がない場合は、何も行いません。
• objects: 指定したオブジェクトのみに作用します。オブジェクトが指定されていない場合は、何も行いません。

-animation フラグを使用して、「translateX」など attributeName という形式の引数を取る、多目的な -attribute フラグによって固有に識別されるカーブをオーバーライドすることができます。

アニメーション カーブ上の各キーは、カーブの時間値またはインデックスによって識別されます。時間とインデックスは、単独にあるいはリストの一部または範囲として指定することができます(例を参照)。

このコマンドは、指定されたオブジェクトまたはパラメータ カーブにおけるキーの時間または値を編集します。

別途、「-query」フラグで指定されていない限り、このコマンドは既定でキーフレームを編集します。

戻り値

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-absolute(-a)
移動量は絶対値です。
-adjustBreakdown(-abd)	boolean
false のときは、キーを移動してもブレークダウン タイミングは保持されません。true (既定)のときは、ブレークダウン タイミング リレーションが保持されるように調整されます。
-animation(-an)	string
このコマンドが、自身が影響を与えるアニメーションを取得する場所です。有効な値は「objects」、「keys」、「keysOrObjects」で、既定は「keysOrObjects」です(詳細については、説明を参照してください)。
-attribute(-at)	string
選択するアトリビュートのリストです。 照会モードでは、このフラグに値が必要になります。
-breakdown(-bd)	boolean
キーのブレークダウン状態を設定します。整数を返します。既定は false です。キーのブレークダウン状態は、-tc や -fc フラグを使ったキーの移動コマンドでは設定できません。
-clipTime(-ct)	time time float
オフセット、ピボット、およびスケールを使用してキーを挿入する最終的な時間を変更します。
-controlPoints(-cp)	boolean
このフラグは、アトリビュートのリストにシェイプのコントロール ポイントを含めるかどうかを明示的に指定します(「-s」フラグを参照)。既定: false(「pasteKey」コマンドでは無効)。 照会モードでは、このフラグに値が必要になります。
-eval(-ev)
入力接続と無関係に、-t/time または -f/float フラグで指定される時間で評価されるときのアニメーション カーブの値を返します。他の照会フラグと一緒に使ったり、タイム レンジ(-t "5:10")と共に使うことはできません。コマンド ラインに -t または -f フラグが使われていないとき、eval は現在のタイムに照会されます。照会すると float[] を返します。
-float(-f)	floatrange
時間ベースの animCurve 上の時間ベースでないキー(またはキー レンジ)を固有に表す値です。有効な floatRange は、単一の値(-f 10)、または上下限をコロンで区切った文字列(-f "10:20")です。 照会モードでは、このフラグに値が必要になります。
-floatChange(-fc)	float
x (float)軸に沿ったキーの(非時間入力アニメーション カーブ上での)移動量(-relative で)または移動場所(-absolute で)を指定します。照会すると float[] を返します。
-hierarchy(-hi)	string
階層展開オプションです。有効な値は、「above」、「below」、「both」、「none」です。(「pasteKey」コマンドでは無効)。 照会モードでは、このフラグに値が必要になります。
-includeUpperBound(-iub)	boolean
-t/time または -f/float フラグがキーの範囲を表す場合に、範囲の上限のキーをキーセットに含めるかどうかを定義します。既定値: true。このフラグは、-t/time フラグの引数が上下限が指定したタイム レンジである場合に限り有効です（「pasteKey」コマンドでこのフラグを使用するときに「replace」、「fitReplace」、「scaleReplace」などのオプションを指定すると、このフラグは、置き換えられるターゲット カーブの時間範囲のみを参照します。このフラグは、クリップボードからペーストされたカーブには影響しません）。
-index(-in)	uint
アニメーション カーブ上のキーのインデックス 照会モードでは、このフラグに値が必要になります。
-indexValue(-iv)
キーのインデックスに対して整数を返す照会専用のフラグです。
-keyframeCount(-kc)
ターゲット用に見つかったキーの数に対して整数を返します。
-lastSelected(-lsl)
このフラグが照会で使われた場合、最後に選択したキーに対して要求された値を返します。
-name(-n)
指定したノード、アトリビュート、キーのアニメーション カーブの名前を返します。
-option(-o)	string
有効な値は、「move」、「insert」、「over」、「segmentOver」です。キーに「move」を設定しても、そのキーは前後でほかのキーを越えては移動しません。キーを「insert」すると、(-timeChange の値に応じて)その前後にあるキーがすべて、同等の量、移動します。キーを「over」すると、このキーは(他のキーがその場所に既に存在しない限り)いつでも移動することができます。複数のキーのセットを「segmentOver」すると(このオプションは、複数のキーを移動する場合のみ、明らかなエフェクトを生み出します)、タイム レンジを指定しない限り、(時間的に)最初のキーと、最後のキーにより、セグメントが定義されます。その後、このセグメントは他のキーの上に移動できるようになり、このセグメントのための余地を作るために、キーは移動します。
-relative(-r)
移動量は、キーの現行位置を基準にした相対値です。
-selected(-sl)
このフラグが照会で使われた場合、どんなアクティブなキーに対しても要求された値を返します。
-shape(-s)	boolean
トランスフォームの下にあるシェイプのアトリビュート(「controlPoints」以外)も考慮します。既定: true(「pasteKey」コマンドでは無効)。 照会モードでは、このフラグに値が必要になります。
-tickDrawSpecial(-tds)	boolean
タイム スライダの表示がキー マークに変わると、このキーに特殊な描画状態が設定されます。
-time(-t)	timerange
時間ベースのアニメーション カーブ上のキー(またはキー レンジ)を固有に表す時間です。単一のフレームまたはフレーム範囲の設定方法については、以下のコード例を参照してください。 照会モードでは、このフラグに値が必要になります。
-timeChange(-tc)	time
x (時間)軸に沿ったキーの(時間入力アニメーション カーブ上での)移動量(-relative で)または移動場所(-absolute で)を指定します。照会すると float[] を返します。
-valueChange(-vc)	float
y (値)軸に沿ったキーの移動量(-relative で)または移動場所(-absolute で)を指定します。照会すると float[] を返します。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	コマンド内でフラグを複数回使用できます。

MEL 例

// Keys on animation curves are identified by either
// their time values or their indices.  Times and indices can
// be given individually or as part of a list or range.

// -time 10pal means the key at frame 10 (PAL format).
// -time 1.0sec -time 15ntsc -time 20 means the keys at time 1.0 second, frame 15 (in NTSC format), and time 20 (in the currently defined global time unit).
// -time "10:20" means all keys in the range from 10 to 20, inclusive, in the current time unit.
// Omitting one end of a range means "go to infinity", as in the following examples:
// -time "10:" means all keys from time 10 (in the current time unit) onwards.
// -time ":10" means all keys up to (and including) time 10 (in the current time unit).
// -time ":" is a short form to specify all keys.
// -index 0 means the first key of each animation curve. (Indices are 0-based.)
// -index 2 -index 5 -index 7 means the 3rd, 6th, and 8th keys.
// -index "1:5" means the 2nd, 3rd, 4th, 5th, and 6th keys of each animation curve.

// Two ways to find out how many keys there are on the
// paramCurve connected to surface1.translateX;
//
keyframe -attribute translateX -query -keyframeCount surface1;
keyframe -query -keyframeCount surface1.translateX;

// Query all keyframes of object "polySurface1"
// with in the time range 0 to 20.
//
keyframe -time "0:20" -query -timeChange -valueChange surface1

// Query just the time of the first key in the
// "Translate X" parameter curve.  Note that the indices
// are 0-based.
//
keyframe -index 0  -query "surface1.translateX"

// Shift all the active object's keys in the range 10-20
// by one (current) time unit (frame, second, etc.)
//
keyframe -edit -relative -timeChange 1 -time "10:20";

// Two ways to move all keys at time 10 of
// the active object to time 12.  Note that "-absolute"
// is the default.
//
keyframe -time 10 -timeChange 12;
keyframe -time 10 -absolute -timeChange 12;

// Set the 2nd keyframe of cube1's Translate X parameter
// curve to be 10.25 at time 1.5 seconds.
//
keyframe -edit -index 1 -timeChange 1.5sec -valueChange 10.25 "surface1.translateX";

// Evaluate the animCurve feeding into nurbsCone1's translateX attribute at time 3
//
keyframe -at tx -t 3 -q -eval nurbsCone1;

// Query the times of the active keys on attribute translateX of nurbsCone1
//
keyframe -at tx  -sl -q -tc nurbsCone1;

// How many keys are selected on nurbsCone1?
//
keyframe  -sl -q  -kc nurbsCone1;

// Here's a script to print out all a cone's animCurves that have
// keys selected.  Each animCurve is followed by a list of times
// for the selected keys.  The result of this script is:
//     nurbsCone1_translateX: 5
//     nurbsCone1_translateY: 12
//     nurbsCone1_translateZ: 4 14
//
string $myCone[] = `cone`;
setKeyframe -t 0 -t 5 -t 10 -at tx -v 5 $myCone[0];
setKeyframe -t 2 -t 7 -t 12 -at ty -v 10 $myCone[0];
setKeyframe -t 4 -t 9 -t 14 -at tz -v 15 $myCone[0];
selectKey -t 5 -t 12 -t 4;
selectKey -animation objects -add -t 14;

float $keyTimes[];
string $nodes[] = `keyframe -q -name $myCone`;
for( $node in $nodes ) {
    $keyTimes = `keyframe -sl -q -tc $node`;
    print ($node + ": ");
    for( $time in $keyTimes ) {
        print( $time + " " );
    }
    print "\n";
}

// For the above sample script, the last selected key is
// nurbsCone1_translateZ: 14.  The following may be used to query
// the values for that key
//
keyframe -query -lastSelected -name;
keyframe -query -lastSelected -timeChange;
keyframe -query -lastSelected -valueChange;