ReactOS  0.4.12-dev-75-g00dd17e
mpg123 PCM sample encodings

Classes

struct  mpg123_fmt
 

Macros

#define MPG123_SAMPLESIZE(enc)
 

Enumerations

enum  mpg123_enc_enum {
  MPG123_ENC_8 = 0x00f, MPG123_ENC_16 = 0x040, MPG123_ENC_24 = 0x4000, MPG123_ENC_32 = 0x100,
  MPG123_ENC_SIGNED = 0x080, MPG123_ENC_FLOAT = 0xe00, MPG123_ENC_SIGNED_16 = (MPG123_ENC_16|MPG123_ENC_SIGNED|0x10), MPG123_ENC_UNSIGNED_16 = (MPG123_ENC_16|0x20),
  MPG123_ENC_UNSIGNED_8 = 0x01, MPG123_ENC_SIGNED_8 = (MPG123_ENC_SIGNED|0x02), MPG123_ENC_ULAW_8 = 0x04, MPG123_ENC_ALAW_8 = 0x08,
  MPG123_ENC_SIGNED_32 = MPG123_ENC_32|MPG123_ENC_SIGNED|0x1000, MPG123_ENC_UNSIGNED_32 = MPG123_ENC_32|0x2000, MPG123_ENC_SIGNED_24 = MPG123_ENC_24|MPG123_ENC_SIGNED|0x1000, MPG123_ENC_UNSIGNED_24 = MPG123_ENC_24|0x2000,
  MPG123_ENC_FLOAT_32 = 0x200, MPG123_ENC_FLOAT_64 = 0x400, MPG123_ENC_ANY
}
 

Detailed Description

These are definitions for audio formats used by libmpg123 and libout123.

Macro Definition Documentation

◆ MPG123_SAMPLESIZE

#define MPG123_SAMPLESIZE (   enc)
Value:
( \
(enc) & MPG123_ENC_8 \
? 1 \
: ( (enc) & MPG123_ENC_16 \
? 2 \
: ( (enc) & MPG123_ENC_24 \
? 3 \
: ( ( (enc) & MPG123_ENC_32 \
|| (enc) == MPG123_ENC_FLOAT_32 ) \
? 4 \
: ( (enc) == MPG123_ENC_FLOAT_64 \
? 8 \
: 0 \
) ) ) ) )

Get size of one PCM sample with given encoding. This is included both in libmpg123 and libout123. Both offer an API function to provide the macro results from library compile-time, not that of you application. This most likely does not matter as I do not expect any fresh PCM sample encoding to appear. But who knows? Perhaps the encoding type will be abused for funny things in future, not even plain PCM. And, by the way: Thomas really likes the ?: operator.

Parameters
encthe encoding (mpg123_enc_enum value)
Returns
size of one sample in bytes

Definition at line 101 of file fmt123.h.

Referenced by mpg123_encsize().

Enumeration Type Documentation

◆ mpg123_enc_enum

An enum over all sample types possibly known to mpg123. The values are designed as bit flags to allow bitmasking for encoding families. This is also why the enum is not used as type for actual encoding variables, plain integers (at least 16 bit, 15 bit being used) cover the possible combinations of these flags.

Note that (your build of) libmpg123 does not necessarily support all these. Usually, you can expect the 8bit encodings and signed 16 bit. Also 32bit float will be usual beginning with mpg123-1.7.0 . What you should bear in mind is that (SSE, etc) optimized routines may be absent for some formats. We do have SSE for 16, 32 bit and float, though. 24 bit integer is done via postprocessing of 32 bit output – just cutting the last byte, no rounding, even. If you want better, do it yourself.

All formats are in native byte order. If you need different endinaness, you can simply postprocess the output buffers (libmpg123 wouldn't do anything else). The macro MPG123_SAMPLESIZE() can be helpful there.

Enumerator
MPG123_ENC_8 
MPG123_ENC_16 
MPG123_ENC_24 
MPG123_ENC_32 
MPG123_ENC_SIGNED 
MPG123_ENC_FLOAT 
MPG123_ENC_SIGNED_16 
MPG123_ENC_UNSIGNED_16 
MPG123_ENC_UNSIGNED_8 
MPG123_ENC_SIGNED_8 
MPG123_ENC_ULAW_8 
MPG123_ENC_ALAW_8 
MPG123_ENC_SIGNED_32 
MPG123_ENC_UNSIGNED_32 
MPG123_ENC_SIGNED_24 
MPG123_ENC_UNSIGNED_24 
MPG123_ENC_FLOAT_32 
MPG123_ENC_FLOAT_64 
MPG123_ENC_ANY 

Definition at line 43 of file fmt123.h.

44 {
45 /* 0000 0000 0000 1111 Some 8 bit integer encoding. */
46  MPG123_ENC_8 = 0x00f
47 /* 0000 0000 0100 0000 Some 16 bit integer encoding. */
48 , MPG123_ENC_16 = 0x040
49 /* 0100 0000 0000 0000 Some 24 bit integer encoding. */
50 , MPG123_ENC_24 = 0x4000
51 /* 0000 0001 0000 0000 Some 32 bit integer encoding. */
52 , MPG123_ENC_32 = 0x100
53 /* 0000 0000 1000 0000 Some signed integer encoding. */
54 , MPG123_ENC_SIGNED = 0x080
55 /* 0000 1110 0000 0000 Some float encoding. */
56 , MPG123_ENC_FLOAT = 0xe00
57 /* 0000 0000 1101 0000 signed 16 bit */
59 /* 0000 0000 0110 0000 unsigned 16 bit */
61 /* 0000 0000 0000 0001 unsigned 8 bit */
62 , MPG123_ENC_UNSIGNED_8 = 0x01
63 /* 0000 0000 1000 0010 signed 8 bit */
65 /* 0000 0000 0000 0100 ulaw 8 bit */
66 , MPG123_ENC_ULAW_8 = 0x04
67 /* 0000 0000 0000 1000 alaw 8 bit */
68 , MPG123_ENC_ALAW_8 = 0x08
69 /* 0001 0001 1000 0000 signed 32 bit */
71 /* 0010 0001 0000 0000 unsigned 32 bit */
73 /* 0101 0000 1000 0000 signed 24 bit */
75 /* 0110 0000 0000 0000 unsigned 24 bit */
77 /* 0000 0010 0000 0000 32bit float */
78 , MPG123_ENC_FLOAT_32 = 0x200
79 /* 0000 0100 0000 0000 64bit float */
80 , MPG123_ENC_FLOAT_64 = 0x400
81 /* Any possibly known encoding from the list above. */
88 };