turbulence

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

概要

turbulence( selectionList , [attenuation=float], [frequency=float], [magnitude=float], [maxDistance=linear], [name=string], [noiseLevel=int], [noiseRatio=float], [perVertex=boolean], [phase=float], [phaseX=float], [phaseY=float], [phaseZ=float], [position=[linear, linear, linear]], [torusSectionRadius=linear], [volumeExclusion=boolean], [volumeOffset=[linear, linear, linear]], [volumeShape=string], [volumeSweep=angle])

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

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

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

オブジェクト名は提供されないがアクティブな選択リストが空ではない場合、このコマンドにより、リスト内の各オブジェクトに対するフィールドが作成されます。リストが空の場合、コマンドの既定は -pos 0 0 0 です。乱気流フイールドは、対象となるオブジェクトのモーションに不規則性(「ノイズ」または「ジッタ」)を与えます。

connectDynamic を使用して、フィールドがダイナミック オブジェクトに影響を及ぼすようにします。

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

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

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

戻り値

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

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
attenuation(att)	float
フィールドの減衰率です。
frequency(f)	float
タービュランスの頻度。これによりモーションのかく乱の度合いが決まります。
magnitude(m)	float
フィールドの強さです。
maxDistance(mxd)	linear
フィールドが作用する最大距離です。-1 は、フィールドに最大距離がないことを示します。
name(n)	string
フィールドの名前です。
noiseLevel(nsl)	int
noiseLevel のパラメータ値がゼロよりも大きい場合、このフィールドはテーブルで複合的な lookup を行います。それぞれの追加された lookup には、noiseRatio を使用してウェイトがかけられます。noiseLevel は追加する lookup の数です。noiseLevel が 0 の場合、1 つだけの lookup になります。値 0 (既定)に設定すると、Maya 3.0 より前のバージョンの動作と同じになります。
noiseRatio(nsr)	float
noiseLevel がゼロよりも大きい場合、noiseRatio はそれぞれの連続したノイズ評価の相対的な強さとなります。これは、たとえば、noiseRatio が 0.5 の場合、最初の評価のウェイトは 0.5、2 番目は 0.25 というふうになります。noiseLevel が 0 の場合、エフェクトはなしになります。
perVertex(pv)	boolean
頂点ごとに適用します。このフラグが true に設定されている場合、選択したオブジェクトのそれぞれのポイント(CV、パーティクル、頂点など)に、フォース フィールドの同一コピーが発生します。このフラグを false に設定すると、フォースはポイント セットのジオメトリの中心からのみ発せられます。
phase(p)	float
タービュランス フィールドの位相をシフトします。これにより、かく乱の起こる方向が決まります。このフラグはサポートされていませんが、下位互換性を保つ目的だけで提供されています。このフラグは -phaseX、-phaseY と -phaseZ に置き換えられました。-phase を設定するということは、-phaseZ を設定するということと同じことです(位相のシフトは常に Z 軸の方向に行われます)。
phaseX(px)	float
タービュランス フィールドの位相シフトを X 軸方向に行います。これにより、かく乱の起こる方向が決まります。
phaseY(py)	float
タービュランス フィールドの位相シフトを Y 軸方向に行います。これにより、かく乱の起こる方向が決まります。
phaseZ(pz)	float
タービュランス フィールドの位相シフトを Z 軸方向に行います。これにより、かく乱の起こる方向が決まります。
position(pos)	[linear, linear, linear]
重力フィールドを配置する空間内の位置(x, y,z)です。これで、重力がオブジェクトからではなく空間のその位置から発生します。-pos を使用する(位置でフィールド作成時)ことも、オブジェクト名を示すこともできることに注意してください。
torusSectionRadius(tsr)	linear
トーラス ボリュームの断面半径です。トーラスにのみ適用されます。トーラス モデリング プリミティブの断面半径と同じです。
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

# Creates a new field
cmds.turbulence( n='turbulenceF', m=5.0, pos=(0.25, 0, 0) )

# Edits the frequency value of the field named turbulenceF
cmds.turbulence( 'turbulenceF', e=True, f=0.5 )

# Queries turbulenceF for its frequency value
cmds.turbulence( 'turbulenceF', q=True, f=1 )