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

概要

goal( selectionList , [goal=string], [index=boolean], [useTransformAsGoal=boolean], [weight=float])

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

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

特定のパーティクル オブジェクトのゴールとなる特定のオブジェクトを指定します。ゴール オブジェクトがジオメトリの場合、パーティクル オブジェクト内の各パーティクルはそれぞれ、ゴールの特定の頂点、CV、ラティス ポイントの位置に追従するか一致しようとします。ゴール オブジェクトがほかのパーティクル オブジェクトの場合、各パーティクルはゴールのパーティクルに追従しようとします。その他の場合、全パーティクルはゴール オブジェクトがトランスフォームする現在位置に追従しようとします。ジオメトリとパーティクル オブジェクトの場合、この後者の動作については、-utr true を使用しても得られます。

ゴール ウェイトはキーフレーム設定できます。これは、ゴールを追加してマルチアトリビュートとなる、パーティクル オブジェクトによります。

戻り値

string

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

関連

particle

フラグ

goal, index, useTransformAsGoal, weight
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
goal(g) string createquerymultiuse
このフラグは文字列を指定して、コマンド ラインのパーティクル オブジェクト、または現在選択されているパーティクル オブジェクトのゴールにします。このフラグを複数回使用して、パーティクル オブジェクトのゴールを複数指定することができます。照会はアトリビュート エディタ(Attribute Editor)で使用されます。
weight(w) float create
これはゴール ウェイト値を 0 から 1 に指定します。値が 0 であればゴールの位置はパーティクル オブジェクトに影響しませんが、ウェイトを 1 にするとパーティクル オブジェクトはゴール オブジェクトに正確に追従しようとします。このフラグは一度渡されるだけで、-g/-goal フラグで渡された全ゴールにウェイトを設定します。
index(i) boolean query
ゴールのマルチアトリビュート インデックスの配列を返します。これはアトリビュート エディタ(Attribute Editor)専用です。
useTransformAsGoal(utr) boolean create
指定したオブジェクトの、シェイプではなく、トランスフォームを使用します。パーティクルとジオメトリ オブジェクトにのみ有効です。一度渡されるだけで、-g で渡された全オブジェクトに適用されます。

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

Python 例

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.