Difference between revisions of "LlTriggerSoundLimited"

Revision as of 15:05, 15 October 2013

Function: llTriggerSoundLimited( string sound, float volume, vector top_north_east, vector bottom_south_west );

Plays sound at volume, centered at but not attached to the object, limited to the box defined by vectors top_north_east and bottom_south_west

• string	sound	–	a sound in the inventory of the prim this script is in or a UUID of a sound
• float	volume	–	between 0.0 (silent) and 1.0 (loud) (`0.0 <= volume <= 1.0`)
• vector	top_north_east	–	position in region coordinates
• vector	bottom_south_west	–	position in region coordinates

If the object moves the sound does not move with it.
Use llPlaySound to play a sound attached to the object.

If sound is missing from the prim's inventory and it is not a UUID or it is not a sound then an error is shouted on DEBUG_CHANNEL.
If sound is a UUID then there are no new asset permissions consequences for the object.
- The resulting object develops no new usage restrictions that might have occurred if the asset had been placed in the prims inventory.

A

llTriggerSoundLimited generates an improper script error when avatar sounds are disabled, llPlaySound disregards parcel settings

		SVC-4897	A		llSetSyncTime() - a function for synchronising client side effects
		BUG-4130	A		llTriggerSoundLimited generates an improper script error when avatar sounds are disabled, llPlaySound disregards parcel settings

Signature
function void llTriggerSoundLimited( string sound, float volume, vector top_north_east, vector bottom_south_west );

@@ Line 1: / Line 1: @@
 {{LSL_Function
-|inject-2={{Issues/SVC-4897}}
+|inject-2={{Issues/SVC-4897}}{{Issues/BUG-4130}}
 {{LSL_Function/inventory|sound|uuid=true|type=sound|volume=volume}}
 {{LSL_Function/position|top_north_east|region=*}}
@@ Line 11: / Line 11: @@
 |p4_type=vector|p4_name=bottom_south_west
 |func_footnote=If the object moves the sound does not move with it.<br/>Use {{LSLG|llPlaySound}} to play a sound attached to the object.
-|func_desc=Plays '''sound''' at '''volume''', centered at but not attached to the object, limited to the box defined by vectors '''top_north_east''' and '''bottom_south_west'''
+|func_desc=Plays {{LSLPT|sound}} at {{LSLPT|volume}}, centered at but not attached to the object, limited to the box defined by vectors {{LSLPT|top_north_east}} and {{LSLPT|bottom_south_west}}
 |return_text
 |spec