ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.
event(
[object]
, [count=uint], [delete=boolean], [dieAtCollision=boolean], [emit=uint], [list=boolean], [name=string], [proc=script], [random=boolean], [rename=string], [select=boolean], [split=uint], [spread=float], [target=string])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
event は、取り消し可能、照会可能、および編集可能です。
event コマンドは、衝突イベントをパーティクル オブジェクトに割り当てます。衝突イベントは、パーティクル シェイプの複数のアトリビュートに格納されます。event コマンドはイベント名を返します。
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
collision, particle
count, delete, dieAtCollision, emit, list, name, proc, random, rename, select, split, spread, target
| ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
|
count(ct)
|
uint
|
 
|
|
このイベントを適用する(各パーティクルの)衝突数です。ゼロ(既定)は、すべての衝突に適用することを意味します。
|
|
delete(d)
|
boolean
|
|
|
|
dieAtCollision(die)
|
boolean
|
|
|
「count」で指定した衝突でパーティクルが消滅します。count 値が指定されていなければ、最初の衝突で消滅します。
|
|
emit(em)
|
uint
|
|
|
割り当てられたターゲット オブジェクトに n 個の追加のパーティクルを放出します。オリジナルの(衝突)パーティクルは存在し続け、オリジナルのオブジェクトの中に残ったままです。新しいパーティクルの存在時間はゼロ、質量は放出する側のパーティクルと同じです。このパーティクルは、ターゲット オブジェクトの速度継承パラメータを使用します。
|
|
list(ls)
|
boolean
|
|
|
選択したシェイプのイベントを次のようにすべてリスト表示します。event1Name event2Name...。シェイプがまったく識別されない場合、次のようにシェイプのイベントをすべてリスト表示します。shape1Name event1Name shape2Name event2Name...。文字配列を返します。
|
|
name(n)
|
string
|
|
|
作成しているイベントに名前を割り当てるか、または編集、照会、削除したいイベントを識別します。例を参照してください。
|
|
proc(pr)
|
script
|
|
|
イベントが発生するたびにコールする MEL プロシージャを指定します。 これは、次のような引数を持つグローバル プロシージャである必要があります。global proc procName( string obj, int id, string objHit); 渡される引数はパーティクル オブジェクトの名前、衝突したパーティクルの ID、衝突したオブジェクトの名前です。パーティクル -id -q を使用してパーティクルのアトリビュートの値を取得できます。
|
|
random(r)
|
boolean
|
|
|
-split フラグと -emit フラグを使用します。-random が true に、-split または -emit が n に設定されていれば、1 と n の間で均一に分散されたランダムな数のパーティクルが、イベントで作成されます。
|
|
rename(re)
|
string
|
|
|
編集しているイベントに新しい名前を割り当てます。例を参照してください。
|
|
select(s)
|
boolean
|
|
|
このフラグは現在サポートしていません。-name フラグを参照してください。
|
|
split(spl)
|
uint
|
|
|
衝突するパーティクルを指定した数の新しいパーティクルに分割します。これらの新しいパーティクルは、割り当てられたターゲット オブジェクトの一部になります。ターゲットが割り当てられていない場合、パーティクルは同じオブジェクトの一部になります。新しいパーティクルは、分割元のパーティクルの現在の存在時間を継承します。このパーティクルは、ターゲット オブジェクトの速度継承パラメータを使用します。放出と分割の両方を設定すると、event コマンドは両方を実行します。まず新しいパーティクルを放出してから、オリジナルのパーティクルを分割します。これは、放出と分割が両立しなかった旧バージョンからの変更点です。
|
|
spread(sp)
|
float
|
|
|
衝突で作成されるパーティクルは、衝突する側のパーティクルの跳ね返る方向からランダムな量だけスプレッドします。このスプレッドは、90 度の割合(0-1)として指定されます。spread が 0 (既定)に設定されていれば、作成された新しいパーティクルはすべて一致します。
|
|
target(t)
|
string
|
|
|
パーティクルを放出または分割するターゲット オブジェクトです。-emit フラグまたは -split フラグで作成された新しいパーティクルは、このオブジェクトに加えられます。
|
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
cmds.event( em=2, t='newCloud' )
# At every collision, emit two new particles into the object
# newCloud. The original colliding particles will survive and
# remain in their original object. This event will be
# assigned to the currently selected object.
cmds.event( em=2 )
# At every collision, emit two new particles into the same object.
cmds.event( count=1, em=2 )
# At the first collision for each particle, emit two new particles
# into the same object.
# Subsequent collisions for that same particle will not cause any
# additional particles to be emitted. However, the new particles will
# each emit two new ones at their first collision, since they also
# belong to the object for which this event has been assigned.
cmds.event( die=1, count=2 )
# All particles in the selected object will die at their second
# collision.
cmds.event( 'myCloud', name='foo', count=1, q=1 )
# Return the current value of the count parameter for the event "foo"
# assigned to particle shape myCloud. The order of the flags is
# important. Thef lag you are querying (in this case, -count) must
# come before the -q. The -name flag and the particle object name must
# come after.
cmds.event( 'myCloud', d=True, name='foo' )
# Delete the event "foo" assigned to particle shape myCloud.
cmds.event( 'myCloud', e=True, name='foo', emit=2 )
# Edit the "emit" value of the event "foo" assigned to
# particle shape myCloud.
cmds.event( 'myCloud', proc='myProc' )
# Call the MEL proc "myProc(name, id, name) each time a particle
# of myCloud collides with anything.
cmds.event( name='oldName', e=1, rename='newName' )
# For the selected particle shape, rename the event "oldName" to "newName."