1 /***************************************************************************
3 * Open \______ \ ____ ____ | | _\_ |__ _______ ___
4 * Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
5 * Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
6 * Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
10 * Copyright (C) 2009 Yoshihisa Uchida
12 * This program is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU General Public License
14 * as published by the Free Software Foundation; either version 2
15 * of the License, or (at your option) any later version.
17 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
18 * KIND, either express or implied.
20 ****************************************************************************/
21 #ifndef CODEC_LIBPCM_PCM_COMMON_H
22 #define CODEC_LIBPCM_PCM_COMMON_H
24 #include <sys/types.h>
28 /* decoded pcm sample depth */
29 #define PCM_OUTPUT_DEPTH 28
31 /* Macro that sign extends an unsigned byte */
32 #define SE(x) ((int32_t)((int8_t)(x)))
34 /* Macro that shift to -0x80. (0 .. 127 to -128 .. -1, 128 .. 255 to 0 .. 127) */
35 #define SFT(x) ((int32_t)x-0x80)
37 /* Macro that clipping data */
38 #define CLIP(data, min, max) \
39 if ((data) > (max)) data = max; \
40 else if ((data) < (min)) data = min;
42 /* nums of msadpcm coeffs
43 * In many case, nNumCoef is 7.
44 * Depending upon the encoder, as for this value there is a possibility
46 * If you found the file where this value exceeds 7, please report.
48 #define MSADPCM_NUM_COEFF 7
52 * RIFF: wFormatTag (in 'fmt ' chunk)
53 * AIFF: compressionType (in 'COMM' chunk)
58 * RIFF: wChannels (in 'fmt ' chunk)
59 * AIFF: numChannels (in 'COMM' chunk)
64 * RIFF: dwSamplesPerSec (in 'fmt ' chunk)
65 * AIFF: sampleRate (in 'COMM' chunk)
67 uint32_t samplespersec
;
69 /* RIFF: dwAvgBytesPerSec (in 'fmt ' chunk) */
70 uint32_t avgbytespersec
;
73 * RIFF: wBlockAlign (in 'fmt ' chunk)
74 * AIFF: blockSize (in 'SSND' chunk)
79 * RIFF: wBitsPerSample (in 'fmt ' chunk)
80 * AIFF: sampleSize (in 'COMM' chunk)
82 uint16_t bitspersample
;
84 /* RIFF: wSize (in 'fmt ' chunk) */
87 /* RIFF: dSamplesPerBlock (in 'fmt ' chunk) */
88 uint16_t samplesperblock
;
90 /* RIFF: wTotalSamples (in 'fact' chunk) */
91 uint16_t totalsamples
;
93 /* the following values are not RIFF/AIFF chunk values */
95 /* bytes per sample */
106 * true: little endian, false: big endian
108 bool is_little_endian
;
112 * true: signed, false: unsigned
116 /* the following values are format speciffic parameters */
118 /* microsoft adpcm: aCoeff */
119 int16_t coeffs
[MSADPCM_NUM_COEFF
][2];
129 * sets the format speciffic RIFF/AIFF header information and checks the pcm_format.
132 * the structure which supplies RIFF/AIFF header information.
135 * true: RIFF/AIFF header check OK
136 * false: RIFF/AIFF header check NG
138 bool (*set_format
)(struct pcm_format
*format
);
147 * the function which reads the data from the file (chunksize bytes read).
150 * position after the seeking.
152 struct pcm_pos
*(*get_seek_pos
)(long seek_time
,
153 uint8_t *(*read_buffer
)(size_t *realsize
));
159 * the start pointer of wave data buffer.
162 * wave data buffer size (bytes).
165 * the start pointer of the buffer which supplies decoded pcm data.
168 * decoded pcm data count.
171 * CODEC_OK: decode succeed.
172 * CODEC_ERROR: decode failure.
174 int (*decode
)(const uint8_t *inbuf
, size_t inbufsize
,
175 int32_t *outbuf
, int *outbufcount
);
180 const struct pcm_codec
*(*get_codec
)(void);