PSYS_SRC_PATTERN
Specifies the general emission pattern.
  • Angle Pattern(PSYS_SRC_PATTERN_ANGLE) - Present particles in a 2-dimensional circular section as defined by PSYS_SRC_ANGLE_BEGIN and PSYS_SRC_ANGLE_END. The orientation of the particle plane is at X=0 relative to the emitter's region rotation.
  • Cone Pattern(PSYS_SRC_PATTERN_ANGLE_CONE) - Present particles in a 3-dimensional spherical section, as defined by PSYS_SRC_ANGLE_BEGIN and PSYS_SRC_ANGLE_END.
  • Empty Cone(PSYS_SRC_PATTERN_ANGLE_CONE_EMPTY) - (not officially documented; appears to be non-functional) Present particles in a 3-dimensional spherical section, as defined by PSYS_SRC_ANGLE_BEGIN and PSYS_SRC_ANGLE_END, but inversely compared to the ANGLE_CONE pattern (i.e., where there were voids in ANGLE_CONE, there are particles in ANGLE_CONE_EMPTY, and vice-versa.
  • Drop Pattern(PSYS_SRC_PATTERN_DROP) - Present particles by dropping them at the emitter position with no force. Ignores the PSYS_SRC_BURST_RADIUS, PSYS_SRC_BURST_SPEED_MIN, and PSYS_SRC_BURST_SPEED_MAX rules.
  • Burst Pattern(PSYS_SRC_PATTERN_EXPLODE) - Present particles by shooting them out in all directions according to the burst motion rules.
PSYS_PART_FLAGS
Various flags controlling the behavior of the particle system. The value may be specified as an integer in decimal or hex format, or by ORing together (using the | operator) one or more of the following flag constants
Automatically add needed flags:
  • Bounce(PSYS_PART_BOUNCE_MASK) - When set, specifies particles will bounce off a plane at the region Z height of the emitter. On "bounce", each particle reverses velocity and angle. This only works for particles above the plane falling down on it.
  • Glow(PSYS_PART_EMISSIVE_MASK) - When set, particles are full-bright and are unaffected by global lighting (sunlight). Otherwise, particles will be lit depending on the current global lighting conditions. Note that point lights do illuminate non-emissive particles.
  • Follow Source(PSYS_PART_FOLLOW_SRC_MASK) - When set, particles move relative to the position of the emitter. Otherwise, particle position and movement are unaffected by the position/movement of the emitter. This flag disables the PSYS_SRC_BURST_RADIUS rule.
  • Rotate on particle velocity.(PSYS_PART_FOLLOW_VELOCITY_MASK) - When set, particles rotate to orient their "top" towards the direction of movement or emission. Otherwise, particles are always emitted based on the current rotation of the emitter.
  • Interpolate Color(PSYS_PART_INTERP_COLOR_MASK) - When set, particle color and alpha transition from their START settings to their END settings during the particle's lifetime. The transition is a smooth interpolation.
  • Interpolate Scale(PSYS_PART_INTERP_SCALE_MASK) - When set, particle size/scale transitions from its START setting to its END setting during the particle's lifetime.
  • PSYS_PART_TARGET_LINEAR_MASK(PSYS_PART_TARGET_LINEAR_MASK) - (not officially documented) When set, emitted particles move in a straight line towards the target specified by the PSYS_SRC_TARGET_KEY rule. In this mode, PSYS_SRC_ACCEL, PSYS_SRC_BURST_RADIUS, and possibly other rules are ignored.
  • Move to target(PSYS_PART_TARGET_POS_MASK) - When set, emitted particles change course during their lifetime, attempting to move towards the target specified by the PSYS_SRC_TARGET_KEY rule by the time they expire. Note that if no target is specified, the target moves out of range, or an invalid target is specified, the particles target the prim itself.
  • Wind(PSYS_PART_WIND_MASK) - When set, particle movement is affected by the wind. It is applied as a secondary force on the particles.
PSYS_SRC_BURST_RADIUS
Specifies the distance from the emitter where particles will be created. This rule is ignored when the PSYS_PART_FOLLOW_SRC_MASK flag is set.
[0.00,65534.00]
PSYS_SRC_ANGLE_BEGIN
Specifies a half angle, in radians, of a circular or spherical "dimple" or conic section (starting from the emitter facing) within which particles will NOT be emitted. Valid values are the same as for PSYS_SRC_ANGLE_END, though the effects are reversed accordingly. If the pattern is PSYS_SRC_PATTERN_ANGLE, the presentation is a 2D flat circular section. If PSYS_SRC_PATTERN_ANGLE_CONE or PSYS_SRC_PATTERN_ANGLE_CONE_EMPTY is used, the presentation is a 3D spherical section. Note that the value of this parameter and PSYS_SRC_ANGLE_END are internally re-ordered such that this parameter gets the smaller of the two values.
[0.00,3.14]
PSYS_SRC_ANGLE_END
Specifies a half angle, in radians, of a circular or spherical "dimple" or conic section (starting from the emitter facing) within which particles will NOT be emitted. Valid values are 0.0, which will result in particles being emitted in a straight line in the direction of the emitter facing, to PI, which will result in particles being emitted in a full circular or spherical arc around the emitter, not including the "dimple" or conic section defined by PSYS_SRC_ANGLE_BEGIN. If the pattern is PSYS_SRC_PATTERN_ANGLE, the presentation is a 2D flat circular section. If PSYS_SRC_PATTERN_ANGLE_CONE or PSYS_SRC_PATTERN_ANGLE_CONE_EMPTY is used, the presentation is a 3D spherical section. Note that the value of this parameter and PSYS_SRC_ANGLE_BEGIN are internally re-ordered such that this parameter gets the larger of the two values.
[0.00,3.14]
PSYS_SRC_TARGET_KEY
Specifies the key of a target object, prim, or agent towarads which the particles will change course and move. They will attempt to end up at the geometric center of the target at the end of their lifetime. Requires the PSYS_PART_TARGET_POS_MASK flag be set.
PSYS_PART_START_COLOR
A unit vector specifying the color of the particles upon emission.
x: y: z:
PSYS_PART_END_COLOR
A unit vector specifying the color the particles transition to during their lifetime. Only used if the PSYS_PART_INTERP_COLOR_MASK flag is set.
x: y: z:
PSYS_PART_START_ALPHA
Specifies the alpha of the particles upon emission. Valid values are in the range 0.0 to 1.0. Higher values are more opaque; lower ones are more transparent.
[0.00,1.00]
PSYS_PART_END_ALPHA
Specifies the alpha the particles transition to during their lifetime. Only used if the PSYS_PART_INTERP_COLOR_MASK flag is set. Valid values are the same as PSYS_PART_START_ALPHA.v
[0.00,1.00]
PSYS_PART_START_SCALE
Specifies the scale or size of the particles upon emission. Valid values for each direction are 0.04 (0.03125) to 4.0, in meters. Since particles are essentially 2D sprites, the Z component of the vector is ignored and can be set to 0.0.
x: y: z:
PSYS_PART_END_SCALE
Specifies the scale or size the particles transition to during their lifetime. Only used if the PSYS_PART_INTERP_SCALE_MASK flag is set. Valid values are the same as PSYS_PART_START_SCALE.
x: y: z:
PSYS_SRC_TEXTURE
Specifies the name of a texture in the prim's inventory to use for each particle. Alternatively, you may specify an asset key UUID for a texture.
PSYS_SRC_MAX_AGE
Specifies the length of time, in seconds, that the emitter will operate upon coming into view range (if the particle system is already set) or upon execution of this function (if already in view range). Upon expiration, no more particles will be emitted, except as specified above. Zero will give the particle system an infinite duration.
[0.00,65534.00]
PSYS_PART_MAX_AGE
Specifies the lifetime of each particle emitted, in seconds. Maximum is 30.0 seconds. During this time, the particle will appear, change appearance and move according to the parameters specified in the other sections, and then disappear.
[0.00,30.00]
PSYS_SRC_BURST_RATE
Specifies the time interval, in seconds, between "bursts" of particles being emitted. Specifying a value of 0.0 will cause the emission of particles as fast as the viewer can do so.
[0.00,65534.00]
PSYS_SRC_BURST_PART_COUNT
Specifies the number of particles emitted in each "burst".
[0.00,4096.00]
PSYS_SRC_ACCEL
Specifies a directional acceleration vector applied to each particle as it is emitted, in meters per second. Valid values are 0.0 to 100.0 for each direction, as region coordinates.
x: y: z:
PSYS_SRC_OMEGA
Specifies the rotational spin of the emitter in radians per second along each axis. This "unsticks" the emitter facing from the prim's positive Z axis and is noticeable in directional presentations. Prim spin (via llTargetOmega) has no effect on emitter spin.
x: y: z:
PSYS_SRC_BURST_SPEED_MIN
Specifies the minimum value of a random range of values which is selected for each particle in a burst as its initial speed upon emission, in meters per second. Note that the value of this parameter and PSYS_SRC_BURST_SPEED_MAX are internally re-ordered such that this parameter gets the smaller of the two values.
[0.00,65534.00]
PSYS_SRC_BURST_SPEED_MAX
Specifies the maximum value of a random range of values which is selected for each particle in a burst as its initial speed upon emission, in meters per second. Note that the value of this parameter and PSYS_SRC_BURST_SPEED_MIN are internally re-ordered such that this parameter gets the larger of the two values.
[0.00,65534.00]

Questions or comments? See my blog http://channel3b.wordpress.com or e-mail Andy -at- NewWorldElectric.