LlLinkParticleSystem

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

ParticleSystem

llLinkParticleSystem

	Pre-release Documentation Warning!
	This function is not available yet. This documentation was written prior to its final release so it may not match the final implementation.It is slated for release in Server 1.38.

Summary

Function: llLinkParticleSystem( integer link, list rules );

0.0	Forced Delay
10.0	Energy

A particle system defined by a list of rules is set for the prim(s) link. This is identical to llParticleSystem except that it applies to a specified linked prim and not just the prim the script is in.

• integer	link	–	Link number (0: unlinked, 1: root prim, >1: child prims and seated avatars) or a LINK_* flag
• list	rules

Flag Description LINK_ROOT 1 refers to the root prim in a multi-prim linked set[1] LINK_SET -1 refers to all prims LINK_ALL_OTHERS -2 refers to all other prims

Flag Description LINK_ALL_CHILDREN -3 refers to all children, (everything but the root) LINK_THIS -4 refers to the prim the script is in

	Rule / Value Constant	Rule Parameter	Description	Value
System Behavior
PSYS_PART_FLAGS		integer 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:	0
V a l u e s	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 its Z-velocity. Particles spawned below the plane will reflect to an equivalent distance above the plane.	0x004
	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.	0x100
	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.	0x010
	PSYS_PART_FOLLOW_VELOCITY_MASK		When set, particles rotate to orient their "top" towards the direction of movement or emission. Otherwise, particles are oriented vertically as their textures would appear (top of texture at top, left at left).	0x020
	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.	0x001
	PSYS_PART_INTERP_SCALE_MASK		When set, particle size/scale transitions from its START setting to its END setting during the particle's lifetime.	0x002
	PSYS_PART_RIBBON_MASK		Joins a stream of particles together into a continuous strip. Particle textures are stretched (or squeezed) to join their right edges to their predecessor's left. Ribbon 'width' is controlled by the 'x' values of start and end scale. The 'y' values are used only for computing the maximum visibility distance of the particles, and the distance between particles controls the 'length' of each ribbon segment instead. Unlike other particle effects, ribbon segments are not rendered facing the viewer's camera. The Z axis of each new particle mimics the Z axis of the emitter prim. Ribbon segments will not render if they have no 'length' - this happens when particles move only 'up' or 'down' the local Z-axis of their emitter prim. PSYS_PART_FOLLOW_VELOCITY_MASK has no effect on ribbons. For a simple ribbon effect, try using the DROP pattern, TEXTURE_BLANK, ACCEL and/or WIND.	0x400
	PSYS_PART_TARGET_LINEAR_MASK		When set, emitted particles move in a straight evenly-spaced line towards the target specified by the PSYS_SRC_TARGET_KEY rule. This option ignores all Non-DROP patterns and their dependent attributes (radius, burst speeds, angles, and omega). PSYS_SRC_ACCEL and PSYS_PART_WIND_MASK are ignored as well. Using PSYS_PART_BOUNCE_MASK while the target is 'below' the emitter will cause the linear particle stream to deflect upwards, terminating above the target.	0x080
	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.	0x040
	PSYS_PART_WIND_MASK		When set, particle movement is affected by the wind. It is applied as a secondary force on the particles.	0x008
	PSYS_PART_BEAM_MASK		(unimplemented) mask but in the enum	0x200
	LL_PART_HUD		Used by the viewer to keep HUD and World particle sources separate.	0x40000000
	LL_PART_DEAD_MASK		Removes particles, not compatible with any other PSYS_PART_*_MASK	0x80000000
