aboutsummaryrefslogtreecommitdiffstats
path: root/OpenAL32/Include/alBuffer.h
blob: e22d839d5fa072477d00806ab438258c667da2bd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
#ifndef _AL_BUFFER_H_
#define _AL_BUFFER_H_

#include "AL/al.h"

#ifdef __cplusplus
extern "C" {
#endif

/* Input formats (some are currently theoretical) */
enum UserFmtType {
    UserFmtByte,   /* AL_BYTE */
    UserFmtUByte,  /* AL_UNSIGNED_BYTE */
    UserFmtShort,  /* AL_SHORT */
    UserFmtUShort, /* AL_UNSIGNED_SHORT */
    UserFmtInt,    /* AL_INT */
    UserFmtUInt,   /* AL_UNSIGNED_INT */
    UserFmtFloat,  /* AL_FLOAT */
    UserFmtDouble, /* AL_DOUBLE */
    UserFmtMulaw,  /* AL_MULAW */
    UserFmtIMA4,   /* AL_IMA4 */
};
enum UserFmtChannels {
    UserFmtMono,   /* AL_MONO */
    UserFmtStereo, /* AL_STEREO */
    UserFmtRear,   /* AL_REAR */
    UserFmtQuad,   /* AL_QUAD */
    UserFmtX51,    /* AL_5POINT1 (WFX order) */
    UserFmtX61,    /* AL_6POINT1 (WFX order) */
    UserFmtX71,    /* AL_7POINT1 (WFX order) */
};

ALboolean DecomposeUserFormat(ALenum format, enum UserFmtChannels *chans,
                              enum UserFmtType *type);
ALuint BytesFromUserFmt(enum UserFmtType type);
ALuint ChannelsFromUserFmt(enum UserFmtChannels chans);
static __inline ALuint FrameSizeFromUserFmt(enum UserFmtChannels chans,
                                            enum UserFmtType type)
{
    return ChannelsFromUserFmt(chans) * BytesFromUserFmt(type);
}


/* Storable formats */
enum FmtType {
    FmtUByte = UserFmtUByte,
    FmtShort = UserFmtShort,
    FmtFloat = UserFmtFloat,
};
enum FmtChannels {
    FmtMono = UserFmtMono,
    FmtStereo = UserFmtStereo,
    FmtRear = UserFmtRear,
    FmtQuad = UserFmtQuad,
    FmtX51 = UserFmtX51,
    FmtX61 = UserFmtX61,
    FmtX71 = UserFmtX71,
};

ALboolean DecomposeFormat(ALenum format, enum FmtChannels *chans, enum FmtType *type);
ALuint BytesFromFmt(enum FmtType type);
ALuint ChannelsFromFmt(enum FmtChannels chans);
static __inline ALuint FrameSizeFromFmt(enum FmtChannels chans, enum FmtType type)
{
    return ChannelsFromFmt(chans) * BytesFromFmt(type);
}


typedef struct ALbuffer
{
    ALvoid  *data;
    ALsizei  size;

    ALsizei          Frequency;
    enum FmtChannels FmtChannels;
    enum FmtType     FmtType;

    enum UserFmtChannels OriginalChannels;
    enum UserFmtType     OriginalType;
    ALsizei OriginalSize;
    ALsizei OriginalAlign;

    ALsizei  LoopStart;
    ALsizei  LoopEnd;

    ALuint   refcount; // Number of sources using this buffer (deletion can only occur when this is 0)

    // Index to itself
    ALuint buffer;
} ALbuffer;

ALvoid ReleaseALBuffers(ALCdevice *device);

#ifdef __cplusplus
}
#endif

#endif