extra/openal/openal.factor

   1 ! Copyright (C) 2007 Chris Double.
   2 ! See http://factorcode.org/license.txt for BSD license.
   3 USING: kernel accessors arrays alien system combinators alien.syntax namespaces
   4        alien.c-types sequences vocabs.loader shuffle
   5        openal.backend specialized-arrays.uint alien.libraries generalizations ;
   6 IN: openal
   7
   8 << "alut" {
   9         { [ os windows? ]  [ "alut.dll" ] }
  10         { [ os macosx? ] [
  11             "/System/Library/Frameworks/OpenAL.framework/OpenAL"
  12         ] }
  13         { [ os unix?  ]  [ "libalut.so" ] }
  14     } cond "cdecl" add-library >>
  15
  16 << "openal" {
  17         { [ os windows? ]  [ "OpenAL32.dll" ] }
  18         { [ os macosx? ] [
  19             "/System/Library/Frameworks/OpenAL.framework/OpenAL"
  20         ] }
  21         { [ os unix?  ]  [ "libopenal.so" ] }
  22     } cond "cdecl" add-library >>
  23
  24 LIBRARY: openal
  25
  26 TYPEDEF: char ALboolean
  27 TYPEDEF: char ALchar
  28 TYPEDEF: char ALbyte
  29 TYPEDEF: uchar ALubyte
  30 TYPEDEF: short ALshort
  31 TYPEDEF: ushort ALushort
  32 TYPEDEF: int ALint
  33 TYPEDEF: uint ALuint
  34 TYPEDEF: int ALsizei
  35 TYPEDEF: int ALenum
  36 TYPEDEF: float ALfloat
  37 TYPEDEF: double ALdouble
  38
  39 CONSTANT: AL_INVALID -1
  40 CONSTANT: AL_NONE 0
  41 CONSTANT: AL_FALSE 0
  42 CONSTANT: AL_TRUE 1
  43 CONSTANT: AL_SOURCE_RELATIVE HEX: 202
  44 CONSTANT: AL_CONE_INNER_ANGLE HEX: 1001
  45 CONSTANT: AL_CONE_OUTER_ANGLE HEX: 1002
  46 CONSTANT: AL_PITCH HEX: 1003
  47 CONSTANT: AL_POSITION HEX: 1004
  48 CONSTANT: AL_DIRECTION HEX: 1005
  49 CONSTANT: AL_VELOCITY HEX: 1006
  50 CONSTANT: AL_LOOPING HEX: 1007
  51 CONSTANT: AL_BUFFER HEX: 1009
  52 CONSTANT: AL_GAIN HEX: 100A
  53 CONSTANT: AL_MIN_GAIN HEX: 100D
  54 CONSTANT: AL_MAX_GAIN HEX: 100E
  55 CONSTANT: AL_ORIENTATION HEX: 100F
  56 CONSTANT: AL_CHANNEL_MASK HEX: 3000
  57 CONSTANT: AL_SOURCE_STATE HEX: 1010
  58 CONSTANT: AL_INITIAL HEX: 1011
  59 CONSTANT: AL_PLAYING HEX: 1012
  60 CONSTANT: AL_PAUSED HEX: 1013
  61 CONSTANT: AL_STOPPED HEX: 1014
  62 CONSTANT: AL_BUFFERS_QUEUED HEX: 1015
  63 CONSTANT: AL_BUFFERS_PROCESSED HEX: 1016
  64 CONSTANT: AL_SEC_OFFSET HEX: 1024
  65 CONSTANT: AL_SAMPLE_OFFSET HEX: 1025
  66 CONSTANT: AL_BYTE_OFFSET HEX: 1026
  67 CONSTANT: AL_SOURCE_TYPE HEX: 1027
  68 CONSTANT: AL_STATIC HEX: 1028
  69 CONSTANT: AL_STREAMING HEX: 1029
  70 CONSTANT: AL_UNDETERMINED HEX: 1030
  71 CONSTANT: AL_FORMAT_MONO8 HEX: 1100
  72 CONSTANT: AL_FORMAT_MONO16 HEX: 1101
  73 CONSTANT: AL_FORMAT_STEREO8 HEX: 1102
  74 CONSTANT: AL_FORMAT_STEREO16 HEX: 1103
  75 CONSTANT: AL_REFERENCE_DISTANCE HEX: 1020
  76 CONSTANT: AL_ROLLOFF_FACTOR HEX: 1021
  77 CONSTANT: AL_CONE_OUTER_GAIN HEX: 1022
  78 CONSTANT: AL_MAX_DISTANCE HEX: 1023
  79 CONSTANT: AL_FREQUENCY HEX: 2001
  80 CONSTANT: AL_BITS HEX: 2002
  81 CONSTANT: AL_CHANNELS HEX: 2003
  82 CONSTANT: AL_SIZE HEX: 2004
  83 CONSTANT: AL_UNUSED HEX: 2010
  84 CONSTANT: AL_PENDING HEX: 2011
  85 CONSTANT: AL_PROCESSED HEX: 2012
  86 CONSTANT: AL_NO_ERROR AL_FALSE
  87 CONSTANT: AL_INVALID_NAME HEX: A001
  88 CONSTANT: AL_ILLEGAL_ENUM HEX: A002
  89 CONSTANT: AL_INVALID_ENUM HEX: A002
  90 CONSTANT: AL_INVALID_VALUE HEX: A003
  91 CONSTANT: AL_ILLEGAL_COMMAND HEX: A004
  92 CONSTANT: AL_INVALID_OPERATION HEX: A004
  93 CONSTANT: AL_OUT_OF_MEMORY HEX: A005
  94 CONSTANT: AL_VENDOR HEX: B001
  95 CONSTANT: AL_VERSION HEX: B002
  96 CONSTANT: AL_RENDERER HEX: B003
  97 CONSTANT: AL_EXTENSIONS HEX: B004
  98 CONSTANT: AL_DOPPLER_FACTOR HEX: C000
  99 CONSTANT: AL_DOPPLER_VELOCITY HEX: C001
 100 CONSTANT: AL_SPEED_OF_SOUND HEX: C003
 101 CONSTANT: AL_DISTANCE_MODEL HEX: D000
 102 CONSTANT: AL_INVERSE_DISTANCE HEX: D001
 103 CONSTANT: AL_INVERSE_DISTANCE_CLAMPED HEX: D002
 104 CONSTANT: AL_LINEAR_DISTANCE HEX: D003
 105 CONSTANT: AL_LINEAR_DISTANCE_CLAMPED HEX: D004
 106 CONSTANT: AL_EXPONENT_DISTANCE HEX: D005
 107 CONSTANT: AL_EXPONENT_DISTANCE_CLAMPED HEX: D006
 108
 109 FUNCTION: void alEnable ( ALenum capability ) ;
 110 FUNCTION: void alDisable ( ALenum capability ) ;
 111 FUNCTION: ALboolean alIsEnabled ( ALenum capability ) ;
 112 FUNCTION: ALchar* alGetString ( ALenum param ) ;
 113 FUNCTION: void alGetBooleanv ( ALenum param, ALboolean* data ) ;
 114 FUNCTION: void alGetIntegerv ( ALenum param, ALint* data ) ;
 115 FUNCTION: void alGetFloatv ( ALenum param, ALfloat* data ) ;
 116 FUNCTION: void alGetDoublev ( ALenum param, ALdouble* data ) ;
 117 FUNCTION: ALboolean alGetBoolean ( ALenum param ) ;
 118 FUNCTION: ALint alGetInteger ( ALenum param ) ;
 119 FUNCTION: ALfloat alGetFloat ( ALenum param ) ;
 120 FUNCTION: ALdouble alGetDouble ( ALenum param ) ;
 121 FUNCTION: ALenum alGetError (  ) ;
 122 FUNCTION: ALboolean alIsExtensionPresent ( ALchar* extname ) ;
 123 FUNCTION: void* alGetProcAddress ( ALchar* fname ) ;
 124 FUNCTION: ALenum alGetEnumValue ( ALchar* ename ) ;
 125 FUNCTION: void alListenerf ( ALenum param, ALfloat value ) ;
 126 FUNCTION: void alListener3f ( ALenum param, ALfloat value1, ALfloat value2, ALfloat value3 ) ;
 127 FUNCTION: void alListenerfv ( ALenum param, ALfloat* values ) ;
 128 FUNCTION: void alListeneri ( ALenum param, ALint value ) ;
 129 FUNCTION: void alListener3i ( ALenum param, ALint value1, ALint value2, ALint value3 ) ;
 130 FUNCTION: void alListeneriv ( ALenum param, ALint* values ) ;
 131 FUNCTION: void alGetListenerf ( ALenum param, ALfloat* value ) ;
 132 FUNCTION: void alGetListener3f ( ALenum param, ALfloat* value1, ALfloat* value2, ALfloat* value3 ) ;
 133 FUNCTION: void alGetListenerfv ( ALenum param, ALfloat* values ) ;
 134 FUNCTION: void alGetListeneri ( ALenum param, ALint* value ) ;
 135 FUNCTION: void alGetListener3i ( ALenum param, ALint* value1, ALint* value2, ALint* value3 ) ;
 136 FUNCTION: void alGetListeneriv ( ALenum param, ALint* values ) ;
 137 FUNCTION: void alGenSources ( ALsizei n, ALuint* sources ) ;
 138 FUNCTION: void alDeleteSources ( ALsizei n, ALuint* sources ) ;
 139 FUNCTION: ALboolean alIsSource ( ALuint sid ) ;
 140 FUNCTION: void alSourcef ( ALuint sid, ALenum param, ALfloat value ) ;
 141 FUNCTION: void alSource3f ( ALuint sid, ALenum param, ALfloat value1, ALfloat value2, ALfloat value3 ) ;
 142 FUNCTION: void alSourcefv ( ALuint sid, ALenum param, ALfloat* values ) ;
 143 FUNCTION: void alSourcei ( ALuint sid, ALenum param, ALint value ) ;
 144 FUNCTION: void alSource3i ( ALuint sid, ALenum param, ALint value1, ALint value2, ALint value3 ) ;
 145 FUNCTION: void alSourceiv ( ALuint sid, ALenum param, ALint* values ) ;
 146 FUNCTION: void alGetSourcef ( ALuint sid, ALenum param, ALfloat* value ) ;
 147 FUNCTION: void alGetSource3f ( ALuint sid, ALenum param, ALfloat* value1, ALfloat* value2, ALfloat* value3) ;
 148 FUNCTION: void alGetSourcefv ( ALuint sid, ALenum param, ALfloat* values ) ;
 149 FUNCTION: void alGetSourcei ( ALuint sid,  ALenum param, ALint* value ) ;
 150 FUNCTION: void alGetSource3i ( ALuint sid, ALenum param, ALint* value1, ALint* value2, ALint* value3) ;
 151 FUNCTION: void alGetSourceiv ( ALuint sid,  ALenum param, ALint* values ) ;
 152 FUNCTION: void alSourcePlayv ( ALsizei ns, ALuint* sids ) ;
 153 FUNCTION: void alSourceStopv ( ALsizei ns, ALuint* sids ) ;
 154 FUNCTION: void alSourceRewindv ( ALsizei ns, ALuint* sids ) ;
 155 FUNCTION: void alSourcePausev ( ALsizei ns, ALuint* sids ) ;
 156 FUNCTION: void alSourcePlay ( ALuint sid ) ;
 157 FUNCTION: void alSourceStop ( ALuint sid ) ;
 158 FUNCTION: void alSourceRewind ( ALuint sid ) ;
 159 FUNCTION: void alSourcePause ( ALuint sid ) ;
 160 FUNCTION: void alSourceQueueBuffers ( ALuint sid, ALsizei numEntries, ALuint* bids ) ;
 161 FUNCTION: void alSourceUnqueueBuffers ( ALuint sid, ALsizei numEntries, ALuint* bids ) ;
 162 FUNCTION: void alGenBuffers ( ALsizei n, ALuint* buffers ) ;
 163 FUNCTION: void alDeleteBuffers ( ALsizei n, ALuint* buffers ) ;
 164 FUNCTION: ALboolean alIsBuffer ( ALuint bid ) ;
 165 FUNCTION: void alBufferData ( ALuint bid, ALenum format, void* data, ALsizei size, ALsizei freq ) ;
 166 FUNCTION: void alBufferf ( ALuint bid, ALenum param, ALfloat value ) ;
 167 FUNCTION: void alBuffer3f ( ALuint bid, ALenum param, ALfloat value1, ALfloat value2, ALfloat value3 ) ;
 168 FUNCTION: void alBufferfv ( ALuint bid, ALenum param, ALfloat* values ) ;
 169 FUNCTION: void alBufferi ( ALuint bid, ALenum param, ALint value ) ;
 170 FUNCTION: void alBuffer3i ( ALuint bid, ALenum param, ALint value1, ALint value2, ALint value3 ) ;
 171 FUNCTION: void alBufferiv ( ALuint bid, ALenum param, ALint* values ) ;
 172 FUNCTION: void alGetBufferf ( ALuint bid, ALenum param, ALfloat* value ) ;
 173 FUNCTION: void alGetBuffer3f ( ALuint bid, ALenum param, ALfloat* value1, ALfloat* value2, ALfloat* value3) ;
 174 FUNCTION: void alGetBufferfv ( ALuint bid, ALenum param, ALfloat* values ) ;
 175 FUNCTION: void alGetBufferi ( ALuint bid, ALenum param, ALint* value ) ;
 176 FUNCTION: void alGetBuffer3i ( ALuint bid, ALenum param, ALint* value1, ALint* value2, ALint* value3) ;
 177 FUNCTION: void alGetBufferiv ( ALuint bid, ALenum param, ALint* values ) ;
 178 FUNCTION: void alDopplerFactor ( ALfloat value ) ;
 179 FUNCTION: void alDopplerVelocity ( ALfloat value ) ;
 180 FUNCTION: void alSpeedOfSound ( ALfloat value ) ;
 181 FUNCTION: void alDistanceModel ( ALenum distanceModel ) ;
 182
 183 LIBRARY: alut
 184
 185 CONSTANT: ALUT_API_MAJOR_VERSION 1
 186 CONSTANT: ALUT_API_MINOR_VERSION 1
 187 CONSTANT: ALUT_ERROR_NO_ERROR 0
 188 CONSTANT: ALUT_ERROR_OUT_OF_MEMORY HEX: 200
 189 CONSTANT: ALUT_ERROR_INVALID_ENUM HEX: 201
 190 CONSTANT: ALUT_ERROR_INVALID_VALUE HEX: 202
 191 CONSTANT: ALUT_ERROR_INVALID_OPERATION HEX: 203
 192 CONSTANT: ALUT_ERROR_NO_CURRENT_CONTEXT HEX: 204
 193 CONSTANT: ALUT_ERROR_AL_ERROR_ON_ENTRY HEX: 205
 194 CONSTANT: ALUT_ERROR_ALC_ERROR_ON_ENTRY HEX: 206
 195 CONSTANT: ALUT_ERROR_OPEN_DEVICE HEX: 207
 196 CONSTANT: ALUT_ERROR_CLOSE_DEVICE HEX: 208
 197 CONSTANT: ALUT_ERROR_CREATE_CONTEXT HEX: 209
 198 CONSTANT: ALUT_ERROR_MAKE_CONTEXT_CURRENT HEX: 20A
 199 CONSTANT: ALUT_ERROR_DESTRY_CONTEXT HEX: 20B
 200 CONSTANT: ALUT_ERROR_GEN_BUFFERS HEX: 20C
 201 CONSTANT: ALUT_ERROR_BUFFER_DATA HEX: 20D
 202 CONSTANT: ALUT_ERROR_IO_ERROR HEX: 20E
 203 CONSTANT: ALUT_ERROR_UNSUPPORTED_FILE_TYPE HEX: 20F
 204 CONSTANT: ALUT_ERROR_UNSUPPORTED_FILE_SUBTYPE HEX: 210
 205 CONSTANT: ALUT_ERROR_CORRUPT_OR_TRUNCATED_DATA HEX: 211
 206 CONSTANT: ALUT_WAVEFORM_SINE HEX: 100
 207 CONSTANT: ALUT_WAVEFORM_SQUARE HEX: 101
 208 CONSTANT: ALUT_WAVEFORM_SAWTOOTH HEX: 102
 209 CONSTANT: ALUT_WAVEFORM_WHITENOISE HEX: 103
 210 CONSTANT: ALUT_WAVEFORM_IMPULSE HEX: 104
 211 CONSTANT: ALUT_LOADER_BUFFER HEX: 300
 212 CONSTANT: ALUT_LOADER_MEMORY HEX: 301
 213
 214 FUNCTION: ALboolean alutInit ( int* argcp, char** argv ) ;
 215 FUNCTION: ALboolean alutInitWithoutContext ( int* argcp, char** argv ) ;
 216 FUNCTION: ALboolean alutExit ( ) ;
 217 FUNCTION: ALenum alutGetError ( ) ;
 218 FUNCTION: char* alutGetErrorString ( ALenum error ) ;
 219 FUNCTION: ALuint alutCreateBufferFromFile ( char* fileName ) ;
 220 FUNCTION: ALuint alutCreateBufferFromFileImage ( void* data, ALsizei length ) ;
 221 FUNCTION: ALuint alutCreateBufferHelloWorld ( ) ;
 222 FUNCTION: ALuint alutCreateBufferWaveform ( ALenum waveshape, ALfloat frequency, ALfloat phase, ALfloat duration ) ;
 223 FUNCTION: void* alutLoadMemoryFromFile ( char* fileName, ALenum* format, ALsizei* size, ALfloat* frequency ) ;
 224 FUNCTION: void* alutLoadMemoryFromFileImage ( void* data, ALsizei length, ALenum* format, ALsizei* size, ALfloat* frequency ) ;
 225 FUNCTION: void* alutLoadMemoryHelloWorld ( ALenum* format, ALsizei* size, ALfloat* frequency ) ;
 226 FUNCTION: void* alutLoadMemoryWaveform ( ALenum waveshape, ALfloat frequency, ALfloat phase, ALfloat duration, ALenum* format, ALsizei* size, ALfloat* freq ) ;
 227 FUNCTION: char* alutGetMIMETypes ( ALenum loader ) ;
 228 FUNCTION: ALint alutGetMajorVersion ( ) ;
 229 FUNCTION: ALint alutGetMinorVersion ( ) ;
 230 FUNCTION: ALboolean alutSleep ( ALfloat duration ) ;
 231
 232 FUNCTION: void alutUnloadWAV ( ALenum format, void* data, ALsizei size, ALsizei frequency ) ;
 233
 234 SYMBOL: init
 235
 236 : init-openal ( -- )
 237     init get-global expired? [
 238         f f alutInit 0 = [ "Could not initialize OpenAL" throw ] when
 239         1337 <alien> init set-global
 240     ] when ;
 241
 242 : exit-openal ( -- )
 243     init get-global expired? [
 244         alutExit 0 = [ "Could not close OpenAL" throw ] when
 245         f init set-global
 246     ] unless ;
 247
 248 : gen-sources ( size -- seq )
 249     dup <uint-array> [ alGenSources ] keep ;
 250
 251 : gen-buffers ( size -- seq )
 252     dup <uint-array> [ alGenBuffers ] keep ;
 253
 254 : gen-buffer ( -- buffer ) 1 gen-buffers first ;
 255
 256 : create-buffer-from-file ( filename -- buffer )
 257     alutCreateBufferFromFile dup AL_NONE = [
 258         "create-buffer-from-file failed" throw
 259     ] when ;
 260
 261 os macosx? "openal.macosx" "openal.other" ? require
 262
 263 : create-buffer-from-wav ( filename -- buffer )
 264     gen-buffer dup rot load-wav-file
 265     [ alBufferData ] 4 nkeep alutUnloadWAV ;
 266
 267 : queue-buffers ( source buffers -- )
 268     [ length ] [ >uint-array ] bi alSourceQueueBuffers ;
 269
 270 : queue-buffer ( source buffer -- )
 271     1array queue-buffers ;
 272
 273 : set-source-param ( source param value -- )
 274     alSourcei ;
 275
 276 : get-source-param ( source param -- value )
 277     0 <uint> dup [ alGetSourcei ] dip *uint ;
 278
 279 : set-buffer-param ( source param value -- )
 280     alBufferi ;
 281
 282 : get-buffer-param ( source param -- value )
 283     0 <uint> dup [ alGetBufferi ] dip *uint ;
 284
 285 : source-play ( source -- ) alSourcePlay ;
 286
 287 : source-stop ( source -- ) alSourceStop ;
 288
 289 : check-error ( -- )
 290     alGetError dup ALUT_ERROR_NO_ERROR = [
 291         drop
 292     ] [
 293         alGetString throw
 294     ] if ;
 295
 296 : source-playing? ( source -- bool )
 297     AL_SOURCE_STATE get-source-param AL_PLAYING = ;