SetWorldSoundEnabled: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
(Info about new argument) |
||
Line 12: | Line 12: | ||
==Syntax== | ==Syntax== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
bool setWorldSoundEnabled( int group, [ int index = -1, ] bool enable ) | bool setWorldSoundEnabled( int group, [ int index = -1, ] bool enable, [ bool forceCancel = false ] ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Line 21: | Line 21: | ||
===OptionalArguments=== | ===OptionalArguments=== | ||
*'''index :''' An integer representing an individual sound within the group | *'''index :''' An integer representing an individual sound within the group | ||
{{New feature/item|9.0156|1.5.6|11860| | |||
*'''forceCancel :''' Boolean if set to true will cancel the sound if it's already playing. | |||
}} | |||
===Returns=== | ===Returns=== |
Revision as of 15:53, 21 February 2018
This function allows you to disable world sounds. A world sound is a sound effect which has not been caused by playSound or playSound3D.
Note: The values for group and index can be determined by using the client command showsound in conjunction with setDevelopmentMode
Note: This function does not affect sounds which are already playing, such as the wind sound that can only be stopped by entering an interior.
This template is no longer in use as it results in poor readability.
Syntax
bool setWorldSoundEnabled( int group, [ int index = -1, ] bool enable, [ bool forceCancel = false ] )
Required Arguments
- group : An integer representing the world sound group
- enable : Set false to disable, true to enable
OptionalArguments
- index : An integer representing an individual sound within the group
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 )
Requirements
This template will be deleted.
See Also
- createSWATRope
- getBirdsEnabled
- getCoronaReflectionsEnabled
- getGarageBoundingBox
- getGaragePosition
- getGarageSize
- getGroundPosition
- getInteriorFurnitureEnabled
- getNearClipDistance
- getPedsLODDistance
- getRoofPosition
- getScreenFromWorldPosition
- getVehiclesLODDistance
- getWorldFromScreenPosition
- isAmbientSoundEnabled
- isLineOfSightClear
- isWorldSoundEnabled
- processLineOfSight
- resetAmbientSounds
- resetBlurLevel
- resetColorFilter
- resetCoronaReflectionsEnabled
- resetNearClipDistance
- resetPedsLODDistance
- resetVehiclesLODDistance
- resetWorldSounds
- setAmbientSoundEnabled
- setBirdsEnabled
- setColorFilter
- setCoronaReflectionsEnabled
- setInteriorFurnitureEnabled
- setInteriorSoundsEnabled
- setNearClipDistance
- setPedsLODDistance
- setVehiclesLODDistance
- setWorldSoundEnabled
- testLineAgainstWater
- areTrafficLightsLocked
- getAircraftMaxHeight
- getAircraftMaxVelocity
- getCloudsEnabled
- getFarClipDistance
- getFogDistance
- getGameSpeed
- getGravity
- getHeatHaze
- getInteriorSoundsEnabled
- getJetpackMaxHeight
- getMinuteDuration
- getMoonSize
- getOcclusionsEnabled
- getRainLevel
- getSunColor
- getSunSize
- getTime
- getTrafficLightState
- getWeather
- getWindVelocity
- getSkyGradient
- getPlayerBlurLevel
- getZoneName
- isGarageOpen
- removeWorldModel
- resetFarClipDistance
- resetFogDistance
- resetHeatHaze
- resetMoonSize
- resetRainLevel
- resetSkyGradient
- resetSunColor
- resetSunSize
- resetWindVelocity
- restoreAllWorldModels
- restoreWorldModel
- setAircraftMaxHeight
- setAircraftMaxVelocity
- setCloudsEnabled
- setFarClipDistance
- setFogDistance
- setGameSpeed
- setGarageOpen
- setGravity
- setHeatHaze
- setInteriorSoundsEnabled
- setMinuteDuration
- setMoonSize
- setOcclusionsEnabled
- setRainLevel
- setSkyGradient
- setSunColor
- setSunSize
- setTime
- setTrafficLightState
- setTrafficLightsLocked
- setWeather
- setWeatherBlended
- setWindVelocity
- setJetpackMaxHeight
- setPlayerBlurLevel