OpenAL32/Include/alBuffer.h

   1 #ifndef _AL_BUFFER_H_
   2 #define _AL_BUFFER_H_
   3
   4 #include "AL/al.h"
   5
   6 #ifdef __cplusplus
   7 extern "C" {
   8 #endif
   9
  10 /* Input formats (some are currently theoretical) */
  11 enum SrcFmtType {
  12     SrcFmtByte,   /* AL_BYTE */
  13     SrcFmtUByte,  /* AL_UNSIGNED_BYTE */
  14     SrcFmtShort,  /* AL_SHORT */
  15     SrcFmtUShort, /* AL_UNSIGNED_SHORT */
  16     SrcFmtFloat,  /* AL_FLOAT */
  17     SrcFmtDouble, /* AL_DOUBLE */
  18     SrcFmtMulaw,  /* AL_MULAW */
  19 };
  20 enum SrcFmtChannels {
  21     SrcFmtMono,   /* AL_MONO */
  22     SrcFmtStereo, /* AL_STEREO */
  23     SrcFmtRear,   /* AL_REAR */
  24     SrcFmtQuad,   /* AL_QUAD */
  25     SrcFmtX51,    /* AL_5POINT1 (WFX order) */
  26     SrcFmtX61,    /* AL_6POINT1 (WFX order) */
  27     SrcFmtX71,    /* AL_7POINT1 (WFX order) */
  28 };
  29
  30 void DecomposeInputFormat(ALenum format, enum SrcFmtType *type,
  31                           enum SrcFmtChannels *order);
  32
  33 static __inline ALuint BytesFromSrcFmt(enum SrcFmtType type)
  34 {
  35     switch(type)
  36     {
  37     case SrcFmtByte: return sizeof(ALbyte);
  38     case SrcFmtUByte: return sizeof(ALubyte);
  39     case SrcFmtShort: return sizeof(ALshort);
  40     case SrcFmtUShort: return sizeof(ALushort);
  41     case SrcFmtFloat: return sizeof(ALfloat);
  42     case SrcFmtDouble: return sizeof(ALdouble);
  43     case SrcFmtMulaw: return sizeof(ALubyte);
  44     }
  45     return 0;
  46 }
  47 static __inline ALuint ChannelsFromSrcFmt(enum SrcFmtChannels chans)
  48 {
  49     switch(chans)
  50     {
  51     case SrcFmtMono: return 1;
  52     case SrcFmtStereo: return 2;
  53     case SrcFmtRear: return 2;
  54     case SrcFmtQuad: return 4;
  55     case SrcFmtX51: return 6;
  56     case SrcFmtX61: return 7;
  57     case SrcFmtX71: return 8;
  58     }
  59     return 0;
  60 }
  61 static __inline ALuint FrameSizeFromSrcFmt(enum SrcFmtType type,
  62                                            enum SrcFmtChannels chans)
  63 {
  64     return BytesFromSrcFmt(type) * ChannelsFromSrcFmt(chans);
  65 }
  66
  67
  68 /* Storable formats */
  69 enum FmtType {
  70     FmtUByte,
  71     FmtShort,
  72     FmtFloat,
  73     FmtDouble,
  74 };
  75 enum FmtChannels {
  76     FmtMono,
  77     FmtStereo,
  78     FmtRear,
  79     FmtQuad,
  80     FmtX51,
  81     FmtX61,
  82     FmtX71,
  83 };
  84
  85 void DecomposeFormat(ALenum format, enum FmtType *type, enum FmtChannels *order);
  86
  87 static __inline ALuint BytesFromFmt(enum FmtType type)
  88 {
  89     switch(type)
  90     {
  91     case FmtUByte: return sizeof(ALubyte);
  92     case FmtShort: return sizeof(ALshort);
  93     case FmtFloat: return sizeof(ALfloat);
  94     case FmtDouble: return sizeof(ALdouble);
  95     }
  96     return 0;
  97 }
  98 static __inline ALuint ChannelsFromFmt(enum FmtChannels chans)
  99 {
 100     switch(chans)
 101     {
 102     case FmtMono: return 1;
 103     case FmtStereo: return 2;
 104     case FmtRear: return 2;
 105     case FmtQuad: return 4;
 106     case FmtX51: return 6;
 107     case FmtX61: return 7;
 108     case FmtX71: return 8;
 109     }
 110     return 0;
 111 }
 112 static __inline ALuint FrameSizeFromFmt(enum FmtType type, enum FmtChannels chans)
 113 {
 114     return BytesFromFmt(type) * ChannelsFromFmt(chans);
 115 }
 116
 117
 118 typedef struct ALbuffer
 119 {
 120     ALvoid  *data;
 121     ALsizei  size;
 122
 123     ALsizei          Frequency;
 124     enum FmtType     FmtType;
 125     enum FmtChannels FmtChannels;
 126
 127     ALenum   OriginalFormat;
 128     ALsizei  OriginalSize;
 129     ALsizei  OriginalAlign;
 130
 131     ALsizei  LoopStart;
 132     ALsizei  LoopEnd;
 133
 134     ALuint   refcount; // Number of sources using this buffer (deletion can only occur when this is 0)
 135
 136     // Index to itself
 137     ALuint buffer;
 138 } ALbuffer;
 139
 140 ALvoid ReleaseALBuffers(ALCdevice *device);
 141
 142 #ifdef __cplusplus
 143 }
 144 #endif
 145
 146 #endif