ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.
particle(
object
, [attribute=string], [cache=boolean], [conserve=float], [count=boolean], [deleteCache=boolean], [dynamicAttrList=boolean], [floatValue=float], [gridSpacing=linear], [inherit=float], [jitterBasePoint=[linear, linear, linear]], [jitterRadius=linear], [lowerLeft=[linear, linear, linear]], [name=string], [numJitters=uint], [order=int], [particleId=int], [perParticleDouble=boolean], [perParticleVector=boolean], [position=[linear, linear, linear]], [shapeName=string], [upperRight=[linear, linear, linear]], [vectorValue=[float, float, float]])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
particle は、取り消し可能、照会可能、および編集可能です。
ワールド空間のポイントのリストから新しいパーティクル オブジェクトが作成されます。パーティクル オブジェクトが作成されると、新しいパーティクル シェイプと関連するパーティクル オブジェクトのディペンデンシー ノードの名前を返します。オブジェクトを照会すると、照会結果を返します。パーティクル ID かパーティクル配列内でのパーティクルの順位を使用すると、パーティクル単位のアトリビュートを照会できます。オブジェクトを編集した場合は何も返されません。
string | 作成したパーティクル オブジェクトの名前 |
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
addPP, air, collision, connectDynamic, drag, dynExport, dynExpression, emit, emitter, event, getParticleAttr, goal, gravity, newton, radial, setParticleAttr
attribute, cache, conserve, count, deleteCache, dynamicAttrList, floatValue, gridSpacing, inherit, jitterBasePoint, jitterRadius, lowerLeft, name, numJitters, order, particleId, perParticleDouble, perParticleVector, position, shapeName, upperRight, vectorValue
ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
position(p)
|
[linear, linear, linear]
|
|
|
inherit(i)
|
float
|
|
|
放出されるオブジェクトの速度の小数部(0-1)が継承されます。
|
|
name(n)
|
string
|
|
|
shapeName(sn)
|
string
|
|
|
ジオメトリのインスタンス化で使用するシェイプ名を指定します。パーティクル オブジェクトに名前を付ける -n フラグと混同しないでください。
|
|
count(ct)
|
boolean
|
|
|
dynamicAttrList(dal)
|
boolean
|
|
|
オブジェクトのダイナミック アトリビュートのリストを返します。
|
|
perParticleDouble(ppd)
|
boolean
|
|
|
初期状態アトリビュート、キャッシュ アトリビュート、情報のみのアトリビュートを除き、パーティクル単位の二重アトリビュートのリストを返します。
|
|
perParticleVector(ppv)
|
boolean
|
|
|
初期状態アトリビュート、キャッシュ アトリビュート、情報のみのアトリビュートを除き、パーティクル単位のベクトル アトリビュートのリストを返します。
|
|
conserve(c)
|
float
|
|
|
運動量保存のコントロール(0~1 の間)。フレームからフレームへ保存されるパーティクル シェイプの既存の運動量の割合を指定します。値を 1 にすると(既定)、本来のニュートン物理学に対応し、運動量が保存されます。
|
|
particleId(id)
|
int
|
|
|
パーティクル単位のアトリビュートの照会と編集で使用されます。アトリビュートの照会か編集を行うパーティクルの ID を指定します。パーティクル単位のアトリビュートの値を照会する場合は、-attribute フラグと -id フラグか -order フラグが必要となり、-q フラグの前に引数を指定する必要があります。
照会モードでは、このフラグに値が必要になります。
|
|
order(order)
|
int
|
|
|
パーティクル単位のアトリビュートの照会と編集で使用されます。アトリビュートの照会か編集を行うパーティクルの、パーティクル配列のゼロベースの順序(インデックス)を指定します。パーティクル単位のアトリビュートの値を照会する場合は、-attribute フラグと -id フラグか -order フラグが必要となり、-q フラグの前に引数を指定する必要があります。
照会モードでは、このフラグに値が必要になります。
|
|
attribute(at)
|
string
|
|
|
パーティクル単位のアトリビュートの照会と編集で使用されます。照会か編集を行うアトリビュートの名前を指定します。
照会モードでは、このフラグに値が必要になります。
|
|
vectorValue(vv)
|
[float, float, float]
|
|
|
パーティクル単位のアトリビュートの編集のみで使用されます。ベクトル アトリビュートの編集を指定し、ベクトルの 3 つの浮動小数値を続ける必要があります。
|
|
floatValue(fv)
|
float
|
|
|
パーティクル単位のアトリビュートの編集のみで使用されます。浮動小数アトリビュートの編集を指定し、新しい浮動小数値を続ける必要があります。
|
|
numJitters(nj)
|
uint
|
|
|
jitterRadius(jr)
|
linear
|
|
|
パーティクル インスタンスを配置する、中心からの最大半径。
|
|
jitterBasePoint(jbp)
|
[linear, linear, linear]
|
|
|
ジッタのベース ポイント(中心点)。それぞれのベース ポイントで、ジッタの 1 つのスウォッチが作成されます。コマンド ラインで指定される順序で、ベース ポイントを含むその他のフラグと組み合わせられます。その他のフラグのインスタンスが十分に使用できない場合、-jpb のその他すべてのインスタンスに、ラインの最後のものが使用されます。
|
|
gridSpacing(grs)
|
linear
|
|
|
lowerLeft(ll)
|
[linear, linear, linear]
|
|
|
upperRight(ur)
|
[linear, linear, linear]
|
|
|
cache(ch)
|
boolean
|
|
|
パーティクル シェイプのキャッシングをオンまたはオフにします。
|
|
deleteCache(dc)
|
boolean
|
|
|
パーティクル シェイプ キャッシュを削除します。このコマンドは元に戻せません。
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
# Creates a particle object with four particles
cmds.particle( p=[(0, 0, 0), (3, 5, 6), (5, 6, 7), (9, 9, 9)] )
# Returns the age of the particle with id 2 in object particle1
cmds.particle( 'particle1', q=True, attribute='age', id=2 )
# Returns the velocity of the 3rd particle in the currently selected
# particle object
cmds.particle( attribute='velocity', q=True, order=3 )
# Edits the velocity of the 7th particle in the currently selected
# particle object to be 0.0, 1.0, 0.0
cmds.particle( e=True, attribute='velocity', order=3, vectorValue=(0.0, 1.0, 0.0) )
# Edits the mass of the particle in "particle1" with id 3 to be 0.7
cmds.particle( 'particle1', e=True, attribute='mass', id=3, fv=0.7 )