2007-11-13 18:02:18 -08:00
|
|
|
#ifndef _AL_BUFFER_H_
|
|
|
|
#define _AL_BUFFER_H_
|
|
|
|
|
2018-01-26 21:32:43 -08:00
|
|
|
#include "AL/alc.h"
|
|
|
|
#include "AL/al.h"
|
|
|
|
#include "AL/alext.h"
|
|
|
|
|
|
|
|
#include "inprogext.h"
|
|
|
|
#include "atomic.h"
|
2018-11-24 10:07:48 -08:00
|
|
|
#include "vector.h"
|
2007-11-13 18:02:18 -08:00
|
|
|
|
|
|
|
|
2011-05-05 22:36:26 -07:00
|
|
|
/* User formats */
|
2010-12-03 22:33:41 -08:00
|
|
|
enum UserFmtType {
|
2018-01-21 17:19:57 -08:00
|
|
|
UserFmtUByte,
|
|
|
|
UserFmtShort,
|
|
|
|
UserFmtFloat,
|
|
|
|
UserFmtDouble,
|
|
|
|
UserFmtMulaw,
|
2018-01-19 19:28:23 -08:00
|
|
|
UserFmtAlaw,
|
2012-01-10 00:58:07 -08:00
|
|
|
UserFmtIMA4,
|
2014-03-04 22:44:30 -08:00
|
|
|
UserFmtMSADPCM,
|
2010-11-27 15:33:33 -08:00
|
|
|
};
|
2010-12-03 22:33:41 -08:00
|
|
|
enum UserFmtChannels {
|
2018-01-21 17:19:57 -08:00
|
|
|
UserFmtMono,
|
|
|
|
UserFmtStereo,
|
|
|
|
UserFmtRear,
|
|
|
|
UserFmtQuad,
|
|
|
|
UserFmtX51, /* (WFX order) */
|
|
|
|
UserFmtX61, /* (WFX order) */
|
|
|
|
UserFmtX71, /* (WFX order) */
|
|
|
|
UserFmtBFormat2D, /* WXY */
|
2018-01-19 19:28:23 -08:00
|
|
|
UserFmtBFormat3D, /* WXYZ */
|
2010-11-27 15:33:33 -08:00
|
|
|
};
|
|
|
|
|
2017-01-18 07:13:23 -08:00
|
|
|
ALsizei BytesFromUserFmt(enum UserFmtType type);
|
|
|
|
ALsizei ChannelsFromUserFmt(enum UserFmtChannels chans);
|
|
|
|
inline ALsizei FrameSizeFromUserFmt(enum UserFmtChannels chans, enum UserFmtType type)
|
2010-11-28 12:53:35 -08:00
|
|
|
{
|
2010-12-03 22:33:41 -08:00
|
|
|
return ChannelsFromUserFmt(chans) * BytesFromUserFmt(type);
|
2010-11-28 12:53:35 -08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
2010-11-27 15:33:33 -08:00
|
|
|
/* Storable formats */
|
2010-11-26 23:42:30 -08:00
|
|
|
enum FmtType {
|
2018-01-21 18:34:03 -08:00
|
|
|
FmtUByte = UserFmtUByte,
|
|
|
|
FmtShort = UserFmtShort,
|
|
|
|
FmtFloat = UserFmtFloat,
|
|
|
|
FmtDouble = UserFmtDouble,
|
|
|
|
FmtMulaw = UserFmtMulaw,
|
|
|
|
FmtAlaw = UserFmtAlaw,
|
2010-11-26 23:42:30 -08:00
|
|
|
};
|
|
|
|
enum FmtChannels {
|
2011-03-16 05:47:07 -07:00
|
|
|
FmtMono = UserFmtMono,
|
2010-12-03 22:33:41 -08:00
|
|
|
FmtStereo = UserFmtStereo,
|
2011-03-16 05:47:07 -07:00
|
|
|
FmtRear = UserFmtRear,
|
|
|
|
FmtQuad = UserFmtQuad,
|
|
|
|
FmtX51 = UserFmtX51,
|
|
|
|
FmtX61 = UserFmtX61,
|
|
|
|
FmtX71 = UserFmtX71,
|
2014-10-31 17:18:45 -07:00
|
|
|
FmtBFormat2D = UserFmtBFormat2D,
|
|
|
|
FmtBFormat3D = UserFmtBFormat3D,
|
2010-11-26 23:42:30 -08:00
|
|
|
};
|
2013-07-23 00:13:15 -07:00
|
|
|
#define MAX_INPUT_CHANNELS (8)
|
2010-11-26 23:42:30 -08:00
|
|
|
|
2018-11-20 02:42:49 -08:00
|
|
|
/* DevFmtType traits, providing the type, etc given a DevFmtType. */
|
|
|
|
template<FmtType T>
|
|
|
|
struct FmtTypeTraits { };
|
|
|
|
|
|
|
|
template<>
|
|
|
|
struct FmtTypeTraits<FmtUByte> { using Type = ALubyte; };
|
|
|
|
template<>
|
|
|
|
struct FmtTypeTraits<FmtShort> { using Type = ALshort; };
|
|
|
|
template<>
|
|
|
|
struct FmtTypeTraits<FmtFloat> { using Type = ALfloat; };
|
|
|
|
template<>
|
|
|
|
struct FmtTypeTraits<FmtDouble> { using Type = ALdouble; };
|
|
|
|
template<>
|
|
|
|
struct FmtTypeTraits<FmtMulaw> { using Type = ALubyte; };
|
|
|
|
template<>
|
|
|
|
struct FmtTypeTraits<FmtAlaw> { using Type = ALubyte; };
|
|
|
|
|
|
|
|
|
2017-01-18 07:13:23 -08:00
|
|
|
ALsizei BytesFromFmt(enum FmtType type);
|
|
|
|
ALsizei ChannelsFromFmt(enum FmtChannels chans);
|
|
|
|
inline ALsizei FrameSizeFromFmt(enum FmtChannels chans, enum FmtType type)
|
2010-11-28 12:53:35 -08:00
|
|
|
{
|
2010-11-29 19:48:18 -08:00
|
|
|
return ChannelsFromFmt(chans) * BytesFromFmt(type);
|
2010-11-28 12:53:35 -08:00
|
|
|
}
|
|
|
|
|
2010-11-26 23:42:30 -08:00
|
|
|
|
2018-11-24 10:07:48 -08:00
|
|
|
struct ALbuffer {
|
|
|
|
al::vector<ALbyte,16> mData;
|
2009-10-22 08:53:59 -07:00
|
|
|
|
2018-11-24 10:07:48 -08:00
|
|
|
ALsizei Frequency{0};
|
|
|
|
ALbitfieldSOFT Access{0u};
|
|
|
|
ALsizei SampleLen{0};
|
2011-10-03 10:07:50 -07:00
|
|
|
|
2018-11-24 10:07:48 -08:00
|
|
|
enum FmtChannels FmtChannels{};
|
|
|
|
enum FmtType FmtType{};
|
|
|
|
ALsizei BytesAlloc{0};
|
2009-10-22 08:53:59 -07:00
|
|
|
|
2018-11-24 10:07:48 -08:00
|
|
|
enum UserFmtType OriginalType{};
|
|
|
|
ALsizei OriginalSize{0};
|
|
|
|
ALsizei OriginalAlign{0};
|
2010-05-12 01:36:09 -07:00
|
|
|
|
2018-11-24 10:07:48 -08:00
|
|
|
ALsizei LoopStart{0};
|
|
|
|
ALsizei LoopEnd{0};
|
2010-05-13 02:03:48 -07:00
|
|
|
|
2018-11-24 10:07:48 -08:00
|
|
|
std::atomic<ALsizei> UnpackAlign{0};
|
|
|
|
std::atomic<ALsizei> PackAlign{0};
|
Add an extension to alter the block alignment for buffer unpack/pack ops
This is for unpacking (reading, e.g. alBufferData) and packing (writing, e.g.
alGetBufferSamplesSOFT) operations. The alignments are specified in sample
frames, with 0 meaning the default (65 for IMA4, 1 otherwise). IMA4 alignment
must be a multiple of 8, plus 1 (e.g. alignment = n*8 + 1), otherwise an error
will occur during (un)packing. Chenging the block alignment does not affect
already-loaded sample data, only future unpack/pack operations... so for
example, this is perfectly valid:
// Load mono IMA4 data with a block alignment of 1024 bytes, or 2041 sample
// frames.
alBufferi(buffer, AL_UNPACK_BLOCK_ALIGNMENT_SOFT, 2041);
alBufferData(buffer, AL_FORMAT_MONO_IMA4, data, data_len, srate);
alBufferi(buffer, AL_UNPACK_BLOCK_ALIGNMENT_SOFT, 0);
2014-03-04 05:16:45 -08:00
|
|
|
|
2018-11-24 10:07:48 -08:00
|
|
|
ALbitfieldSOFT MappedAccess{0u};
|
|
|
|
ALsizei MappedOffset{0};
|
|
|
|
ALsizei MappedSize{0};
|
2018-01-20 11:49:01 -08:00
|
|
|
|
2012-04-19 22:14:02 -07:00
|
|
|
/* Number of times buffer was attached to a source (deletion can only occur when 0) */
|
2018-11-24 10:07:48 -08:00
|
|
|
RefCount ref{0u};
|
2009-10-22 08:53:59 -07:00
|
|
|
|
2012-04-19 22:14:02 -07:00
|
|
|
/* Self ID */
|
2018-11-24 10:07:48 -08:00
|
|
|
ALuint id{0};
|
|
|
|
};
|
2007-11-13 18:02:18 -08:00
|
|
|
|
|
|
|
#endif
|