Go to: Related nodes. Attributes.

The emitter node is a dependency graph node used to generate particles which then live in a a particle shape node. The emitter type determines the general characteristic of the emission. Some attributes do not apply to all types emitters.

Node nameParentsClassificationMFn typeCompatible function sets
pointEmitterdynBasedrawdb/geometry/dynamics/emitterkEmitterkBase
kNamedObject
kDependencyNode
kDagNode
kTransform
kEmitter

Related nodes

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

Attributes (65)

The following quick index only shows top-level attributes (too many attributes to show them all): alongAxis, aroundAxis, awayFromAxis, awayFromCenter, currentTime, cycleEmission, cycleInterval, deltaTime, deltaTimeCycle, direction (3), directionalSpeed, displaySpeed, emitCountRemainder, emitFromDark, emitterType, enableTextureRate, inheritColor, inheritFactor, inheritOpacity, invertOpacity, isFull, maxDistance, minDistance, needParentUV, normalSpeed, output, parentId, particleColor (3), randState (3), randomDirection, rate, ratePP, scaleRateByObjectSize, scaleRateBySpeed, scaleSpeedBySize, sectionRadius, seed, speed, speedRandom, spread, startTime, sweptGeometry, tangentSpeed, textureRate (3), useLuminance, useRatePP, volumeEfficiency, volumeOffset (3), volumeShape, volumeSweep