System Presentation
PSYS_SRC_PATTERN		integer pattern	Specifies the general emission pattern.	9
V a l u e s	PSYS_SRC_PATTERN_EXPLODE		Sprays particles outwards in a spherical area. The Initial velocity of each particle is determined by PSYS_SRC_BURST_SPEED_MIN and PSYS_SRC_BURST_SPEED_MAX. The EXPLODE pattern ignores the ANGLE parameters.	0x02
	PSYS_SRC_PATTERN_ANGLE_CONE		Sprays particles outwards in a spherical, sub-spherical, conical or ring shaped area, as defined by the ANGLE parameters PSYS_SRC_ANGLE_BEGIN and PSYS_SRC_ANGLE_END. The ANGLE_CONE pattern can be used to imitate the EXPLODE pattern by explicitly setting PSYS_SRC_ANGLE_BEGIN to 0.00000 and PSYS_SRC_ANGLE_END to 3.14159 (or PI) (or vice versa).	0x08
	PSYS_SRC_PATTERN_ANGLE		Sprays particles outward in a flat circular, semi-circular, arc or ray shaped areas, as defined by PSYS_SRC_ANGLE_BEGIN and PSYS_SRC_ANGLE_END. The circular pattern radiates outwards around the prim's local X axis line.	0x04
	PSYS_SRC_PATTERN_DROP		Creates particles with no initial velocity. The DROP pattern will override any values given for PSYS_SRC_BURST_RADIUS, PSYS_SRC_BURST_SPEED_MIN, and PSYS_SRC_BURST_SPEED_MAX, setting each to 0.00000. (All patterns will behave like the DROP pattern, if RADIUS, SPEED_MIN and SPEED_MAX are explicitly set to 0.0000.)	0x01
	PSYS_SRC_PATTERN_ANGLE_CONE_EMPTY		(incomplete implementation) acts the same as the PSYS_SRC_PATTERN_DROP pattern, it is believed that the original intention for this pattern was to invert the effect of the ANGLE parameters, making them delineate an area where particles were NOT to be sprayed. (effectively the inverse or opposite of the behavior of the ANGLE_CONE pattern).	0x10
PSYS_SRC_BURST_RADIUS		float 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. A test in http://forums-archive.secondlife.com/327/f5/226722/1.html indicates that the maximum value is 50.00	16
PSYS_SRC_ANGLE_BEGIN		float 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.	22
PSYS_SRC_ANGLE_END		float 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 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.	23
PSYS_SRC_INNERANGLE		float angle_inner	DEPRECATED: Use PSYS_SRC_ANGLE_BEGIN instead. Works similar to its replacement rule, except the edge of the section is aligned with the emitter facing, rather than its center.	10
PSYS_SRC_OUTERANGLE		float angle_outer	DEPRECATED: Use PSYS_SRC_ANGLE_END instead. Works similar to its replacement rule, except the edge of the section is aligned with the emitter facing, rather than the section's center.	11
PSYS_SRC_TARGET_KEY		key target	Specifies the key of a target object, prim, or agent towards which the particles will change course and move (if PSYS_PART_TARGET_POS_MASK is specified) or will move in a straight line (if PSYS_PART_TARGET_LINEAR_MASK is specified). 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 or PSYS_PART_TARGET_LINEAR_MASK flag be set. caveat 4	20
Particle Appearance
PSYS_PART_START_COLOR		vector color_start	A vector specifying the color of the particles upon emission.	1
PSYS_PART_END_COLOR		vector color_end	A vector specifying the color the particles transition to during their lifetime. Only used if the PSYS_PART_INTERP_COLOR_MASK flag is set.	3
PSYS_PART_START_ALPHA		float alpha_start	Specifies the alpha of the particles upon emission. Valid values are in the range 0.0 to 1.0. Lower values are more transparent; higher ones are more opaque.	2
PSYS_PART_END_ALPHA		float alpha_end	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.	4
PSYS_PART_START_SCALE		vector scale_start	Specifies the scale or size of the particles upon emission. Valid values for each direction are 0.03125 to 4.0, in meters. The actual particle size is always a multiple of 0.03125. Smaller changes don't have any effect. Since particles are essentially 2D sprites, the Z component of the vector is ignored and can be set to 0.0.	5
PSYS_PART_END_SCALE		vector scale_end	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.	6
PSYS_SRC_TEXTURE		string texture	Specifies the name of a texture in the emitter prim's inventory to use for each particle. Alternatively, you may specify an asset key UUID for a texture. If using llLinkParticleSystem and texture is not a UUID, texture must be in the emitter prim (not necessarily with the script).	12
PSYS_PART_START_GLOW		float glow_start	Specifies the glow of the particles upon emission. Valid values are in the range of 0.0 (no glow) to 1.0 (full glow).	26
PSYS_PART_END_GLOW		float glow_end	Specifies the glow that the particles transition to during their lifetime. Valid values are the same as PSYS_PART_START_GLOW.	27
Particle Blending
Note: The particle system blend parameters wrap directly to OpenGL's glBlendFunc. Detailed documentation for glBlendFunc, including formulas, can be found in the official glBlendFunc documentation
PSYS_PART_BLEND_FUNC_SOURCE		integer bf_source	Specifies how blending function uses the incoming particle's color and alpha information to produce the rendered result. Defaults to PSYS_PART_BF_SOURCE_ALPHA.	24
PSYS_PART_BLEND_FUNC_DEST		integer bf_dest	Specifies how blending function uses the current framebuffer's color and alpha information to produce the rendered result. Defaults to PSYS_PART_BF_ONE_MINUS_SOURCE_ALPHA. To make particles blend with the background in a less opaque and more luminescent way use PSYS_PART_BF_ONE for dest and the default for source. Most other blending combinations will render the invisible/alpha portion of your particle texture, unless the invisible area of your texture is all black (or, in some cases, unless it is all white).	25
V a l u e s	PSYS_PART_BF_ONE		Do not scale the source or destination RGBA values.	0x0
	PSYS_PART_BF_ZERO		Zero out the source or destination RGBA values.	0x1
	PSYS_PART_BF_DEST_COLOR		Scale the RGBA values by the RGBA values of the destination.	0x2
	PSYS_PART_BF_SOURCE_COLOR		Scale the RGBA values by the RGBA values of the particle source.	0x3
	PSYS_PART_BF_ONE_MINUS_DEST_COLOR		Scale the RGBA values by the inverted RGBA values of the destination.	0x4
	PSYS_PART_BF_ONE_MINUS_SOURCE_COLOR		Scale the RGBA values by the inverted RGBA values of the particle source.	0x5
	PSYS_PART_BF_SOURCE_ALPHA		Scale the RGBA values by the alpha values of the particle source.	0x7
	PSYS_PART_BF_ONE_MINUS_SOURCE_ALPHA		Scale the RGBA values by the inverted alpha values of the particle source.	0x9
