移動先: 概要 戻り値 関連項目 フラグ Python の例
setDrivenKeyframe(
[objects]
, [attribute=string], [controlPoints=boolean], [currentDriver=string], [driven=boolean], [driver=boolean], [driverValue=float], [hierarchy=string], [inTangentType=string], [insert=boolean], [insertBlend=boolean], [outTangentType=string], [shape=boolean], [value=float])
注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。
setDrivenKeyframe は「元に戻す」が可能、「照会」が可能、「編集」が可能です。
このコマンドは、ドリブン キーフレームを設定します。ドリブン キーフレームは、通常のキーフレームと似ています。ただし、標準キーフレームではグラフ エディタ（Graph Editor）の X 軸が常に時間に設定されているのに対して、
drivenkeyframe の場合、グラフ エディタの X 軸としてユーザが任意のアトリビュートを選択することができます。
たとえば、蛇口からの水の放出にキーフレームを設定して、
蛇口のハンドルを y 軸中心に回転したときに蛇口から水を放出させることができます。
この例では、蛇口からの水の放出はドリブン アトリビュートと呼ばれます。
ハンドルの回転はドライバと呼ばれます。setDrivenKeyframe を使用して蛇口からの水の放出とハンドルの回転との間に
リレーションを設定したら、グラフ エディタを使用して、
キーフレーム設定されたオブジェクトのアニメーション カーブを修正するのと同じように、
アトリビュート間のリレーションを修正します。
単一のドライバによってドライブされるアトリビュートの場合、
ディペンデンシー グラフは次のようにコネクトされます。
ドライバ アトリビュート ---> アニメーション カーブ ---> ドリブン アトリビュート
ドリブン キーフレームは複数のドライバを使用して設定できます。複数のドライバによるエフェクトは、ブレンド ノードによって結合されます。
戻り値の型は照会モードでは照会フラグが基になります。
autoKeyframe, findKeyframe, setKeyPath, setKeyframe
attribute, controlPoints, currentDriver, driven, driver, driverValue, hierarchy, inTangentType, insert, insertBlend, outTangentType, shape, value
| ロング ネーム（ショート ネーム） |
引数型 |
プロパティ |
attribute(at)
|
string
|
 
|
|
|
insert(i)
|
boolean
|
|
|
所定の時間にキーを挿入し、アニメーション カーブのシェイプを保持します。注: 挿入されたキーの接線のタイプは固定されるため、
カーブ シェイプを保持できます。
|
|
inTangentType(itt)
|
string
|
|
|
このコマンドによって設定されるキーフレームのイン接線タイプです。
有効な値は 「spline」、「linear」、「fast」、「slow」、「flat」、「step」、「clamped」です。デフォルトは「keyTangent -q -g -inTangentType」です。
|
|
outTangentType(ott)
|
string
|
|
|
このコマンドによって設定されるキーフレームのアウト接線タイプです。
有効な値は 「spline」、「linear」、「fast」、「slow」、「flat」、「step」、「clamped」です。デフォルトは「keyTangent -q -g -outTangentType」です。
|
|
hierarchy(hi)
|
string
|
|
|
このコマンドが作用するオブジェクトを、
指定した（またはアクティブな）ターゲット オブジェクトからの相対位置に基づいて制御します。
有効な値は、「above」、「below」、「both」、「none」です。
デフォルトは「hierarchy -query」です。
|
|
shape(s)
|
boolean
|
|
|
トランスフォームの下にあるシェイプのアトリビュート（「controlPoints」以外）も考慮します。デフォルト: true
|
|
controlPoints(cp)
|
boolean
|
|
|
アトリビュートのリストにシェイプの制御点を含めるかどうかを
明示的に指定します（「-s」フラグを参照）。
デフォルト: false
|
|
insertBlend(ib)
|
boolean
|
|
|
true の場合、pairBlend ノードは、チャンネルをドライブする
アニメーション カーブ以外のノードを持つチャンネルに挿入されるので、
そのチャンネルでアニメーションがブレンドされるようにできます。false の場合、これらのチャンネルではキーが挿入されません。このフラグを指定しないと、アニメーションのブレンド用の
グローバル プリファレンスに基づいて、ブレンドが挿入されます。
|
|
currentDriver(cd)
|
string
|
|
|
カレントのドリブン キーフレームで使用するドライバを、
引数として渡すアトリビュートに設定します。
|
|
driver(dr)
|
boolean
|
|
|
アトリビュートの使用可能なドライバのリストを返します。
|
|
driven(dn)
|
boolean
|
|
|
選択した項目のドリブン アトリビュートのリストを返します。
|
|
driverValue(dv)
|
float
|
|
|
このキーフレームで使用するドライバの値。
デフォルトはカレント値です。
|
|
value(v)
|
float
|
|
|
キーフレームを設定する値。デフォルトはカレント値です。
|
|
|
: コマンドの作成モードで使用可能なフラグ
|
: コマンドの編集モードで使用可能なフラグ
|
|
: コマンドの照会モードで使用可能なフラグ
|
: タプルまたはリストとして渡された複数の引数を持てるフラグ
|
import maya.cmds as cmds
# Create a curve and a cone
#
cmds.curve(d=3,p=[(-10, 0, 0),(-6, 0, 10),(-3, 0, -10),(10, 0, 0)],k=[0, 0, 0, 1, 1, 1])
cmds.polyCone()
# To set the keyframe on the selected object's translateX based on
# curve1's rotateZ:
cmds.setDrivenKeyframe( at='translateX', cd='curve1.rz' )
# To set the keyframe on pCone1.tx based on the value of curve1.rz:
cmds.setDrivenKeyframe( 'pCone1.tx', cd='curve1.rz' )
# To query the current driver of pCone1.tx:
cmds.setDrivenKeyframe( 'pCone1.tx', q=True, cd=True )
# To query the available drivers of pCone1.tx:
cmds.setDrivenKeyframe( 'pCone1.tx', q=True, dr=True )