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 nameParentsClassificationMFn typeCompatible function sets
particledeformableShapedrawdb/geometry/dynamics/particlekParticlekBase
kNamedObject
kDependencyNode
kDagNode
kShape
kParticle

Related nodes

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

Attributes (190)

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

Long name (short name)TypeDefaultFlags
acceleration (acc) vectorArrayemptyoutputinputconnectable
Runtime state, accelerations, per-particle.
acceleration0 (acc0) vectorArrayemptyoutputinputconnectablestorablehidden
Initial state, accelerations, 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.
auxiliariesOwned (ao) Messagen/aoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
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.
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.
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.
cachedTime (chti) time0filmoutputconnectablehidden
Users should not set or use this attribute. Results will be unpredictable.
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.
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.
cachedWorldPosition (cwps) vectorArrayemptyoutputconnectablehidden
This is the most current value for the aWorldPosition attribute WITHOUT forcing evaluation of the dynamics.
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.
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.
collisionConnections (cc) Messagen/aarrayoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
collisionData (cda) compoundn/aoutputinputconnectable
Parent attribute for all collision input data.
collisionGeometry (cge) sweptGeometrynullptrarrayoutputinputconnectablehidden
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.
collisionEvents (cev) boolfalsehidden
Requesting this attribute will trigger collision events.
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.
collisions (col) boolfalsehidden
Requesting this attribute will trigger collisions.
computingCount (cmp) boolfalseoutputinputhidden
This is a boolean used to avoid recursion in the computeCount method. It should not be set by customers.
connectionsToMe (ct) Messagen/aarrayoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
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.
count (cnt) integer0outputconnectable
The number of particles in the object.
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.
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.
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.
death (dth) boolfalsehidden
Requesting this attribute will trigger death of old particles.
debugDraw (dbd) short0outputinputhidden
For internal use only. Should not be set by customers.
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.
depthSort (ds) boolfalseoutputinputconnectablestorable
Turn on depth sorting of particles for rendering.
dieOnEmissionVolumeExit (dve) boolfalseoutputinputconnectablestorablekeyable
If the particles were emitted from a volume, die when they exit that volume.
diedLastTime (dlt) integer0outputinputconnectablehidden
OBSOLETE ATTRIBUTE. No effect.
disableCloudAxis (dca) boolfalseoutputinputconnectablestorablehidden
Disable the dominant axis for cloud better illumination.
doAge (dag) boolfalseoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
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.
dynamicsWeight (dw) double1.0outputinputconnectablestorablekeyable
Fraction of dynamics forces which get applied each time step.
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.
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.
emitterConnections (ec) Messagen/aarrayoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
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.
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.
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.
enforceCountFromHistory (ecfh) booltrueoutputinputconnectablestorablekeyable
Tells the particle object to keep its count consistent with the pointCount of any incoming history in inputGeometry, if one exists.
evaluationTime (eti) time0.0filmoutputinputkeyablehidden
For internal use only.
eventCount (ecp) short-1arrayoutputinputconnectablestorablekeyable
Event count 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.
eventEmit (eve) short-1arrayoutputinputconnectablestorablekeyable
Emit parameters of particle collision events. Edit this through the particle event editor.
eventName (evn) stringnullptrarrayoutputinputconnectablestorable
Names of particle collision events. Edit this through the particle event editor.
eventNameCount (enc) short0outputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
eventProc (epr) stringnullptrarrayoutputinputconnectablestorablekeyable
Proc names for particle collision events. Edit this through the particle event editor.
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.
eventRandom (evr) short-1arrayoutputinputconnectablestorablekeyable
Random parameters of particle collision events. Edit this through the particle event editor.
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.
eventSplit (evs) short-1arrayoutputinputconnectablestorablekeyable
Split 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.
eventTarget (etg) Messagen/aarrayoutputinputconnectable
Target parameters of particle collision events. Edit this through the particle event editor.
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.
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.
executeCreationExpression (ece) boolfalsehidden
This attribute is requested to trigger the execution of creation expressions.
executeRuntimeAfterDynamicsExpression (erae) boolfalsehidden
This attribute is requested to trigger the execution of runtime expressions.
executeRuntimeBeforeDynamicsExpression (erbe) boolfalsehidden
This attribute is requested to trigger the execution of runtime expressions.
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.
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.
expressionsAfterDynamics (ead) boolfalseoutputinputconnectablestorablekeyable
This boolean attribute lets the user decide whether they want the expressions to happen before or after the dynamics is computed.
fieldConnections (fc) Messagen/aarrayoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
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.
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.
force (frc) vectorArrayemptyoutputconnectable
The effects of fields, goals, etc. on the particles are accumulated in this attribute.
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.
forceEmission (fem) boolfalseoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
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.
generalSeed (gsd) integer0outputinputhidden
Seed for random number generation. It is independent of all other random number streams.
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.
goalGeometry (ggeo) Genericn/aarrayoutputinputconnectable
The input geometry attributes for the goal objects.
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.
goalUvSetName (guv) stringnullptrarrayoutputinputconnectablestorable
For goal objects that have multiple uv sets, this attribute specifies which uv set to use when goalU/goalV values are present for particles.
goalWeight (gw) double0.0arrayoutputinputconnectablestorablekeyable
The goal weights for the various goal objects.
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.
inheritColor (inc) boolfalseoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
inheritFactor (inh) double0.0outputinputconnectablestorablekeyable
Fraction of emitter velocity that particles emitted into this object inherit.
input (xi) Genericnullptrarrayoutputinputconnectablehidden
This attribute is where any input attribute for the expressions, both runtime and creation, is connected.
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.
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.
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) stringArraynullptroutputinputstorable
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.
internalCreationExpression (icx) stringnullptroutputinputstorablehidden
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.
internalRuntimeAfterDynamicsExpression (irax) stringnullptroutputinputstorablehidden
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) stringnullptroutputinputstorablehidden
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.
internalRuntimeExpression (irx) stringnullptroutputinputhidden
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.
isDynamic (isd) booltrueoutputinputconnectablestorablekeyable
Toggle dynamics on/off for this object.
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.
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.
lastCachedPosition (lcps) vectorArrayemptyoutputconnectablehidden
This is the most current value for aLastPosition WITHOUT forcing evaluation of the dynamics.
lastPosition (lpos) vectorArrayemptyoutputconnectablehidden
The position of the particles at the end of the previous timestep. This attribute does force the evaluation of dynamics.
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.
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.
lastTotalEventCount (ltec) integer0outputinputconnectablehidden
Used to compute eventTest attribute.
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.
lastWorldMatrix (lwm) matrixidentityoutputconnectablehidden
This is the world matrix from the last time evaluated (currentSceneTime - sceneTimeStepSize).
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.
lastWorldVelocity (lwvl) vectorArrayemptyoutputconnectablehidden
This is the world-space velocity from the end of the LAST time-step.
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.
mass (mas) doubleArrayemptyoutputinputconnectable
Runtime state, mass, per-particle.
mass0 (mas0) doubleArrayemptyoutputinputconnectablestorablehidden
Initial state, mass, per-particle.
massCache (masc) doubleArrayemptyoutputconnectablehidden
Cached state, mass.
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.
netEmittedLastTime (nlt) integer0outputinputconnectablehidden
OBSOLETE ATTRIBUTE. No effect.
newFileFormat (nff) short0outputinputconnectablestorablehidden
Obsolete. No function. Will be removed in next major release.
newParticles (npt) genericArrayemptyarrayinputconnectablehidden
This is where emitters will send any particles that they create for this particle object.
nextId (nid) integer0outputinputstorablehidden
Next available value for aId
nextId0 (nid0) integer0outputinputstorablehidden
Initial value of aNextId
normalizeVelocity (nvl) boolfalseoutputinputconnectablestorable
Not yet enabled
numberOfEvents (nev) short0outputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
output (xo) Genericnullptrarrayoutputconnectablehidden
This attribute is where any output attribute for the expressions, both runtime and creation, is connected.
ownerPPFieldData (opfd) genericArrayemptyarrayoutputconnectablehidden
This contains a list of arrays and each array stores the per particle inforamtion of a particular attribute
ppFieldData (ppfd) genericArrayemptyarrayoutputconnectablehidden
This contains a list of arrays and each array stores the per particle inforamtion of a particular attribute
parentMatrixDirty (pmd) boolfalseoutputinputconnectablehidden
Obsolete. No function. Will be removed in next major release.
particleRenderType (prt) enum3outputinputconnectablestorablekeyable
Hardware rendering method.
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.
position0 (pos0) vectorArrayemptyoutputinputconnectablestorablehidden
Initial state, positions, 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.
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.
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.
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.
samplerPerParticleData (spd) genericArrayemptyoutputhidden
This attribute gives any node access to all of the output or user-defined per-particle data for this particle shape.
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.
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.
shapeNameMsg (snmg) Messagen/aoutputinputconnectable
Identifies a shape to be used for geometry instancing. (Incomplete in Maya 1.0.)
startEmittedIndex (sei) integer-1outputinputconnectablehidden
OBSOLETE ATTRIBUTE. No effect.
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.
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.
startupCachePath (scp) stringnullptroutputinputconnectablestorable
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.
targetGeometry (tgeo) Genericn/aoutputconnectable
Geometry for soft body.
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.
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.
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.
timeStepSize (tss) time0filmoutputconnectable
For internal use only. Users should not set this. It is defined as (currentTime - lastTimeEvaluated)/overSamples.
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.
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.
useCustomCache (ucc) boolfalseoutputinputconnectablestorablehidden
This boolean attribute is used to override disk cache. The particleShape will evaluate this attribute right before it evaluates internal disk cache. If the value is true, it means the connected custom cache node has updated the particleShape with its cache data, and thus the particleShape won't continue with update from its internal disk cache.
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.
velocity (vel) vectorArrayemptyoutputinputconnectable
Runtime state, velocities at the end of the time-step, per-particle.
velocity0 (vel0) vectorArrayemptyoutputinputconnectablestorablehidden
Initial state, velocities, per-particle.
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."
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.
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.