Version:

# UI Particle Emitter Component

You can use a Particle Emitter component to emit two-dimensional particles from an element. Use the Properties pane of the UI Editor to configure the following settings for the Particle Emitter component.

Emitter Settings

NameDescription
Emit on activateStart emitting when the component is activated.
Hit particle count on activateEmit and process the average number of particles when the emitter starts emitting.
Infinite life timeMake the lifetime of the emitter infinite.
Emitter life timeEnter the number of seconds that the emitter is active during. When the end of the lifetime is reached, the emitter stops emitting. This option is available when Infinite life time isn’t set.
Emit rateEnter the number of particles to emit per second.
Emitter shapeSelect one of the following:
Particle count limitUse the Active particle limit value to limit the number of active particles.
Active particles limitThis option is available when Particle Count Limit is set. Type the maximum number of active particles. When the maximum number is reached, additional particles are emitted only after existing particles are removed. The maximum value is 9999.
Fixed random seedSpecify a fixed random seed for the emitter. When not selected, a random seed is generated each time the emitter starts emitting.
Random seedThis option is available when Fixed random seed is set. Enter the numerical seed to use for the particle emitter when Fixed random seed is selected. The field accepts a maximum nine-digit negative or positive integer.
Emit on edgeThis option is available when Emitter shape is Circle or Quad. Emit particles on the edge of the specified shape.
Emit inside distanceThis option is available when Emit on Edge is set. Enter the distance inside the edge that the particles are emitted from.
Emit outside distanceType the distance outside the edge that the particles are emitted from.
Initial direction typeThis option is available when Emitter shape is Circle or Quad. Select one of the following to specify how the initial direction is calculated:
Emit angleEnter the number of degrees vertical that particles are emitted from.
Emit angle variationEnter a number or use the slider to specify, in degrees, the variation of the emit angle. Valid values are from 0 through 180. A value of 10 specifies a variation range of plus or minus 10 degrees.

Particle Settings

NameDescription
Infinite life timeMake the particle lifetime infinite.
Life timeEnter the number of seconds that the emitted particles are initially active during.
Life time variationEnter the number of seconds that the lifetime of the emitted particles can vary.
Sprite pathnameClick the ellipsis (…) to open the Pick Texture dialog box and select a sprite image file.
Animated sprite sheetThis option is available when the selected sprite is a sprite sheet (has more than one cell). Select to change the sprite sheet cell index on each particle over time.
Loop sprite sheet animationThis option is available when Animated sprite sheet is set. Select to loop the sprite sheet cell animation.
Random sprite sheet indexThis option is available when the selected sprite is a sprite sheet (has more than one cell). Select to randomly choose the initial sprite sheet cell index.
Sprite sheet indexThis option is available when the selected sprite is a sprite sheet (has more than one cell) and Random sprite sheet index isn’t set. Select the sprite sheet index that is used for the emitted particles.
Sprite sheet start frameThis option is available when the selected sprite is a sprite sheet (has more than one cell) and Random sprite sheet index is set. Select the starting frame of the sprite sheet range for sprite sheet animation or randomly choosing the index.
Sprite sheet end frameThis option is available when the selected sprite is a sprite sheet (has more than one cell) and Random sprite sheet index is set. Sets the end frame of the sprite sheet range for sprite sheet animation or randomly choosing the index.
Sprite sheet frame delayThis option is available when Animated sprite sheet is set. Type the number of seconds of delay between each sprite sheet frame.
Blend modeSelect one of the following:

Particle Movement

