reverb.cpp 48 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238
  1. #include "config.h"
  2. #include <algorithm>
  3. #include <array>
  4. #include <cmath>
  5. #include <variant>
  6. #include "AL/al.h"
  7. #include "AL/efx.h"
  8. #include "alnumeric.h"
  9. #include "alspan.h"
  10. #include "core/effects/base.h"
  11. #include "effects.h"
  12. #ifdef ALSOFT_EAX
  13. #include <cassert>
  14. #include "al/eax/api.h"
  15. #include "al/eax/call.h"
  16. #include "al/eax/effect.h"
  17. #include "al/eax/exception.h"
  18. #include "al/eax/utils.h"
  19. #endif // ALSOFT_EAX
  20. namespace {
  21. constexpr EffectProps genDefaultProps() noexcept
  22. {
  23. ReverbProps props{};
  24. props.Density = AL_EAXREVERB_DEFAULT_DENSITY;
  25. props.Diffusion = AL_EAXREVERB_DEFAULT_DIFFUSION;
  26. props.Gain = AL_EAXREVERB_DEFAULT_GAIN;
  27. props.GainHF = AL_EAXREVERB_DEFAULT_GAINHF;
  28. props.GainLF = AL_EAXREVERB_DEFAULT_GAINLF;
  29. props.DecayTime = AL_EAXREVERB_DEFAULT_DECAY_TIME;
  30. props.DecayHFRatio = AL_EAXREVERB_DEFAULT_DECAY_HFRATIO;
  31. props.DecayLFRatio = AL_EAXREVERB_DEFAULT_DECAY_LFRATIO;
  32. props.ReflectionsGain = AL_EAXREVERB_DEFAULT_REFLECTIONS_GAIN;
  33. props.ReflectionsDelay = AL_EAXREVERB_DEFAULT_REFLECTIONS_DELAY;
  34. props.ReflectionsPan[0] = AL_EAXREVERB_DEFAULT_REFLECTIONS_PAN_XYZ;
  35. props.ReflectionsPan[1] = AL_EAXREVERB_DEFAULT_REFLECTIONS_PAN_XYZ;
  36. props.ReflectionsPan[2] = AL_EAXREVERB_DEFAULT_REFLECTIONS_PAN_XYZ;
  37. props.LateReverbGain = AL_EAXREVERB_DEFAULT_LATE_REVERB_GAIN;
  38. props.LateReverbDelay = AL_EAXREVERB_DEFAULT_LATE_REVERB_DELAY;
  39. props.LateReverbPan[0] = AL_EAXREVERB_DEFAULT_LATE_REVERB_PAN_XYZ;
  40. props.LateReverbPan[1] = AL_EAXREVERB_DEFAULT_LATE_REVERB_PAN_XYZ;
  41. props.LateReverbPan[2] = AL_EAXREVERB_DEFAULT_LATE_REVERB_PAN_XYZ;
  42. props.EchoTime = AL_EAXREVERB_DEFAULT_ECHO_TIME;
  43. props.EchoDepth = AL_EAXREVERB_DEFAULT_ECHO_DEPTH;
  44. props.ModulationTime = AL_EAXREVERB_DEFAULT_MODULATION_TIME;
  45. props.ModulationDepth = AL_EAXREVERB_DEFAULT_MODULATION_DEPTH;
  46. props.AirAbsorptionGainHF = AL_EAXREVERB_DEFAULT_AIR_ABSORPTION_GAINHF;
  47. props.HFReference = AL_EAXREVERB_DEFAULT_HFREFERENCE;
  48. props.LFReference = AL_EAXREVERB_DEFAULT_LFREFERENCE;
  49. props.RoomRolloffFactor = AL_EAXREVERB_DEFAULT_ROOM_ROLLOFF_FACTOR;
  50. props.DecayHFLimit = AL_EAXREVERB_DEFAULT_DECAY_HFLIMIT;
  51. return props;
  52. }
  53. constexpr EffectProps genDefaultStdProps() noexcept
  54. {
  55. ReverbProps props{};
  56. props.Density = AL_REVERB_DEFAULT_DENSITY;
  57. props.Diffusion = AL_REVERB_DEFAULT_DIFFUSION;
  58. props.Gain = AL_REVERB_DEFAULT_GAIN;
  59. props.GainHF = AL_REVERB_DEFAULT_GAINHF;
  60. props.GainLF = 1.0f;
  61. props.DecayTime = AL_REVERB_DEFAULT_DECAY_TIME;
  62. props.DecayHFRatio = AL_REVERB_DEFAULT_DECAY_HFRATIO;
  63. props.DecayLFRatio = 1.0f;
  64. props.ReflectionsGain = AL_REVERB_DEFAULT_REFLECTIONS_GAIN;
  65. props.ReflectionsDelay = AL_REVERB_DEFAULT_REFLECTIONS_DELAY;
  66. props.ReflectionsPan = {0.0f, 0.0f, 0.0f};
  67. props.LateReverbGain = AL_REVERB_DEFAULT_LATE_REVERB_GAIN;
  68. props.LateReverbDelay = AL_REVERB_DEFAULT_LATE_REVERB_DELAY;
  69. props.LateReverbPan = {0.0f, 0.0f, 0.0f};
  70. props.EchoTime = 0.25f;
  71. props.EchoDepth = 0.0f;
  72. props.ModulationTime = 0.25f;
  73. props.ModulationDepth = 0.0f;
  74. props.AirAbsorptionGainHF = AL_REVERB_DEFAULT_AIR_ABSORPTION_GAINHF;
  75. props.HFReference = 5000.0f;
  76. props.LFReference = 250.0f;
  77. props.RoomRolloffFactor = AL_REVERB_DEFAULT_ROOM_ROLLOFF_FACTOR;
  78. props.DecayHFLimit = AL_REVERB_DEFAULT_DECAY_HFLIMIT;
  79. return props;
  80. }
  81. } // namespace
  82. const EffectProps ReverbEffectProps{genDefaultProps()};
  83. void ReverbEffectHandler::SetParami(ReverbProps &props, ALenum param, int val)
  84. {
  85. switch(param)
  86. {
  87. case AL_EAXREVERB_DECAY_HFLIMIT:
  88. if(!(val >= AL_EAXREVERB_MIN_DECAY_HFLIMIT && val <= AL_EAXREVERB_MAX_DECAY_HFLIMIT))
  89. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb decay hflimit out of range"};
  90. props.DecayHFLimit = val != AL_FALSE;
  91. break;
  92. default:
  93. throw effect_exception{AL_INVALID_ENUM, "Invalid EAX reverb integer property 0x%04x",
  94. param};
  95. }
  96. }
  97. void ReverbEffectHandler::SetParamiv(ReverbProps &props, ALenum param, const int *vals)
  98. { SetParami(props, param, *vals); }
  99. void ReverbEffectHandler::SetParamf(ReverbProps &props, ALenum param, float val)
  100. {
  101. switch(param)
  102. {
  103. case AL_EAXREVERB_DENSITY:
  104. if(!(val >= AL_EAXREVERB_MIN_DENSITY && val <= AL_EAXREVERB_MAX_DENSITY))
  105. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb density out of range"};
  106. props.Density = val;
  107. break;
  108. case AL_EAXREVERB_DIFFUSION:
  109. if(!(val >= AL_EAXREVERB_MIN_DIFFUSION && val <= AL_EAXREVERB_MAX_DIFFUSION))
  110. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb diffusion out of range"};
  111. props.Diffusion = val;
  112. break;
  113. case AL_EAXREVERB_GAIN:
  114. if(!(val >= AL_EAXREVERB_MIN_GAIN && val <= AL_EAXREVERB_MAX_GAIN))
  115. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb gain out of range"};
  116. props.Gain = val;
  117. break;
  118. case AL_EAXREVERB_GAINHF:
  119. if(!(val >= AL_EAXREVERB_MIN_GAINHF && val <= AL_EAXREVERB_MAX_GAINHF))
  120. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb gainhf out of range"};
  121. props.GainHF = val;
  122. break;
  123. case AL_EAXREVERB_GAINLF:
  124. if(!(val >= AL_EAXREVERB_MIN_GAINLF && val <= AL_EAXREVERB_MAX_GAINLF))
  125. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb gainlf out of range"};
  126. props.GainLF = val;
  127. break;
  128. case AL_EAXREVERB_DECAY_TIME:
  129. if(!(val >= AL_EAXREVERB_MIN_DECAY_TIME && val <= AL_EAXREVERB_MAX_DECAY_TIME))
  130. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb decay time out of range"};
  131. props.DecayTime = val;
  132. break;
  133. case AL_EAXREVERB_DECAY_HFRATIO:
  134. if(!(val >= AL_EAXREVERB_MIN_DECAY_HFRATIO && val <= AL_EAXREVERB_MAX_DECAY_HFRATIO))
  135. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb decay hfratio out of range"};
  136. props.DecayHFRatio = val;
  137. break;
  138. case AL_EAXREVERB_DECAY_LFRATIO:
  139. if(!(val >= AL_EAXREVERB_MIN_DECAY_LFRATIO && val <= AL_EAXREVERB_MAX_DECAY_LFRATIO))
  140. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb decay lfratio out of range"};
  141. props.DecayLFRatio = val;
  142. break;
  143. case AL_EAXREVERB_REFLECTIONS_GAIN:
  144. if(!(val >= AL_EAXREVERB_MIN_REFLECTIONS_GAIN && val <= AL_EAXREVERB_MAX_REFLECTIONS_GAIN))
  145. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb reflections gain out of range"};
  146. props.ReflectionsGain = val;
  147. break;
  148. case AL_EAXREVERB_REFLECTIONS_DELAY:
  149. if(!(val >= AL_EAXREVERB_MIN_REFLECTIONS_DELAY && val <= AL_EAXREVERB_MAX_REFLECTIONS_DELAY))
  150. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb reflections delay out of range"};
  151. props.ReflectionsDelay = val;
  152. break;
  153. case AL_EAXREVERB_LATE_REVERB_GAIN:
  154. if(!(val >= AL_EAXREVERB_MIN_LATE_REVERB_GAIN && val <= AL_EAXREVERB_MAX_LATE_REVERB_GAIN))
  155. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb late reverb gain out of range"};
  156. props.LateReverbGain = val;
  157. break;
  158. case AL_EAXREVERB_LATE_REVERB_DELAY:
  159. if(!(val >= AL_EAXREVERB_MIN_LATE_REVERB_DELAY && val <= AL_EAXREVERB_MAX_LATE_REVERB_DELAY))
  160. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb late reverb delay out of range"};
  161. props.LateReverbDelay = val;
  162. break;
  163. case AL_EAXREVERB_ECHO_TIME:
  164. if(!(val >= AL_EAXREVERB_MIN_ECHO_TIME && val <= AL_EAXREVERB_MAX_ECHO_TIME))
  165. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb echo time out of range"};
  166. props.EchoTime = val;
  167. break;
  168. case AL_EAXREVERB_ECHO_DEPTH:
  169. if(!(val >= AL_EAXREVERB_MIN_ECHO_DEPTH && val <= AL_EAXREVERB_MAX_ECHO_DEPTH))
  170. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb echo depth out of range"};
  171. props.EchoDepth = val;
  172. break;
  173. case AL_EAXREVERB_MODULATION_TIME:
  174. if(!(val >= AL_EAXREVERB_MIN_MODULATION_TIME && val <= AL_EAXREVERB_MAX_MODULATION_TIME))
  175. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb modulation time out of range"};
  176. props.ModulationTime = val;
  177. break;
  178. case AL_EAXREVERB_MODULATION_DEPTH:
  179. if(!(val >= AL_EAXREVERB_MIN_MODULATION_DEPTH && val <= AL_EAXREVERB_MAX_MODULATION_DEPTH))
  180. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb modulation depth out of range"};
  181. props.ModulationDepth = val;
  182. break;
  183. case AL_EAXREVERB_AIR_ABSORPTION_GAINHF:
  184. if(!(val >= AL_EAXREVERB_MIN_AIR_ABSORPTION_GAINHF && val <= AL_EAXREVERB_MAX_AIR_ABSORPTION_GAINHF))
  185. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb air absorption gainhf out of range"};
  186. props.AirAbsorptionGainHF = val;
  187. break;
  188. case AL_EAXREVERB_HFREFERENCE:
  189. if(!(val >= AL_EAXREVERB_MIN_HFREFERENCE && val <= AL_EAXREVERB_MAX_HFREFERENCE))
  190. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb hfreference out of range"};
  191. props.HFReference = val;
  192. break;
  193. case AL_EAXREVERB_LFREFERENCE:
  194. if(!(val >= AL_EAXREVERB_MIN_LFREFERENCE && val <= AL_EAXREVERB_MAX_LFREFERENCE))
  195. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb lfreference out of range"};
  196. props.LFReference = val;
  197. break;
  198. case AL_EAXREVERB_ROOM_ROLLOFF_FACTOR:
  199. if(!(val >= AL_EAXREVERB_MIN_ROOM_ROLLOFF_FACTOR && val <= AL_EAXREVERB_MAX_ROOM_ROLLOFF_FACTOR))
  200. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb room rolloff factor out of range"};
  201. props.RoomRolloffFactor = val;
  202. break;
  203. default:
  204. throw effect_exception{AL_INVALID_ENUM, "Invalid EAX reverb float property 0x%04x", param};
  205. }
  206. }
  207. void ReverbEffectHandler::SetParamfv(ReverbProps &props, ALenum param, const float *vals)
  208. {
  209. static constexpr auto finite_checker = [](float f) -> bool { return std::isfinite(f); };
  210. al::span<const float> values;
  211. switch(param)
  212. {
  213. case AL_EAXREVERB_REFLECTIONS_PAN:
  214. values = {vals, 3_uz};
  215. if(!std::all_of(values.cbegin(), values.cend(), finite_checker))
  216. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb reflections pan out of range"};
  217. std::copy(values.cbegin(), values.cend(), props.ReflectionsPan.begin());
  218. break;
  219. case AL_EAXREVERB_LATE_REVERB_PAN:
  220. values = {vals, 3_uz};
  221. if(!std::all_of(values.cbegin(), values.cend(), finite_checker))
  222. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb late reverb pan out of range"};
  223. std::copy(values.cbegin(), values.cend(), props.LateReverbPan.begin());
  224. break;
  225. default:
  226. SetParamf(props, param, *vals);
  227. break;
  228. }
  229. }
  230. void ReverbEffectHandler::GetParami(const ReverbProps &props, ALenum param, int *val)
  231. {
  232. switch(param)
  233. {
  234. case AL_EAXREVERB_DECAY_HFLIMIT: *val = props.DecayHFLimit; break;
  235. default:
  236. throw effect_exception{AL_INVALID_ENUM, "Invalid EAX reverb integer property 0x%04x",
  237. param};
  238. }
  239. }
  240. void ReverbEffectHandler::GetParamiv(const ReverbProps &props, ALenum param, int *vals)
  241. { GetParami(props, param, vals); }
  242. void ReverbEffectHandler::GetParamf(const ReverbProps &props, ALenum param, float *val)
  243. {
  244. switch(param)
  245. {
  246. case AL_EAXREVERB_DENSITY: *val = props.Density; break;
  247. case AL_EAXREVERB_DIFFUSION: *val = props.Diffusion; break;
  248. case AL_EAXREVERB_GAIN: *val = props.Gain; break;
  249. case AL_EAXREVERB_GAINHF: *val = props.GainHF; break;
  250. case AL_EAXREVERB_GAINLF: *val = props.GainLF; break;
  251. case AL_EAXREVERB_DECAY_TIME: *val = props.DecayTime; break;
  252. case AL_EAXREVERB_DECAY_HFRATIO: *val = props.DecayHFRatio; break;
  253. case AL_EAXREVERB_DECAY_LFRATIO: *val = props.DecayLFRatio; break;
  254. case AL_EAXREVERB_REFLECTIONS_GAIN: *val = props.ReflectionsGain; break;
  255. case AL_EAXREVERB_REFLECTIONS_DELAY: *val = props.ReflectionsDelay; break;
  256. case AL_EAXREVERB_LATE_REVERB_GAIN: *val = props.LateReverbGain; break;
  257. case AL_EAXREVERB_LATE_REVERB_DELAY: *val = props.LateReverbDelay; break;
  258. case AL_EAXREVERB_ECHO_TIME: *val = props.EchoTime; break;
  259. case AL_EAXREVERB_ECHO_DEPTH: *val = props.EchoDepth; break;
  260. case AL_EAXREVERB_MODULATION_TIME: *val = props.ModulationTime; break;
  261. case AL_EAXREVERB_MODULATION_DEPTH: *val = props.ModulationDepth; break;
  262. case AL_EAXREVERB_AIR_ABSORPTION_GAINHF: *val = props.AirAbsorptionGainHF; break;
  263. case AL_EAXREVERB_HFREFERENCE: *val = props.HFReference; break;
  264. case AL_EAXREVERB_LFREFERENCE: *val = props.LFReference; break;
  265. case AL_EAXREVERB_ROOM_ROLLOFF_FACTOR: *val = props.RoomRolloffFactor; break;
  266. default:
  267. throw effect_exception{AL_INVALID_ENUM, "Invalid EAX reverb float property 0x%04x", param};
  268. }
  269. }
  270. void ReverbEffectHandler::GetParamfv(const ReverbProps &props, ALenum param, float *vals)
  271. {
  272. al::span<float> values;
  273. switch(param)
  274. {
  275. case AL_EAXREVERB_REFLECTIONS_PAN:
  276. values = {vals, 3_uz};
  277. std::copy(props.ReflectionsPan.cbegin(), props.ReflectionsPan.cend(), values.begin());
  278. break;
  279. case AL_EAXREVERB_LATE_REVERB_PAN:
  280. values = {vals, 3_uz};
  281. std::copy(props.LateReverbPan.cbegin(), props.LateReverbPan.cend(), values.begin());
  282. break;
  283. default:
  284. GetParamf(props, param, vals);
  285. break;
  286. }
  287. }
  288. const EffectProps StdReverbEffectProps{genDefaultStdProps()};
  289. void StdReverbEffectHandler::SetParami(ReverbProps &props, ALenum param, int val)
  290. {
  291. switch(param)
  292. {
  293. case AL_REVERB_DECAY_HFLIMIT:
  294. if(!(val >= AL_REVERB_MIN_DECAY_HFLIMIT && val <= AL_REVERB_MAX_DECAY_HFLIMIT))
  295. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb decay hflimit out of range"};
  296. props.DecayHFLimit = val != AL_FALSE;
  297. break;
  298. default:
  299. throw effect_exception{AL_INVALID_ENUM, "Invalid EAX reverb integer property 0x%04x",
  300. param};
  301. }
  302. }
  303. void StdReverbEffectHandler::SetParamiv(ReverbProps &props, ALenum param, const int *vals)
  304. { SetParami(props, param, *vals); }
  305. void StdReverbEffectHandler::SetParamf(ReverbProps &props, ALenum param, float val)
  306. {
  307. switch(param)
  308. {
  309. case AL_REVERB_DENSITY:
  310. if(!(val >= AL_REVERB_MIN_DENSITY && val <= AL_REVERB_MAX_DENSITY))
  311. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb density out of range"};
  312. props.Density = val;
  313. break;
  314. case AL_REVERB_DIFFUSION:
  315. if(!(val >= AL_REVERB_MIN_DIFFUSION && val <= AL_REVERB_MAX_DIFFUSION))
  316. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb diffusion out of range"};
  317. props.Diffusion = val;
  318. break;
  319. case AL_REVERB_GAIN:
  320. if(!(val >= AL_REVERB_MIN_GAIN && val <= AL_REVERB_MAX_GAIN))
  321. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb gain out of range"};
  322. props.Gain = val;
  323. break;
  324. case AL_REVERB_GAINHF:
  325. if(!(val >= AL_REVERB_MIN_GAINHF && val <= AL_REVERB_MAX_GAINHF))
  326. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb gainhf out of range"};
  327. props.GainHF = val;
  328. break;
  329. case AL_REVERB_DECAY_TIME:
  330. if(!(val >= AL_REVERB_MIN_DECAY_TIME && val <= AL_REVERB_MAX_DECAY_TIME))
  331. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb decay time out of range"};
  332. props.DecayTime = val;
  333. break;
  334. case AL_REVERB_DECAY_HFRATIO:
  335. if(!(val >= AL_REVERB_MIN_DECAY_HFRATIO && val <= AL_REVERB_MAX_DECAY_HFRATIO))
  336. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb decay hfratio out of range"};
  337. props.DecayHFRatio = val;
  338. break;
  339. case AL_REVERB_REFLECTIONS_GAIN:
  340. if(!(val >= AL_REVERB_MIN_REFLECTIONS_GAIN && val <= AL_REVERB_MAX_REFLECTIONS_GAIN))
  341. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb reflections gain out of range"};
  342. props.ReflectionsGain = val;
  343. break;
  344. case AL_REVERB_REFLECTIONS_DELAY:
  345. if(!(val >= AL_REVERB_MIN_REFLECTIONS_DELAY && val <= AL_REVERB_MAX_REFLECTIONS_DELAY))
  346. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb reflections delay out of range"};
  347. props.ReflectionsDelay = val;
  348. break;
  349. case AL_REVERB_LATE_REVERB_GAIN:
  350. if(!(val >= AL_REVERB_MIN_LATE_REVERB_GAIN && val <= AL_REVERB_MAX_LATE_REVERB_GAIN))
  351. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb late reverb gain out of range"};
  352. props.LateReverbGain = val;
  353. break;
  354. case AL_REVERB_LATE_REVERB_DELAY:
  355. if(!(val >= AL_REVERB_MIN_LATE_REVERB_DELAY && val <= AL_REVERB_MAX_LATE_REVERB_DELAY))
  356. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb late reverb delay out of range"};
  357. props.LateReverbDelay = val;
  358. break;
  359. case AL_REVERB_AIR_ABSORPTION_GAINHF:
  360. if(!(val >= AL_REVERB_MIN_AIR_ABSORPTION_GAINHF && val <= AL_REVERB_MAX_AIR_ABSORPTION_GAINHF))
  361. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb air absorption gainhf out of range"};
  362. props.AirAbsorptionGainHF = val;
  363. break;
  364. case AL_REVERB_ROOM_ROLLOFF_FACTOR:
  365. if(!(val >= AL_REVERB_MIN_ROOM_ROLLOFF_FACTOR && val <= AL_REVERB_MAX_ROOM_ROLLOFF_FACTOR))
  366. throw effect_exception{AL_INVALID_VALUE, "EAX Reverb room rolloff factor out of range"};
  367. props.RoomRolloffFactor = val;
  368. break;
  369. default:
  370. throw effect_exception{AL_INVALID_ENUM, "Invalid EAX reverb float property 0x%04x", param};
  371. }
  372. }
  373. void StdReverbEffectHandler::SetParamfv(ReverbProps &props, ALenum param, const float *vals)
  374. { SetParamf(props, param, *vals); }
  375. void StdReverbEffectHandler::GetParami(const ReverbProps &props, ALenum param, int *val)
  376. {
  377. switch(param)
  378. {
  379. case AL_REVERB_DECAY_HFLIMIT: *val = props.DecayHFLimit; break;
  380. default:
  381. throw effect_exception{AL_INVALID_ENUM, "Invalid EAX reverb integer property 0x%04x",
  382. param};
  383. }
  384. }
  385. void StdReverbEffectHandler::GetParamiv(const ReverbProps &props, ALenum param, int *vals)
  386. { GetParami(props, param, vals); }
  387. void StdReverbEffectHandler::GetParamf(const ReverbProps &props, ALenum param, float *val)
  388. {
  389. switch(param)
  390. {
  391. case AL_REVERB_DENSITY: *val = props.Density; break;
  392. case AL_REVERB_DIFFUSION: *val = props.Diffusion; break;
  393. case AL_REVERB_GAIN: *val = props.Gain; break;
  394. case AL_REVERB_GAINHF: *val = props.GainHF; break;
  395. case AL_REVERB_DECAY_TIME: *val = props.DecayTime; break;
  396. case AL_REVERB_DECAY_HFRATIO: *val = props.DecayHFRatio; break;
  397. case AL_REVERB_REFLECTIONS_GAIN: *val = props.ReflectionsGain; break;
  398. case AL_REVERB_REFLECTIONS_DELAY: *val = props.ReflectionsDelay; break;
  399. case AL_REVERB_LATE_REVERB_GAIN: *val = props.LateReverbGain; break;
  400. case AL_REVERB_LATE_REVERB_DELAY: *val = props.LateReverbDelay; break;
  401. case AL_REVERB_AIR_ABSORPTION_GAINHF: *val = props.AirAbsorptionGainHF; break;
  402. case AL_REVERB_ROOM_ROLLOFF_FACTOR: *val = props.RoomRolloffFactor; break;
  403. default:
  404. throw effect_exception{AL_INVALID_ENUM, "Invalid EAX reverb float property 0x%04x", param};
  405. }
  406. }
  407. void StdReverbEffectHandler::GetParamfv(const ReverbProps &props, ALenum param, float *vals)
  408. { GetParamf(props, param, vals); }
  409. #ifdef ALSOFT_EAX
  410. namespace {
  411. class EaxReverbEffectException : public EaxException
  412. {
  413. public:
  414. explicit EaxReverbEffectException(const char* message)
  415. : EaxException{"EAX_REVERB_EFFECT", message}
  416. {}
  417. }; // EaxReverbEffectException
  418. struct EnvironmentValidator1 {
  419. void operator()(unsigned long ulEnvironment) const
  420. {
  421. eax_validate_range<EaxReverbEffectException>(
  422. "Environment",
  423. ulEnvironment,
  424. EAXREVERB_MINENVIRONMENT,
  425. EAX1REVERB_MAXENVIRONMENT);
  426. }
  427. }; // EnvironmentValidator1
  428. struct VolumeValidator {
  429. void operator()(float volume) const
  430. {
  431. eax_validate_range<EaxReverbEffectException>(
  432. "Volume",
  433. volume,
  434. EAX1REVERB_MINVOLUME,
  435. EAX1REVERB_MAXVOLUME);
  436. }
  437. }; // VolumeValidator
  438. struct DecayTimeValidator {
  439. void operator()(float flDecayTime) const
  440. {
  441. eax_validate_range<EaxReverbEffectException>(
  442. "Decay Time",
  443. flDecayTime,
  444. EAXREVERB_MINDECAYTIME,
  445. EAXREVERB_MAXDECAYTIME);
  446. }
  447. }; // DecayTimeValidator
  448. struct DampingValidator {
  449. void operator()(float damping) const
  450. {
  451. eax_validate_range<EaxReverbEffectException>(
  452. "Damping",
  453. damping,
  454. EAX1REVERB_MINDAMPING,
  455. EAX1REVERB_MAXDAMPING);
  456. }
  457. }; // DampingValidator
  458. struct AllValidator1 {
  459. void operator()(const EAX_REVERBPROPERTIES& all) const
  460. {
  461. EnvironmentValidator1{}(all.environment);
  462. VolumeValidator{}(all.fVolume);
  463. DecayTimeValidator{}(all.fDecayTime_sec);
  464. DampingValidator{}(all.fDamping);
  465. }
  466. }; // AllValidator1
  467. struct RoomValidator {
  468. void operator()(long lRoom) const
  469. {
  470. eax_validate_range<EaxReverbEffectException>(
  471. "Room",
  472. lRoom,
  473. EAXREVERB_MINROOM,
  474. EAXREVERB_MAXROOM);
  475. }
  476. }; // RoomValidator
  477. struct RoomHFValidator {
  478. void operator()(long lRoomHF) const
  479. {
  480. eax_validate_range<EaxReverbEffectException>(
  481. "Room HF",
  482. lRoomHF,
  483. EAXREVERB_MINROOMHF,
  484. EAXREVERB_MAXROOMHF);
  485. }
  486. }; // RoomHFValidator
  487. struct RoomRolloffFactorValidator {
  488. void operator()(float flRoomRolloffFactor) const
  489. {
  490. eax_validate_range<EaxReverbEffectException>(
  491. "Room Rolloff Factor",
  492. flRoomRolloffFactor,
  493. EAXREVERB_MINROOMROLLOFFFACTOR,
  494. EAXREVERB_MAXROOMROLLOFFFACTOR);
  495. }
  496. }; // RoomRolloffFactorValidator
  497. struct DecayHFRatioValidator {
  498. void operator()(float flDecayHFRatio) const
  499. {
  500. eax_validate_range<EaxReverbEffectException>(
  501. "Decay HF Ratio",
  502. flDecayHFRatio,
  503. EAXREVERB_MINDECAYHFRATIO,
  504. EAXREVERB_MAXDECAYHFRATIO);
  505. }
  506. }; // DecayHFRatioValidator
  507. struct ReflectionsValidator {
  508. void operator()(long lReflections) const
  509. {
  510. eax_validate_range<EaxReverbEffectException>(
  511. "Reflections",
  512. lReflections,
  513. EAXREVERB_MINREFLECTIONS,
  514. EAXREVERB_MAXREFLECTIONS);
  515. }
  516. }; // ReflectionsValidator
  517. struct ReflectionsDelayValidator {
  518. void operator()(float flReflectionsDelay) const
  519. {
  520. eax_validate_range<EaxReverbEffectException>(
  521. "Reflections Delay",
  522. flReflectionsDelay,
  523. EAXREVERB_MINREFLECTIONSDELAY,
  524. EAXREVERB_MAXREFLECTIONSDELAY);
  525. }
  526. }; // ReflectionsDelayValidator
  527. struct ReverbValidator {
  528. void operator()(long lReverb) const
  529. {
  530. eax_validate_range<EaxReverbEffectException>(
  531. "Reverb",
  532. lReverb,
  533. EAXREVERB_MINREVERB,
  534. EAXREVERB_MAXREVERB);
  535. }
  536. }; // ReverbValidator
  537. struct ReverbDelayValidator {
  538. void operator()(float flReverbDelay) const
  539. {
  540. eax_validate_range<EaxReverbEffectException>(
  541. "Reverb Delay",
  542. flReverbDelay,
  543. EAXREVERB_MINREVERBDELAY,
  544. EAXREVERB_MAXREVERBDELAY);
  545. }
  546. }; // ReverbDelayValidator
  547. struct EnvironmentSizeValidator {
  548. void operator()(float flEnvironmentSize) const
  549. {
  550. eax_validate_range<EaxReverbEffectException>(
  551. "Environment Size",
  552. flEnvironmentSize,
  553. EAXREVERB_MINENVIRONMENTSIZE,
  554. EAXREVERB_MAXENVIRONMENTSIZE);
  555. }
  556. }; // EnvironmentSizeValidator
  557. struct EnvironmentDiffusionValidator {
  558. void operator()(float flEnvironmentDiffusion) const
  559. {
  560. eax_validate_range<EaxReverbEffectException>(
  561. "Environment Diffusion",
  562. flEnvironmentDiffusion,
  563. EAXREVERB_MINENVIRONMENTDIFFUSION,
  564. EAXREVERB_MAXENVIRONMENTDIFFUSION);
  565. }
  566. }; // EnvironmentDiffusionValidator
  567. struct AirAbsorptionHFValidator {
  568. void operator()(float flAirAbsorptionHF) const
  569. {
  570. eax_validate_range<EaxReverbEffectException>(
  571. "Air Absorbtion HF",
  572. flAirAbsorptionHF,
  573. EAXREVERB_MINAIRABSORPTIONHF,
  574. EAXREVERB_MAXAIRABSORPTIONHF);
  575. }
  576. }; // AirAbsorptionHFValidator
  577. struct FlagsValidator2 {
  578. void operator()(unsigned long ulFlags) const
  579. {
  580. eax_validate_range<EaxReverbEffectException>(
  581. "Flags",
  582. ulFlags,
  583. 0UL,
  584. ~EAX2LISTENERFLAGS_RESERVED);
  585. }
  586. }; // FlagsValidator2
  587. struct AllValidator2 {
  588. void operator()(const EAX20LISTENERPROPERTIES& all) const
  589. {
  590. RoomValidator{}(all.lRoom);
  591. RoomHFValidator{}(all.lRoomHF);
  592. RoomRolloffFactorValidator{}(all.flRoomRolloffFactor);
  593. DecayTimeValidator{}(all.flDecayTime);
  594. DecayHFRatioValidator{}(all.flDecayHFRatio);
  595. ReflectionsValidator{}(all.lReflections);
  596. ReflectionsDelayValidator{}(all.flReflectionsDelay);
  597. ReverbValidator{}(all.lReverb);
  598. ReverbDelayValidator{}(all.flReverbDelay);
  599. EnvironmentValidator1{}(all.dwEnvironment);
  600. EnvironmentSizeValidator{}(all.flEnvironmentSize);
  601. EnvironmentDiffusionValidator{}(all.flEnvironmentDiffusion);
  602. AirAbsorptionHFValidator{}(all.flAirAbsorptionHF);
  603. FlagsValidator2{}(all.dwFlags);
  604. }
  605. }; // AllValidator2
  606. struct EnvironmentValidator3 {
  607. void operator()(unsigned long ulEnvironment) const
  608. {
  609. eax_validate_range<EaxReverbEffectException>(
  610. "Environment",
  611. ulEnvironment,
  612. EAXREVERB_MINENVIRONMENT,
  613. EAX30REVERB_MAXENVIRONMENT);
  614. }
  615. }; // EnvironmentValidator1
  616. struct RoomLFValidator {
  617. void operator()(long lRoomLF) const
  618. {
  619. eax_validate_range<EaxReverbEffectException>(
  620. "Room LF",
  621. lRoomLF,
  622. EAXREVERB_MINROOMLF,
  623. EAXREVERB_MAXROOMLF);
  624. }
  625. }; // RoomLFValidator
  626. struct DecayLFRatioValidator {
  627. void operator()(float flDecayLFRatio) const
  628. {
  629. eax_validate_range<EaxReverbEffectException>(
  630. "Decay LF Ratio",
  631. flDecayLFRatio,
  632. EAXREVERB_MINDECAYLFRATIO,
  633. EAXREVERB_MAXDECAYLFRATIO);
  634. }
  635. }; // DecayLFRatioValidator
  636. struct VectorValidator {
  637. void operator()(const EAXVECTOR&) const
  638. {}
  639. }; // VectorValidator
  640. struct EchoTimeValidator {
  641. void operator()(float flEchoTime) const
  642. {
  643. eax_validate_range<EaxReverbEffectException>(
  644. "Echo Time",
  645. flEchoTime,
  646. EAXREVERB_MINECHOTIME,
  647. EAXREVERB_MAXECHOTIME);
  648. }
  649. }; // EchoTimeValidator
  650. struct EchoDepthValidator {
  651. void operator()(float flEchoDepth) const
  652. {
  653. eax_validate_range<EaxReverbEffectException>(
  654. "Echo Depth",
  655. flEchoDepth,
  656. EAXREVERB_MINECHODEPTH,
  657. EAXREVERB_MAXECHODEPTH);
  658. }
  659. }; // EchoDepthValidator
  660. struct ModulationTimeValidator {
  661. void operator()(float flModulationTime) const
  662. {
  663. eax_validate_range<EaxReverbEffectException>(
  664. "Modulation Time",
  665. flModulationTime,
  666. EAXREVERB_MINMODULATIONTIME,
  667. EAXREVERB_MAXMODULATIONTIME);
  668. }
  669. }; // ModulationTimeValidator
  670. struct ModulationDepthValidator {
  671. void operator()(float flModulationDepth) const
  672. {
  673. eax_validate_range<EaxReverbEffectException>(
  674. "Modulation Depth",
  675. flModulationDepth,
  676. EAXREVERB_MINMODULATIONDEPTH,
  677. EAXREVERB_MAXMODULATIONDEPTH);
  678. }
  679. }; // ModulationDepthValidator
  680. struct HFReferenceValidator {
  681. void operator()(float flHFReference) const
  682. {
  683. eax_validate_range<EaxReverbEffectException>(
  684. "HF Reference",
  685. flHFReference,
  686. EAXREVERB_MINHFREFERENCE,
  687. EAXREVERB_MAXHFREFERENCE);
  688. }
  689. }; // HFReferenceValidator
  690. struct LFReferenceValidator {
  691. void operator()(float flLFReference) const
  692. {
  693. eax_validate_range<EaxReverbEffectException>(
  694. "LF Reference",
  695. flLFReference,
  696. EAXREVERB_MINLFREFERENCE,
  697. EAXREVERB_MAXLFREFERENCE);
  698. }
  699. }; // LFReferenceValidator
  700. struct FlagsValidator3 {
  701. void operator()(unsigned long ulFlags) const
  702. {
  703. eax_validate_range<EaxReverbEffectException>(
  704. "Flags",
  705. ulFlags,
  706. 0UL,
  707. ~EAXREVERBFLAGS_RESERVED);
  708. }
  709. }; // FlagsValidator3
  710. struct AllValidator3 {
  711. void operator()(const EAXREVERBPROPERTIES& all) const
  712. {
  713. EnvironmentValidator3{}(all.ulEnvironment);
  714. EnvironmentSizeValidator{}(all.flEnvironmentSize);
  715. EnvironmentDiffusionValidator{}(all.flEnvironmentDiffusion);
  716. RoomValidator{}(all.lRoom);
  717. RoomHFValidator{}(all.lRoomHF);
  718. RoomLFValidator{}(all.lRoomLF);
  719. DecayTimeValidator{}(all.flDecayTime);
  720. DecayHFRatioValidator{}(all.flDecayHFRatio);
  721. DecayLFRatioValidator{}(all.flDecayLFRatio);
  722. ReflectionsValidator{}(all.lReflections);
  723. ReflectionsDelayValidator{}(all.flReflectionsDelay);
  724. VectorValidator{}(all.vReflectionsPan);
  725. ReverbValidator{}(all.lReverb);
  726. ReverbDelayValidator{}(all.flReverbDelay);
  727. VectorValidator{}(all.vReverbPan);
  728. EchoTimeValidator{}(all.flEchoTime);
  729. EchoDepthValidator{}(all.flEchoDepth);
  730. ModulationTimeValidator{}(all.flModulationTime);
  731. ModulationDepthValidator{}(all.flModulationDepth);
  732. AirAbsorptionHFValidator{}(all.flAirAbsorptionHF);
  733. HFReferenceValidator{}(all.flHFReference);
  734. LFReferenceValidator{}(all.flLFReference);
  735. RoomRolloffFactorValidator{}(all.flRoomRolloffFactor);
  736. FlagsValidator3{}(all.ulFlags);
  737. }
  738. }; // AllValidator3
  739. struct EnvironmentDeferrer2 {
  740. void operator()(EAX20LISTENERPROPERTIES& props, unsigned long dwEnvironment) const
  741. {
  742. props = EAX2REVERB_PRESETS[dwEnvironment];
  743. }
  744. }; // EnvironmentDeferrer2
  745. struct EnvironmentSizeDeferrer2 {
  746. void operator()(EAX20LISTENERPROPERTIES& props, float flEnvironmentSize) const
  747. {
  748. if (props.flEnvironmentSize == flEnvironmentSize)
  749. {
  750. return;
  751. }
  752. const auto scale = flEnvironmentSize / props.flEnvironmentSize;
  753. props.flEnvironmentSize = flEnvironmentSize;
  754. if ((props.dwFlags & EAX2LISTENERFLAGS_DECAYTIMESCALE) != 0)
  755. {
  756. props.flDecayTime = std::clamp(
  757. props.flDecayTime * scale,
  758. EAXREVERB_MINDECAYTIME,
  759. EAXREVERB_MAXDECAYTIME);
  760. }
  761. if ((props.dwFlags & EAX2LISTENERFLAGS_REFLECTIONSSCALE) != 0 &&
  762. (props.dwFlags & EAX2LISTENERFLAGS_REFLECTIONSDELAYSCALE) != 0)
  763. {
  764. props.lReflections = std::clamp(
  765. props.lReflections - static_cast<long>(gain_to_level_mb(scale)),
  766. EAXREVERB_MINREFLECTIONS,
  767. EAXREVERB_MAXREFLECTIONS);
  768. }
  769. if ((props.dwFlags & EAX2LISTENERFLAGS_REFLECTIONSDELAYSCALE) != 0)
  770. {
  771. props.flReflectionsDelay = std::clamp(
  772. props.flReflectionsDelay * scale,
  773. EAXREVERB_MINREFLECTIONSDELAY,
  774. EAXREVERB_MAXREFLECTIONSDELAY);
  775. }
  776. if ((props.dwFlags & EAX2LISTENERFLAGS_REVERBSCALE) != 0)
  777. {
  778. const auto log_scalar = ((props.dwFlags & EAXREVERBFLAGS_DECAYTIMESCALE) != 0) ? 2'000.0F : 3'000.0F;
  779. props.lReverb = std::clamp(
  780. props.lReverb - static_cast<long>(std::log10(scale) * log_scalar),
  781. EAXREVERB_MINREVERB,
  782. EAXREVERB_MAXREVERB);
  783. }
  784. if ((props.dwFlags & EAX2LISTENERFLAGS_REVERBDELAYSCALE) != 0)
  785. {
  786. props.flReverbDelay = std::clamp(
  787. props.flReverbDelay * scale,
  788. EAXREVERB_MINREVERBDELAY,
  789. EAXREVERB_MAXREVERBDELAY);
  790. }
  791. }
  792. }; // EnvironmentSizeDeferrer2
  793. struct EnvironmentDeferrer3 {
  794. void operator()(EAXREVERBPROPERTIES& props, unsigned long ulEnvironment) const
  795. {
  796. if (ulEnvironment == EAX_ENVIRONMENT_UNDEFINED)
  797. {
  798. props.ulEnvironment = EAX_ENVIRONMENT_UNDEFINED;
  799. return;
  800. }
  801. props = EAXREVERB_PRESETS[ulEnvironment];
  802. }
  803. }; // EnvironmentDeferrer3
  804. struct EnvironmentSizeDeferrer3 {
  805. void operator()(EAXREVERBPROPERTIES& props, float flEnvironmentSize) const
  806. {
  807. if (props.flEnvironmentSize == flEnvironmentSize)
  808. {
  809. return;
  810. }
  811. const auto scale = flEnvironmentSize / props.flEnvironmentSize;
  812. props.ulEnvironment = EAX_ENVIRONMENT_UNDEFINED;
  813. props.flEnvironmentSize = flEnvironmentSize;
  814. if ((props.ulFlags & EAXREVERBFLAGS_DECAYTIMESCALE) != 0)
  815. {
  816. props.flDecayTime = std::clamp(
  817. props.flDecayTime * scale,
  818. EAXREVERB_MINDECAYTIME,
  819. EAXREVERB_MAXDECAYTIME);
  820. }
  821. if ((props.ulFlags & EAXREVERBFLAGS_REFLECTIONSSCALE) != 0 &&
  822. (props.ulFlags & EAXREVERBFLAGS_REFLECTIONSDELAYSCALE) != 0)
  823. {
  824. props.lReflections = std::clamp(
  825. props.lReflections - static_cast<long>(gain_to_level_mb(scale)),
  826. EAXREVERB_MINREFLECTIONS,
  827. EAXREVERB_MAXREFLECTIONS);
  828. }
  829. if ((props.ulFlags & EAXREVERBFLAGS_REFLECTIONSDELAYSCALE) != 0)
  830. {
  831. props.flReflectionsDelay = std::clamp(
  832. props.flReflectionsDelay * scale,
  833. EAXREVERB_MINREFLECTIONSDELAY,
  834. EAXREVERB_MAXREFLECTIONSDELAY);
  835. }
  836. if ((props.ulFlags & EAXREVERBFLAGS_REVERBSCALE) != 0)
  837. {
  838. const auto log_scalar = ((props.ulFlags & EAXREVERBFLAGS_DECAYTIMESCALE) != 0) ? 2'000.0F : 3'000.0F;
  839. props.lReverb = std::clamp(
  840. props.lReverb - static_cast<long>(std::log10(scale) * log_scalar),
  841. EAXREVERB_MINREVERB,
  842. EAXREVERB_MAXREVERB);
  843. }
  844. if ((props.ulFlags & EAXREVERBFLAGS_REVERBDELAYSCALE) != 0)
  845. {
  846. props.flReverbDelay = std::clamp(
  847. props.flReverbDelay * scale,
  848. EAXREVERB_MINREVERBDELAY,
  849. EAXREVERB_MAXREVERBDELAY);
  850. }
  851. if ((props.ulFlags & EAXREVERBFLAGS_ECHOTIMESCALE) != 0)
  852. {
  853. props.flEchoTime = std::clamp(
  854. props.flEchoTime * scale,
  855. EAXREVERB_MINECHOTIME,
  856. EAXREVERB_MAXECHOTIME);
  857. }
  858. if ((props.ulFlags & EAXREVERBFLAGS_MODULATIONTIMESCALE) != 0)
  859. {
  860. props.flModulationTime = std::clamp(
  861. props.flModulationTime * scale,
  862. EAXREVERB_MINMODULATIONTIME,
  863. EAXREVERB_MAXMODULATIONTIME);
  864. }
  865. }
  866. }; // EnvironmentSizeDeferrer3
  867. } // namespace
  868. struct EaxReverbCommitter::Exception : public EaxReverbEffectException
  869. {
  870. using EaxReverbEffectException::EaxReverbEffectException;
  871. };
  872. [[noreturn]] void EaxReverbCommitter::fail(const char* message)
  873. {
  874. throw Exception{message};
  875. }
  876. void EaxReverbCommitter::translate(const EAX_REVERBPROPERTIES& src, EAXREVERBPROPERTIES& dst) noexcept
  877. {
  878. assert(src.environment <= EAX1REVERB_MAXENVIRONMENT);
  879. dst = EAXREVERB_PRESETS[src.environment];
  880. dst.flDecayTime = src.fDecayTime_sec;
  881. dst.flDecayHFRatio = src.fDamping;
  882. dst.lReverb = static_cast<int>(std::min(gain_to_level_mb(src.fVolume), 0.0f));
  883. }
  884. void EaxReverbCommitter::translate(const EAX20LISTENERPROPERTIES& src, EAXREVERBPROPERTIES& dst) noexcept
  885. {
  886. assert(src.dwEnvironment <= EAX1REVERB_MAXENVIRONMENT);
  887. dst = EAXREVERB_PRESETS[src.dwEnvironment];
  888. dst.ulEnvironment = src.dwEnvironment;
  889. dst.flEnvironmentSize = src.flEnvironmentSize;
  890. dst.flEnvironmentDiffusion = src.flEnvironmentDiffusion;
  891. dst.lRoom = src.lRoom;
  892. dst.lRoomHF = src.lRoomHF;
  893. dst.flDecayTime = src.flDecayTime;
  894. dst.flDecayHFRatio = src.flDecayHFRatio;
  895. dst.lReflections = src.lReflections;
  896. dst.flReflectionsDelay = src.flReflectionsDelay;
  897. dst.lReverb = src.lReverb;
  898. dst.flReverbDelay = src.flReverbDelay;
  899. dst.flAirAbsorptionHF = src.flAirAbsorptionHF;
  900. dst.flRoomRolloffFactor = src.flRoomRolloffFactor;
  901. dst.ulFlags = src.dwFlags;
  902. }
  903. bool EaxReverbCommitter::commit(const EAX_REVERBPROPERTIES &props)
  904. {
  905. EAXREVERBPROPERTIES dst{};
  906. translate(props, dst);
  907. return commit(dst);
  908. }
  909. bool EaxReverbCommitter::commit(const EAX20LISTENERPROPERTIES &props)
  910. {
  911. EAXREVERBPROPERTIES dst{};
  912. translate(props, dst);
  913. return commit(dst);
  914. }
  915. bool EaxReverbCommitter::commit(const EAXREVERBPROPERTIES &props)
  916. {
  917. if(auto *cur = std::get_if<EAXREVERBPROPERTIES>(&mEaxProps); cur && *cur == props)
  918. return false;
  919. mEaxProps = props;
  920. const auto size = props.flEnvironmentSize;
  921. const auto density = (size * size * size) / 16.0f;
  922. mAlProps = [&]{
  923. ReverbProps ret{};
  924. ret.Density = std::min(density, AL_EAXREVERB_MAX_DENSITY);
  925. ret.Diffusion = props.flEnvironmentDiffusion;
  926. ret.Gain = level_mb_to_gain(static_cast<float>(props.lRoom));
  927. ret.GainHF = level_mb_to_gain(static_cast<float>(props.lRoomHF));
  928. ret.GainLF = level_mb_to_gain(static_cast<float>(props.lRoomLF));
  929. ret.DecayTime = props.flDecayTime;
  930. ret.DecayHFRatio = props.flDecayHFRatio;
  931. ret.DecayLFRatio = props.flDecayLFRatio;
  932. ret.ReflectionsGain = level_mb_to_gain(static_cast<float>(props.lReflections));
  933. ret.ReflectionsDelay = props.flReflectionsDelay;
  934. ret.ReflectionsPan = {props.vReflectionsPan.x, props.vReflectionsPan.y,
  935. props.vReflectionsPan.z};
  936. ret.LateReverbGain = level_mb_to_gain(static_cast<float>(props.lReverb));
  937. ret.LateReverbDelay = props.flReverbDelay;
  938. ret.LateReverbPan = {props.vReverbPan.x, props.vReverbPan.y, props.vReverbPan.z};
  939. ret.EchoTime = props.flEchoTime;
  940. ret.EchoDepth = props.flEchoDepth;
  941. ret.ModulationTime = props.flModulationTime;
  942. ret.ModulationDepth = props.flModulationDepth;
  943. ret.AirAbsorptionGainHF = level_mb_to_gain(props.flAirAbsorptionHF);
  944. ret.HFReference = props.flHFReference;
  945. ret.LFReference = props.flLFReference;
  946. ret.RoomRolloffFactor = props.flRoomRolloffFactor;
  947. ret.DecayHFLimit = ((props.ulFlags & EAXREVERBFLAGS_DECAYHFLIMIT) != 0);
  948. return ret;
  949. }();
  950. return true;
  951. }
  952. void EaxReverbCommitter::SetDefaults(EAX_REVERBPROPERTIES &props)
  953. {
  954. props = EAX1REVERB_PRESETS[EAX_ENVIRONMENT_GENERIC];
  955. }
  956. void EaxReverbCommitter::SetDefaults(EAX20LISTENERPROPERTIES &props)
  957. {
  958. props = EAX2REVERB_PRESETS[EAX2_ENVIRONMENT_GENERIC];
  959. props.lRoom = -10'000L;
  960. }
  961. void EaxReverbCommitter::SetDefaults(EAXREVERBPROPERTIES &props)
  962. {
  963. props = EAXREVERB_PRESETS[EAX_ENVIRONMENT_GENERIC];
  964. }
  965. void EaxReverbCommitter::SetDefaults(EaxEffectProps &props)
  966. {
  967. SetDefaults(props.emplace<EAXREVERBPROPERTIES>());
  968. }
  969. void EaxReverbCommitter::Get(const EaxCall &call, const EAX_REVERBPROPERTIES &props)
  970. {
  971. switch(call.get_property_id())
  972. {
  973. case DSPROPERTY_EAX_ALL: call.set_value<Exception>(props); break;
  974. case DSPROPERTY_EAX_ENVIRONMENT: call.set_value<Exception>(props.environment); break;
  975. case DSPROPERTY_EAX_VOLUME: call.set_value<Exception>(props.fVolume); break;
  976. case DSPROPERTY_EAX_DECAYTIME: call.set_value<Exception>(props.fDecayTime_sec); break;
  977. case DSPROPERTY_EAX_DAMPING: call.set_value<Exception>(props.fDamping); break;
  978. default: fail_unknown_property_id();
  979. }
  980. }
  981. void EaxReverbCommitter::Get(const EaxCall &call, const EAX20LISTENERPROPERTIES &props)
  982. {
  983. switch(call.get_property_id())
  984. {
  985. case DSPROPERTY_EAX20LISTENER_NONE: break;
  986. case DSPROPERTY_EAX20LISTENER_ALLPARAMETERS: call.set_value<Exception>(props); break;
  987. case DSPROPERTY_EAX20LISTENER_ROOM: call.set_value<Exception>(props.lRoom); break;
  988. case DSPROPERTY_EAX20LISTENER_ROOMHF: call.set_value<Exception>(props.lRoomHF); break;
  989. case DSPROPERTY_EAX20LISTENER_ROOMROLLOFFFACTOR: call.set_value<Exception>(props.flRoomRolloffFactor); break;
  990. case DSPROPERTY_EAX20LISTENER_DECAYTIME: call.set_value<Exception>(props.flDecayTime); break;
  991. case DSPROPERTY_EAX20LISTENER_DECAYHFRATIO: call.set_value<Exception>(props.flDecayHFRatio); break;
  992. case DSPROPERTY_EAX20LISTENER_REFLECTIONS: call.set_value<Exception>(props.lReflections); break;
  993. case DSPROPERTY_EAX20LISTENER_REFLECTIONSDELAY: call.set_value<Exception>(props.flReflectionsDelay); break;
  994. case DSPROPERTY_EAX20LISTENER_REVERB: call.set_value<Exception>(props.lReverb); break;
  995. case DSPROPERTY_EAX20LISTENER_REVERBDELAY: call.set_value<Exception>(props.flReverbDelay); break;
  996. case DSPROPERTY_EAX20LISTENER_ENVIRONMENT: call.set_value<Exception>(props.dwEnvironment); break;
  997. case DSPROPERTY_EAX20LISTENER_ENVIRONMENTSIZE: call.set_value<Exception>(props.flEnvironmentSize); break;
  998. case DSPROPERTY_EAX20LISTENER_ENVIRONMENTDIFFUSION: call.set_value<Exception>(props.flEnvironmentDiffusion); break;
  999. case DSPROPERTY_EAX20LISTENER_AIRABSORPTIONHF: call.set_value<Exception>(props.flAirAbsorptionHF); break;
  1000. case DSPROPERTY_EAX20LISTENER_FLAGS: call.set_value<Exception>(props.dwFlags); break;
  1001. default: fail_unknown_property_id();
  1002. }
  1003. }
  1004. void EaxReverbCommitter::Get(const EaxCall &call, const EAXREVERBPROPERTIES &props)
  1005. {
  1006. switch(call.get_property_id())
  1007. {
  1008. case EAXREVERB_NONE: break;
  1009. case EAXREVERB_ALLPARAMETERS: call.set_value<Exception>(props); break;
  1010. case EAXREVERB_ENVIRONMENT: call.set_value<Exception>(props.ulEnvironment); break;
  1011. case EAXREVERB_ENVIRONMENTSIZE: call.set_value<Exception>(props.flEnvironmentSize); break;
  1012. case EAXREVERB_ENVIRONMENTDIFFUSION: call.set_value<Exception>(props.flEnvironmentDiffusion); break;
  1013. case EAXREVERB_ROOM: call.set_value<Exception>(props.lRoom); break;
  1014. case EAXREVERB_ROOMHF: call.set_value<Exception>(props.lRoomHF); break;
  1015. case EAXREVERB_ROOMLF: call.set_value<Exception>(props.lRoomLF); break;
  1016. case EAXREVERB_DECAYTIME: call.set_value<Exception>(props.flDecayTime); break;
  1017. case EAXREVERB_DECAYHFRATIO: call.set_value<Exception>(props.flDecayHFRatio); break;
  1018. case EAXREVERB_DECAYLFRATIO: call.set_value<Exception>(props.flDecayLFRatio); break;
  1019. case EAXREVERB_REFLECTIONS: call.set_value<Exception>(props.lReflections); break;
  1020. case EAXREVERB_REFLECTIONSDELAY: call.set_value<Exception>(props.flReflectionsDelay); break;
  1021. case EAXREVERB_REFLECTIONSPAN: call.set_value<Exception>(props.vReflectionsPan); break;
  1022. case EAXREVERB_REVERB: call.set_value<Exception>(props.lReverb); break;
  1023. case EAXREVERB_REVERBDELAY: call.set_value<Exception>(props.flReverbDelay); break;
  1024. case EAXREVERB_REVERBPAN: call.set_value<Exception>(props.vReverbPan); break;
  1025. case EAXREVERB_ECHOTIME: call.set_value<Exception>(props.flEchoTime); break;
  1026. case EAXREVERB_ECHODEPTH: call.set_value<Exception>(props.flEchoDepth); break;
  1027. case EAXREVERB_MODULATIONTIME: call.set_value<Exception>(props.flModulationTime); break;
  1028. case EAXREVERB_MODULATIONDEPTH: call.set_value<Exception>(props.flModulationDepth); break;
  1029. case EAXREVERB_AIRABSORPTIONHF: call.set_value<Exception>(props.flAirAbsorptionHF); break;
  1030. case EAXREVERB_HFREFERENCE: call.set_value<Exception>(props.flHFReference); break;
  1031. case EAXREVERB_LFREFERENCE: call.set_value<Exception>(props.flLFReference); break;
  1032. case EAXREVERB_ROOMROLLOFFFACTOR: call.set_value<Exception>(props.flRoomRolloffFactor); break;
  1033. case EAXREVERB_FLAGS: call.set_value<Exception>(props.ulFlags); break;
  1034. default: fail_unknown_property_id();
  1035. }
  1036. }
  1037. void EaxReverbCommitter::Set(const EaxCall &call, EAX_REVERBPROPERTIES &props)
  1038. {
  1039. switch(call.get_property_id())
  1040. {
  1041. case DSPROPERTY_EAX_ALL: defer<AllValidator1>(call, props); break;
  1042. case DSPROPERTY_EAX_ENVIRONMENT: defer<EnvironmentValidator1>(call, props.environment); break;
  1043. case DSPROPERTY_EAX_VOLUME: defer<VolumeValidator>(call, props.fVolume); break;
  1044. case DSPROPERTY_EAX_DECAYTIME: defer<DecayTimeValidator>(call, props.fDecayTime_sec); break;
  1045. case DSPROPERTY_EAX_DAMPING: defer<DampingValidator>(call, props.fDamping); break;
  1046. default: fail_unknown_property_id();
  1047. }
  1048. }
  1049. void EaxReverbCommitter::Set(const EaxCall &call, EAX20LISTENERPROPERTIES &props)
  1050. {
  1051. switch(call.get_property_id())
  1052. {
  1053. case DSPROPERTY_EAX20LISTENER_NONE: break;
  1054. case DSPROPERTY_EAX20LISTENER_ALLPARAMETERS: defer<AllValidator2>(call, props); break;
  1055. case DSPROPERTY_EAX20LISTENER_ROOM: defer<RoomValidator>(call, props.lRoom); break;
  1056. case DSPROPERTY_EAX20LISTENER_ROOMHF: defer<RoomHFValidator>(call, props.lRoomHF); break;
  1057. case DSPROPERTY_EAX20LISTENER_ROOMROLLOFFFACTOR: defer<RoomRolloffFactorValidator>(call, props.flRoomRolloffFactor); break;
  1058. case DSPROPERTY_EAX20LISTENER_DECAYTIME: defer<DecayTimeValidator>(call, props.flDecayTime); break;
  1059. case DSPROPERTY_EAX20LISTENER_DECAYHFRATIO: defer<DecayHFRatioValidator>(call, props.flDecayHFRatio); break;
  1060. case DSPROPERTY_EAX20LISTENER_REFLECTIONS: defer<ReflectionsValidator>(call, props.lReflections); break;
  1061. case DSPROPERTY_EAX20LISTENER_REFLECTIONSDELAY: defer<ReflectionsDelayValidator>(call, props.flReverbDelay); break;
  1062. case DSPROPERTY_EAX20LISTENER_REVERB: defer<ReverbValidator>(call, props.lReverb); break;
  1063. case DSPROPERTY_EAX20LISTENER_REVERBDELAY: defer<ReverbDelayValidator>(call, props.flReverbDelay); break;
  1064. case DSPROPERTY_EAX20LISTENER_ENVIRONMENT: defer<EnvironmentValidator1, EnvironmentDeferrer2>(call, props, props.dwEnvironment); break;
  1065. case DSPROPERTY_EAX20LISTENER_ENVIRONMENTSIZE: defer<EnvironmentSizeValidator, EnvironmentSizeDeferrer2>(call, props, props.flEnvironmentSize); break;
  1066. case DSPROPERTY_EAX20LISTENER_ENVIRONMENTDIFFUSION: defer<EnvironmentDiffusionValidator>(call, props.flEnvironmentDiffusion); break;
  1067. case DSPROPERTY_EAX20LISTENER_AIRABSORPTIONHF: defer<AirAbsorptionHFValidator>(call, props.flAirAbsorptionHF); break;
  1068. case DSPROPERTY_EAX20LISTENER_FLAGS: defer<FlagsValidator2>(call, props.dwFlags); break;
  1069. default: fail_unknown_property_id();
  1070. }
  1071. }
  1072. void EaxReverbCommitter::Set(const EaxCall &call, EAXREVERBPROPERTIES &props)
  1073. {
  1074. switch(call.get_property_id())
  1075. {
  1076. case EAXREVERB_NONE: break;
  1077. case EAXREVERB_ALLPARAMETERS: defer<AllValidator3>(call, props); break;
  1078. case EAXREVERB_ENVIRONMENT: defer<EnvironmentValidator3, EnvironmentDeferrer3>(call, props, props.ulEnvironment); break;
  1079. case EAXREVERB_ENVIRONMENTSIZE: defer<EnvironmentSizeValidator, EnvironmentSizeDeferrer3>(call, props, props.flEnvironmentSize); break;
  1080. case EAXREVERB_ENVIRONMENTDIFFUSION: defer3<EnvironmentDiffusionValidator>(call, props, props.flEnvironmentDiffusion); break;
  1081. case EAXREVERB_ROOM: defer3<RoomValidator>(call, props, props.lRoom); break;
  1082. case EAXREVERB_ROOMHF: defer3<RoomHFValidator>(call, props, props.lRoomHF); break;
  1083. case EAXREVERB_ROOMLF: defer3<RoomLFValidator>(call, props, props.lRoomLF); break;
  1084. case EAXREVERB_DECAYTIME: defer3<DecayTimeValidator>(call, props, props.flDecayTime); break;
  1085. case EAXREVERB_DECAYHFRATIO: defer3<DecayHFRatioValidator>(call, props, props.flDecayHFRatio); break;
  1086. case EAXREVERB_DECAYLFRATIO: defer3<DecayLFRatioValidator>(call, props, props.flDecayLFRatio); break;
  1087. case EAXREVERB_REFLECTIONS: defer3<ReflectionsValidator>(call, props, props.lReflections); break;
  1088. case EAXREVERB_REFLECTIONSDELAY: defer3<ReflectionsDelayValidator>(call, props, props.flReflectionsDelay); break;
  1089. case EAXREVERB_REFLECTIONSPAN: defer3<VectorValidator>(call, props, props.vReflectionsPan); break;
  1090. case EAXREVERB_REVERB: defer3<ReverbValidator>(call, props, props.lReverb); break;
  1091. case EAXREVERB_REVERBDELAY: defer3<ReverbDelayValidator>(call, props, props.flReverbDelay); break;
  1092. case EAXREVERB_REVERBPAN: defer3<VectorValidator>(call, props, props.vReverbPan); break;
  1093. case EAXREVERB_ECHOTIME: defer3<EchoTimeValidator>(call, props, props.flEchoTime); break;
  1094. case EAXREVERB_ECHODEPTH: defer3<EchoDepthValidator>(call, props, props.flEchoDepth); break;
  1095. case EAXREVERB_MODULATIONTIME: defer3<ModulationTimeValidator>(call, props, props.flModulationTime); break;
  1096. case EAXREVERB_MODULATIONDEPTH: defer3<ModulationDepthValidator>(call, props, props.flModulationDepth); break;
  1097. case EAXREVERB_AIRABSORPTIONHF: defer3<AirAbsorptionHFValidator>(call, props, props.flAirAbsorptionHF); break;
  1098. case EAXREVERB_HFREFERENCE: defer3<HFReferenceValidator>(call, props, props.flHFReference); break;
  1099. case EAXREVERB_LFREFERENCE: defer3<LFReferenceValidator>(call, props, props.flLFReference); break;
  1100. case EAXREVERB_ROOMROLLOFFFACTOR: defer3<RoomRolloffFactorValidator>(call, props, props.flRoomRolloffFactor); break;
  1101. case EAXREVERB_FLAGS: defer3<FlagsValidator3>(call, props, props.ulFlags); break;
  1102. default: fail_unknown_property_id();
  1103. }
  1104. }
  1105. #endif // ALSOFT_EAX