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