Difference between revisions of "LlLoopSoundMaster"

From Second Life Wiki
Jump to navigation Jump to search
m (States should not be used for something so simple as a toggle. Modified the example.)
m (Fixed the example syntax & Toggle State artifact text that is irrelevant)
Line 16: Line 16:
llLoopSoundMaster("MasterLoop", 1.0);
llLoopSoundMaster("MasterLoop", 1.0);
</source>
</source>
The script below can be added to an object, to toggle a SoundMaster on and off. Note that the script requires a sound in inventory called MasterLoop, or you need to change the argument in the function for it to work. This script is a slight modification to the script [[Toggle_States]], adding only the llLoopSoundMaster and [[llStopSound]] to make it work.
The script below can be added to an object, to toggle a SoundMaster on and off. Note that the script requires a sound in inventory called MasterLoop, or you need to change the argument in the function for it to work.
<source lang="lsl2">
<source lang="lsl2">
//This integer (actually a boolean) will be used to manage the toggle effect.
//This integer (actually a boolean) will be used to manage the toggle effect.
integer soundState = FALSE;
integer soundState = FALSE;
//Change MasterLoop to the sound clip you want to use.
string soundClip = "MasterLoop";
string soundClip = "MasterLoop";
default {
default {
     state_entry() {
     state_entry()
         // run this code when entering the default state
    {
        // displays red "OFF" as floating text above the prim
         //Displays red "OFF" as floating text above the prim
         llSetText("OFF", <1,0,0>, 1.0);
         llSetText("OFF", <1,0,0>, 1.0);
     }
     }
     touch_start(integer num_detected) {
     touch_start(integer num_detected)
         // when touched, soundState inverts its current boolean value.  
    {
         //When touched, soundState inverts its current boolean value. 1 becomes 0, 0 becomes 1.  
         soundState = !soundState;
         soundState = !soundState;
if(soundState)
        if(soundState)
{
        {
// run this code when entering soundState 'on'
            //Run this code when entering soundState 'on'
// displays green "ON" as floating text above the prim
            //Displays green "ON" as floating text above the prim
llSetText("ON", <0,1,0>, 1.0);
            llSetText("ON", <0,1,0>, 1.0);
llLoopSoundMaster(soundClip, 1.0);
            llLoopSoundMaster(soundClip, 1.0);
}else
        }else
{
        {   //Run this code when entering soundState 'off'
// when touched, stop sound & switch back to the default state
            //When touched, stop sound & display red "OFF" as floating text.
llStopSound();
            llSetText("OFF", <1,0,0>, 1.0);
}
            llStopSound();
        }
     }
     }
}
}

Revision as of 08:47, 26 December 2018

Summary

Function: llLoopSoundMaster( string sound, float volume );

Plays attached sound looping at volume, declares it a sync master.

• 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)

Caveats

  • 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.
All Issues ~ Search JIRA for related Bugs

Examples

// for an uploaded .wav file called "MasterLoop" in inventory
llLoopSoundMaster("MasterLoop", 1.0);

The script below can be added to an object, to toggle a SoundMaster on and off. Note that the script requires a sound in inventory called MasterLoop, or you need to change the argument in the function for it to work. 

//This integer (actually a boolean) will be used to manage the toggle effect.
integer soundState = FALSE;
//Change MasterLoop to the sound clip you want to use.
string soundClip = "MasterLoop";
default {
    state_entry()
    {
        //Displays red "OFF" as floating text above the prim
        llSetText("OFF", <1,0,0>, 1.0);
    }
    touch_start(integer num_detected)
    {
        //When touched, soundState inverts its current boolean value. 1 becomes 0, 0 becomes 1. 
        soundState = !soundState;
        if(soundState)
        {
            //Run this code when entering soundState 'on'
            //Displays green "ON" as floating text above the prim
            llSetText("ON", <0,1,0>, 1.0);
            llLoopSoundMaster(soundClip, 1.0);
        }else
        {   //Run this code when entering soundState 'off'
            //When touched, stop sound & display red "OFF" as floating text.
            llSetText("OFF", <1,0,0>, 1.0);
            llStopSound();
        }
    }
}

See Also

Functions

•  llLoopSound – Plays a sound attached indefinitely.
•  llLoopSoundSlave
•  llPlaySoundSlave – Plays a sound attached once.

Deep Notes

Search JIRA for related Issues

Signature

function void llLoopSoundMaster( string sound, float volume );
Retrieved from "https://wiki.secondlife.com/w/index.php?title=LlLoopSoundMaster&oldid=1207952"