ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.
cutKey(
[targetList]
, [animation=string], [attribute=string], [clear=boolean], [controlPoints=boolean], [float=floatrange], [hierarchy=string], [includeUpperBound=boolean], [index=uint], [option=string], [selectKey=boolean], [shape=boolean], [time=timerange])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
cutKey は、取り消し可能、照会不可能、および 編集不可能 です。
このコマンドは、キーセット上に作用します。キーセットは、1 つまたは複数のアニメーション カーブ上の指定したタイム レンジ内のキー グループとして定義されます。
キーセットを構成するアニメーション カーブは、「-animation」フラグの値に依存します。
-
keysOrObjects:
- コマンド ラインにターゲット オブジェクトまたは -attribute フラグが表示されていない場合は任意のアクティブ キー
- アクティブ キーが存在しない場合は、コマンド ラインの 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 番目のキーを意味します。
cutKey コマンドは、指定したターゲットからカーブ セグメントの階層をカットし、クリップボードに置きます。pasteKey コマンドを使うと、それらのカーブがほかのオブジェクトへペーストされます。
クリップボードにあるカットしたカーブのシェイプ、ソース アニメーション カーブへの cutKey コマンドの影響は、指定した cutKey の[「-option」によって異なります。以下のオプションについては、それぞれ例を用いて説明します。すべての説明において、ソース アニメーション カーブ(キーのカット元)には、10、15、20、25、30 の 5 つのキーフレームがあるものとします。
TbaseKeySetCmd.h
- cutKey -t "12:22" -option keys
- 時間 15 および 20 のキーフレームが除去されます。その他のすべてのキーは変更されません。
- 5 フレームのアニメーション カーブがキーセット クリップボードに置かれます。
- cutKey -t "12:22" -option keysCollapse
- タイム 15 と 20 のキーフレームを除去します。タイム 20 より後のすべてのキーが 5 フレームずつ左に移動し、値はすべてそのまま残ります。
- 5 フレームのアニメーション カーブがキーセット クリップボードに置かれます。
- cutKey -t "12:22" -option keysConnect
- タイム 15 と 20 のキーフレームを除去します。タイム 20 より後にあるすべてのキーが 5 フレームずつ左に移動し、以前はタイム 25 にあったキーがタイム 15 にあったキーの値に置かれます。
- 5 フレームのアニメーション カーブがキーセット クリップボードに置かれます。
- cutKey -t "12:22" -option curve
- タイム 15 と 20 のキーフレームを除去します。タイム 12 と 22 にキーが挿入されます。
- 10 フレームのアニメーション カーブがキーセット クリップボードに置かれます。
- cutKey -t "12:22" -option curveCollapse
- タイム 15 と 20 のキーフレームを除去します。タイム 12 と 22 にキーが挿入されます。タイム 22 より後のすべてのキーが 10 フレームずつ左に移動し、値はそのまま残ります。
- 10 フレームのアニメーション カーブがキーセット クリップボードに置かれます。
- cutKey -t "12:22" -option curveConnect
- タイム 15 と 20 のキーフレームを除去します。タイム 12 と 22 にキーが挿入されます。タイム 22 より後のすべてのキーが 10 フレームずつ左に移動し、タイム 12 に挿入されたキーがタイム 22 に新しく挿入されたキーと置き換えられます。
- 10 フレームのアニメーション カーブがキーセット クリップボードに置かれます。
- cutKey -t "12:22" -option areaCollapse
- タイム 15 と 20 のキーフレームを除去します。タイム 22 より後のすべてのキーが 10 フレームずつ左に移動し、値はそのまま残ります。
- 10 フレームのアニメーション カーブがキーセット クリップボードに置かれます。
copyKey, findKeyframe, keyTangent, keyframe, keyframeOutliner, keyframeStats, pasteKey, scaleKey, setInfinity, snapKey
animation, attribute, clear, controlPoints, float, hierarchy, includeUpperBound, index, option, selectKey, shape, time
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
# Cut keyframes from frame 10 to 20 of cube1's "Translate X" attribute
#
cmds.cutKey( 'cube1', time=(10,20), attribute='translateX', option="keys" )
# Cut from all active objects all keys in the range 0 to 60
#
cmds.cutKey( time=(0,60) )