ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.
air(
[objects]
, [attenuation=float], [directionX=float], [directionY=float], [directionZ=float], [enableSpread=boolean], [fanSetup=boolean], [inheritRotation=boolean], [inheritVelocity=float], [magnitude=float], [maxDistance=linear], [name=string], [perVertex=boolean], [position=[linear, linear, linear]], [speed=float], [spread=float], [velocityComponentOnly=boolean], [wakeSetup=boolean], [windSetup=boolean])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
air は、取り消し可能、照会可能、および 編集可能 です。
大気フィールドは移動する大気をシミュレートします。影響を受けるオブジェクトは、大気の速度に合わせて加速されたり減速されたりします。「-vco true」フラグを付けないと、加速度だけが適用されます。大気フィールドをオブジェクトの動きのある部分(キャラクタの足など)にペアレント化して、「-i 1 -m 0 -s .5 -vco true」フラグを使用すると足が動くときの空気の動きをシミュレートできます。これは、このフィールドの総速度ベクトルが足の動きに基づいているからです。これで、キャラクタが地面の落ち葉や埃の中を歩くときの動きもシミュレートできます。このコマンドは、リストされた各オブジェクトに対して新しいフィールドを作成します。このトランスフォームは関連付けられたディペンデンシー ノードです。connectDynamic を使用して、フィールドがダイナミック オブジェクトに影響を及ぼすようにします。フィールドが作成されると、このコマンドはフィールドの名前を返します。フィールドを照会すると、その結果を返します。フィールドを編集すると、フィールド名を返します。-pos フラグを指定すると、指定した位置にフィールドが作成されます。指定しないと、オブジェクト名が提供されるか、アクティブなセレクション リストが空でない場合、このコマンドはリスト内の全オブジェクトのフィールドを作成し、addDynamic を呼び出してオブジェクトに追加します。オブジェクト名が提供されないか、リストが空の場合、コマンドの既定は -pos 0 0 0 です。コマンド ラインにオブジェクトを指定して -pos フラグを設定すると、エラーになります。
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
addDynamic, connectDynamic, particle
attenuation, directionX, directionY, directionZ, enableSpread, fanSetup, inheritRotation, inheritVelocity, magnitude, maxDistance, name, perVertex, position, speed, spread, velocityComponentOnly, wakeSetup, windSetup
ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
position(pos)
|
[linear, linear, linear]
|
|
|
フィールドを配置する空間内の位置です。フィールドはオブジェクトではなく、空間のこの位置に生成されます。-pos を使用する(位置でフィールド作成時)ことも、オブジェクト名を示すこともできることに注意してください。
|
|
magnitude(m)
|
float
|
|
|
大気の移動するベクトル方向の速さです。これは、-dx -dy -dz フラグと一緒に使用します。
|
|
attenuation(att)
|
float
|
|
|
最大距離に到達した時点で大気フィールドの影響度がゼロになるような、減衰率です。したがって、useMaxDistance が true で最大距離に正の値が設定されていなければ、減速は起こりません。
|
|
maxDistance(mxd)
|
linear
|
|
|
フィールドが作用する最大距離です。-1 は、フィールドに最大距離がないことを示します。
|
|
name(n)
|
string
|
|
|
perVertex(pv)
|
boolean
|
|
|
頂点ごとに適用します。このフラグが true に設定されている場合、選択したオブジェクトのそれぞれのポイント(CV、パーティクル、頂点など)ごとに、フォース フィールドの同一コピーが発生します。このフラグを false に設定すると、フォースはポイントの集合の幾何学的中心からのみ発せられます。
|
|
directionX(dx)
|
float
|
|
|
directionY(dy)
|
float
|
|
|
directionZ(dz)
|
float
|
|
|
影響を受けるパーティクルの速度に合わせるために指定する大気の移動方向。注: 速度ではなく、方向です。速さを設定するには、-s フラグを使います。
|
|
speed(s)
|
float
|
|
|
影響を受けるオブジェクトの速さが大気フィールドの(-mag、-dx、-dy、-dz フラグに基づく)スピードに到達する速さです。この値は内部的にクランプされ、0.0 と 1.0 の間になります。値が 0.0 であれば、大気フィールドは作用しません。値が 1.0 のときは、大気フィールドのスピードをさらにすばやく合わせようとしますが、必ずしも即時にというわけではありません。
|
|
inheritVelocity(iv)
|
float
|
|
|
direction フラグと speed フラグで定義されるベクトルに追加される、フィールドを所有する側の速度の割合(0 から 1)です。この 2 つのベクトルの組み合わせが、大気フィールドの総速度ベクトルになります。これによって、所有するオブジェクトの動きで大気を直接定義することができます。
|
|
velocityComponentOnly(vco)
|
boolean
|
|
|
「false」の場合、大気は影響を受けるオブジェクトを加速または減速して
その速度を最終的に大気フィールドの総速度ベクトルに合わせます。「true」の場合、ACCELERTION のみが影響を受けるオブジェクトに適用され、総速度ベクトルに従ってその速度コンポーネントは、総速度ベクトルの大きさと同じかそれ以上になります。これにより、オブジェクトを減速して速度に合わせるのではなく、コンポーネントに合わせるために加速されます。これは、0 より大きな値を持つ -iv フラグを使用するときに大変便利です。
|
|
inheritRotation(iro)
|
boolean
|
|
|
「true」に設定されている場合、-dx、-dy、と -dz で指定される方向ベクトルは所有する側のオブジェクトに対してローカルとみなされます。したがって、所有するオブジェクトのトランスフォームで何らかの回転が行われた場合(自身、またはその親による)、大気フィールドの方向ベクトルもそれと同じ回転を受けます。
|
|
spread(sp)
|
float
|
|
|
方向ベクトルからの角度を示し、その角度の範囲内のオブジェクトが影響を受けます。この値は 0 から 1 の範囲になります。0 の場合は、方向ベクトルに沿った大気フィールドのちょうど前面だけが影響を受けます。1 の場合は、所有するオブジェクトの前にあるすべてのオブジェクト、方向ベクトルから全方向に 90 度の範囲で影響があります。
|
|
enableSpread(es)
|
boolean
|
|
|
これは、システムに対して、「-sp」で指定されるスプレッド角度を使用するかどうかを通知します。これが false の場合、最大距離内にある接続されたオブジェクトすべてが影響を受けます。また、false に設定されている場合、影響を受けるすべてのオブジェクトは、方向ベクトルに沿ってその速度を強制的に合わせられます。true に設定されてスプレッドが使用されている場合、フォースの方向はフィールドからオブジェクトの方向になります。
|
|
windSetup(wns)
|
boolean
|
|
|
上の値のいくつかを指定すると、基本的な風のエフェクトをほぼ設定できます。これにより、特定の値を同じコマンド ラインで変更することができます。まず、プリセットの値が設定され、渡された他のフラグの値がすべて考慮されます。次の値により、近似の「風」を設定できます。inheritVelocity 0.0 inheritRotation true componentOnly false enableSpread false
|
|
fanSetup(fs)
|
boolean
|
|
|
「windSetup」と同じです。ただし、シミュレーションされるのは、ファンや息を吹きかけるエフェクトです。コマンド ラインで同じフラグを渡して、既定を調整することができます。次の値により、「ファン」のシミュレーションが準備できます。inheritVelocity 1.0 inheritRotation true componentOnly false enableSpread true spread .5 (中心から 45°)
|
|
wakeSetup(wks)
|
boolean
|
|
|
「windSetup」と「fanSetup」と同様に、「wakeSetup」はフィールドの特定の値を設定して、キャラクタの足や手といった動くオブジェクトの近くの空気の動きをシミュレートします。値は次のように設定されます。inheritVelocity 1.0 inheritRotation false componentOnly true enableSpread false speed 0.0
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
cmds.air( name='particle1', m=5.0, mxd=2.0 )
# Creates an air field with magnitude 5.0 and maximum distance 2.0,
# and adds it to the list
# of fields particle1 owns.
cmds.air( wakeSetup=True )
# Creates an air field with no no velocity in and of itself (magnitude = 0).
# All of the air's
# velocity is derived from the motion of the objects that own the field.