ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.
addPP(
objects
, [attribute=string])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
addPP は、取り消し可能、照会不可能、および編集不可能です。
CV、頂点、またはパーティクルなどのポイント単位のアトリビュート機能を、エミッタまたはフィールドのアトリビュートに追加します。-atr フラグはアトリビュートを識別します。アトリビュートが指定されていない場合、addPP は警告メッセージを返して処理は何も行いません。
このコマンドは、必要なアトリビュートをすべて追加し、必要な接続をすべて作成します。既存のアトリビュートがある場合、そのアトリビュートに接続します。このコマンドは、エミッタまたはフィールドの該当するアトリビュートをすべてオンにし、ポイントごとの機能が使用中であることを示します。
このコマンドは、各エミッタ/フィールドが所有するオブジェクトに、個別のポイントごとのアトリビュートを追加します。たとえば放出率の場合、各エミッタに個別の ratePP があります。このアトリビュートは、<エミッタ/フィールド名><アトリビュート名> PP という規則に従って命名されます。たとえば、パーティクル シェイプのエミッタが「smoke」である場合、そのシェイプにはアトリビュート「smokeRatePP」が存在します。
オブジェクト名は、ポイントごとの機能が追加されるエミッタまたはフィールドである必要があります(またはその親のトランスフォームの名前)。addPP コマンドは、同じオブジェクトに所有される別のエミッタやフィールドではなく、そのエミッタまたはフィールドにポイントごとの機能を追加します。ポイントごとの機能が指定したオブジェクトでサポートされていない場合、このコマンドは警告メッセージをトリガしますが、他の有効なオブジェクトに対しては処理を続行します。
指定したオブジェクトがない場合、addPP は、指定したアトリビュートを適用できる、現在のセレクション リストのオブジェクトすべてを使用します(たとえば、選択したすべてのエミッタに対して、ポイントごとの割合を追加します)。
addPP が、削除されたエミッタのアトリビュートがオーナー オブジェクトに残っていることを検知した場合、新しいアトリビュートを追加する前にこのアトリビュートを除去します。したがって、エミッタを削除して新しいエミッタを作成し、addPP を再度実行すると、addPP は削除されたエミッタをクリーン アップします。これは、ジオメトリ エミッタがあり、そのジオメトリを変更する場合の最も一般的な方法です。同様に、addPP がいくつかの CV または頂点がジオメトリに追加されたことを検知すると、必要に応じて追加された CV や頂点に対応するマルチアトリビュートが展開されます。ただし、CV や頂点が除去されたことを検知した場合、addPP はマルチアトリビュートのエントリを一切除去しません。詳細については、ユーザ マニュアルを参照してください。
| string[] | 指定したアトリビュートにポイント単位の機能を追加したエミッタ/フィールドの名前を返します。 |
emitter, particle
attribute
| ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
|
attribute(atr)
|
string
|
|
|
PP 機能を追加するアトリビュートの名前。現在サポートされているアトリビュートは、(エミッタの)速度だけです。
|
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
import maya.cmds as cmds
cmds.emitter( n='myEmitter1' )
cmds.particle( n='myParticle1' )
cmds.connectDynamic( 'myParticle1', em='myEmitter1' )
cmds.select( 'myParticle1' )
cmds.emitter( n='myEmitter2' )
cmds.particle( n='myParticle2' )
cmds.connectDynamic( 'myParticle2', em='myEmitter2' )
cmds.addPP( 'myEmitter2', atr='rate' )
# Suppose that myEmitter2 is owned by a particle shape, "myParticle1."
# addPP will add an attribute "myEmitter2RatePP" to myParticle1, will connect
# myParticle1.myEmitter2RatePP to myEmitter2.ratePP, and will set myEmitter2.useRatePP
# to true.