Returns the states of all effects of a sound.

OOP Syntax Help! I don't understand this!

• Method: sound:getEffects(...)

Syntax

table|false getSoundEffects ( sound/player theSound )

Required Arguments

• theSound: A sound element.

Returns

• table|false: effects
  • gargle
  • compressor
  • echo
  • i3dl2reverb
  • distortion
  • chorus
  • parameq
  • reverb
  • flanger

Returns a table with the effect names as the keys, and their states as the values if successful. Otherwise, it returns false.

Code Examples

Example 1 Example 2 (OOP)

client

function switchEffects(sound)
  for _,v in ipairs(getSoundEffects(sound)) do -- Go through the whole list of sound effects for the sound
    if v == "gargle" then -- If the sound effect is 'gargle', proceed
      setSoundEffectEnabled(sound, "gargle", false) -- Disable the 'gargle' -effect
      break
    end
  end
end

client

OOP Required

function switchEffects(sound)
  for _,v in ipairs(sound:getEffects()) do -- Go through the whole list of sound effects for the sound
    if v == "gargle" then -- If the sound effect is 'gargle', proceed
      sound:setEffectEnabled("gargle", false) -- Disable the 'gargle' -effect
      break
    end
  end
end

See Also

Audio Functions

• getSFXStatus
• getRadioChannel
• getSoundBPM
• getSoundBufferLength
• getRadioChannelName
• getSoundEffectParameters
• getSoundFFTData
• getSoundEffects
• getSoundLevelData
• getSoundMetaTags
• getSoundPan
• getSoundMinDistance
• getSoundMaxDistance
• getSoundPosition
• getSoundLength
• getSoundProperties
• getSoundVolume
• getSoundSpeed
• getSoundWaveData
• isSoundPanningEnabled
• playSFX3D
• isSoundPaused
• playSFX
• isSoundLooped
• playSound
• playSound3D
• setRadioChannel
• setSoundEffectEnabled
• setSoundLooped
• setSoundMaxDistance
• setSoundEffectParameter
• setSoundPan
• setSoundMinDistance
• setSoundPanningEnabled
• setSoundPaused
• setSoundPosition
• setSoundProperties
• setSoundSpeed
• setSoundVolume
• stopSound

Audio Elements

• sound

Reference

• Scripting Functions