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

概要

geometryConstraint( [target...] object , [name=string], [remove=boolean], [targetList=boolean], [weight=float], [weightAliasList=boolean])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

geometryConstraint は「元に戻す」が可能、「照会」が可能、「編集」が可能です。

ターゲット サーフェスのシェイプに基づき、オブジェクトの位置を、オブジェクトに最も近いポイントにコンストレインします。

geometryConstraint は、入力データとして、1 つまたは複数のサーフェス シェイプ(ターゲット)と DAG トランスフォーム(オブジェクト)を取ります。geometryConstraint で位置をコンストレインされたオブジェクトは、ターゲットのサーフェスに最大ウェイト値で置かれます。ウェイト値の等しいターゲットが 2 つある場合、インデックスが下位にあるターゲットが選択されます。

戻り値

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

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

関連項目

aimConstraint, normalConstraint, orientConstraint, parent, pointConstraint, poleVectorConstraint, scaleConstraint, tangentConstraint

フラグ

name, remove, targetList, weight, weightAliasList
ロング ネーム(ショート ネーム) 引数型 プロパティ
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 フラグで返されるターゲットと同じ順序で、エイリアスを返します。

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

Python の例

import maya.cmds as cmds

# Constrain cube1 to surf1 at the closest point to  cube1.
cmds.geometryConstraint( 'surf1', 'cube1' )

# Will prefer surf1 though the weights are equal
cmds.geometryConstraint( 'surf1', 'surf2', 'cube2', w=.1 )

# Now constraints cube2 to lie on surf2 as it's weight is greater
cmds.geometryConstraint( 'surf2', 'cube2', e=True, w=10. )

# Removes surf2 from cube2's geometryConstraint.
cmds.geometryConstraint( 'surf2', 'cube2', e=True, rm=True )

# Adds surf3 to cube2's geometryConstraint with the default weight.
cmds.geometryConstraint( 'surf3', 'cube2' )