radial

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

概要

radial( selectionList , [attenuation=float], [magnitude=float], [maxDistance=linear], [name=string], [perVertex=boolean], [position=[linear, linear, linear]], [torusSectionRadius=linear], [type=float], [volumeExclusion=boolean], [volumeOffset=[linear, linear, linear]], [volumeShape=string], [volumeSweep=angle])

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

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

フィールドが作成されると、このコマンドは各所有シェイプの名前とフィールド シェイプそのものの名前を返します。フィールドを照会すると、その結果を返します。フィールドを編集すると、フィールド名を返します。

オブジェクト名は提供されないがアクティブな選択リストが空ではない場合、このコマンドにより、リスト内の各オブジェクトに対するフィールドが作成されます。リストが空の場合、コマンドの既定は -pos 0 0 0 です。放射状フィールドが、磁石のように、オブジェクトを直接放射状フィールドに引き寄せるか、または押しやります。

このトランスフォームは関連付けられたディペンデンシー ノードです。connectDynamic を使用して、フィールドがダイナミック オブジェクトに影響を及ぼすようにします。

フィールドを作成すると、このコマンドは各フィールドの名前を返します。フィールドを照会すると、その結果を返します。フィールドを編集すると、フィールド名を返します。

オブジェクト名が提供されるか、アクティブなセレクション リストが空でない場合、このコマンドはリスト内の全オブジェクトのフィールドを作成し、addDynamic をコールしてオブジェクトに追加します。リストが空の場合、コマンドの既定は -pos 0 0 0 です。

コマンド ラインにオブジェクトを指定して -pos フラグを設定すると、エラーになります。

戻り値

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

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
attenuation(att)	float
フィールドの減衰率です。
magnitude(m)	float
フィールドの強さです。
maxDistance(mxd)	linear
フィールドが作用する最大距離です。-1 は、フィールドに最大距離がないことを示します。
name(n)	string
フィールドの名前です。
perVertex(pv)	boolean
頂点ごとに適用します。このフラグが true に設定されている場合、選択したオブジェクトのそれぞれのポイント(CV、パーティクル、頂点など)に、フォース フィールドの同一コピーが発生します。このフラグを false に設定すると、フォースはポイント セットのジオメトリの中心からのみ発せられます。
position(pos)	[linear, linear, linear]
重力フィールドを配置する空間内の位置(x, y,z)です。これで、重力がオブジェクトからではなく空間のその位置から発生します。-pos を使用する(位置でフィールド作成時)ことも、オブジェクト名を示すこともできることに注意してください。
torusSectionRadius(tsr)	linear
トーラス ボリュームの断面半径です。トーラスにのみ適用されます。トーラス モデリング プリミティブの断面半径と同じです。
type(typ)	float
放射状フィールド(0 - 1)のタイプです。フィールドの作用を減衰するアルゴリズムを制御します。タイプ 1 は下位互換性のために提供され、Alias | Wavefront Dynamation と同じアルゴリズムを指定します。0 から 1 の値は、一次的なブレンドになります。
volumeExclusion(vex)	boolean
フィールドのボリューム排除です。true の場合は、ボリュームの外側のポイント(ボリューム シェイプ アトリビュートによって定義される)が影響を受けます。false の場合は、ボリュームの内側が影響を受けます。volumeShape が「none」に設定されている場合は何も起こりません。
volumeOffset(vof)	[linear, linear, linear]
フィールドのボリューム オフセットです。 ボリューム オフセットによって、フィールドのボリュームはフィールドの実際の場所から指定した量だけ移動します。 これはフィールドのローカル空間にあります。
volumeShape(vsh)	string
フィールドのボリューム シェイプです。 フィールドのボリューム シェイプのアトリビュートを設定、編集、照会します。「none」以外の値に設定すると、フィールドが影響を受ける 3-D ボリュームを定義します。 指定できる値は、「none」、「cube」、「sphere」、「cylinder」、「cone」、「torus」のいずれかです。
volumeSweep(vsw)	angle
フィールドのボリューム スイープです。 球、円錐、円柱、トーラスにのみ適用されます。モデリングのスイープ アトリビュートと同じエフェクトです。

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

Python 例

import maya.cmds as cmds

cmds.radial( 'particle1', m=5.0, mxd=2.0 )
# Creates a radial field with magnitude 5.0 and maximum distance 2.0,
# and adds it to the list of fields particle1 owns.

cmds.radial( pos=(2, 0, 4 ))
# Creates a radial field at position (0,2,4) in world coordinates,
# with default magnitude(1.0), attentuation (1.0),
# and max distance (5.0).

cmds.radial( 'radialField1', e=True, att=0.98 )
# Edits the attenuation value of the field named radialField1

cmds.radial( 'radialField1', q=True, m=True )
# Queries radialField1 for its magnitude.

cmds.radial( 'radialField1', e=True, mxd=10.0 )
# Changes the maximum distance of the field called
# "radialField1" to 10.0.

cmds.radial( m=2.0 )
# Creates a radial field with magnitude 2.0 for every active selection.
# If no there are active
# selections, creates such a field at world position (0,0,0).