alExtension.c 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335
  1. /**
  2. * OpenAL cross platform audio library
  3. * Copyright (C) 1999-2007 by authors.
  4. * This library is free software; you can redistribute it and/or
  5. * modify it under the terms of the GNU Library General Public
  6. * License as published by the Free Software Foundation; either
  7. * version 2 of the License, or (at your option) any later version.
  8. *
  9. * This library is distributed in the hope that it will be useful,
  10. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  12. * Library General Public License for more details.
  13. *
  14. * You should have received a copy of the GNU Library General Public
  15. * License along with this library; if not, write to the
  16. * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17. * Boston, MA 02111-1307, USA.
  18. * Or go to http://www.gnu.org/copyleft/lgpl.html
  19. */
  20. #include "config.h"
  21. #include <stdlib.h>
  22. #include <string.h>
  23. #include <ctype.h>
  24. #include "alError.h"
  25. #include "alMain.h"
  26. #include "alFilter.h"
  27. #include "alEffect.h"
  28. #include "alAuxEffectSlot.h"
  29. #include "alDatabuffer.h"
  30. #include "alSource.h"
  31. #include "alBuffer.h"
  32. #include "AL/al.h"
  33. #include "AL/alc.h"
  34. typedef struct ALenums {
  35. const ALchar *enumName;
  36. ALenum value;
  37. } ALenums;
  38. static const ALenums enumeration[] = {
  39. // Types
  40. { "AL_INVALID", AL_INVALID },
  41. { "AL_NONE", AL_NONE },
  42. { "AL_FALSE", AL_FALSE },
  43. { "AL_TRUE", AL_TRUE },
  44. // Source and Listener Properties
  45. { "AL_SOURCE_RELATIVE", AL_SOURCE_RELATIVE },
  46. { "AL_CONE_INNER_ANGLE", AL_CONE_INNER_ANGLE },
  47. { "AL_CONE_OUTER_ANGLE", AL_CONE_OUTER_ANGLE },
  48. { "AL_PITCH", AL_PITCH },
  49. { "AL_POSITION", AL_POSITION },
  50. { "AL_DIRECTION", AL_DIRECTION },
  51. { "AL_VELOCITY", AL_VELOCITY },
  52. { "AL_LOOPING", AL_LOOPING },
  53. { "AL_BUFFER", AL_BUFFER },
  54. { "AL_GAIN", AL_GAIN },
  55. { "AL_MIN_GAIN", AL_MIN_GAIN },
  56. { "AL_MAX_GAIN", AL_MAX_GAIN },
  57. { "AL_ORIENTATION", AL_ORIENTATION },
  58. { "AL_REFERENCE_DISTANCE", AL_REFERENCE_DISTANCE },
  59. { "AL_ROLLOFF_FACTOR", AL_ROLLOFF_FACTOR },
  60. { "AL_CONE_OUTER_GAIN", AL_CONE_OUTER_GAIN },
  61. { "AL_MAX_DISTANCE", AL_MAX_DISTANCE },
  62. { "AL_SEC_OFFSET", AL_SEC_OFFSET },
  63. { "AL_SAMPLE_OFFSET", AL_SAMPLE_OFFSET },
  64. { "AL_SAMPLE_RW_OFFSETS_SOFT", AL_SAMPLE_RW_OFFSETS_SOFT },
  65. { "AL_BYTE_OFFSET", AL_BYTE_OFFSET },
  66. { "AL_BYTE_RW_OFFSETS_SOFT", AL_BYTE_RW_OFFSETS_SOFT },
  67. { "AL_SOURCE_TYPE", AL_SOURCE_TYPE },
  68. { "AL_STATIC", AL_STATIC },
  69. { "AL_STREAMING", AL_STREAMING },
  70. { "AL_UNDETERMINED", AL_UNDETERMINED },
  71. { "AL_METERS_PER_UNIT", AL_METERS_PER_UNIT },
  72. // Source EFX Properties
  73. { "AL_DIRECT_FILTER", AL_DIRECT_FILTER },
  74. { "AL_AUXILIARY_SEND_FILTER", AL_AUXILIARY_SEND_FILTER },
  75. { "AL_AIR_ABSORPTION_FACTOR", AL_AIR_ABSORPTION_FACTOR },
  76. { "AL_ROOM_ROLLOFF_FACTOR", AL_ROOM_ROLLOFF_FACTOR },
  77. { "AL_CONE_OUTER_GAINHF", AL_CONE_OUTER_GAINHF },
  78. { "AL_DIRECT_FILTER_GAINHF_AUTO", AL_DIRECT_FILTER_GAINHF_AUTO },
  79. { "AL_AUXILIARY_SEND_FILTER_GAIN_AUTO", AL_AUXILIARY_SEND_FILTER_GAIN_AUTO },
  80. { "AL_AUXILIARY_SEND_FILTER_GAINHF_AUTO", AL_AUXILIARY_SEND_FILTER_GAINHF_AUTO},
  81. // Source State information
  82. { "AL_SOURCE_STATE", AL_SOURCE_STATE },
  83. { "AL_INITIAL", AL_INITIAL },
  84. { "AL_PLAYING", AL_PLAYING },
  85. { "AL_PAUSED", AL_PAUSED },
  86. { "AL_STOPPED", AL_STOPPED },
  87. // Queue information
  88. { "AL_BUFFERS_QUEUED", AL_BUFFERS_QUEUED },
  89. { "AL_BUFFERS_PROCESSED", AL_BUFFERS_PROCESSED },
  90. // Buffer Formats
  91. { "AL_FORMAT_MONO8", AL_FORMAT_MONO8 },
  92. { "AL_FORMAT_MONO16", AL_FORMAT_MONO16 },
  93. { "AL_FORMAT_MONO_FLOAT32", AL_FORMAT_MONO_FLOAT32 },
  94. { "AL_FORMAT_MONO_DOUBLE_EXT", AL_FORMAT_MONO_DOUBLE_EXT },
  95. { "AL_FORMAT_STEREO8", AL_FORMAT_STEREO8 },
  96. { "AL_FORMAT_STEREO16", AL_FORMAT_STEREO16 },
  97. { "AL_FORMAT_STEREO_FLOAT32", AL_FORMAT_STEREO_FLOAT32 },
  98. { "AL_FORMAT_STEREO_DOUBLE_EXT", AL_FORMAT_STEREO_DOUBLE_EXT },
  99. { "AL_FORMAT_MONO_IMA4", AL_FORMAT_MONO_IMA4 },
  100. { "AL_FORMAT_STEREO_IMA4", AL_FORMAT_STEREO_IMA4 },
  101. { "AL_FORMAT_QUAD8_LOKI", AL_FORMAT_QUAD8_LOKI },
  102. { "AL_FORMAT_QUAD16_LOKI", AL_FORMAT_QUAD16_LOKI },
  103. { "AL_FORMAT_QUAD8", AL_FORMAT_QUAD8 },
  104. { "AL_FORMAT_QUAD16", AL_FORMAT_QUAD16 },
  105. { "AL_FORMAT_QUAD32", AL_FORMAT_QUAD32 },
  106. { "AL_FORMAT_51CHN8", AL_FORMAT_51CHN8 },
  107. { "AL_FORMAT_51CHN16", AL_FORMAT_51CHN16 },
  108. { "AL_FORMAT_51CHN32", AL_FORMAT_51CHN32 },
  109. { "AL_FORMAT_61CHN8", AL_FORMAT_61CHN8 },
  110. { "AL_FORMAT_61CHN16", AL_FORMAT_61CHN16 },
  111. { "AL_FORMAT_61CHN32", AL_FORMAT_61CHN32 },
  112. { "AL_FORMAT_71CHN8", AL_FORMAT_71CHN8 },
  113. { "AL_FORMAT_71CHN16", AL_FORMAT_71CHN16 },
  114. { "AL_FORMAT_71CHN32", AL_FORMAT_71CHN32 },
  115. { "AL_FORMAT_REAR8", AL_FORMAT_REAR8 },
  116. { "AL_FORMAT_REAR16", AL_FORMAT_REAR16 },
  117. { "AL_FORMAT_REAR32", AL_FORMAT_REAR32 },
  118. { "AL_FORMAT_MONO_MULAW", AL_FORMAT_MONO_MULAW },
  119. { "AL_FORMAT_MONO_MULAW_EXT", AL_FORMAT_MONO_MULAW },
  120. { "AL_FORMAT_STEREO_MULAW", AL_FORMAT_STEREO_MULAW },
  121. { "AL_FORMAT_STEREO_MULAW_EXT", AL_FORMAT_STEREO_MULAW },
  122. { "AL_FORMAT_QUAD_MULAW", AL_FORMAT_QUAD_MULAW },
  123. { "AL_FORMAT_51CHN_MULAW", AL_FORMAT_51CHN_MULAW },
  124. { "AL_FORMAT_61CHN_MULAW", AL_FORMAT_61CHN_MULAW },
  125. { "AL_FORMAT_71CHN_MULAW", AL_FORMAT_71CHN_MULAW },
  126. { "AL_FORMAT_REAR_MULAW", AL_FORMAT_REAR_MULAW },
  127. // Buffer attributes
  128. { "AL_FREQUENCY", AL_FREQUENCY },
  129. { "AL_BITS", AL_BITS },
  130. { "AL_CHANNELS", AL_CHANNELS },
  131. { "AL_SIZE", AL_SIZE },
  132. // Buffer States (not supported yet)
  133. { "AL_UNUSED", AL_UNUSED },
  134. { "AL_PENDING", AL_PENDING },
  135. { "AL_PROCESSED", AL_PROCESSED },
  136. // AL Error Messages
  137. { "AL_NO_ERROR", AL_NO_ERROR },
  138. { "AL_INVALID_NAME", AL_INVALID_NAME },
  139. { "AL_INVALID_ENUM", AL_INVALID_ENUM },
  140. { "AL_INVALID_VALUE", AL_INVALID_VALUE },
  141. { "AL_INVALID_OPERATION", AL_INVALID_OPERATION },
  142. { "AL_OUT_OF_MEMORY", AL_OUT_OF_MEMORY },
  143. // Context strings
  144. { "AL_VENDOR", AL_VENDOR },
  145. { "AL_VERSION", AL_VERSION },
  146. { "AL_RENDERER", AL_RENDERER },
  147. { "AL_EXTENSIONS", AL_EXTENSIONS },
  148. // Global states
  149. { "AL_DOPPLER_FACTOR", AL_DOPPLER_FACTOR },
  150. { "AL_DOPPLER_VELOCITY", AL_DOPPLER_VELOCITY },
  151. { "AL_DISTANCE_MODEL", AL_DISTANCE_MODEL },
  152. { "AL_SPEED_OF_SOUND", AL_SPEED_OF_SOUND },
  153. { "AL_SOURCE_DISTANCE_MODEL", AL_SOURCE_DISTANCE_MODEL },
  154. // Distance Models
  155. { "AL_INVERSE_DISTANCE", AL_INVERSE_DISTANCE },
  156. { "AL_INVERSE_DISTANCE_CLAMPED", AL_INVERSE_DISTANCE_CLAMPED },
  157. { "AL_LINEAR_DISTANCE", AL_LINEAR_DISTANCE },
  158. { "AL_LINEAR_DISTANCE_CLAMPED", AL_LINEAR_DISTANCE_CLAMPED },
  159. { "AL_EXPONENT_DISTANCE", AL_EXPONENT_DISTANCE },
  160. { "AL_EXPONENT_DISTANCE_CLAMPED", AL_EXPONENT_DISTANCE_CLAMPED },
  161. // Apportable Extensions
  162. { "AL_PRIORITY", AL_PRIORITY },
  163. { "AL_PRIORITY_SLOTS", AL_PRIORITY_SLOTS },
  164. // Filter types
  165. { "AL_FILTER_TYPE", AL_FILTER_TYPE },
  166. { "AL_FILTER_NULL", AL_FILTER_NULL },
  167. { "AL_FILTER_LOWPASS", AL_FILTER_LOWPASS },
  168. #if 0
  169. { "AL_FILTER_HIGHPASS", AL_FILTER_HIGHPASS },
  170. { "AL_FILTER_BANDPASS", AL_FILTER_BANDPASS },
  171. #endif
  172. // Filter params
  173. { "AL_LOWPASS_GAIN", AL_LOWPASS_GAIN },
  174. { "AL_LOWPASS_GAINHF", AL_LOWPASS_GAINHF },
  175. // Effect types
  176. { "AL_EFFECT_TYPE", AL_EFFECT_TYPE },
  177. { "AL_EFFECT_NULL", AL_EFFECT_NULL },
  178. { "AL_EFFECT_REVERB", AL_EFFECT_REVERB },
  179. { "AL_EFFECT_EAXREVERB", AL_EFFECT_EAXREVERB },
  180. #if 0
  181. { "AL_EFFECT_CHORUS", AL_EFFECT_CHORUS },
  182. { "AL_EFFECT_DISTORTION", AL_EFFECT_DISTORTION },
  183. #endif
  184. { "AL_EFFECT_ECHO", AL_EFFECT_ECHO },
  185. #if 0
  186. { "AL_EFFECT_FLANGER", AL_EFFECT_FLANGER },
  187. { "AL_EFFECT_FREQUENCY_SHIFTER", AL_EFFECT_FREQUENCY_SHIFTER },
  188. { "AL_EFFECT_VOCAL_MORPHER", AL_EFFECT_VOCAL_MORPHER },
  189. { "AL_EFFECT_PITCH_SHIFTER", AL_EFFECT_PITCH_SHIFTER },
  190. #endif
  191. { "AL_EFFECT_RING_MODULATOR", AL_EFFECT_RING_MODULATOR },
  192. #if 0
  193. { "AL_EFFECT_AUTOWAH", AL_EFFECT_AUTOWAH },
  194. { "AL_EFFECT_COMPRESSOR", AL_EFFECT_COMPRESSOR },
  195. { "AL_EFFECT_EQUALIZER", AL_EFFECT_EQUALIZER },
  196. #endif
  197. // Reverb params
  198. { "AL_REVERB_DENSITY", AL_REVERB_DENSITY },
  199. { "AL_REVERB_DIFFUSION", AL_REVERB_DIFFUSION },
  200. { "AL_REVERB_GAIN", AL_REVERB_GAIN },
  201. { "AL_REVERB_GAINHF", AL_REVERB_GAINHF },
  202. { "AL_REVERB_DECAY_TIME", AL_REVERB_DECAY_TIME },
  203. { "AL_REVERB_DECAY_HFRATIO", AL_REVERB_DECAY_HFRATIO },
  204. { "AL_REVERB_REFLECTIONS_GAIN", AL_REVERB_REFLECTIONS_GAIN },
  205. { "AL_REVERB_REFLECTIONS_DELAY", AL_REVERB_REFLECTIONS_DELAY },
  206. { "AL_REVERB_LATE_REVERB_GAIN", AL_REVERB_LATE_REVERB_GAIN },
  207. { "AL_REVERB_LATE_REVERB_DELAY", AL_REVERB_LATE_REVERB_DELAY },
  208. { "AL_REVERB_AIR_ABSORPTION_GAINHF", AL_REVERB_AIR_ABSORPTION_GAINHF },
  209. { "AL_REVERB_ROOM_ROLLOFF_FACTOR", AL_REVERB_ROOM_ROLLOFF_FACTOR },
  210. { "AL_REVERB_DECAY_HFLIMIT", AL_REVERB_DECAY_HFLIMIT },
  211. // EAX Reverb params
  212. { "AL_EAXREVERB_DENSITY", AL_EAXREVERB_DENSITY },
  213. { "AL_EAXREVERB_DIFFUSION", AL_EAXREVERB_DIFFUSION },
  214. { "AL_EAXREVERB_GAIN", AL_EAXREVERB_GAIN },
  215. { "AL_EAXREVERB_GAINHF", AL_EAXREVERB_GAINHF },
  216. { "AL_EAXREVERB_GAINLF", AL_EAXREVERB_GAINLF },
  217. { "AL_EAXREVERB_DECAY_TIME", AL_EAXREVERB_DECAY_TIME },
  218. { "AL_EAXREVERB_DECAY_HFRATIO", AL_EAXREVERB_DECAY_HFRATIO },
  219. { "AL_EAXREVERB_DECAY_LFRATIO", AL_EAXREVERB_DECAY_LFRATIO },
  220. { "AL_EAXREVERB_REFLECTIONS_GAIN", AL_EAXREVERB_REFLECTIONS_GAIN },
  221. { "AL_EAXREVERB_REFLECTIONS_DELAY", AL_EAXREVERB_REFLECTIONS_DELAY },
  222. { "AL_EAXREVERB_REFLECTIONS_PAN", AL_EAXREVERB_REFLECTIONS_PAN },
  223. { "AL_EAXREVERB_LATE_REVERB_GAIN", AL_EAXREVERB_LATE_REVERB_GAIN },
  224. { "AL_EAXREVERB_LATE_REVERB_DELAY", AL_EAXREVERB_LATE_REVERB_DELAY },
  225. { "AL_EAXREVERB_LATE_REVERB_PAN", AL_EAXREVERB_LATE_REVERB_PAN },
  226. { "AL_EAXREVERB_ECHO_TIME", AL_EAXREVERB_ECHO_TIME },
  227. { "AL_EAXREVERB_ECHO_DEPTH", AL_EAXREVERB_ECHO_DEPTH },
  228. { "AL_EAXREVERB_MODULATION_TIME", AL_EAXREVERB_MODULATION_TIME },
  229. { "AL_EAXREVERB_MODULATION_DEPTH", AL_EAXREVERB_MODULATION_DEPTH },
  230. { "AL_EAXREVERB_AIR_ABSORPTION_GAINHF", AL_EAXREVERB_AIR_ABSORPTION_GAINHF },
  231. { "AL_EAXREVERB_HFREFERENCE", AL_EAXREVERB_HFREFERENCE },
  232. { "AL_EAXREVERB_LFREFERENCE", AL_EAXREVERB_LFREFERENCE },
  233. { "AL_EAXREVERB_ROOM_ROLLOFF_FACTOR", AL_EAXREVERB_ROOM_ROLLOFF_FACTOR },
  234. { "AL_EAXREVERB_DECAY_HFLIMIT", AL_EAXREVERB_DECAY_HFLIMIT },
  235. // Echo params
  236. { "AL_ECHO_DELAY", AL_ECHO_DELAY },
  237. { "AL_ECHO_LRDELAY", AL_ECHO_LRDELAY },
  238. { "AL_ECHO_DAMPING", AL_ECHO_DAMPING },
  239. { "AL_ECHO_FEEDBACK", AL_ECHO_FEEDBACK },
  240. { "AL_ECHO_SPREAD", AL_ECHO_SPREAD },
  241. // Ring Modulator params
  242. { "AL_RING_MODULATOR_FREQUENCY", AL_RING_MODULATOR_FREQUENCY },
  243. { "AL_RING_MODULATOR_HIGHPASS_CUTOFF", AL_RING_MODULATOR_HIGHPASS_CUTOFF },
  244. { "AL_RING_MODULATOR_WAVEFORM", AL_RING_MODULATOR_WAVEFORM },
  245. // Default
  246. { NULL, (ALenum)0 }
  247. };
  248. AL_API ALboolean AL_APIENTRY alIsExtensionPresent(const ALchar *extName)
  249. {
  250. ALboolean bIsSupported = AL_FALSE;
  251. ALCcontext *pContext;
  252. const char *ptr;
  253. size_t len;
  254. pContext = GetContextSuspended();
  255. if(!pContext) return AL_FALSE;
  256. if(!extName)
  257. {
  258. alSetError(pContext, AL_INVALID_VALUE);
  259. ProcessContext(pContext);
  260. return AL_FALSE;
  261. }
  262. len = strlen(extName);
  263. ptr = pContext->ExtensionList;
  264. while(ptr && *ptr)
  265. {
  266. if(strncasecmp(ptr, extName, len) == 0 &&
  267. (ptr[len] == '\0' || isspace(ptr[len])))
  268. {
  269. bIsSupported = AL_TRUE;
  270. break;
  271. }
  272. if((ptr=strchr(ptr, ' ')) != NULL)
  273. {
  274. do {
  275. ++ptr;
  276. } while(isspace(*ptr));
  277. }
  278. }
  279. ProcessContext(pContext);
  280. return bIsSupported;
  281. }
  282. AL_API ALvoid* AL_APIENTRY alGetProcAddress(const ALchar *funcName)
  283. {
  284. if(!funcName)
  285. return NULL;
  286. return alcGetProcAddress(NULL, funcName);
  287. }
  288. AL_API ALenum AL_APIENTRY alGetEnumValue(const ALchar *enumName)
  289. {
  290. ALsizei i = 0;
  291. while(enumeration[i].enumName &&
  292. strcmp(enumeration[i].enumName, enumName) != 0)
  293. i++;
  294. return enumeration[i].value;
  295. }