NameDescription
Relative to emitterMove particles relative to the element to which the Particle Emitter component is attached. When this option isn’t selected, the element leaves a trail of particles as the emitter moves around the canvas.
Movement co-ordinate typeSelect the type of coordinate space for particle movement:
SpeedThis option is available when Movement co-ordinate type is set to Cartesian. Enter a number that specifies the initial speed of the emitted particles when the emit direction is calculated.
Speed variationThis option is available when Movement co-ordinate type is set to Cartesian. Enter a number that specifies the variation in initial speed of the emitted particles when the emit direction is calculated.
Initial velocityThis option is available when Movement co-ordinate type is set to Polar. Enter X and Y values that specify the initial velocity of the emitted particles.
Initial velocity variationThis option is available when Movement co-ordinate type is set to Polar. Enter X and Y values that specify the variation in the initial velocity of the emitted particles.
Acceleration co-ordinate typeSelect the type of coordinate space that is used for particle acceleration:
AccelerationEnter X and Y values that specify the acceleration of each emitted particle.
Orientation velocity basedPoint the top of each particle toward the current velocity vector.
Initial orientation velocity basedPoint the top of each particle toward the initial velocity vector.
Initial rotationEnter the number of degrees of the initial rotation clockwise from vertical.
Initial rotation variationEnter the number of degrees in the variation of the initial rotation. A value of 10 specifies a variation range of plus or minus 10 degrees around the specified initial rotation.
Rotation speedEnter the rotation speed in degrees clockwise per second.
Rotation speed variationType the variation in rotation speed in degrees clockwise per second. A value of 10 specifies a variation range of plus or minus 10 degrees in the specified rotation speed.

Particle Size

NameDescription
Lock aspect ratioLocks the width and height of the emitted particles into the current aspect ratio.
PivotEnter X and Y values that specify the pivot for the particles from (0,0) at the top left to (1,1) at the bottom right.
SizeEnter X and Y values that specify the size of each emitted particle.
Size variationEnter X and Y values that specify the variation in size of each emitted particle.

Particle Color

NameDescription
ColorEnter RGB values that specify the color of each emitted particle or click the white square to use the Select Color dialog box.
Color brightness variationEnter a decimal number between 0 and 1 that specifies the variation in brightness of each emitted particle.
Color tint variationEnter a decimal number between 0 and 1 that specifies the tint variation of each emitted particle.
AlphaEnter a decimal number between 0 and 1 that specifies the alpha that is used for the emitted particles.

Timelines

NameDescription
Speed multiplierClick the plus sign (+) to add keyframes that control a curve to multiply the particle speed over its lifetime.
Width multiplierThis option is available when Lock aspect ratio (in Particle Size) isn’t set. Click the plus sign (+) to add keyframes that control a curve to multiply the particle width over its lifetime.
Height multiplierThis option is available when Lock aspect ratio (in Particle Size) isn’t set. Click the plus sign (+) to add keyframes that control a curve to multiply the particle height over its lifetime.
Size multiplierClick the plus sign (+) to add keyframes that control a curve to multiply the particle size over its lifetime.
Color multiplierClick the plus sign (+) to add keyframes that control a curve to multiply the particle color over its lifetime.
Alpha multiplierClick the plus sign (+) to add keyframes that control a curve to multiply the particle alpha over its lifetime.
TimeEnter a value between 0 and 1 that specifies when the keyframe occurs during the particle lifetime. A value of 0 is the start of the particle lifetime and 1 is the end of the particle lifetime.
MultiplierSpecify a value from -100 through 100 to multiply against the value that this timeline controls. For example, if the speed value is 50.0 and the speed multiplier for a specific keyframe is 2.0, the value of speed at the specified keyframe is 100.
In tangentControls the in tangent for the current keyframe. Select one of the following:
Out tangentControls the out tangent for the current keyframe. Select one of the following:
Ease InSpecifies a gradual approach of a curve to a flat tangent. For example, a keyframe that specifies Ease In for In tangent and Ease Out for Out tangent looks like the flattened tangent of an x3 (x-cubed) curve at its origin.
Ease OutSpecifies a gradual retreat of a curve from a flat tangent. For example, a keyframe that specifies Ease In for In tangent and Ease Out for Out tangent looks like the flattened tangent of an x3 (x-cubed) curve at its origin.
LinearSpecifies that the curve moves linearly from the keyframe towards the next or previous keyframe.
StepSpecifies that the curve jumps from the current keyframe value to the next or previous keyframe value.