findKeyframe

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

概要

findKeyframe [-animation string] [-attribute string] [-controlPoints boolean] [-curve] [-float floatrange] [-hierarchy string] [-includeUpperBound boolean] [-index uint] [-shape boolean] [-time timerange] [-timeSlider] [-which string] [animatedObject]

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

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

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

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

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

• -time 10pal は、フレーム 10 のキーを意味します(PAL 形式)。
• -time 1.0sec -time 15ntsc -time 20 は、時間 1.0 秒、フレーム 15 (NTSC 形式)、時間 20 (現在定義されているグローバル時間単位)のキーを意味します。
• -time "10:20" は、10～20 の範囲(現在の時間単位、両方の値を含む)のすべてのキーを意味します。

• -time "10:" は、時間 10 (現在の時間単位)より後にあるすべてのキーを意味します。
• -time ":10" は、時間 10 (現在の時間単位)以前のすべてのキーを意味します。
• -time ":" は、すべてのキーを指定するための短い形式です。

• -index 0 は、各アニメーション カーブの最初のキーを意味します(インデックスは 0 ベースです)。
• -index 2 -index 5 -index 7 は、3 番目、6 番目、8 番目のキーを意味します。
• -index "1:5" は、各アニメーショ ン カーブの 2 番目、3 番目、4 番目、5 番目、6 番目のキーを意味します。

このコマンドは要求されたキーの時間(現在の単位で)を返します。相対的な方向の場合(次、前)、-time が指定されていなければ、現在のタイムを使用します。指定したオブジェクトがアニメートされない場合、このコマンドは現在のタイムを返します。

戻り値

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-animation(-an)	string
このコマンドが、自身が影響を与えるアニメーションを取得する場所です。有効な値は「objects」、「keys」、「keysOrObjects」で、既定は「keysOrObjects」です(詳細については、説明を参照してください)。
-attribute(-at)	string
選択するアトリビュートのリストです。 照会モードでは、このフラグに値が必要になります。
-controlPoints(-cp)	boolean
このフラグは、アトリビュートのリストにシェイプのコントロール ポイントを含めるかどうかを明示的に指定します(「-s」フラグを参照)。既定: false (「pasteKey」コマンドでは無効)。 照会モードでは、このフラグに値が必要になります。
-curve(-c)
選択したオブジェクトやアトリビュートをドライブする既存のカーブのリストを返します。このフラグを使用すると、which、index、floatRange、timeRange、と includeUpperBound フラグは無視されます。
-float(-f)	floatrange
時間ベースの animCurve上の時間ベースでないキー(またはキー レンジ)を固有に表す値です。有効な floatRange は、単一の値(-f 10)、または上下限をコロンで区切った文字列(-f "10:20")です。 照会モードでは、このフラグに値が必要になります。
-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
アニメーション カーブ上のキーのインデックス 照会モードでは、このフラグに値が必要になります。
-shape(-s)	boolean
トランスフォームの下にあるシェイプのアトリビュート(「controlPoints」以外)も考慮します。既定: true (「pasteKey」コマンドでは無効)。 照会モードでは、このフラグに値が必要になります。
-time(-t)	timerange
時間ベースのアニメーション カーブ上のキー(またはキー レンジ)を固有に表す時間です。有効な timeRange は、単一の値(-t 10)、または上下限をコロンで区切った文字列(-t "10:20")です。 照会モードでは、このフラグに値が必要になります。
-timeSlider(-ts)
タイム スライダに表示されているキー マークから次のキー タイムを選びます。このフラグが設定されると、-an/animation フラグは無視されます。
-which(-w)	string
キーの検索方法で、「next」、「previous」、「first」、または「last」を指定します。

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

MEL 例

// Find the next key from the current time, based upon the ticks
// displayed within the time slider
//
findKeyframe -timeSlider -which next;

// Find the next key for an object after time 25
//
findKeyframe -time 25 -which next nurbsCone1;

// Find the curves driving the nurbsCone1's rotateX attribute
//
findKeyframe -curve -at "rotateX" nurbsCone1;