OsTriggerSoundLimited
From OpenSimulator
(Difference between revisions)
m (Use 0 and not None for no function delay.) |
(Add exemple) |
||
| Line 4: | Line 4: | ||
|permissions=true | |permissions=true | ||
|delay=0 | |delay=0 | ||
| − | |||
| − | |||
| − | |||
| − | |||
|description=Start a one time play of the specified sound once at the specified volume in the viewers of avatars located within the box defined by the two vectors. | |description=Start a one time play of the specified sound once at the specified volume in the viewers of avatars located within the box defined by the two vectors. | ||
| + | The sound parameter can be the UUID of a sound or the name of a sound that is in the inventory of the target prim.<br> | ||
| + | The two vectors are locations in region coordinates. | ||
| + | |ossl_example=<source lang="lsl"> | ||
| + | // | ||
| + | // osTriggerSoundLimited Script Example | ||
| + | // Author: djphil | ||
| + | // | ||
| − | + | vector north_east_corner = <30.0, 30.0, 22.0>; | |
| + | vector south_west_corner = <50.0, 50.0, 30.0>; | ||
| + | string sound; | ||
| − | + | default | |
| − | + | { | |
| − | + | state_entry() | |
| + | { | ||
| + | sound = llGetInventoryName(INVENTORY_SOUND, 0); | ||
| + | |||
| + | if (sound == "") | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "Inventory sound missing ..."); | ||
| + | } | ||
| + | |||
| + | else | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "Touch to hear osTriggerSoundLimited running."); | ||
| + | } | ||
| + | } | ||
| + | touch_start(integer number) | ||
| + | { | ||
| + | osTriggerSoundLimited(1, sound, 1.0, north_east_corner, south_west_corner); | ||
| + | } | ||
| + | } | ||
| + | </source> | ||
| + | |additional_info=This function was added in 0.9.0.1 | ||
Since 0.9.1 if target prim inventory does not contain the sound, the inventory of the prim containing the script calling this function is also checked | Since 0.9.1 if target prim inventory does not contain the sound, the inventory of the prim containing the script calling this function is also checked | ||
}} | }} | ||
Revision as of 13:52, 3 December 2020
 |
Languages: |
|
osTriggerSoundLimited(integer linknum, string sound, float volume, vector north_east_corner, vector south_west_corner)
| |
| Start a one time play of the specified sound once at the specified volume in the viewers of avatars located within the box defined by the two vectors.
The sound parameter can be the UUID of a sound or the name of a sound that is in the inventory of the target prim. | |
| Threat Level | This function does not do a threat level check |
| Permissions | Use of this function is always allowed by default |
| Extra Delay | 0 seconds |
| Example(s) | |
// // osTriggerSoundLimited Script Example // Author: djphil // vector north_east_corner = <30.0, 30.0, 22.0>; vector south_west_corner = <50.0, 50.0, 30.0>; string sound; default { state_entry() { sound = llGetInventoryName(INVENTORY_SOUND, 0); if (sound == "") { llSay(PUBLIC_CHANNEL, "Inventory sound missing ..."); } else { llSay(PUBLIC_CHANNEL, "Touch to hear osTriggerSoundLimited running."); } } touch_start(integer number) { osTriggerSoundLimited(1, sound, 1.0, north_east_corner, south_west_corner); } } | |
| Notes | |
| This function was added in 0.9.0.1
Since 0.9.1 if target prim inventory does not contain the sound, the inventory of the prim containing the script calling this function is also checked | |
