nParticle is undoable, queryable, and editable.
The nParticle command creates a new nParticle object from a list of
world space points. If an nParticle object is created, the command
returns the names of the new particle shape and its associated
particle object dependency node. If an object was queried, the
results of the query are returned. Per particle attributes can be
queried using the particleId or the order of the particle in the
particle array. If an object was edited, nothing is returned.
In query mode, return type is based on queried flag.
Long name (short name) |
Argument types |
Properties |
-position(-p) |
linear linear linear |
|
|
World-space position of each particle. |
|
-inherit(-i) |
float |
|
|
Inherit this fraction (0-1) of emitting object's velocity. |
|
-name(-n) |
string |
|
|
-shapeName(-sn) |
string |
|
|
Specify the shape name used for geometry instancing. DO not
confuse this with the -n flag which names the particle object. |
|
-count(-ct) |
|
|
|
Returns the number of particles in the object. |
|
-dynamicAttrList(-dal) |
|
|
|
Returns a list of the dynamic attributes in the object. |
|
-perParticleDouble(-ppd) |
|
|
|
Returns a list of the per-particle double attributes, excluding
initial-state, cache, and information-only attributes. |
|
-perParticleVector(-ppv) |
|
|
|
Returns a list of the per-particle vector attributes, excluding
initial-state, cache, and information-only attributes. |
|
-conserve(-c) |
float |
|
|
Conservation of momentum control (between 0 and 1). Specifies
the fraction of the particle shape's existing momentum which is
conserved from frame to frame. A value of 1 (the default)
corresponds to true Newtonian physics, in which momentum is
conserved. |
|
-particleId(-id) |
int |
|
|
Used in per particle attribute query and edit. Specifies the id
of the particle whose attribute is being queried or edited.
Querying the value of a per particle attribute requires the
-attribute and -id or -order flags and their arguments to precede
the -q flag.
In query mode, this flag needs a value.
|
|
-order(-or) |
int |
|
|
Used in per particle attribute query and edit. Specifies the
zero-based order (index) of the particle whose attribute is being
queried or edited in the particle array. Querying the value of a
per particle attribute requires the -attribute and -id or -order
flags and their arguments to precede the -q flag.
In query mode, this flag needs a value.
|
|
-attribute(-at) |
string |
|
|
Used in per particle attribute query and edit. Specifies the
name of the attribute being queried or edited.
In query mode, this flag needs a value.
|
|
-vectorValue(-vv) |
float float float |
|
|
Used only in per particle attribute edit. Specifies that the
edit is of a vector attribute and must be followed by all three
float values for the vector. |
|
-floatValue(-fv) |
float |
|
|
Used only in per particle attribute edit. Specifies that the
edit is of a float attribute and must be followed by the new float
value. |
|
-numJitters(-nj) |
uint |
|
|
Number of jitters (instances) per particle. |
|
-jitterRadius(-jr) |
linear |
|
|
Max radius from the center to place the particle
instances. |
|
-jitterBasePoint(-jbp) |
linear linear linear |
|
|
Base point (center point) for jitters. The command will create
one swatch of jitters for each base point. It will pair up other
flags with base points in the order they are given in the command
line. If not enough instances of the other flags are availble, the
last one on the line with be used for all other instances of
-jpb. |
|
-gridSpacing(-grs) |
linear |
|
|
Spacing between particles in the grid. |
|
-lowerLeft(-ll) |
linear linear linear |
|
|
Lower left point of grid. |
|
-upperRight(-ur) |
linear linear linear |
|
|
Upper right point of grid. |
|
-cache(-ch) |
boolean |
|
|
Turns caching on/off for the particle shape. |
|
-deleteCache(-dc) |
|
|
|
Deletes the particle shapes cache. This command is not
undoable. |
|