3 demac - A Monkey's Audio decoder
7 Copyright (C) Dave Chapman 2007
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program; if not, write to the Free Software
21 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA
27 This example is intended to demonstrate how the decoder can be used in
28 embedded devices - there is no usage of dynamic memory (i.e. no
29 malloc/free) and small buffer sizes are chosen to minimise both the
30 memory usage and decoding latency.
32 This implementation requires the following memory and supports decoding of all APE files up to 24-bit Stereo.
34 32768 - data from the input stream to be presented to the decoder in one contiguous chunk.
35 18432 - decoding buffer (left channel)
36 18432 - decoding buffer (right channel)
38 17408+5120+2240 - buffers used for filter histories (compression levels 2000-5000)
40 In addition, this example uses a static 27648 byte buffer as temporary
41 storage for outputting the data to a WAV file but that could be
42 avoided by writing the decoded data one sample at a time.
63 #define BLOCKS_PER_LOOP 4608
64 #define MAX_CHANNELS 2
65 #define MAX_BYTESPERSAMPLE 3
67 #define INPUT_CHUNKSIZE (32*1024)
70 #define MIN(a,b) ((a) < (b) ? (a) : (b))
74 /* 4608*2*3 = 27648 bytes */
75 static unsigned char wavbuffer
[BLOCKS_PER_LOOP
*MAX_CHANNELS
*MAX_BYTESPERSAMPLE
];
77 /* 4608*4 = 18432 bytes per channel */
78 static int32_t decoded0
[BLOCKS_PER_LOOP
];
79 static int32_t decoded1
[BLOCKS_PER_LOOP
];
81 /* We assume that 32KB of compressed data is enough to extract up to
82 27648 bytes of decompressed data. */
84 static unsigned char inbuffer
[INPUT_CHUNKSIZE
];
86 int ape_decode(char* infile
, char* outfile
)
93 struct ape_ctx_t ape_ctx
;
105 fd
= open(infile
,O_RDONLY
|O_BINARY
);
106 if (fd
< 0) return -1;
108 /* Read the file headers to populate the ape_ctx struct */
109 if (ape_parseheader(fd
,&ape_ctx
) < 0) {
110 printf("Cannot read header\n");
115 if ((ape_ctx
.fileversion
< APE_MIN_VERSION
) || (ape_ctx
.fileversion
> APE_MAX_VERSION
)) {
116 printf("Unsupported file version - %.2f\n", ape_ctx
.fileversion
/1000.0);
121 //ape_dumpinfo(&ape_ctx);
123 printf("Decoding file - v%.2f, compression level %d\n",ape_ctx
.fileversion
/1000.0,ape_ctx
.compressiontype
);
125 /* Open the WAV file and write a canonical 44-byte WAV header
126 based on the audio format information in the ape_ctx struct.
128 NOTE: This example doesn't write the original WAV header and
129 tail data which are (optionally) stored in the APE file.
131 fdwav
= open_wav(&ape_ctx
,outfile
);
135 /* Initialise the buffer */
136 lseek(fd
, ape_ctx
.firstframe
, SEEK_SET
);
137 bytesinbuffer
= read(fd
, inbuffer
, INPUT_CHUNKSIZE
);
138 firstbyte
= 3; /* Take account of the little-endian 32-bit byte ordering */
140 /* The main decoding loop - we decode the frames a small chunk at a time */
141 while (currentframe
< ape_ctx
.totalframes
)
143 /* Calculate how many blocks there are in this frame */
144 if (currentframe
== (ape_ctx
.totalframes
- 1))
145 nblocks
= ape_ctx
.finalframeblocks
;
147 nblocks
= ape_ctx
.blocksperframe
;
149 ape_ctx
.currentframeblocks
= nblocks
;
151 /* Initialise the frame decoder */
152 init_frame_decoder(&ape_ctx
, inbuffer
, &firstbyte
, &bytesconsumed
);
155 memmove(inbuffer
,inbuffer
+ bytesconsumed
, bytesinbuffer
- bytesconsumed
);
156 bytesinbuffer
-= bytesconsumed
;
158 n
= read(fd
, inbuffer
+ bytesinbuffer
, INPUT_CHUNKSIZE
- bytesinbuffer
);
162 frame_crc
= ape_initcrc();
165 /* Decode the frame a chunk at a time */
168 blockstodecode
= MIN(BLOCKS_PER_LOOP
, nblocks
);
170 if ((res
= decode_chunk(&ape_ctx
, inbuffer
, &firstbyte
,
173 blockstodecode
)) < 0)
175 /* Frame decoding error, abort */
180 /* Convert the output samples to WAV format and write to output file */
182 if (ape_ctx
.bps
== 8) {
183 for (i
= 0 ; i
< blockstodecode
; i
++)
185 /* 8 bit WAV uses unsigned samples */
186 *(p
++) = (decoded0
[i
] + 0x80) & 0xff;
188 if (ape_ctx
.channels
== 2) {
189 *(p
++) = (decoded1
[i
] + 0x80) & 0xff;
192 } else if (ape_ctx
.bps
== 16) {
193 for (i
= 0 ; i
< blockstodecode
; i
++)
195 sample16
= decoded0
[i
];
196 *(p
++) = sample16
& 0xff;
197 *(p
++) = (sample16
>> 8) & 0xff;
199 if (ape_ctx
.channels
== 2) {
200 sample16
= decoded1
[i
];
201 *(p
++) = sample16
& 0xff;
202 *(p
++) = (sample16
>> 8) & 0xff;
205 } else if (ape_ctx
.bps
== 24) {
206 for (i
= 0 ; i
< blockstodecode
; i
++)
208 sample32
= decoded0
[i
];
209 *(p
++) = sample32
& 0xff;
210 *(p
++) = (sample32
>> 8) & 0xff;
211 *(p
++) = (sample32
>> 16) & 0xff;
213 if (ape_ctx
.channels
== 2) {
214 sample32
= decoded1
[i
];
215 *(p
++) = sample32
& 0xff;
216 *(p
++) = (sample32
>> 8) & 0xff;
217 *(p
++) = (sample32
>> 16) & 0xff;
223 frame_crc
= ape_updatecrc(wavbuffer
, p
- wavbuffer
, frame_crc
);
225 write(fdwav
,wavbuffer
,p
- wavbuffer
);
227 /* Update the buffer */
228 memmove(inbuffer
,inbuffer
+ bytesconsumed
, bytesinbuffer
- bytesconsumed
);
229 bytesinbuffer
-= bytesconsumed
;
231 n
= read(fd
, inbuffer
+ bytesinbuffer
, INPUT_CHUNKSIZE
- bytesinbuffer
);
234 /* Decrement the block count */
235 nblocks
-= blockstodecode
;
239 frame_crc
= ape_finishcrc(frame_crc
);
241 if (ape_ctx
.CRC
!= frame_crc
)
243 fprintf(stderr
,"CRC error in frame %d\n",currentframe
);
260 int main(int argc
, char* argv
[])
265 fprintf(stderr
,"Usage: demac infile.ape outfile.wav\n");
269 res
= ape_decode(argv
[1], argv
[2]);
273 fprintf(stderr
,"DECODING ERROR %d, ABORTING\n", res
);
277 fprintf(stderr
,"DECODED OK - NO CRC ERRORS.\n");