Long name (short name)TypeDefaultFlags
emitterType (emt) enum1outputinputconnectablestorablekeyable
Specifies the emitter type: omni, directional, surface, curve, or some type of volume.
rate (rat) double100outputinputconnectablestorablekeyable
Rate of emission per second.
scaleRateByObjectSize (sro) booltrueoutputinputstorablekeyable
Applies to curve and surface emitters, only. If true, number of particles is determined by object size (area or length) times rate value. If false, object size is ignored and the rate value is used without modification. The former is the way Maya behaved prior to version 3.0.
scaleRateBySpeed (srs) boolfalseoutputinputstorablekeyable
If true, number of particles is determined by the speed of emission. In this way the overall density of particles can be preserved as one changes the emission speed.
useRatePP (urpp) boolfalseoutputinputstorablekeyable
It determines if the node uses RatePP or Rate. By default, this node uses Rate.
needParentUV (npuv) boolfalseoutputinputstorablekeyable
If aNeedParentUV is true, send (u,v) coordinates for point of emission to the particle object. Particle object must have parentU/parentV attributes. Applies only to nurbs surfaces.
cycleEmission (cye) enum0outputinputconnectablestorablekeyable
Cycling emission restarts the random number stream after an interval in frames, specified by the cycleInterval attribute. Setting cycleEmission to "Frame" and cycleInterval to 1 is will cause the random stream to re-start every frame. cycleInterval values greater than 1 can be used to generate cycles for games work. Note that this resets ONLY the random stream used by the emitter. It does not reset the random number stream used by Mel, shaders, etc. Note also that the "frame" option resets at most once per frame. Use caution when animating the particle's currentTime. However, oversampling does not affect the results.
cycleInterval (cyi) integer1outputinputconnectablestorablekeyable
Specifies the number of frames between restarts of the random number stream. See cycleEmission. Has no effect if cycleEmission is set to None.
deltaTimeCycle (dtc) time0filmarrayoutputinputstorablehidden
Stores the time since last reset of the random number generator for each stream of emission. Used to implement the cycleEmission feature. This value is maintained by the emitter and should not be set by the user. The cycleEmission and cycleInterval attributes are the ones the user controls.
maxDistance (max) distance (double)0.0cmoutputinputconnectablestorablekeyable
Maximum distance at which new particles or density is created from emitter. Not used for volume emitters.
minDistance (min) distance (double)0.0cmoutputinputconnectablestorablekeyable
Minimum distance at which new particles are created from emitter. Not used for volume emitters.
direction (d) double3outputinputconnectablestorable
Direction of emitter. Not used for omni emitters.
directionX (dx) double1.0outputinputconnectablestorablekeyable
X-component of direction of emission (if directional).
directionY (dy) double0.0outputinputconnectablestorablekeyable
Y-component of direction of emission (if directional).
directionZ (dz) double0.0outputinputconnectablestorablekeyable
Z-component of direction of emission (if directional).
spread (spr) double0.0outputinputconnectablestorablekeyable
Degree of spread off direction axis as fraction of 90 degrees.
speed (spd) double1.0outputinputconnectablestorablekeyable
Initial velocity multiplier.
speedRandom (srnd) double0.0outputinputconnectablestorablekeyable
Identifies a range of random variation for the speed of each generated particle. If set to a non-zero value, speed becomes the mean value of the generated particles, whose speeds vary by a random amount up to plus or minus speedRandom/2. For example, speed 5 and speedRandom 2 will make the speeds vary between 4 and 6.
tangentSpeed (tspd) double0.0outputinputconnectablestorablekeyable
Surface emission only. Speed multipler tangent to emitting plane.
normalSpeed (nspd) double1.0outputinputconnectablestorablekeyable
Speed multipler normal to emitting plane or emitting curve.
currentTime (ct) time0filmoutputinputconnectable
The current scene time. It is connected with time1.
inheritFactor (inh) double0.0arrayoutputinputconnectablestorable
It is connected with the particle object(target particle). The final velocities of new particles has a portion of emitter's velocity multiplying inheritFactor.
isFull (full) boolfalsearrayoutputinputconnectablestorable
It determines if the target particle object has enough particles. If it is true, no more emission.
startTime (stt) time0filmarrayoutputinputconnectablehidden
It is used to determine if emitting particles. If currentTime <= startTime, reset emitter states, such as remainder, fLastWorldPoint. It is connected with target particle.
deltaTime (dt) time0filmarrayoutputinputconnectablehidden
An elapsed time since particles were emitted. It is connected with particle object.
emitCountRemainder (ecr) doubleArrayemptyarrayoutputinputconnectablehidden
This is a storage to save emit count remainder. It is for positional emitter only(curve/surface emitter handles remainder differently).
ratePP (rpp) doubleArrayemptyinputconnectablestorable
Rate per-particle array. It is connected with its owner object. If aUseRatePP is true, this node will use ratePP.
parentId (paid) doubleArrayemptyinputconnectablestorable
If the emitter's owner is a particle object, it will be connected with the owner. The new particles know where they from.
sweptGeometry (swge) sweptGeometryNULLoutputinputconnectablehidden
This is for surface/curve emitter. The owner is a geoConnector. The geoConnector creates triangle/line list from a surface/curve.
output (ot) genericArrayemptyarrayoutputconnectable
It outputs new particles to the particle object.
seed (sd) integer0arrayoutputinputconnectablehidden
Random number stream seed for emitter's own random number stream. Separate seed for each particle object into which we are emitting.
randState (rst) long3arrayoutputinput
Random state attribute to hold emitter's own random number stream.
randStateX (rstx) integer0outputinputstorable
Random state attribute to hold emitter's own random number stream.
randStateY (rsty) integer0outputinputstorable
Random state attribute to hold emitter's own random number stream.
randStateZ (rstz) integer0outputinputstorable
Random state attribute to hold emitter's own random number stream.
enableTextureRate (etr) boolfalseoutputinputconnectablestorable
If it is on, the surface emitter generates particles based on texture information of the geometric owner. Note that a texture can have a continous range of values while a particle either exists or does not exist. As a consequence of this the texture is used to filter the particles. The emission of particles more closely matches the texture as the rate of particle emission increases. Since low emission rates do not clearly match the texture a high emission rate is recommended when textured emission is being used.
textureRate (txr) float30.0, 0.0, 0.0outputinputconnectablestorable
It is connected with the texture node which control the rate.
textureRateR (txrr) float0.0outputinputconnectablestorable
See comments for aTextureRate.
textureRateG (txrg) float0.0outputinputconnectablestorable
See comments for aTextureRate.
textureRateB (txrb) float0.0outputinputconnectablestorable
See comments for aTextureRate.
emitFromDark (efd) boolfalseoutputinputconnectablestorable
If it is on, particles will be emitted from dark area.
inheritColor (inhc) boolfalseoutputinputconnectablestorable
If it is true, emitter passes the color to new particles. The color may be from a texture or color selector.
inheritOpacity (inho) boolfalseoutputinputconnectablestorable
If it is true, emitter passes the opacity to new particles if there is a texture node is connected to the particle color attribute.
invertOpacity (invo) boolfalseoutputinputconnectablestorable
If it is true, use invert-alpha as opacity for new particles.
useLuminance (usel) boolfalseoutputinputconnectablestorable
If it is true, use luminance as opacity for new particles.
particleColor (pc) float30.5, 0.5, 0.5outputinputconnectablestorablekeyable
The color for new particles.
particleColorR (pcr) float0.5outputinputconnectablestorablekeyable
The color for new particles.
particleColorG (pcg) float0.5outputinputconnectablestorablekeyable
The color for new particles.
particleColorB (pcb) float0.5outputinputconnectablestorablekeyable
The color for new particles.
volumeShape (vol) enum0outputinputconnectablestorablekeyable
Indicates the shape of volume the emitter will use, if the emitter is of volume type. Has an effect only if emitter type is Volume. Otherwise volume controls are disabled.
volumeOffset (vof) double3outputinputconnectablestorable
This is the parent attribute for the translational offset of the emission volume's center from the emitter's origin.
volumeOffsetX (vfx) distance (double)0.0cmoutputinputconnectablestorablekeyable
This is the X component of the translational offset of the emission volume's center from the emitter's origin.
volumeOffsetY (vfy) distance (double)0.0cmoutputinputconnectablestorablekeyable
This is the Y component of the translational offset of the emission volume's center from the emitter's origin.
volumeOffsetZ (vfz) distance (double)0.0cmoutputinputconnectablestorablekeyable
This is the Z component of the translational offset of the emission volume's center from the emitter's origin.
volumeEfficiency (vef) double0.0outputconnectablehidden
This attribute computes how efficient the volume will be at generating uniformly-distributed random point within the volume.
volumeSweep (vsw) angle (double)360.0degoutputinputconnectablestorablekeyable
The arc of the volume emission. Used for sphere, cone, cynlinder and torus.
sectionRadius (vsr) distance (double)0.5cmoutputinputconnectablestorablekeyable
Applies to torus volumes only. The radius of a section of the torus.
awayFromCenter (afc) double1.0outputinputconnectablestorablekeyable
Initial velocity in the direction away from the center point of a cube or sphere volume emitter. Used only with the cube and sphere volume emitters.
awayFromAxis (afa) double1.0outputinputconnectablestorablekeyable
Initial velocity multiplier in the direction away from the central axis of the volume. See the diagrams in the documentation. Used only with the cylinder, cone, and sphere volume emitters.
alongAxis (alx) double0.0outputinputconnectablestorablekeyable
Initial velocity multiplier in the direction along the central axis of the volume. See the diagrams in the documentation. Applies only to volume emitters.
aroundAxis (arx) double0.0outputinputconnectablestorablekeyable
Initial velocity multiplier in the direction around the central axis of the volume. See the diagrams in the documentation. Applies only to volume emitters.
randomDirection (rnd) double0.0outputinputconnectablestorablekeyable
Magnitude of a random component of the speed from volume emission.
directionalSpeed (drs) double0.0outputinputconnectablestorablekeyable
For volume emitters only, adds a component of speed in the direction specified by the directionX, Y, and Z attributes. Applies only to volume emitters. Does not apply to other types of emitters.
scaleSpeedBySize (ssz) boolfalseoutputinputconnectablestorablekeyable
Indicates whether the scale of a volume emitter affects the velocity of the emitted particles.
displaySpeed (dss) booltrueoutputinputconnectablestorablekeyable
This boolean tells the emitter whether or not to draw the volume speed arrows.