SetWorldSoundEnabled: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
Line 13: Line 13:


===Required Arguments===  
===Required Arguments===  
*'''group:''' An [[integer]] representing the [[World sound groups|world sound group]]
*'''group:''' An [[int|integer]] representing the [[World sound groups|world sound group]]
*'''enable:''' Set to ''false'' to disable, ''true'' to enable
*'''enable:''' Set to ''false'' to disable, ''true'' to enable


===Optional Arguments===  
===Optional Arguments===  
*'''index:''' An [[integer]] representing an individual sound within the group
*'''index:''' An [[int|integer]] representing an individual sound within the group
{{New feature/item|9.0156|1.5.6|11860|
{{New feature/item|9.0156|1.5.6|11860|
*'''immediate:''' A [[boolean]] if set to true will cancel the sound if it's already playing. This parameter only works for stopping the sound.
*'''immediate:''' A [[boolean]] if set to true will cancel the sound if it's already playing. This parameter only works for stopping the sound.

Revision as of 17:25, 30 July 2018

This template is no longer in use as it results in poor readability. This function allows you to disable world sounds. A world sound is a sound effect which has not been caused by playSound or playSound3D.

[[{{{image}}}|link=|]] Note:
  • The values for group and index can be determined by using the client command showsound in conjunction with setDevelopmentMode
  • This function does not affect sounds which are already playing, such as the wind sound that can only be stopped by entering an interior.

Syntax

bool setWorldSoundEnabled ( int group, [ int index = -1, ] bool enable [, bool immediate = false ] )

Required Arguments

Optional Arguments

  • index: An integer representing an individual sound within the group
ADDED/UPDATED IN VERSION 1.5.6 r11860:
  • immediate: A boolean if set to true will cancel the sound if it's already playing. This parameter only works for stopping the sound.

Returns

Returns true if the world sound was correctly enabled/disabled, false if invalid values were passed.

Example

This is a simplified example that lets the client toggle their weapon sounds. 

function toggleWeaponSounds_f ( )
    local enabled = isWorldSoundEnabled ( 5 ) -- We place this variable here for checking.
    enabled       = not enabled -- And here we invert (toggle) the variable, so if it's false, it becomes true, if it's true, it becomes false.
    -- Used for the chat declaration:
    local state   = "enabled"

    if ( not enabled ) then
        state = "disabled"
    end
    --

    setWorldSoundEnabled ( 5, enabled ) -- And here the toggling happens.
    outputChatBox ( "Weapon sounds " .. state )
end
addCommandHandler ( "toggleweaponsounds", toggleWeaponSounds_f )
ADDED/UPDATED IN VERSION 1.5.6 r11860:

This example disables the wind sound effect immediately without changing the interior afterwards. 

setWorldSoundEnabled(0, 0, false, true)
setWorldSoundEnabled(0, 29, false, true)
setWorldSoundEnabled(0, 30, false, true)

Requirements

This template will be deleted.

See Also



Retrieved from "https://wiki.multitheftauto.com/wiki/SetWorldSoundEnabled?oldid=57199"