Go to: Related nodes. Attributes.

The particle node implements a particle object (a collection of particles).
It uses the position, velocity, acceleration (and mass, if the user adds it)
attributes to compute dynamics for the particles.   It also has attributes
to define goal forces for the particles and to write per-particle expressions
for the particles.  To save memory, many attributes are added dynamically
as the user needs them: these include lifespan, color, goals, and most
rendering attributes.  The particle node also maintains the collection of
collision events which has been defined for this object, and resolves the
effect of those events as collisions occur.

Node nameParentsMFn typeCompatible function sets
particledeformableShapekParticlekBase
kNamedObject
kDependencyNode
kDagNode
kShape
kParticle

Related nodes

rigidConstraint, dynBase, field, airField, turbulenceField, radialField, vortexField, newtonField, volumeAxisField, dragField, uniformField, gravityField, pointEmitter, rigidBody, geoConnectable, spring

Attributes (205)

Attribute quick index omitted (too many attributes to show them all).

Long name (short name)TypeDefaultFlags
position (pos) vectorArrayemptyoutputinputconnectable
Runtime state, positions in object-space at the end of the time-step, per-particle. Requesting this attribute will force the dynamics to be solved.
rampPosition (rps) vectorArrayemptyoutputinputconnectablehidden
Use this attribute to control position by a ramp. The values from this attribute will be copied into "position" before each step in the dynamics simulation.
centroid (ctd) double3outputconnectable
Centroid (average position) of the particles. This is in local coordinates. See also worldCentroid.
centroidX (ctdx) double0.0outputconnectable
X-component of centroid (average position) of the particles. This is in local coordinates. See also worldCentroid.
centroidY (ctdy) double0.0outputconnectable
Y-component of centroid (average position) of the particles. This is in local coordinates. See also worldCentroid.
centroidZ (ctdz) double0.0outputconnectable
Z-component of centroid (average position) of the particles. This is in local coordinates. See also worldCentroid.
lastPosition (lpos) vectorArrayemptyoutputconnectablehidden
The position of the particles at the end of the previous timestep. This attribute does force the evaluation of dynamics.
velocity (vel) vectorArrayemptyoutputinputconnectable
Runtime state, velocities at the end of the time-step, per-particle.
rampVelocity (rvl) vectorArrayemptyoutputinputconnectablehidden
Use this attribute to control velocity with a ramp. The values from this attribute will be copied into "velocity" before each step in the dynamics simulation.
lastVelocity (lvel) vectorArrayemptyoutputconnectablehidden
The velocity at the end of the previous solving step. This will have its value set at the END of the previous solving step.
acceleration (acc) vectorArrayemptyoutputinputconnectable
Runtime state, accelerations, per-particle.
rampAcceleration (rac) vectorArrayemptyoutputinputconnectablehidden
This is where all ramps input "acceleration" will actually connect. The values from this attribute will be copied into "acceleration" before each step in the dynamics simulation.
force (frc) vectorArrayemptyoutputconnectable
The effects of fields, goals, etc. on the particles are accumulated in this attribute.
inputForce (ifc) vectorArrayemptyarrayoutputinputconnectable
This is the input multi-attribute where any fields acting on this particle object are connected. These are accumulated in the computePlug() section for aForce, along with other forces like goals.
worldPosition (wps) vectorArrayemptyoutputconnectable
This is the world-space position of the particles at the end of the time-step. Requesting this attribute will force the dynamics to be solved.
worldCentroid (wctn) double3outputconnectable
World-space centroid (average position) of the particles. This is in world coordinates. See also "centroid."
worldCentroidX (wctx) double0.0outputconnectable
X-component of world centroid (average position) of the particles. This is in world coordinates. See also "centroid."
worldCentroidY (wcty) double0.0outputconnectable
Y-component of world centroid (average position)of the particles. This is in world coordinates. See also "centroid."
worldCentroidZ (wctz) double0.0outputconnectable
Z-component of world centroid (average position) of the particles. This is in world coordinates. See also "centroid."
lastWorldPosition (lwps) vectorArrayemptyoutputconnectablehidden
The world-space position of the particles at the end of the previous timestep. This attribute does force the evaluation of dynamics.
worldVelocity (wvl) vectorArrayemptyoutputconnectable
This is the world-space velocity of the particles at the end of the time-step. This includes motion from the parent matrix.
worldVelocityInObjectSpace (wvo) vectorArrayemptyoutputinputconnectable
This is the world-space velocity of the particles as derived from dynamics and from motion of the world matrix. THis value is then tranformed into object-space for drawing.
lastWorldVelocity (lwvl) vectorArrayemptyoutputconnectablehidden
This is the world-space velocity from the end of the LAST time-step.
lastWorldMatrix (lwm) matrixidentityoutputconnectablehidden
This is the world matrix from the last time evaluated (currentSceneTime - sceneTimeStepSize).
position0 (pos0) vectorArrayemptyoutputinputconnectablestorablehidden
Initial state, positions, per-particle.
velocity0 (vel0) vectorArrayemptyoutputinputconnectablestorablehidden
Initial state, velocities, per-particle.
acceleration0 (acc0) vectorArrayemptyoutputinputconnectablestorablehidden
Initial state, accelerations, per-particle.
emitterId0 (eid0) doubleArrayemptyoutputhidden
This attribute holds the emitter id (multi index) of the particles added to this object from emitters and the emit action, but NOT from collision events.
useStartupCache (usc) boolfalseoutputinputstorablehidden
This boolean attribute is used at file save and load. It records whether a runtime state has been stored in a startup cache file. If this attribute is true, Maya will use the values stored in that file instead of restoring the initial state and running up the scene. If Maya cannot find the startup cache file or it does not contain valid data, Maya will run up the scene. Users normally do not set this attribute. Instead, use the dynamics preferences window to tell Maya to do all the necessary operations. Just setting this attribute does not create the cache.
startupCachePath (scp) stringNULLoutputinputconnectablestorable
This attribute holds the name of the file path on which to find the startup cache file (see useStartupCache). Users normally do not set this attribute. Maya sets it when creating the cache. The path is always relative to the workspace particle data area.
startupCacheFrame (scf) integer0outputinputconnectablestorable
Ifentifies the frame for which the current startup cache is valid. generally this will be the frame for which this object was most recently saved. Users notmally should not set this attribute. Use the Dynamics option window to enable or disable startup cache.
cachedPosition (cpos) vectorArrayemptyoutputconnectablehidden
This will have its value set at the END of the solving step. This attribute shares the memory with aPosition and is the most current value of aPosition WITHOUT forcing evaluation of the dynamics.
lastCachedPosition (lcps) vectorArrayemptyoutputconnectablehidden
This is the most current value for aLastPosition WITHOUT forcing evaluation of the dynamics.
cachedWorldPosition (cwps) vectorArrayemptyoutputconnectablehidden
This is the most current value for the aWorldPosition attribute WITHOUT forcing evaluation of the dynamics.
cachedWorldCentroid (cwcn) double3outputconnectablehidden
Cached World-space centroid (average position) of the particles. This is the most current value of the worldCentroid WITHOUT forcing the evaluation of dynamics.
cachedWorldCentroidX (cwcx) double0.0outputconnectablehidden
Cached World x-component of centroid (average position) of the particles. This is the most current value of the worldCentroid WITHOUT forcing the evaluation of dynamics.
cachedWorldCentroidY (cwcy) double0.0outputconnectablehidden
Cached World y-component of centroid (average position) of the particles. This is the most current value of the worldCentroid WITHOUT forcing the evaluation of dynamics.
cachedWorldCentroidZ (cwcz) double0.0outputconnectablehidden
Cached World z-component of centroid (average position) of the particles. This is the most current value of the worldCentroid WITHOUT forcing the evaluation of dynamics.
cachedVelocity (cvel) vectorArrayemptyoutputconnectablehidden
This will have its value set at the END of the solving step. Its value will be that of the resulting aVelocity attribute.
cachedWorldVelocity (cwvl) vectorArrayemptyoutputconnectablehidden
This will have its value set at the END of the solving step. Its value will be that of the resulting aVelocity attribute.
count (cnt) integer0outputconnectable
The number of particles in the object.
computingCount (cmp) boolfalseoutputinputhidden
This is a boolean used to avoid recursion in the computeCount method. It should not be set by customers.
mass (mas) doubleArrayemptyoutputinputconnectable
Runtime state, mass, per-particle.
mass0 (mas0) doubleArrayemptyoutputinputconnectablestorablehidden
Initial state, mass, per-particle.
massCache (masc) doubleArrayemptyoutputconnectablehidden
Cached state, mass.
particleId (id) doubleArrayemptyoutputconnectablehidden
Unique id number for each particle.
particleId0 (id0) doubleArrayemptyoutputinputconnectablestorablehidden
Initial state, id values, per-particle.
idCache (idc) doubleArrayemptyoutputconnectablehidden
Cached state, id values.
idMapping (idm) compoundn/aoutputconnectablehidden
This compound holds the mapping information for the particle ID values.
sortedId (sid) intArrayemptyoutputconnectablehidden
This array holds the particleId values sorted in ascending order. Together with idIndex, it can be used to locate a given id quickly in the arrays of particle data.
idIndex (idix) intArrayemptyoutputconnectablehidden
This array holds the index positions into the per-particle attribute arrays for the corresponding ids stored in aSortedId. Together with sortedId, it can be used to locate a given id quickly in the arrays of particle data.
nextId (nid) integer0outputinputstorablehidden
Next available value for aId
nextId0 (nid0) integer0outputinputstorablehidden
Initial value of aNextId
birthTime (bt) doubleArrayemptyoutputconnectable
This stores the time, in seconds, at which each particle was born. This makes the age computation more accurate and easily calculated.
birthTime0 (bt0) doubleArrayemptyoutputinputconnectablestorablehidden
Initial state, birth times, per-particle.
birthTimeCache (btc) doubleArrayemptyoutputinputconnectablehidden
Cached state, birth times, per-particle.
age (ag) doubleArrayemptyoutputconnectable
Age per-particle in seconds.
age0 (ag0) doubleArrayemptyoutputinputconnectablestorable
Initial state, ages, per-particle.
ageCache (agc) doubleArrayemptyoutputconnectable
Cached state, age values.
emission (emt) genericArrayemptyoutputconnectablehidden
This attribute holds all of the particles added to this object from emitters and the emit action, but NOT from collision events.
emitterId (eid) doubleArrayemptyoutputhidden
This attribute holds the emitter id (multi index) of the particles added to this object from emitters and the emit action, but NOT from collision events.
dieOnEmissionVolumeExit (dve) boolfalseoutputinputconnectablestorablekeyable
If the particles were emitted from a volume, die when they exit that volume.
isFull (ifl) boolfalseoutputconnectable
Tells any object whether this particle object has room for any new particles or not, based on the maxCount and count attributes.
newParticles (npt) genericArrayemptyarrayinputconnectablehidden
This is where emitters will send any particles that they create for this particle object.
collisionEvents (cev) boolfalsehidden
Requesting this attribute will trigger collision events.
death (dth) boolfalsehidden
Requesting this attribute will trigger death of old particles.
lifespanMode (lfm) enum0outputinputconnectablestorablekeyable
Determines which attributes to use for particle lifespan. "Range" means use lifespan + lifespanRandom together to give each particle an individual lifespan. This lifespan is stored in the attribute "finalLifespanPP." "PP" means that you want to drive lifespans using the lifespanPP attribute. You must then either write an expression or set values for this attribute in the component editor. "Live forever" disables lifespan altogether. In this mode, all particles live forever, unless killed by collision events or emission volume exit (see the dieOnEmissionVolume exit attribute). Lifespan mode has nothing to do with events or emission volume exit and does not override them.
lifespanRandom (lfr) double0.0outputinputconnectablestorablekeyable
Used only if lifespanMode is set to "Random Range." Identifies a range of random variation for the lifespan of each particle. If set to a non-zero value, each particle's lifespan varies randomly up to plus or minus lifespanRandom/2, with the "lifespan" attribute value as the mean (the average lifespan). For example, lifespan 5 and lifespanRandom 2 will make the lifespans vary between 4 and 6. In Constant or Random Range mode, the finalLifespanPP attribute stores the values generated from lifespan and lifespanRandom. Note: Changes in the values of lifespan and lifespanRandom affect only new particles, not particles that already exist. For example, if you key the value of lifespan to be 2 up until frame 50 and 5 thereafter, then particles generated from frame 1 to 50 will have finalLifespanPP 2 and particles generated after frame 50 will have finalLifespanPP 5. The finalLifespanPP values of particles born prior to frame 50 will not change.
finalLifespanPP (flp) doubleArrayemptyoutputconnectablehidden
finalLifespanPP stores the final result of the particle object's lifespan computations, from whatever lifespan mode is currently in force. if the lifespan mode is "use lifespanPP" then this attribute will be a copy of lifespanPP. If the mode is "constant" or "random range" then it will be generated from lifespan and lifespan random. If the mode is "None" then it will be an array of maximum float values. You cannot write to finalLifespanPP, the particle object generates it for you. You can always access finalLifespanPP for expressions and it will always be the effective lifespan value regardless of mode. Note that there is no finalLifespanPP0 initial state attribute. Instead, finalLifespanPP values are re-generated when needed from the random stream.
generalSeed (gsd) integer0outputinputhidden
Seed for random number generation. It is independent of all other random number streams.
randState (rnst) long3outputinputhidden
Current state of random stream. Should not be set by users.
randStateX (rstx) integer0outputinputhidden
Current state of random stream. Should not be set by users.
randStateY (rsty) integer0outputinputhidden
Current state of random stream. Should not be set by users.
randStateZ (rstz) integer0outputinputhidden
Current state of random stream. Should not be set by users.
expressionsAfterDynamics (ead) boolfalseoutputinputconnectablestorablekeyable
This boolean attribute lets the user decide whether they want the expressions to happen before or after the dynamics is computed.
executeCreationExpression (ece) boolfalsehidden
This attribute is requested to trigger the execution of creation expressions.
executeRuntimeBeforeDynamicsExpression (erbe) boolfalsehidden
This attribute is requested to trigger the execution of runtime expressions.
executeRuntimeAfterDynamicsExpression (erae) boolfalsehidden
This attribute is requested to trigger the execution of runtime expressions.
input (xi) GenericNULLarrayoutputinputconnectablehidden
This attribute is where any input attribute for the expressions, both runtime and creation, is connected.
output (xo) GenericNULLarrayoutputconnectablehidden
This attribute is where any output attribute for the expressions, both runtime and creation, is connected.
time (tim) time0filminputconnectablehidden
This holds the value for time to be queried in seconds. This is a separate attribute then the time in frames because the Sophia (MEL) nodes are using a plug to decide which values to get. If they just had a handle to the time-in-seconds plug, we could not tell if the user wanted seconds or frames. Also, it must be a TattributeTime instead of a Double because the dependency graph would try to insert a conversion node in between the time node and this attribute. This would always result in the current time unit to be sent.
frame (frm) time0filminputconnectablehidden
This holds the value for time to be queried in frames. This is a separate attribute then the time in seconds because the Sophia (MEL) nodes are using a plug to decide which values to get. If they just had a handle to the time-in-seconds plug, we could not tell if the user wanted seconds or frames. Also, it must be a TattributeTime instead of a Double because the dependency graph would try to insert a conversion node in between the time node and this attribute. This would always result in the current time unit to be sent.
internalRuntimeExpression (irx) stringNULLoutputinputhidden
This is the internal representation of the runtime expression. All of the places where attributes were are replaced with tokens representing the multi-index of the input/output attribute to which they are connected.
internalRuntimeBeforeDynamicsExpression (irbx) stringNULLoutputinputstorablehidden
This is the internal representation of the runtime expression. All of the places where attributes were are replaced with tokens representing the multi-index of the input/output attribute to which they are connected.
internalRuntimeAfterDynamicsExpression (irax) stringNULLoutputinputstorablehidden
This is the internal representation of the runtime expression. All of the places where attributes were are replaced with tokens representing the multi-index of the input/output attribute to which they are connected.
internalCreationExpression (icx) stringNULLoutputinputstorablehidden
This is the internal representation of the creation expression. All of the places where attributes were are replaced with tokens representing the multi-index of the input/output attribute to which they are connected.
currentParticle (xcp) integer0hidden
During the evaluation of both runtie and creation expressions, this value is used to keep track of which particle's value each per-particle attribute is to get/set.
diedLastTime (dlt) integer0outputinputconnectablehidden
OBSOLETE ATTRIBUTE. No effect.
netEmittedLastTime (nlt) integer0outputinputconnectablehidden
OBSOLETE ATTRIBUTE. No effect.
startEmittedIndex (sei) integer-1outputinputconnectablehidden
OBSOLETE ATTRIBUTE. No effect.
isDynamic (isd) booltrueoutputinputconnectablestorablekeyable
Toggle dynamics on/off for this object.
dynamicsWeight (dw) double1.0outputinputconnectablestorablekeyable
Fraction of dynamics forces which get applied each time step.
forcesInWorld (fiw) booltrueoutputinputconnectablestorablekeyable
This boolean tells the solver to transform all field forces into object space before doing the dynamics. This makes the particles respond as if they were in the same space as the forces when they are in some non-identity hierarchy.
conserve (con) double1.0outputinputconnectablestorablekeyable
If set to a value less than one, only the corresponding portion of existing velocity will be retained when computing the next step. For example, if conserve is 0, all existing velocity will be erased before each new step. The name "conserve" refers to conservation momentum. Real (Newtonian) physics corresponds to conserve = 1.
emissionInWorld (eiw) booltrueoutputinputconnectablestorablekeyable
This boolean tells the particle object to assume that particles created from emission are in world space, and to transform them into object space before adding them to the particle array. This makes the particles respond as if they were in the same space as the emitter when they are in some non-identity hierarchy.
maxCount (mxc) integer-1outputinputconnectablestorablekeyable
Maximum count of particles this shape will allow. If some particles die off, new particles will again be accepted up to the max count, and so on.
levelOfDetail (lod) double1outputinputconnectablestorablekeyable
Currently only used to scale the amount of emission to be used for quick motion tests without having to change emitter values. Affects only emitted particles.
inheritFactor (inh) double0.0outputinputconnectablestorablekeyable
Fraction of emitter velocity that particles emitted into this object inherit.
seed (sd) integer1arrayoutputinputconnectablestorable
Random number stream seed for emitter's random number stream. Separate seed for each emitter. Set seeds equal to get identical stream. Resetting the seed at a particular frame will restart the stream.
fieldData (fd) compoundn/aoutputconnectablehidden
This is the compound that holds all of the default attribute for the fields to connect to. The contents are just sharing the data from the real attributes.
fieldDataPosition (fdp) vectorArrayemptyoutputconnectablehidden
This is the default place that the fields will get this particle object's position data from. It will share the data from aPosition.
fieldDataVelocity (fdv) vectorArrayemptyoutputconnectablehidden
This is the default place that the fields will get this particle object's velcoity data from. It will share the data from aVelocity.
fieldDataMass (fdm) doubleArrayemptyoutputconnectablehidden
This is the default place that the fields will get this particle object's mass data from. It will share the data from aMass.
fieldDataDeltaTime (fdt) time0filmoutputconnectablehidden
This is the default place that the fields will get this particle object's timeStep size from. It will share the data from aTimeStepSize.
emitterData (ed) compoundn/aoutputconnectablehidden
This is the compound that holds all of the default attribute for the emitters to connect to. The contents are just sharing the data from the real attributes.
emitterDataPosition (edp) vectorArrayemptyoutputconnectablehidden
This is the default place that the emitters will get this particle object's position data from. It will share the data from aPosition.
emitterDataVelocity (edv) vectorArrayemptyoutputconnectablehidden
This is the default place that the emitters will get this particle object's velcoity data from. It will share the data from aVelocity.
emitterDataDeltaTime (edt) time0filmoutputconnectablehidden
This is the default place that the emitters will get this particle object's timeStep size from. It will share the data from aTimeStepSize.
forceDynamics (fdn) boolfalsehidden
By requesting this attribute, all of the dynamics, emission, and death will be forced for this particle shape. It is intended to be used for batch mode and dynamics run-up.
currentTime (cti) time0filmoutputinputconnectablekeyable
This is the current time used for the particle solution. By default, it is given an incoming connection from the main time node. This can be replaced with some other connection (e.g. from an expression or param curve), and then the solving is done based on that time value. There must be some incoming connection in order for the particle object to play back.
currentTimeSave (cts) time0filmoutputinputstorablehidden
This is a copy of the currentTime attribute to be saved to file in the case where the user wishes to save runtime state. Users should not set or read this attribute. Use currentTime instead.
evaluationTime (eti) time0.0filmoutputinputkeyablehidden
For internal use only.
currentSceneTime (cst) time1.0filmoutputinputhidden
This is that actual scene time. It is set from the current graph whenever aCurrentTime is set so that we can recover the worldMatrix information correctly. Users should not set this attribute.
lastTimeEvaluated (lti) time0filmoutputconnectablehidden
This would get the value from aCurrentTime "copied" into it at the end of the solving process. There are no AFFECTS relationships here so that requesting this attribute does not trigger any other evaluation. Because of the timing of when this attribute gets set, it should not be used by users as reliable data. It is for internal computation only.
lastSceneTime (lst) time0filmoutputinputhidden
This is the scene time for the last time the dynamics was evaluated. It is only valid at the beginning of the dynamics computation. After the dynamics computation, it is set to be the current scene time. It is used when computing the lastWorldMatrix attribute. We need to build a context with the scene time of the last evaluation.
cachedTime (chti) time0filmoutputconnectablehidden
Users should not set or use this attribute. Results will be unpredictable.
timeStepSize (tss) time0filmoutputconnectable
For internal use only. Users should not set this. It is defined as (currentTime - lastTimeEvaluated)/overSamples.
sceneTimeStepSize (sts) time0filmoutputconnectablehidden
This is the step size in scene time. This should be used for world-space computations. Users should not set this attribute.
startFrame (stf) double1.0outputinputconnectablestorablekeyable
This is the frame after which dynamics will be solved. No dynamics will play back for this object prior to startFrame.
startTime (stt) time0.0filmoutputconnectablehidden
The time after which dynamics will be solved for this particle object. This is set from the startFrame attribute. Users should set startFrame instead of this attribute.
inputGeometry (igeo) Genericn/aoutputinputconnectablestorable
Input Geometr(y/ies) for soft body. This should be connected from the local/object-space version of the geometry. Valid inputs are polygons, nurbs surfaces, nurbs curves, and lattices.
inputGeometryPoints (igpt) vectorArrayemptyoutputconnectable
This attribute stores the point data from the inputGeometry attribute as a vectorArray. This allows the expressions to have access and knowledge about the geometry.
inputGeometrySpace (igs) enum0outputinputconnectablestorablekeyable
This attribute tells the particle object which coordinate space to make the inputGeometryPoints attribute in. The inputGeometry is received with the points in the geometry's local space. If the attribute is set to 0(kGeomLocal), then those same point values are put into the inputGeometryPoints. If the value is 1(kGeomWorld), then the point values are transformed input world-space with the geometry's world matrix. Finally, if the value is 2(kGeomParticle), then the points are transformed into world-space with the geometry's world matrix, and then into the particle object's loca space with the particle objecty's inverse world matrix.
enforceCountFromHistory (ecfh) booltrueoutputinputconnectablestorablekeyable
Tells the particle object to keep its count consistent with the pointCount of any incoming history in inputGeometry, if one exists.
targetGeometry (tgeo) Genericn/aoutputconnectable
Geometry for soft body.
targetGeometryWorldMatrix (tgm) matrixidentityoutputinputconnectable
This attribute is optionally connected to from the world matrix of the target geometry. It allows the targetGeometrySpace attribute to correctly use the kTargetGeomLocal setting.
targetGeometrySpace (tgs) enum2outputinputconnectablestorablekeyable
This attribute tells the particle object which coordinate space to build the targetGeometry data in. If targetGeometrySpace is 2(kTargetGeomParticle), then the values from the particle object's position attribute are used as the points for the target geometry. If the value is 1(kTargetGeomWorld), then the position points are transformed into world-space with the particle object's world matrix. If the value is 0(kTargetGeomLocal), then the position points are transformed into world-space, and then they are transformed into the target geometry's local space with the inverse of targetGeometryMatrix if it has an incoming connection. If targetGeometryMatrix does not have a connection, then a warning is displayed telling the user why it can not get the target geometry's world matrix, and the identity matrix is used.
goalSmoothness (gsm) double3outputinputconnectablestorablekeyable
This value is used to control the "smoothness" of the change in the goal forces as the weight changes from 0.0 to 1.0. This is purely an asthetic effect, with no scientific basis. The higher the number, the smoother the change.
goalGeometry (ggeo) Genericn/aarrayoutputinputconnectable
The input geometry attributes for the goal objects.
goalWeight (gw) double0.0arrayoutputinputconnectablestorablekeyable
The goal weights for the various goal objects.
goalActive (ga) booltruearrayoutputinputconnectablestorablekeyable
The active status for the goal objects. This is a switch that turns each goal ON or OFF. This has the same visual as setting the corresponding goalWeight to 0. The difference is that with a goalActive of OFF, the goal positions are not even taken into account in the computation, and therefore make the computation run faster.
goalUvSetName (guv) stringNULLarrayoutputinputconnectablestorable
For goal objects that have multiple uv sets, this attribute specifies which uv set to use when goalU/goalV values are present for particles.
cacheData (chd) bool0outputinputconnectablestorablekeyable
Indicates that caching is on/off.
cacheWidth (chw) integer1outputinputconnectablestorable
The width of the cache is the number of different time points for which the state can be cached.
collisions (col) boolfalsehidden
Requesting this attribute will trigger collisions.
traceDepth (trd) integer10outputinputconnectablestorablekeyable
This is the maximum number of consecutive collisions that are detected within a frame for each particle. Particles may collide fewer times, of course.
collisionData (cda) compoundn/aoutputinputconnectable
Parent attribute for all collision input data.
collisionGeometry (cge) sweptGeometryNULLarrayoutputinputconnectablehidden
The swept geometry for the connected shape.
collisionResilience (crs) double0.0arrayoutputinputconnectable
How much of the particle's velocity perpendicular to the surface is reflected
collisionFriction (cfr) double0.0arrayoutputinputconnectable
The amount of a particle's velocity parallel to a surface that is lost in the collision
collisionOffset (cof) double0.01arrayoutputinputconnectable
The distance the particle is offset from point of intersection on surface during reflection.
collisionRecords (crc) genericArrayemptyoutputconnectablehidden
This is the READ-ONLY attribute where all of the information about the particle object's collisions for each frame is stored.
totalEventCount (tec) integer0outputconnectable
Total number of collisions which have occurred for this object. All collisions are counted regardless of whether any collision events were actually executed. In other words, totalEventCount is the sum of the per-particle "event" attribute.
eventTest (evt) boolfalseoutputconnectable
True if any particle collision has occured since the last time the attribute was read. However, if you read the attribute twice in succession in the same frame you will get the same result both times. Note that it does not matter whether collision events were executed at the collisions in question.
lastTotalEventCount (ltec) integer0outputinputconnectablehidden
Used to compute eventTest attribute.
eventSeed (esd) integer0outputinputhidden
Seed for random number generation for events. All events tap into the same random number stream. It is independent of all other random number streams.
eventRandState (erst) long3outputinputhidden
Current state of random stream for events. Should not be set by users.
eventRandStateX (ersx) integer0outputinputhidden
Current state of random stream for events. Should not be set by users.
eventRandStateY (ersy) integer0outputinputhidden
Current state of random stream for events. Should not be set by users.
eventRandStateZ (ersz) integer0outputinputhidden
Current state of random stream for events. Should not be set by users.
eventTarget (etg) Messagen/aarrayoutputinputconnectable
Target parameters of particle collision events. Edit this through the particle event editor.
eventName (evn) stringNULLarrayoutputinputconnectablestorable
Names of particle collision events. Edit this through the particle event editor.
eventValid (evv) integer-1arrayoutputinputconnectablestorablekeyable
Marks valid particle collision events. Setting this to false turns an event off, in effect. Edit this through the particle event editor.
eventCount (ecp) short-1arrayoutputinputconnectablestorablekeyable
Event count parameters of particle collision events. Edit this through the particle event editor.
eventEmit (eve) short-1arrayoutputinputconnectablestorablekeyable
Emit parameters of particle collision events. Edit this through the particle event editor.
eventSplit (evs) short-1arrayoutputinputconnectablestorablekeyable
Split parameters of particle collision events. Edit this through the particle event editor.
eventDie (evd) short-1arrayoutputinputconnectablestorablekeyable
Die parameters of particle collision events. Edit this through the particle event editor.
eventRandom (evr) short-1arrayoutputinputconnectablestorablekeyable
Random parameters of particle collision events. Edit this through the particle event editor.
eventSpread (esp) double-1.0arrayoutputinputconnectablestorablekeyable
Controls random distribution of multiple particles created at single collision. Edit this through the particle event editor.
eventProc (epr) stringNULLarrayoutputinputconnectablestorablekeyable
Proc names for particle collision events. Edit this through the particle event editor.
instanceData (idt) compoundn/aarrayoutputinputconnectablestorable
This compound attribute groups together the attributes that provide data about instanced particles to the instancer node, or other node that can make use of this info.
instanceAttributeMapping (iam) stringArrayNULLoutputinputstorable
This attribute defines the names of the attributes for which the instancePointData attribute will output per-particle data.
instancePointData (ipd) genericArrayemptyoutputinputconnectable
This attribute contains per-particle data that is created according to the string data (attribute names) in the instanceAttributeMapping attribute. For each attribute listed by the instanceAttributeMapping, an array of per-particle data is output for use by the instancer node.
debugDraw (dbd) short0outputinputhidden
For internal use only. Should not be set by customers.
numberOfEvents (nev) short0outputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
eventNameCount (enc) short0outputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
fieldConnections (fc) Messagen/aarrayoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
collisionConnections (cc) Messagen/aarrayoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
connectionsToMe (ct) Messagen/aarrayoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
auxiliariesOwned (ao) Messagen/aoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
emitterConnections (ec) Messagen/aarrayoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
inheritColor (inc) boolfalseoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
shapeNameMsg (snmg) Messagen/aoutputinputconnectable
Identifies a shape to be used for geometry instancing. (Incomplete in Maya 1.0.)
doDynamics (ddy) boolfalseoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
doEmission (dem) boolfalseoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
forceEmission (fem) boolfalseoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
doAge (dag) boolfalseoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
agesLastDone (agld) double0.0outputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
timeLastComputed (tlc) double0.0outputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
parentMatrixDirty (pmd) boolfalseoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
newFileFormat (nff) short0outputinputconnectablestorablehidden
Obsolete. No function. Will be removed in next major release.
depthSort (ds) boolfalseoutputinputconnectablestorable
Turn on depth sorting of particles for rendering.
particleRenderType (prt) enum3outputinputconnectablestorablekeyable
Hardware rendering method.
disableCloudAxis (dca) boolfalseoutputinputconnectablestorablehidden
Disable the dominant axis for cloud better illumination.
normalizeVelocity (nvl) boolfalseoutputinputconnectablestorable
Not yet enabled
mentalRayControls (mrc) compoundn/aoutputinputconnectablestorable
This is a root of following mental ray attributes.
miOverrideCaustics (oca) boolfalseoutputinputconnectablestorable
Enable caustic settings override for this shape. If this parameter is set, the following caustics settings will override the renddr global settings for this shape node.
miCausticAccuracy (caa) short64outputinputconnectablestorable
Caustic accuracy for this shape if miOverrideCaustics is on.
miCausticRadius (car) float0outputinputconnectablestorable
Caustic radius for this shape if miOverrideCaustics is on.
miOverrideGlobalIllumination (ogi) boolfalseoutputinputconnectablestorable
Enable global illumination settings override for this shape. If this parameter is set, the following global illumination settings will override the renddr global settings for this shape node.
miGlobillumAccuracy (gia) short64outputinputconnectablestorable
Global illumination accuracy for this shape if miOverrideGlobalIllumination is on.
miGlobillumRadius (gir) float0outputinputconnectablestorable
Global illumination radius for this shape if miOverrideGlobalIllumination is on.
miOverrideFinalGather (ofg) boolfalseoutputinputconnectablestorable
Enable final gather settings override for this shape. If this parameter is set, the following final gather settings will override the renddr global settings for this shape node.
miFinalGatherRays (fry) integer1000outputinputconnectablestorable
Final gather rays for this shape if miOverrideFinalGather is on.
miFinalGatherMinRadius (fmn) float0outputinputconnectablestorable
Final gather min radius for this shape if miOverrideFinalGather is on.
miFinalGatherMaxRadius (fmx) float0outputinputconnectablestorable
Final gather max radius for this shape if miOverrideFinalGather is on.
miFinalGatherFilter (ffi) short1outputinputconnectablestorable
Final gather filter for this shape if miOverrideFinalGather is on.
miFinalGatherView (fgv) boolfalseoutputinputconnectablestorable
Final gather view flag for this shape if miOverrideFinalGather is on.
miOverrideSamples (oos) boolfalseoutputinputconnectablestorable
Override global object sample settings. In addition to global sample settings mental ray supports per-object sample settings. The global mental ray default for all objects in the scene can be set by minObjectSamples and maxObjectSamples on the mental ray options node (miDefaultOptions). Similar attributes on individual shape nodes miMinSamples and miMaxSamples are overriding the global default.
miMinSamples (mins) short1outputinputconnectablestorable
Specifies min sample settings for the shape. For all pixels that touch this object, at least pow(2, miMinSamples) samples are taken. miMinSamples lower than the global min samples is ignored.
miMaxSamples (maxs) short2outputinputconnectablestorable
Specifies max sample settings for the shape. For all pixels that touch this object, at most pow(2, miMaxSamples) samples are taken. miMaxSamples higher than the global max samples is ignored.
samplerPerParticleData (spd) genericArrayemptyoutputhidden
This attribute gives any node access to all of the output or user-defined per-particle data for this particle shape.
ppFieldData (ppfd) genericArrayemptyarrayoutputconnectablehidden
This contains a list of arrays and each array stores the per particle inforamtion of a particular attribute
ownerPPFieldData (opfd) genericArrayemptyarrayoutputconnectablehidden
This contains a list of arrays and each array stores the per particle inforamtion of a particular attribute
deformedPosition (dpos) Genericn/aoutputinputconnectablestorable
When using a deformer, the output positions from the deformer are connected here on the downstream particle object. A connection on this attribute indicates that this particle object is not dynamic.