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 name Parents Classification MFn type Compatible function sets
pointEmitter dynBase drawdb/geometry/dynamics/emitter kEmitter kBase
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) Type Default Flags
emitterType (emt) enum 1 outputinputconnectablestorablekeyable
Specifies the emitter type: omni, directional, surface, curve, or some type of volume.
rate (rat) double 100 outputinputconnectablestorablekeyable
Rate of emission per second.
scaleRateByObjectSize (sro) bool true outputinputstorablekeyable
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) bool false outputinputstorablekeyable
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) bool false outputinputstorablekeyable
It determines if the node uses RatePP or Rate. By default, this node uses Rate.
needParentUV (npuv) bool false outputinputstorablekeyable
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) enum 0 outputinputconnectablestorablekeyable
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) integer 1 outputinputconnectablestorablekeyable
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) time 0film arrayoutputinputstorablehidden
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.0cm outputinputconnectablestorablekeyable
Maximum distance at which new particles or density is created from emitter. Not used for volume emitters.
minDistance (min) distance (double) 0.0cm outputinputconnectablestorablekeyable
Minimum distance at which new particles are created from emitter. Not used for volume emitters.
direction (d) double3 outputinputconnectablestorable
Direction of emitter. Not used for omni emitters.
directionX (dx) double 1.0 outputinputconnectablestorablekeyable
X-component of direction of emission (if directional).
directionY (dy) double 0.0 outputinputconnectablestorablekeyable
Y-component of direction of emission (if directional).
directionZ (dz) double 0.0 outputinputconnectablestorablekeyable
Z-component of direction of emission (if directional).
spread (spr) double 0.0 outputinputconnectablestorablekeyable
Degree of spread off direction axis as fraction of 90 degrees.
speed (spd) double 1.0 outputinputconnectablestorablekeyable
Initial velocity multiplier.
speedRandom (srnd) double 0.0 outputinputconnectablestorablekeyable
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) double 0.0 outputinputconnectablestorablekeyable
Surface emission only. Speed multipler tangent to emitting plane.
normalSpeed (nspd) double 1.0 outputinputconnectablestorablekeyable
Speed multipler normal to emitting plane or emitting curve.
currentTime (ct) time 0film outputinputconnectable
The current scene time. It is connected with time1.
inheritFactor (inh) double 0.0 arrayoutputinputconnectablestorable
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) bool false arrayoutputinputconnectablestorable
It determines if the target particle object has enough particles. If it is true, no more emission.
startTime (stt) time 0film arrayoutputinputconnectablehidden
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) time 0film arrayoutputinputconnectablehidden
An elapsed time since particles were emitted. It is connected with particle object.
emitCountRemainder (ecr) doubleArray empty arrayoutputinputconnectablehidden
This is a storage to save emit count remainder. It is for positional emitter only(curve/surface emitter handles remainder differently).
ratePP (rpp) doubleArray empty inputconnectablestorable
Rate per-particle array. It is connected with its owner object. If aUseRatePP is true, this node will use ratePP.
parentId (paid) doubleArray empty inputconnectablestorable
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) sweptGeometry NULL outputinputconnectablehidden
This is for surface/curve emitter. The owner is a geoConnector. The geoConnector creates triangle/line list from a surface/curve.
output (ot) genericArray empty arrayoutputconnectable
It outputs new particles to the particle object.
seed (sd) integer 0 arrayoutputinputconnectablehidden
Random number stream seed for emitter's own random number stream. Separate seed for each particle object into which we are emitting.
randState (rst) long3 arrayoutputinput
Random state attribute to hold emitter's own random number stream.
randStateX (rstx) integer 0 outputinputstorable
Random state attribute to hold emitter's own random number stream.
randStateY (rsty) integer 0 outputinputstorable
Random state attribute to hold emitter's own random number stream.
randStateZ (rstz) integer 0 outputinputstorable
Random state attribute to hold emitter's own random number stream.
enableTextureRate (etr) bool false outputinputconnectablestorable
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) float3 0.0, 0.0, 0.0 outputinputconnectablestorable
It is connected with the texture node which control the rate.
textureRateR (txrr) float 0.0 outputinputconnectablestorable
See comments for aTextureRate.
textureRateG (txrg) float 0.0 outputinputconnectablestorable
See comments for aTextureRate.
textureRateB (txrb) float 0.0 outputinputconnectablestorable
See comments for aTextureRate.
emitFromDark (efd) bool false outputinputconnectablestorable
If it is on, particles will be emitted from dark area.
inheritColor (inhc) bool false outputinputconnectablestorable
If it is true, emitter passes the color to new particles. The color may be from a texture or color selector.
inheritOpacity (inho) bool false outputinputconnectablestorable
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) bool false outputinputconnectablestorable
If it is true, use invert-alpha as opacity for new particles.
useLuminance (usel) bool false outputinputconnectablestorable
If it is true, use luminance as opacity for new particles.
particleColor (pc) float3 0.5, 0.5, 0.5 outputinputconnectablestorablekeyable
The color for new particles.
particleColorR (pcr) float 0.5 outputinputconnectablestorablekeyable
The color for new particles.
particleColorG (pcg) float 0.5 outputinputconnectablestorablekeyable
The color for new particles.
particleColorB (pcb) float 0.5 outputinputconnectablestorablekeyable
The color for new particles.
volumeShape (vol) enum 0 outputinputconnectablestorablekeyable
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) double3 outputinputconnectablestorable
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.0cm outputinputconnectablestorablekeyable
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.0cm outputinputconnectablestorablekeyable
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.0cm outputinputconnectablestorablekeyable
This is the Z component of the translational offset of the emission volume's center from the emitter's origin.
volumeEfficiency (vef) double 0.0 outputconnectablehidden
This attribute computes how efficient the volume will be at generating uniformly-distributed random point within the volume.
volumeSweep (vsw) angle (double) 360.0deg outputinputconnectablestorablekeyable
The arc of the volume emission. Used for sphere, cone, cynlinder and torus.
sectionRadius (vsr) distance (double) 0.5cm outputinputconnectablestorablekeyable
Applies to torus volumes only. The radius of a section of the torus.
awayFromCenter (afc) double 1.0 outputinputconnectablestorablekeyable
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) double 1.0 outputinputconnectablestorablekeyable
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) double 0.0 outputinputconnectablestorablekeyable
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) double 0.0 outputinputconnectablestorablekeyable
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) double 0.0 outputinputconnectablestorablekeyable
Magnitude of a random component of the speed from volume emission.
directionalSpeed (drs) double 0.0 outputinputconnectablestorablekeyable
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) bool false outputinputconnectablestorablekeyable
Indicates whether the scale of a volume emitter affects the velocity of the emitted particles.
displaySpeed (dss) bool true outputinputconnectablestorablekeyable
This boolean tells the emitter whether or not to draw the volume speed arrows.