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

概要

selectKey [-addTo] [-animation string] [-attribute string] [-clear] [-controlPoints boolean] [-float floatrange] [-hierarchy string] [-inTangent] [-includeUpperBound boolean] [-index uint] [-keyframe] [-outTangent] [-remove] [-replace] [-shape boolean] [-time timerange] [-toggle] [-unsnappedKeys float] [targetList]

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

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

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

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

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

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

このコマンドは、キーフレームおよび/またはキーフレームの接線をアクティブ リストに配置します。

戻り値

intキーが選択(または選択解除)されたカーブの数です。

関連

select, selectMode, selectPref, selectPriority, selectType, selectedNodes

フラグ

addTo, animation, attribute, clear, controlPoints, float, hierarchy, inTangent, includeUpperBound, index, keyframe, outTangent, remove, replace, shape, time, toggle, unsnappedKeys
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-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」です(詳細については、説明を参照してください)。
-keyframe(-k) create
キーフレームだけを選択します(-in/-out と組み合わせて使用することはできません)。
-inTangent(-it) create
指定したタイム レンジのキーフレームのイン接線を選択します。
-outTangent(-ot) create
指定したタイム レンジのキーフレームのアウト接線を選択します。
-addTo(-add) create
キーフレーム/接線の現在のセレクションに追加します。
-remove(-rm) create
キーフレーム/接線の現在のセレクションから除去します。
-replace(-r) create
キーフレーム/接線の現在のセレクションを置き換えます。
-toggle(-tgl) create
指定したキーセットの選択状態を切り替えます。
-clear(-cl) create
アクティブ リストからすべてのキーフレームと接線を除去します。
-unsnappedKeys(-uk) float create
指定した数値の倍数ではない時間を持つキーだけを選択します。

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

MEL 例

// Select all translateX keyframes on nurbsSphere1 in the range 10 to 20.
//
selectKey -time "10:20" -attribute translateX nurbsSphere1;

// select all the animation of the active objects, range 0-30
//
selectKey -time "0:30";