Difference between revisions of "SoundChannel:setEffect"

From GiderosMobile
(Created page with "__NOTOC__ '''Available since:''' Gideros 2022.6<br/> '''Class:''' SoundChannel<br/> === Description === Sets effects on a sound channel. <source lang="lua"> SoundChannel:...")
 
Line 9: Line 9:
 
</source>
 
</source>
  
 +
Available effects are:
 +
* '''"equalizer"'''
 +
* '''"biquad"'''
  
'''TODO: add a list of all possible effects'''
+
Available parameters for '''equalizer''' are:
 +
* AL_EQUALIZER_LOW_GAIN 0x0001
 +
* AL_EQUALIZER_LOW_CUTOFF 0x0002
 +
* AL_EQUALIZER_MID1_GAIN 0x0003
 +
* AL_EQUALIZER_MID1_CENTER 0x0004
 +
* AL_EQUALIZER_MID1_WIDTH 0x0005
 +
* AL_EQUALIZER_MID2_GAIN 0x0006
 +
* AL_EQUALIZER_MID2_CENTER 0x0007
 +
* AL_EQUALIZER_MID2_WIDTH 0x0008
 +
* AL_EQUALIZER_HIGH_GAIN 0x0009
 +
* AL_EQUALIZER_HIGH_CUTOFF 0x000A
  
 
=== Parameters ===
 
=== Parameters ===
'''effect''': (number) the effect to set new values to<br/>
+
'''effect''': (String) the effect to set new values to<br/>
 
'''params''': (number) the new values of the effect<br/>
 
'''params''': (number) the new values of the effect<br/>
  
Line 20: Line 33:
 
local sndcoin = Sound.new("audio/sfx/sfx_coin_double1.wav")
 
local sndcoin = Sound.new("audio/sfx/sfx_coin_double1.wav")
 
local channel = sndcoin:play()
 
local channel = sndcoin:play()
 +
-- audioChannel:setEffect("equalizer",{ equalizer settings })
 
channel:setEffect("equalizer", {AL_EQUALIZER_HIGH_GAIN, 10})
 
channel:setEffect("equalizer", {AL_EQUALIZER_HIGH_GAIN, 10})
 +
--  audioChannel:setEffect("biquad",{ biquad coefficients })
 +
channel:setEffect("biquad", {2,1,12})
 
</source>
 
</source>
  
 
{{SoundChannel}}
 
{{SoundChannel}}

Revision as of 10:30, 12 March 2023

Available since: Gideros 2022.6
Class: SoundChannel

Description

Sets effects on a sound channel.

SoundChannel:setEffect(effect,params)

Available effects are:

  • "equalizer"
  • "biquad"

Available parameters for equalizer are:

  • AL_EQUALIZER_LOW_GAIN 0x0001
  • AL_EQUALIZER_LOW_CUTOFF 0x0002
  • AL_EQUALIZER_MID1_GAIN 0x0003
  • AL_EQUALIZER_MID1_CENTER 0x0004
  • AL_EQUALIZER_MID1_WIDTH 0x0005
  • AL_EQUALIZER_MID2_GAIN 0x0006
  • AL_EQUALIZER_MID2_CENTER 0x0007
  • AL_EQUALIZER_MID2_WIDTH 0x0008
  • AL_EQUALIZER_HIGH_GAIN 0x0009
  • AL_EQUALIZER_HIGH_CUTOFF 0x000A

Parameters

effect: (String) the effect to set new values to
params: (number) the new values of the effect

Example

local sndcoin = Sound.new("audio/sfx/sfx_coin_double1.wav")
local channel = sndcoin:play()
-- audioChannel:setEffect("equalizer",{ equalizer settings })
channel:setEffect("equalizer", {AL_EQUALIZER_HIGH_GAIN, 10})
--  audioChannel:setEffect("biquad",{ biquad coefficients })
channel:setEffect("biquad", {2,1,12})