OsTriggerSoundLimited

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m (Use 0 and not None for no function delay.)
m (Change See Also)
 
(3 intermediate revisions by one user not shown)
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.
 +
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">
 
|ossl_example=<source lang="lsl">
−
osTriggerSoundLimited(linknum, "c98100c4-6a2a-456c-a5ba-3cfdb5c14715", 1.0, <30,30,22>, <50,50,30>);
+
//
−
osTriggerSoundLimited(linknum, "Name of sound in this prim", 1.0, <30,30,22>, <50,50,30>);
+
// 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>
 
</source>
−
|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.
+
'''And with uuid:'''
 +
<source lang="lsl">
 +
//
 +
// osTriggerSoundLimited Script Example
 +
// Author: djphil
 +
//
  
−
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.
+
string sound = "d7a9a565-a013-2a69-797d-5332baa1a947";
 +
vector north_east_corner = <30.0, 30.0, 22.0>;
 +
vector south_west_corner = <50.0, 50.0, 30.0>;
  
−
The two vectors are locations in region coordinates.
+
default
−
|additional_info=
+
{
−
This function was added in 0.9.0.1
+
    state_entry()
 +
    {
 +
        if (osIsUUID(sound))
 +
        {
 +
            llSay(PUBLIC_CHANNEL, "Touch to hear osTriggerSoundLimited running.");
 +
        }
 +
 +
        else
 +
        {
 +
            llSay(PUBLIC_CHANNEL, "Invalid uuid detected ...");
 +
        }
 +
    }
  
 +
    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  
 
}}
 
}}
 +
== See Also ==
 +
* [[osTriggerSound]]
 +
* [[osTriggerSoundLimited]]

Latest revision as of 19:08, 5 December 2020

Languages Languages: 

En.png English

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.
The two vectors are locations in region coordinates.

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);
    }
}

And with uuid: 

//
// osTriggerSoundLimited Script Example
// Author: djphil
//
 
string sound = "d7a9a565-a013-2a69-797d-5332baa1a947";
vector north_east_corner = <30.0, 30.0, 22.0>;
vector south_west_corner = <50.0, 50.0, 30.0>;
 
default
{
    state_entry()
    {
        if (osIsUUID(sound))
        {
            llSay(PUBLIC_CHANNEL, "Touch to hear osTriggerSoundLimited running.");
        }
 
        else
        {
            llSay(PUBLIC_CHANNEL, "Invalid uuid detected ...");
        }
    }
 
    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


[edit] See Also

Retrieved from "http://opensimulator.org/index.php?title=OsTriggerSoundLimited&oldid=50361"
Personal tools
General
About This Wiki