ジャンプ先: 概要. 戻り値.
関連項目. フラグ. 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」、「stepped」、「step
next」、「fixed」、「clamped」、「plateau」です。 デフォルトは「keyTangent -q -g
-inTangentType」です。 |
|
outTangentType(ott) |
string |
|
|
このコマンドによって設定されるキーフレームのアウト接線タイプです。
有効な値は、「spline」、「linear」、「fast」、「slow」、「flat」、「stepped」、「step
next」、「fixed」、「clamped」、「plateau」です。 デフォルトは「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 )