tangentConstraint

移動先: 概要 戻り値 関連項目 フラグ Python の例

概要

tangentConstraint( [target...] object , [aimVector=[float, float, float]], [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 にアラインされます。統合された接線ベクトルは、 コンストレインされたオブジェクトに最も近いポイントにある、 それぞれのターゲット カーブの接線ベクトルの加重平均です。

戻り値

戻り値の型は照会モードでは照会フラグが基になります。

関連項目

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
name(n)	string
コンストレイン ノードの名前を指定した名前に設定します。デフォルト名は constrainedObjectName_constraintType です。
weight(w)	float
指定したターゲットのウェイト値を設定します。 作成時に指定していない場合は、デフォルト値の 1.0 が使用されます。
remove(rm)	boolean
リストされたターゲットをコンストレインから削除します。
targetList(tl)	boolean
ターゲット オブジェクトのリストを返します。
weightAliasList(wal)	boolean
ターゲット オブジェクトのウェイトをコントロールする、アトリビュートの名前を返します。targetList フラグで返されるターゲットと同じ順序で、エイリアスを返します。
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」です。

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: タプルまたはリストとして渡された複数の引数を持てるフラグ

Python の例

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' )