OpenAL32/Include/alBuffer.h

   1 #ifndef _AL_BUFFER_H_
   2 #define _AL_BUFFER_H_
   3
   4 #include "alMain.h"
   5
   6 #ifdef __cplusplus
   7 extern "C" {
   8 #endif
   9
  10 /* User formats */
  11 enum UserFmtType {
  12     UserFmtByte   = AL_BYTE_SOFT,
  13     UserFmtUByte  = AL_UNSIGNED_BYTE_SOFT,
  14     UserFmtShort  = AL_SHORT_SOFT,
  15     UserFmtUShort = AL_UNSIGNED_SHORT_SOFT,
  16     UserFmtInt    = AL_INT_SOFT,
  17     UserFmtUInt   = AL_UNSIGNED_INT_SOFT,
  18     UserFmtFloat  = AL_FLOAT_SOFT,
  19     UserFmtDouble = AL_DOUBLE_SOFT,
  20     UserFmtByte3  = AL_BYTE3_SOFT,
  21     UserFmtUByte3 = AL_UNSIGNED_BYTE3_SOFT,
  22     UserFmtMulaw,
  23     UserFmtAlaw,
  24     UserFmtIMA4,
  25     UserFmtMSADPCM,
  26 };
  27 enum UserFmtChannels {
  28     UserFmtMono   = AL_MONO_SOFT,
  29     UserFmtStereo = AL_STEREO_SOFT,
  30     UserFmtRear   = AL_REAR_SOFT,
  31     UserFmtQuad   = AL_QUAD_SOFT,
  32     UserFmtX51    = AL_5POINT1_SOFT, /* (WFX order) */
  33     UserFmtX61    = AL_6POINT1_SOFT, /* (WFX order) */
  34     UserFmtX71    = AL_7POINT1_SOFT, /* (WFX order) */
  35 };
  36
  37 ALuint BytesFromUserFmt(enum UserFmtType type);
  38 ALuint ChannelsFromUserFmt(enum UserFmtChannels chans);
  39 inline ALuint FrameSizeFromUserFmt(enum UserFmtChannels chans, enum UserFmtType type)
  40 {
  41     return ChannelsFromUserFmt(chans) * BytesFromUserFmt(type);
  42 }
  43
  44
  45 /* Storable formats */
  46 enum FmtType {
  47     FmtByte  = UserFmtByte,
  48     FmtShort = UserFmtShort,
  49     FmtFloat = UserFmtFloat,
  50 };
  51 enum FmtChannels {
  52     FmtMono   = UserFmtMono,
  53     FmtStereo = UserFmtStereo,
  54     FmtRear   = UserFmtRear,
  55     FmtQuad   = UserFmtQuad,
  56     FmtX51    = UserFmtX51,
  57     FmtX61    = UserFmtX61,
  58     FmtX71    = UserFmtX71,
  59 };
  60 #define MAX_INPUT_CHANNELS  (8)
  61
  62 ALuint BytesFromFmt(enum FmtType type);
  63 ALuint ChannelsFromFmt(enum FmtChannels chans);
  64 inline ALuint FrameSizeFromFmt(enum FmtChannels chans, enum FmtType type)
  65 {
  66     return ChannelsFromFmt(chans) * BytesFromFmt(type);
  67 }
  68
  69
  70 typedef struct ALbuffer {
  71     ALvoid  *data;
  72
  73     ALsizei  Frequency;
  74     ALenum   Format;
  75     ALsizei  SampleLen;
  76
  77     enum FmtChannels FmtChannels;
  78     enum FmtType     FmtType;
  79
  80     enum UserFmtChannels OriginalChannels;
  81     enum UserFmtType     OriginalType;
  82     ALsizei              OriginalSize;
  83     ALsizei              OriginalAlign;
  84
  85     ALsizei  LoopStart;
  86     ALsizei  LoopEnd;
  87
  88     ALsizei UnpackAlign;
  89     ALsizei PackAlign;
  90
  91     /* Number of times buffer was attached to a source (deletion can only occur when 0) */
  92     RefCount ref;
  93
  94     RWLock lock;
  95
  96     /* Self ID */
  97     ALuint id;
  98 } ALbuffer;
  99
 100 inline struct ALbuffer *LookupBuffer(ALCdevice *device, ALuint id)
 101 { return (struct ALbuffer*)LookupUIntMapKey(&device->BufferMap, id); }
 102 inline struct ALbuffer *RemoveBuffer(ALCdevice *device, ALuint id)
 103 { return (struct ALbuffer*)RemoveUIntMapKey(&device->BufferMap, id); }
 104
 105 ALvoid ReleaseALBuffers(ALCdevice *device);
 106
 107 #ifdef __cplusplus
 108 }
 109 #endif
 110
 111 #endif