ジャンプ先: 概要. 戻り値.
関連項目. フラグ. Python 例.
tangentConstraint( [target...] object ,
[aimVector=[float, float,
float]], [layer=string],
[name=string], [remove=boolean], [targetList=boolean], [upVector=[float, float, float]],
[weight=float], [weightAliasList=boolean],
[worldUpObject=name],
[worldUpType=string],
[worldUpVector=[float, float,
float]])
注意:
オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。
tangentConstraint は 「元に戻す」が可能、「照会」が可能、「編集」が可能 です。
オブジェクトの方向を、オブジェクトに最も近いポイントにある ターゲット カーブの接線に基づいてコンストレインします。
tangentConstraint は、1 つまたは複数の NURBS カーブをターゲット入力とし、 DAG トランスフォーム
ノードをオブジェクト入力とします。tangentConstraint は、 (オブジェクトのローカル座標にある)aimVector
がワールド空間の 統合された接線ベクトルにアラインされるような、
コンストレインされたオブジェクトの方向を合わせます。オブジェクトのローカル座標系のアップ ベクトルは、 ワールド空間で
worldUpVector にアラインされます。統合された接線ベクトルは、 コンストレインされたオブジェクトに最も近いポイントにある、
それぞれのターゲット カーブの接線ベクトルの加重平均です。
string[] |
作成されたコンストレイン ノード名 |
戻り値の型は照会モードでは照会フラグが基になります。
aimConstraint, geometryConstraint, normalConstraint, orientConstraint, parentConstraint, pointConstraint, poleVectorConstraint, scaleConstraint
aimVector, layer, name, remove, targetList,
upVector, weight, weightAliasList, worldUpObject, worldUpType, worldUpVector
ロング ネーム(ショート ネーム) |
引数型 |
プロパティ |
name(n) |
string |
|
|
コンストレイン ノードの名前を指定した名前に設定します。デフォルト名は
constrainedObjectName_constraintType です。 |
|
weight(w) |
float |
|
|
指定したターゲットのウェイト値を設定します。 作成時に指定していない場合は、デフォルト値の 1.0 が使用されます。 |
|
remove(rm) |
boolean |
|
|
リストされたターゲットをコンストレインから削除します。 |
|
targetList(tl) |
boolean |
|
|
weightAliasList(wal) |
boolean |
|
|
ターゲット オブジェクトのウェイトをコントロールする、アトリビュートの名前を返します。targetList
フラグで返されるターゲットと同じ順序で、エイリアスを返します。 |
|
layer(l) |
string |
|
|
コンストレインを追加するアニメーション レイヤの名前を指定します。 |
|
aimVector(aim) |
[float, float, float] |
|
|
エイム
ベクトルを設定します。ターゲットを示すローカル座標でのベクトルです。作成時に指定していない場合、デフォルト値の(0.0, 1.0,
0.0)が使用されます。 |
|
upVector(u) |
[float, float, float] |
|
|
ローカル アップ ベクトルを設定します。これは、ワールド アップ
ベクトルとアラインするローカル座標内でのベクトルです。作成時に指定していない場合、デフォルト値の(1.0, 0.0,
0.0)が使用されます。 |
|
worldUpVector(wu) |
[float, float, float] |
|
|
ワールド アップ ベクトルを設定します。これは、アップ ベクトルとアラインする必要のあるワールド座標内のベクトルです。
詳細については、-wut/worldUpType(下記)を参照してください。 作成時に指定していない場合、デフォルト値の(1.0,
0.0, 0.0)が使用されます。 |
|
worldUpObject(wuo) |
name |
|
|
DAG オブジェクトを worldUpType "object"
および「objectrotation」で使用するように設定します。詳細については、worldUpType を参照してください。
デフォルト値は、ワールド空間座標として解釈される非アップ オブジェクトです。 |
|
worldUpType(wut) |
string |
|
|
ワールド アップ ベクトル計算のタイプを設定します。 worldUpType
は、「scene」、「object」、「objectrotation」、「vector」、または「none」です。
「scene」の場合、upVector はシーンのアップ軸にアラインされ、worldUpVector および
worldUpObject は無視されます。 「object」の場合、upVector は worldUpObject
の空間の原点にできるだけ近い位置に配置され、worldUpVector は無視されます。
「objectrotation」の場合、worldUpVector は worldUpObject
の座標空間にあるものと解釈され、ワールド空間にトランスフォームされて upVector はその結果にできるだけ近くアラインされます。
「vector」の場合、upVector は worldUpVector にできるだけ近くアラインされ、worldUpMatrix
は無視されます。 最後に「none」の場合は、コンストレインでツイストの計算は実行されません。その結果、
「upVector」の方向はコンストレインされたオブジェクトの以前の方向に基づくようになり、 「great
circle」回転には、エイム ベクトルをそのコンストレインとアラインすることが必要になります。 デフォルトの worldUpType
は「vector」です。 |
|
: コマンドの作成モードで使用可能なフラグ |
: コマンドの編集モードで使用可能なフラグ |
: コマンドの照会モードで使用可能なフラグ |
: タプルまたはリストとして渡された複数の引数を持てるフラグ |
import maya.cmds as cmds
# orients the aim vector of cube1 in it's local coordinate space,
# to the tangent vector of curve1 at the closest point to cube1.
cmds.tangentConstraint( 'curve1', 'cube1' )
# uses the average of the tangents from curve1 and curve2.
cmds.tangentConstraint( 'curve1', 'curve2', 'cube2', w=.1 )
# sets the weight for curve1's effect on cube2 to 10.
cmds.tangentConstraint( 'curve1', 'cube2', e=True, w=10. )
# removes curve2 from cube2's tangentConstraint
cmds.tangentConstraint( 'curve2', 'cube2', e=True, rm=True )
# adds curve3 to cube2's tangent constraint with the default weight
cmds.tangentConstraint( 'curve3', 'cube2' )