| Attribute long name (and short name) |
Description |
Data Type |
acceleration (acc)
|
Sets the rate of change of velocity on a per
particle basis.
|
vector array
|
age (ag)
|
Contains the number of seconds each particle
in the object has existed since the first frame. This is a read-only attribute.
|
float array
|
attributeName*
|
Specifies the name of the attribute whose values
are to be displayed at particle positions. By default, particle
id numbers are displayed. Valid for Numeric render
type.
|
string
|
betterIllumination*
|
Provides smoother lighting and shadowing at
the expense of increased processing time. Valid for Cloud render type.
|
boolean
|
birthPosition
|
Stores the position at which each particle was
born in the particle’s local space.
|
vector array
|
birthTime
(bt)
|
Contains the Current Time value
at which each particle in the object was created. This is a read-only
attribute.
|
float array
|
cacheData (chd)
|
Turns on or off dynamic state caching for the
object.
|
boolean
|
castsShadows (rsh)
|
Turns on or off the object’s ability to cast
shadows in software rendered images. Valid for Cloud, Blobby Surface,
and Tube render types.
|
boolean
|
centroidX, centroidY, centroidZ (ctdx, ctdy, ctdz)
|
Contains the X, Y, and Z elements of the average
position of its particles. These are read-only attributes.
|
float
|
collisionFriction
(cfr)
|
Sets how much the colliding particle’s velocity
parallel to the surface decreases or increases as it bounces off the
collision surface. This attribute is displayed as Friction in
the user interface. It works on a per geometry basis.
|
float (multi)
|
collisionResilience (crs)
|
Sets how much rebound occurs when particles
collide with a surface. This attribute is listed as Resilience in
the user interface. It works on a per geometry basis.
|
float (multi)
|
collisionU, collisionV*
|
U and V positions of the NURBS surface where
a particle collided in the current frame. For polygonal surfaces, the
values are always 0. The values are reset to -1 at the start of
each frame. Values change only in frames where collision occurs.
These are read-only attributes.
|
float
|
colorAccum*
|
Adds the RGB components of overlapping particles.
Also adds opacity values of overlapping particles. Generally, colors
become brighter and more opaque as they overlap. To see the effect
of Color Accum, you must add an
opacity attribute to particles displayed as Points.
Valid for MultiPoint, MultiStreak, Points,
and Streak render types.
|
boolean
|
colorBlue*
|
Sets blue component of RGB color. Valid for
all render types except Numeric and Tube.
|
float
|
colorGreen*
|
Sets green component of RGB color. Valid for
all render types except Numeric and Tube.
|
float
|
colorRed*
|
Sets red component of RGB color. Valid for all
render types except Numeric and Tube.
|
float
|
conserve
(con)
|
Sets how much of a particle object’s velocity
attribute value is retained from frame to frame.
|
float
|
count
(cnt)
|
Contains the total number of particles in the
object. This is a read-only attribute.
|
integer
|
currentTime (cti)
|
Sets the time value for the particle object’s
independent clock.
|
time
|
depthSort (ds)
|
Turns on or off depth sorting of particles for
rendering. This prevents unexpected colors when you hardware render
overlapping colored, transparent particles. Valid for MultiPoint, MultiStreak, Points, Streak,
and Sprites render types.
|
boolean
|
dynamicsWeight (dw)
|
Scales the effect of fields, collisions, springs,
goals, and emission on particles.
|
float
|
emissionInWorld (eiw)
|
When
on, emission occurs in the world coordinate system. This is the
default setting. When off, emission occurs in the emitted particle
object’s local space.
|
boolean
|
emitterRatePP*
|
Sets the per particle emission rate.
|
float array
|
enforceCountFromHistory
(ecfh)
|
In a soft body, if you change the original geometry’s
construction history in a way that alters the number of CVs, vertices,
or lattice points, Maya updates the number of particles of the soft
body correspondingly.
|
boolean
|
event*
|
Contains the number of times each particle in
the object has hit something. This is a read-only attribute.
|
float array
|
expressionsAfterDynamics
(ead)
|
Sets whether expressions are evaluated before
or after other dynamics.
|
boolean
|
force (frc)
|
Contains
the accumulation of all forces acting on the particle object. This
is a read-only attribute. If you use this attribute in an expression,
first turn on expressionsAfterDynamics.
|
vector array
|
forcesInWorld (fiw)
|
Sets whether forces are applied to the object
in world space or in its local space.
|
boolean
|
goalActive (ga)
|
For a goal object, turns each goal on or off.
It has the same effect as setting the corresponding goalWeight to
0, except the animation processing is more efficient. This attribute
works on a per object basis.
|
boolean (multi)
|
goalOffset*
|
Sets an offset to the world space position of
the goal object.
|
vector array
|
goalPP*
|
Sets how much the particles try to follow the
goal on a per particle basis.
|
float array
|
goalSmoothness (gsm)
|
Sets how smoothly goal forces change as the
goal weight changes from 0 to 1. The higher the number, the smoother the
change.
|
float
|
goalU,
goalV*
|
Set the exact locations on a NURBS surface where
the particles are attracted.
|
float array
|
goalWeight (gw)
|
Sets how much all particles of the object are
attracted to the goal.
|
float (multi)
|
incandescencePP*
|
Sets glow color in conjunction with a software
rendering Particle Incand Mapper Node (see
Rendering.) Valid for Cloud and Tube render types.
|
vector array
|
inheritFactor (inh)
|
Sets the (decimal) fraction of velocity an emitted
particle object inherits from an emitter.
|
float
|
inputGeometrySpace (igs)
|
For a soft body, this sets the coordinate space
Maya uses to position point data provided by the input geometry
to the particle shape.
|
integer
|
isDynamic (isd)
|
Turns on or off dynamic animation of the object.
|
boolean
|
isFull
(ifl)
|
Contains 1 if an emitted particle shape is full,
or 0 if not full. An emitted particle shape is full when the number of
emitted particles equals the maxCount. This is a read-only attribute.
|
boolean
|
lifespan*
|
Sets when all particles in the object die.
|
float
|
lifespanPP*
|
Sets when particles die on a per particle basis.
|
float array
|
levelOfDetail (lod)
|
Scales the number of particles that can be emitted
into the emitted particle object.
|
float
|
lineWidth *
|
Sets the width of streaking particles. Valid
for MultiStreak and Streak render
types.
|
float
|
mass
(mas)
|
Specifies the physical mass of particles. Mass
values affect the results of dynamic calculations. By default, each particle
of a particle object has a mass of 1.
|
float array
|
mass0
(mas0)
|
Initial state counterpart to mass.
|
float array
|
maxCount (mxc)
|
Sets a limit on the number of particles the
emitted particle shape accepts from an emitter.
|
int
|
multiCount*
|
Sets number of points you want displayed for
each particle in the object. Valid for MultiPoint and Points render
types.
|
float
|
multiRadius*
|
Sets radius of spherical region in which particles
are randomly distributed. Valid for MultiPoint and MultiStreak render types.
|
float
|
needParentUV*
|
Turns
on or off the ability to read the parentU and parentV attributes.
If you add a surface emitter to a NURBS or polygonal
surface, parentU and parentV contain the UV coordinates where
each particle was emitted. You can use these attributes in expressions and
MEL scripts.
|
boolean
|
normalDir*
|
Sets direction of normal for particles. Use
with useLighting. Valid for MultiPoint, MultiStreak, Points,
and Streak render types.
|
integer (1-3)
|
opacity*
|
Sets amount of transparency for all particles
in the object. Valid for all render types except Numeric and Tube.
|
float
|
opacityPP*
|
Sets amount of transparency on a per particle
basis. Valid for all render types except Numeric, Tube,
and Blobby Surface.
|
float array
|
particleId
(id)
|
Contains the id number of each particle. Valid
for Numeric render type. This is
a read-only attribute.
|
float array
|
parentId*
|
If you emit from a particle object, this contains
the id of all particles that emit the particles. You can use the
id to query the emitting object’s attribute values, for example,
acceleration, velocity, and lifespanPP. This is a read-only attribute.
Note that if you use the MEL emit command to
create the particles that emit, the parentId attribute of those emitted
particles is always 0.
|
float array
|
parentU, parentV*
|
If
you add a surface emitter to a NURBS or polygonal
surface, these attributes contain the UV coordinates
where each particle was emitted. To use these read-only attributes,
you must turn on Need Parent UV in the emitter.
You can use these attributes in expressions and MEL scripts.
|
float array
|
particleRenderType*
|
Sets render display type of particles, for example, Streak.
|
integer
|
pointSize*
|
Sets how large particles are displayed. Valid
for MultiPoint, Numeric,
and Points render types.
|
float
|
position (pos)
|
Sets the object position in local space coordinates
on a per particle basis.
|
vector array
|
position0
(pos0)
|
Initial state counterpart to position.
|
vector array
|
radius*
|
Sets radius size of all particles. Valid for Blobby
Surface, Cloud, and Sphere render
types.
|
float
|
radius0*
|
Sets starting point radius for Tube render
type.
|
float
|
radius1*
|
Sets ending point radius for Tube render
type.
|
float
|
radiusPP*
|
Sets radius size on a per particle basis. Valid
for Blobby Surface, Cloud,
and Sphere, render types.
|
float array
|
rampAcceleration (rac)
|
Controls acceleration with a ramp. Any other
animation of acceleration is added to the ramp-controlled acceleration.
|
vector array
|
rampPosition
(rps)
|
Controls position with a ramp. Any other animation
of position is added to the ramp-controlled position.
|
vector array
|
rampVelocity
(rvl)
|
Controls velocity with a ramp. Any other animation
of velocity is added to the ramp-controlled velocity.
|
vector array
|
rgbPP*
|
Sets color on a per particle basis. Valid for MultiPoint, MultiStreak, Points, Spheres, Sprites,
and Streak render types.
|
vector array
|
seed
(sd)
|
Sets the id of the random number generator of
the associated emitter. This attribute works on a per object basis.
|
float (multi)
|
sceneTimeStepSize (sts)
|
Contains the value of the time difference between
the last displayed frame and current frame. This contains 1 if you’re
simply playing the animation or clicking the frame forward or backward
button. If you click widely separated frames in the Time Slider,
the attribute contains the difference in time between the two frames.
This is a read-only attribute.
|
time (in current units)
|
selectedOnly*
|
Turns on or off display of id numbers only for
selected particles. Valid for Numeric render
type.
|
boolean
|
spriteNum*
|
Sets the image number index for a Sprite image
sequence.
|
integer
|
spriteNumPP*
|
Sets the image number index for a Sprite image
sequence on a per particle basis.
|
integer array
|
spriteScaleX, spriteScaleY*
|
Sets the Sprite X-
and Y-axis image scale.
|
float
|
spriteScaleXPP, spriteScaleYPP*
|
Sets the Sprite X-
and Y-axis image scale on a per particle basis.
|
float array
|
spriteTwist*
|
Sets the Sprite image’s
rotation angle.
|
float
|
spriteTwistPP*
|
Sets the Sprite image’s
rotation angle on a per particle basis.
|
float array
|
startFrame (stf)
|
Sets the animation frame after which dynamics
(including emission) are computed for the object.
|
float
|
surfaceShading*
|
Sets how sharply the spheres of Cloud render
type are displayed. Use a value between 0 and 1. A value of 1 displays spheres
more distinctly; a value of 0 creates a cloudier effect.
|
float
|
tailFade*
|
Sets the opacity of tail fade. Valid for MultiStreak and Streak render
types.
|
float
|
tailSize*
|
Sets the length of the tails for MultiStreak, Streak,
and Tube render types.
|
float
|
targetGeometrySpace (tgs)
|
For a soft body, sets the coordinate space Maya
uses to position point data provided by the particle shape to the target
geometry.
|
integer
|
threshold*
|
Controls surface blending between Cloud or Blobby surface
spheres. This is a read-only attribute.
|
float
|
timeStepSize
(tss)
|
Contains the animation frame increment in current
units. For example, if your animation is set to Film
(24 fps), timeStepSize has a value of
1 (frame).
Keying or otherwise setting the Current
Time value alters the timeStepSize. For instance, with
a frame rate of 24 frames per second, suppose you set the Current
Time to 0 at frame 0, and to 100 at frame 50. Because
you’re compressing twice as much time between frames 0 and 50, the timeStepSize is
twice as large, in other words, 2. This is a read-only attribute.
|
time
|
totalEventCount (evc)
|
Contains total events that have occurred for
all particles of the object. This is a read-only attribute.
|
integer
|
traceDepth (trd)
|
Sets the maximum number of collisions Maya can
detect for the object in each animation time step.
|
integer
|
traceDepthPP*
|
Sets the trace depth on a per particle basis.
|
float array
|
UseCurrentUVSet
|
Selects the UV set on the poly emitter that
is used for textured emission effects. The same UV set is used for
all textures attached to all textured emission effects (color/opacity
and emission rate). If the UseCurrentUVSet option
is selected, then the active UV set on the surface emitter is used.
|
boolean
|
useLighting*
|
Turns on or off whether scene lighting lights
up particles. Valid for MultiPoint, MultiStreak, Points, Sprites,
and Streak render types.
|
boolean
|
userScalar1PP userScalar2PP userScalar3PP userScalar4PP userScalar5PP
|
Predefined outputs for user-defined attributes
used in Particle Sampler Info node.
|
float array
|
userVector1PP userVector2PP userVector3PP userVector4PP userVector5PP
|
Predefined outputs for user-defined attributes
used in Particle Sampler Info node.
|
vector array
|
velocity
(vel)
|
Sets speed and direction on a per particle basis.
|
vector array
|
velocity0
(vel0)
|
Initial state counterpart to velocity
|
vector array
|
visibleInReflections (rrl)
|
Turns on or off whether the object is visible
in reflections when software rendered. Valid for Cloud, Blobby Surface,
and Tube render types.
|
boolean
|
visibleInRefractions (rrr)
|
Turns on or off whether the object is visible
in refractions when software rendered. Valid for Cloud, Blobby Surface,
and Tube render types
|
boolean
|
worldBirthPosition
|
Stores the position at which each particle was
born in world space.
|
vector array
|
worldCentroidX, worldCentroidY, worldCentroidZ (wctx,
wcty, wctz)
|
Contains the world space X, Y, and Z elements
of the average position of its particles. These attributes are a
read-only attributes.
|
float
|
worldPosition (wps)
|
Contains the world space counterpart to position.
This is a read-only attribute.
|
vector array
|
worldVelocity (wvl)
|
Contains the world space counterpart to velocity.
This is a read-only attribute.
|
vector array
|
worldVelocityInObjectSpace
(wvo)
|
Contains the local space equivalent to the object’s
world space velocity. This is a read-only attribute.
|
vector array
|
(the