ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.
goal(
selectionList
, [goal=string], [index=boolean], [useTransformAsGoal=boolean], [weight=float])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
goal は、取り消し可能、照会可能、および 編集不可能 です。
特定のパーティクル オブジェクトのゴールとなる特定のオブジェクトを指定します。ゴール オブジェクトがジオメトリの場合、パーティクル オブジェクト内の各パーティクルはそれぞれ、ゴールの特定の頂点、CV、ラティス ポイントの位置に追従するか一致しようとします。ゴール オブジェクトがほかのパーティクル オブジェクトの場合、各パーティクルはゴールのパーティクルに追従しようとします。その他の場合、全パーティクルはゴール オブジェクトがトランスフォームする現在位置に追従しようとします。ジオメトリとパーティクル オブジェクトの場合、この後者の動作については、-utr true を使用しても得られます。ゴール ウェイトはキーフレーム設定できます。これは、ゴールを追加してマルチアトリビュートとなる、パーティクル オブジェクトによります。
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
particle
goal, index, useTransformAsGoal, weight
ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
goal(g)
|
string
|
|
|
このフラグは文字列を指定して、コマンド ラインのパーティクル オブジェクト、または現在選択されているパーティクル オブジェクトのゴールにします。このフラグを複数回使用して、パーティクル オブジェクトのゴールを複数指定することができます。照会はアトリビュート エディタ(Attribute Editor)で使用されます。
|
|
weight(w)
|
float
|
|
|
これはゴール ウェイト値を 0 から 1 に指定します。値が 0 であればゴールの位置はパーティクル オブジェクトに影響しませんが、ウェイトを 1 にするとパーティクル オブジェクトはゴール オブジェクトに正確に追従しようとします。このフラグは一度渡されるだけで、-g/-goal フラグで渡された全ゴールにウェイトを設定します。
|
|
index(i)
|
boolean
|
|
|
ゴールのマルチアトリビュート インデックスの配列を返します。これはアトリビュート エディタ(Attribute Editor)専用です。
|
|
useTransformAsGoal(utr)
|
boolean
|
|
|
指定したオブジェクトの、シェイプではなく、トランスフォームを使用します。パーティクルとジオメトリ オブジェクトにのみ有効です。一度渡されるだけで、-g で渡された全オブジェクトに適用されます。
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
cmds.sphere( name='surface1')
cmds.particle( name='Particle')
cmds.goal( 'Particle', g='surface1', w=.75 )
# This command assigns surface1 as a goal of Particle with a goal
# weight of 0.75.
cmds.goal( 'Particle', g='surface1', w=.75, utr=1 )
# This command assigns the transform of surface1 as a goal of Particle
# with a goal weight of 0.75.
cmds.goal( 'Particle', g='camera1', w=.75 )
# This command assigns the transform of camera1 as a goal of Particle
# with a goal weight of 0.75. The -utr flag is not relevant because
# only the transform can be used for any object other than geometry
# or particles.