Particle Flow
PSYS_SRC_MAX_AGE		float duration_system	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. (caveat 1)	19
PSYS_PART_MAX_AGE		float duration_particle	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.	7
PSYS_SRC_BURST_RATE		float burst_sleep	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.	13
PSYS_SRC_BURST_PART_COUNT		integer burst_particle_count	Specifies the number of particles emitted in each "burst".	15
Particle Motion
PSYS_SRC_ACCEL		vector acceleration	Specifies a directional acceleration vector applied to each particle as it is emitted, in meters per second squared. Valid values are 0.0 to 100.0 for each direction both positive and negative, as region coordinates.	8
PSYS_SRC_OMEGA		vector omega	Sets how far to rotate the "pattern" after each particle burst. (Burst frequency is set with PSYS_SRC_BURST_RATE.) Omega values are approximately 'radians per burst' around the prim's global (not local) X,Y,Z axes. For precise and predictable pattern rotation, rotate the prim instead of using PSYS_SRC_OMEGA. Omega has no visible effect on drop, explode and certain specific angle and angle cone patterns, depending on prim orientation. Pattern rotation can be used with prim orientation and llTargetOmega() but won't produce consistent results. (caveat 2 and caveat 3)	21
PSYS_SRC_BURST_SPEED_MIN		float 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.	17
PSYS_SRC_BURST_SPEED_MAX		float 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.	18

Examples

• Example Particle Script
• Neurocam Particle Engine

