ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.

概要

aimConstraint( [target...] object , [aimVector=[float, float, float]], [layer=string], [maintainOffset=boolean], [name=string], [offset=[float, float, float]], [remove=boolean], [skip=string], [targetList=boolean], [upVector=[float, float, float]], [weight=float], [weightAliasList=boolean], [worldUpObject=name], [worldUpType=string], [worldUpVector=[float, float, float]])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

aimConstraint は、取り消し可能、照会可能、および 編集可能 です。

オブジェクトの方向がターゲット オブジェクト、または複数のターゲットの平均位置を指すようにコンストレイントします。aimConstraint は、入力として、単一の「コンストレイント オブジェクト」の DAGトランスフォームを指す、1 つまたは複数の「ターゲット」の DAGトランスフォームを取ります。オブジェクトのローカル座標系の aimVector がワールド空間位置のターゲット オブジェクトの加重平均を指すように、aimConstraint はコンストレイントされたオブジェクトを方向付けます。オブジェクトのローカル座標系のアップ ベクトルは、 ワールド空間で worldUpVector に位置合わせされます。

戻り値

string[]作成されたコンストレイント ノード名

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

関連

geometryConstraint, normalConstraint, orientConstraint, parentConstraint, pointConstraint, poleVectorConstraint, scaleConstraint, tangentConstraint

フラグ

aimVector, layer, maintainOffset, name, offset, remove, skip, targetList, upVector, weight, weightAliasList, worldUpObject, worldUpType, worldUpVector
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
name(n) string createqueryedit
コンストレイント ノードの名前を指定した名前に設定します。既定の名前は constrainedObjectName_constraintType です。
weight(w) float createqueryedit
指定したターゲットのウェイト値を設定します。作成時に指定していない場合は、既定値の 1.0 が使用されます。
remove(rm) boolean edit
リストされたターゲットをコンストレイントから除去します。
targetList(tl) boolean query
ターゲット オブジェクトのリストを返します。
weightAliasList(wal) boolean query
ターゲット オブジェクトのウェイトをコントロールする、アトリビュートの名前を返します。targetList フラグで返されるターゲットと同じ順序で、エイリアスを返します。
layer(l) string createedit
コンストレイントを追加するアニメーション レイヤの名前を指定します。
aimVector(aim) [float, float, float] createqueryedit
エイム ベクトルを設定します。ターゲットを示すローカル座標でのベクトルです。作成時に指定していない場合、既定値の(0.0, 1.0, 0.0)が使用されます。
upVector(u) [float, float, float] createqueryedit
ローカル アップ ベクトルを設定します。これは、ワールド アップ ベクトルと位置合わせるローカル座標内でのベクトルです。作成時に指定していない場合、既定値の(1.0, 0.0, 0.0)が使用されます。
worldUpVector(wu) [float, float, float] createqueryedit
ワールド アップ ベクトルを設定します。これは、アップ ベクトルと位置合わせる必要のあるワールド座標内のベクトルです。詳細については、-wut/worldUpType (下記)を参照してください。作成時に指定していない場合、既定値の(1.0, 0.0, 0.0)が使用されます。
worldUpObject(wuo) name createqueryedit
DAG オブジェクトを worldUpType「object」および「objectrotation」で使用するように設定します。詳細については、worldUpType を参照してください。既定値は、ワールド空間座標として解釈される非アップ オブジェクトです。
worldUpType(wut) string createqueryedit
ワールド アップ ベクトル計算のタイプを設定します。 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」です。
offset(o) [float, float, float] createqueryedit
オフセットの値を設定または照会します。既定は 0,0,0 です。
maintainOffset(mo) boolean create
コンストレイントされたオブジェクトの初期回転角度の保持に必要なオフセットを計算し、オフセットとして使用します。
skip(sk) string createeditmultiuse
省略する軸を指定します。有効な値は、「x」、「y」、「z」、「none」です。作成時の既定は「none」です。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

# Orients the aim vector of cube1 in it's local coordinate space, to point at cone1.
cmds.aimConstraint( 'cone1', 'cube1' )
# Aims cube2 at the average of the position of cone1 and surf2
cmds.aimConstraint( 'cone1', 'surf2', 'cube2', w=.1 )
# Sets the weight for cone1's effect on cube2 to 10.
cmds.aimConstraint( 'cone1', 'cube2', e=True, w=10.0 )
# Removes surf2 from cube2's aimConstraint.
cmds.aimConstraint( 'surf2', 'cube2', e=True, rm=True )
# Adds surf3 to cube2's aimConstraint with the default weight.
cmds.aimConstraint( 'surf3', 'cube2' )
# Aim constrain the z-axis only of sph2 to sph1
cmds.aimConstraint( 'sph1', 'sph2', skip=["x","y"] )