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     SrcFmtInt,    /* AL_INT */
  17     SrcFmtUInt,   /* AL_UNSIGNED_INT */
  18     SrcFmtFloat,  /* AL_FLOAT */
  19     SrcFmtDouble, /* AL_DOUBLE */
  20     SrcFmtMulaw,  /* AL_MULAW */
  21     SrcFmtIMA4,   /* AL_IMA4 */
  22 };
  23 enum SrcFmtChannels {
  24     SrcFmtMono,   /* AL_MONO */
  25     SrcFmtStereo, /* AL_STEREO */
  26     SrcFmtRear,   /* AL_REAR */
  27     SrcFmtQuad,   /* AL_QUAD */
  28     SrcFmtX51,    /* AL_5POINT1 (WFX order) */
  29     SrcFmtX61,    /* AL_6POINT1 (WFX order) */
  30     SrcFmtX71,    /* AL_7POINT1 (WFX order) */
  31 };
  32
  33 void DecomposeInputFormat(ALenum format, enum SrcFmtChannels *chans,
  34                           enum SrcFmtType *type);
  35 ALuint BytesFromSrcFmt(enum SrcFmtType type);
  36 ALuint ChannelsFromSrcFmt(enum SrcFmtChannels chans);
  37 static __inline ALuint FrameSizeFromSrcFmt(enum SrcFmtChannels chans,
  38                                            enum SrcFmtType type)
  39 {
  40     return ChannelsFromSrcFmt(chans) * BytesFromSrcFmt(type);
  41 }
  42
  43
  44 /* Storable formats */
  45 enum FmtType {
  46     FmtUByte,
  47     FmtShort,
  48     FmtFloat,
  49 };
  50 enum FmtChannels {
  51     FmtMono,
  52     FmtStereo,
  53     FmtRear,
  54     FmtQuad,
  55     FmtX51,
  56     FmtX61,
  57     FmtX71,
  58 };
  59
  60 void DecomposeFormat(ALenum format, enum FmtChannels *chans, enum FmtType *type);
  61 ALuint BytesFromFmt(enum FmtType type);
  62 ALuint ChannelsFromFmt(enum FmtChannels chans);
  63 static __inline ALuint FrameSizeFromFmt(enum FmtChannels chans, enum FmtType type)
  64 {
  65     return ChannelsFromFmt(chans) * BytesFromFmt(type);
  66 }
  67
  68
  69 typedef struct ALbuffer
  70 {
  71     ALvoid  *data;
  72     ALsizei  size;
  73
  74     ALsizei          Frequency;
  75     enum FmtChannels FmtChannels;
  76     enum FmtType     FmtType;
  77
  78     enum SrcFmtChannels OriginalChannels;
  79     enum SrcFmtType     OriginalType;
  80     ALsizei OriginalSize;
  81     ALsizei OriginalAlign;
  82
  83     ALsizei  LoopStart;
  84     ALsizei  LoopEnd;
  85
  86     ALuint   refcount; // Number of sources using this buffer (deletion can only occur when this is 0)
  87
  88     // Index to itself
  89     ALuint buffer;
  90 } ALbuffer;
  91
  92 ALvoid ReleaseALBuffers(ALCdevice *device);
  93
  94 #ifdef __cplusplus
  95 }
  96 #endif
  97
  98 #endif