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

概要

scaleKey [-animation string] [-attribute string] [-controlPoints boolean] [-float floatrange] [-floatPivot float] [-floatScale float] [-hierarchy string] [-includeUpperBound boolean] [-index uint] [-newEndFloat float] [-newEndTime time] [-newStartFloat float] [-newStartTime time] [-scaleSpecifiedKeys boolean] [-shape boolean] [-time timerange] [-timePivot time] [-timeScale float] [-valuePivot float] [-valueScale float] objects

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

このコマンドは、キーセット上に作用します。キーセットは、1 つまたは複数のアニメーション カーブ上の指定したタイム レンジ内のキー グループとして定義されます。

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

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

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

範囲の一方の値を省略した場合は、次の例のように、範囲が「無限であること」を意味します。

このコマンドは、指定した時間（またはタイム レンジ内）のキーフレームを取り込み、それらをスケールします。時間が指定されていない場合、アクティブ キーフレーム、または（アクティブなキーがない場合は）アクティブ オブジェクトのすべてのキーにスケールが適用されます。

戻り値

intスケールが実行されたカーブの数。

関連項目

copyKey, cutKey, findKeyframe, keyTangent, keyframe, keyframeOutliner, keyframeStats, pasteKey, setInfinity, snapKey

フラグ

animation, attribute, controlPoints, float, floatPivot, floatScale, hierarchy, includeUpperBound, index, newEndFloat, newEndTime, newStartFloat, newStartTime, scaleSpecifiedKeys, shape, time, timePivot, timeScale, valuePivot, valueScale
ロング ネーム（ショート ネーム） 引数型 プロパティ
-attribute(-at) string createmultiuse
選択するアトリビュートのリストです。

このフラグは照会モードでは値が必要になります。
-hierarchy(-hi) string create
階層展開オプションです。有効な値は、「above」、「below」、「both」、「none」です。（「pasteKey」コマンドでは無効）。

このフラグは照会モードでは値が必要になります。
-shape(-s) boolean create
トランスフォームの下にあるシェイプのアトリビュート（「controlPoints」以外）も考慮します。デフォルト: true（「pasteKey」コマンドでは無効）。

このフラグは照会モードでは値が必要になります。
-controlPoints(-cp) boolean create
このフラグは、アトリビュートのリストにシェイプの制御点を含めるかどうかを明示的に指定します（「-s」フラグを参照）。 デフォルト: false（「pasteKey」コマンドでは無効）。

このフラグは照会モードでは値が必要になります。
-index(-in) uint createmultiuse
アニメーション カーブ上のキーのインデックス

このフラグは照会モードでは値が必要になります。
-time(-t) timerange createmultiuse
時間ベースのアニメーション カーブ上の キー（またはキー レンジ）を固有に表す時間です。有効な timeRange は、単一の値（-t 10）、または上下限をコロンで区切った文字列（-t "10:20"）です。

このフラグは照会モードでは値が必要になります。
-float(-f) floatrange createmultiuse
時間ベースの animCurve上の時間ベースでないキー（またはキー レンジ）を固有に表す値です。有効な floatRange は、単一の値（-f 10）、または上下限をコロンで区切った文字列（-f "10:20"）です。

このフラグは照会モードでは値が必要になります。
-includeUpperBound(-iub) boolean create
-t/time または -f/float フラグがキーの範囲を表す場合に、範囲の上限のキーをキーセットに含めるかどうかを定義します。 デフォルト値: true。 このフラグは、-t/time フラグの引数が上下限が指定したタイム レンジである場合に限り有効です（「pasteKey」コマンドでこのフラグを使用するときに「replace」、「fitReplace」、「scaleReplace」などのオプションを指定すると、このフラグは、置き換えられるターゲット カーブの時間範囲のみを参照します。このフラグは、クリップボードからペーストされたカーブには影響しません）。
-animation(-an) string create
このコマンドが、自身が影響を与えるアニメーションを取得する場所です。有効な値は「objects」、「keys」、「keysOrObjects」で、デフォルトは「keysOrObjects」です（詳細については、説明を参照してください）。
-timeScale(-ts) float create
時間で入力するアニメーション カーブの時間軸に沿ってスケールする量です。
-floatScale(-fs) float create
浮動小数点数で入力するアニメーション カーブの X 軸に沿ってスケールする量です。
-valueScale(-vs) float create
値の軸に沿ってスケールする量です。
-timePivot(-tp) time create
時間で入力するアニメーション カーブの時間軸に沿ってピボットをスケールします。
-floatPivot(-fp) float create
浮動小数点数で入力するアニメーション カーブの X 軸に沿ってピボットをスケールします。
-valuePivot(-vp) float create
値の軸に沿ってピボットをスケールします。
-newStartTime(-nst) time create
時間で入力する接線をスケールした後のタイム レンジの開始位置です。
-newEndTime(-net) time create
時間で入力する接線をスケールした後のタイム レンジの終了位置です。
-newStartFloat(-nsf) float create
浮動小数点数で入力する接線をスケールした後の浮動小数点数範囲の開始位置です。
-newEndFloat(-nef) float create
浮動小数点数で入力する接線をスケールした後の浮動小数点数範囲の終了位置です。
-scaleSpecifiedKeys(-ssk) boolean create
指定したキーだけがスケールによる影響を受けるようにするかどうかを定義します。 false の場合、その他のキーがスケールによって調整されることがあります。デフォルトは true です。
: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : 1 つのコマンドで複数回使用可能なフラグ

MEL の例

// Scale keyframes from frame 10 to 20 of nurbsSphere1's translateX
// to fill frames 10 to 30.
//
scaleKey -time "10:20" -newStartTime 10 -newEndTime 30 -attribute tx nurbsSphere1;

// Scale all the animation of the active objects
// (range 0-30) to fill range 0 to 60.
//
scaleKey -time "0:30" -timeScale 2 -timePivot 0;