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

概要

radial( selectionList , [attenuation=float], [magnitude=float], [maxDistance=linear], [name=string], [perVertex=boolean], [position=[linear, linear, linear]], [type=float])

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

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

放射状フィールドが、磁石のように、オブジェクトを直接放射状フィールドに引き寄せるか、または押しやります。

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

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

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

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

戻り値

string

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

関連

addDynamic, connectDynamic, particle

フラグ

attenuation, magnitude, maxDistance, name, perVertex, position, type
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
attenuation(att) float queryedit
フィールドの減衰率です。
magnitude(m) float queryedit
フィールドの強さです。
maxDistance(mxd) linear queryedit
フィールドが作用する最大距離です。-1 は、フィールドに最大距離がないことを示します。
name(n) string queryedit
フィールドの名前です。
perVertex(pv) boolean queryedit
頂点ごとに適用します。このフラグが true に設定されている場合、選択したオブジェクトのそれぞれのポイント(CV、パーティクル、頂点など)ごとに、フォース フィールドの同一コピーが発生します。このフラグを false に設定すると、フォースはポイント セットのジオメトリの中心からのみ発せられます。
position(pos) [linear, linear, linear] queryeditmultiuse
フィールドを配置する空間内の位置です。フィールドはオブジェクトではなく、空間のこの位置に生成されます。-pos を使用する(位置でフィールド作成時)ことも、オブジェクト名を示すこともできることに注意してください。
type(typ) float queryedit
放射状フィールド(0 - 1)のタイプです。フィールドの作用を減衰するアルゴリズムを制御します。タイプ 1 は下位互換性のために提供され、Alias | Wavefront Dynamation と同じアルゴリズムを指定します。0 から 1 の値は、一次的なブレンドになります。

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

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).