ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.
keyTangent(
[objects]
, [absolute=boolean], [animation=string], [attribute=string], [controlPoints=boolean], [float=floatrange], [g=boolean], [hierarchy=string], [inAngle=angle], [inTangentType=string], [inWeight=float], [includeUpperBound=boolean], [index=uint], [ix=float], [iy=float], [lock=boolean], [outAngle=angle], [outTangentType=string], [outWeight=float], [ox=float], [oy=float], [pluginTangentTypes=string], [relative=boolean], [shape=boolean], [stepAttributes=boolean], [time=timerange], [unify=boolean], [weightLock=boolean], [weightedTangents=boolean])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
keyTangent は、取り消し可能、照会可能、および編集可能です。
このコマンドは、キーセット上に作用します。キーセットは、1 つまたは複数のアニメーション カーブ上の指定したタイム レンジ内のキー グループとして定義されます。
キーセットを構成するアニメーション カーブは、「-animation」フラグの値に依存します。
-
keysOrObjects:
- コマンド ラインにターゲット オブジェクトまたは -attribute フラグが表示されていない場合は任意のアクティブ キー
- アクティブ キーが存在しない場合は、コマンド ラインの targetList として指定されているオブジェクトのキーフレーム可能なすべてのアトリビュートに接続されたすべてのアニメーション カーブ
-
keys: アクティブなキーまたは接線のみに作用します。アクティブなキーまたは接線がない場合は、何も行いません。
-
objects: 指定したオブジェクトのみに作用します。オブジェクトが指定されていない場合は、何も行いません。
-animation フラグを使用して、「translateX」など attributeName という形式の引数を取る、多目的な -attribute フラグによって固有に識別されるカーブをオーバーライドすることができます。
アニメーション カーブ上の各キーは、カーブの時間値またはインデックスによって識別されます。時間とインデックスは、単独にあるいはリストの一部または範囲として指定することができます(例を参照)。
このコマンドは、キーセットにあるキーフレームの接線プロパティを編集/照会します。このコマンドは、新規に作成したキーフレームの既定接線タイプを編集したり照会するためにも使います(この既定をオーバーライドする方法の詳細については、setKeyframe コマンドを参照してください)。
接線は、アニメーション カーブのシェイプを管理するために役立ち、キー間の補間に影響を及ぼします。接線角度は、カーブがキーを離れる(または入る)ときにカーブがとる方向を指定します。接線ウェイトは、カーブが次のキーに向かって開始する前にこのカーブに接線角度が影響する度合いを指定します。
Maya は、x 値と y 値で内部的に接線を表します。接線角度やウェイト、内部 x 値、内部 y 値の間の関係の説明については、MFnAnimCurve 用の API のマニュアルを参照してください。
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
copyKey, cutKey, findKeyframe, keyframe, keyframeOutliner, keyframeStats, pasteKey, scaleKey, setInfinity, snapKey
absolute, animation, attribute, controlPoints, float, g, hierarchy, inAngle, inTangentType, inWeight, includeUpperBound, index, ix, iy, lock, outAngle, outTangentType, outWeight, ox, oy, pluginTangentTypes, relative, shape, stepAttributes, time, unify, weightLock, weightedTangents
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
# Keys on animation curves are identified by either
# their time values or their indices. Times and indices can
# be given as a range or list of ranges.
# time=('10pal','10pal') means the key at frame 10 (PAL format).
# time=[(1.0,1.0),('15ntsc','15ntsc'),(20,20)] means the keys at time 1.0 second, frame 15 (in NTSC format), and time 20 (in the currently defined global time unit).
# time=(10,20) means all keys in the range from 10 to 20, inclusive, in the current time unit.
# Omitting one end of a range means "go to infinity", as in the following examples:
# time=(10,) means all keys from time 10 (in the current time unit) onwards.
# time=(0,10) means all keys up to (and including) time 10 (in the current time unit).
# time=() is a short form to specify all keys.
# index=(0,0) means the first key of each animation curve. (Indices are 0-based.)
# index=[(2,2),(5,5),(7,7)] means the 3rd, 6th, and 8th keys.
# index=(1,5) means the 2nd, 3rd, 4th, 5th, and 6th keys of each animation curve.
# Set the in-tangent to spline for all keyframes
# on an object between 1 and 2 seconds.
#
cmds.keyTangent( 'nurbsSphere1', inTangentType='spline', time=('0sec','2sec') )
# Set the angle and value for the out tangent of the
# keyframe at time 5 of nurbsSphere1's translateX.
#
cmds.keyTangent( 'nurbsSphere1', edit=True, time=(5,5), attribute='translateX', absolute=True, outAngle=10, outWeight=5 )