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 |
|
-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.
|
|
-cache(-ch)
|
boolean
|
|
|
Turns caching on/off for the particle shape.
|
|
-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.
|
|
-count(-ct)
|
|
|
|
Returns the number of particles in the object.
|
|
-deleteCache(-dc)
|
|
|
|
Deletes the particle shapes cache. This command is not undoable.
|
|
-dynamicAttrList(-dal)
|
|
|
|
Returns a list of the dynamic attributes in the object.
|
|
-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.
|
|
-gridSpacing(-grs)
|
linear
|
|
|
Spacing between particles in the grid.
|
|
-inherit(-i)
|
float
|
|
|
Inherit this fraction (0-1) of emitting object's velocity.
|
|
-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.
|
|
-jitterRadius(-jr)
|
linear
|
|
|
Max radius from the center to place the particle instances.
|
|
-lowerLeft(-ll)
|
linear linear linear
|
|
|
Lower left point of grid.
|
|
-name(-n)
|
string
|
|
|
|
-numJitters(-nj)
|
uint
|
|
|
Number of jitters (instances) per particle.
|
|
-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.
|
|
-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.
|
|
-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.
|
|
-position(-p)
|
linear linear linear
|
|
|
World-space position of each particle.
|
|
-shapeName(-sn)
|
string
|
|
|
Specify the shape name used for geometry instancing.
DO not confuse this with the -n flag which names the particle object.
|
|
-upperRight(-ur)
|
linear linear linear
|
|
|
Upper right point of grid.
|
|
-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.
|
|