ジャンプ先: 概要. 戻り値. 関連. フラグ. 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」フラグの値に依存します。
-animation フラグを使用して、「translateX」など attributeName という形式の引数を取る、多目的な -attribute フラグによって固有に識別されるカーブをオーバーライドすることができます。
アニメーション カーブ上の各キーは、カーブの時間値またはインデックスによって識別されます。時間とインデックスは、単独にあるいはリストの一部または範囲として指定することができます。
このコマンドを使うと、指定したターゲットからカーブ セグメントの階層がコピーされ、クリップボードに貼り付けられます。元のカーブは変更されません。pasteKey コマンドを使うと、それらのカーブがほかのオブジェクトへペーストされます。
クリップボードにあるコピーされたカーブのシェイプは、指定した copyKey の「-option」によって異なります。以下のオプションについては、それぞれ例を用いて説明します。すべての説明において、ソース アニメーション カーブ(キーのコピー元)には、10、15、20、25、30 の 5 つのキーフレームがあるものとします。
TbaseKeySetCmd.h
int | コピーしたアニメーション カーブの数。 |
ロング ネーム(ショート ネーム) | 引数タイプ | プロパティ | ||
---|---|---|---|---|
animLayer(al)
|
string
|
![]() |
||
|
||||
animation(an)
|
string
|
![]() |
||
|
||||
attribute(at)
|
string
|
![]() ![]() |
||
|
||||
clipboard(cb)
|
string
|
![]() |
||
|
||||
controlPoints(cp)
|
boolean
|
![]() |
||
|
||||
float(f)
|
floatrange
|
![]() ![]() |
||
|
||||
forceIndependentEulerAngles(fea)
|
boolean
|
![]() |
||
|
||||
hierarchy(hi)
|
string
|
![]() |
||
|
||||
includeUpperBound(iub)
|
boolean
|
![]() |
||
|
||||
index(index)
|
uint
|
![]() ![]() |
||
|
||||
option(o)
|
string
|
![]() |
||
|
||||
shape(s)
|
boolean
|
![]() |
||
|
||||
time(t)
|
timerange
|
![]() ![]() |
||
|
![]() |
![]() |
![]() |
![]() |
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) )