This example produces an effusion of glowing red spheres: <lsl>llParticleSystem(LINK_THIS, [

PSYS_PART_FLAGS, PSYS_PART_WIND_MASK

Notes

Link Numbers

Each prim that makes up an object has an address, a link number. To access a specific prim in the object, the prim's link number must be known. In addition to prims having link numbers, avatars seated upon the object do as well.

• If an object consists of only one prim, and there are no avatars seated upon it, the (root) prim's link number is zero.
• However, if the object is made up of multiple prims or there is an avatar seated upon the object, the root prim's link number is one.

When an avatar sits on an object, it is added to the end of the link set and will have the largest link number. In addition to this, while an avatar is seated upon an object, the object is unable to link or unlink prims without unseating all avatars first.

Counting Prims & Avatars

There are two functions of interest when trying to find the number of prims and avatars on an object.

• llGetNumberOfPrims() - Returns the number of prims and seated avatars.
• llGetObjectPrimCount(llGetKey()) - Returns only the number of prims in the object but will return zero for attachments.

integer GetPrimCount() { //always returns only the number of prims
    if(llGetAttached())//Is it attached?
        return llGetNumberOfPrims();//returns avatars and prims but attachments can't be sat on.
    return llGetObjectPrimCount(llGetKey());//returns only prims but won't work on attachments.
}

See llGetNumberOfPrims for more about counting prims and avatars.

Errata

If a script located in a child prim erroneously attempts to access link 0, it will get or set the property of the linkset's root prim. This bug (BUG-5049) is preserved for broken legacy scripts.

See Also

Functions

•	llGetLinkNumber	–	Returns the link number of the prim the script is in.
•	llParticleSystem

Articles

•	Color in LSL
•	Translucent Color

Deep Notes

Footnotes

1. ^ LINK_ROOT does not work on single prim objects. Unless there is an avatar sitting on the object.

Signature

function void llLinkParticleSystem( integer link, list rules ); integer PSYS_PART_FLAGS = 0; integer PSYS_PART_BOUNCE_MASK = 0x004; integer PSYS_PART_EMISSIVE_MASK = 0x100; integer PSYS_PART_FOLLOW_SRC_MASK = 0x010; integer PSYS_PART_FOLLOW_VELOCITY_MASK = 0x020; integer PSYS_PART_INTERP_COLOR_MASK = 0x001; integer PSYS_PART_INTERP_SCALE_MASK = 0x002; integer PSYS_PART_RIBBON_MASK = 0x400; integer PSYS_PART_TARGET_LINEAR_MASK = 0x080; integer PSYS_PART_TARGET_POS_MASK = 0x040; integer PSYS_PART_WIND_MASK = 0x008; integer PSYS_SRC_PATTERN = 9; integer PSYS_SRC_PATTERN_EXPLODE = 0x02; integer PSYS_SRC_PATTERN_ANGLE_CONE = 0x08; integer PSYS_SRC_PATTERN_ANGLE = 0x04; integer PSYS_SRC_PATTERN_DROP = 0x01; integer PSYS_SRC_PATTERN_ANGLE_CONE_EMPTY = 0x10; integer PSYS_SRC_BURST_RADIUS = 16; integer PSYS_SRC_ANGLE_BEGIN = 22; integer PSYS_SRC_ANGLE_END = 23; integer PSYS_SRC_INNERANGLE = 10;//deprecated integer PSYS_SRC_OUTERANGLE = 11;//deprecated integer PSYS_SRC_TARGET_KEY = 20; integer PSYS_PART_START_COLOR = 1; integer PSYS_PART_END_COLOR = 3; integer PSYS_PART_START_ALPHA = 2; integer PSYS_PART_END_ALPHA = 4; integer PSYS_PART_START_SCALE = 5; integer PSYS_PART_END_SCALE = 6; integer PSYS_SRC_TEXTURE = 12; integer PSYS_PART_START_GLOW = 26; integer PSYS_PART_END_GLOW = 27; integer PSYS_SRC_MAX_AGE = 19; integer PSYS_PART_MAX_AGE = 7; integer PSYS_SRC_BURST_RATE = 13; integer PSYS_SRC_BURST_PART_COUNT = 15; integer PSYS_SRC_ACCEL = 8; integer PSYS_SRC_OMEGA = 21; integer PSYS_SRC_BURST_SPEED_MIN = 17; integer PSYS_SRC_BURST_SPEED_MAX = 18;