2 * libmad - MPEG audio decoder library
3 * Copyright (C) 2000-2004 Underbit Technologies, Inc.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19 * $Id: stream.c,v 1.12 2004/02/05 09:02:39 rob Exp $
34 * NAME: stream->init()
35 * DESCRIPTION: initialize stream struct
37 void mad_stream_init(struct mad_stream *stream)
46 stream->this_frame = 0;
47 stream->next_frame = 0;
48 mad_bit_init(&stream->ptr, 0);
50 mad_bit_init(&stream->anc_ptr, 0);
51 stream->anc_bitlen = 0;
53 stream->main_data = 0;
57 stream->error = MAD_ERROR_NONE;
61 * NAME: stream->finish()
62 * DESCRIPTION: deallocate any dynamic memory associated with stream
64 void mad_stream_finish(struct mad_stream *stream)
66 if (stream->main_data) {
67 free(stream->main_data);
68 stream->main_data = 0;
71 mad_bit_finish(&stream->anc_ptr);
72 mad_bit_finish(&stream->ptr);
76 * NAME: stream->buffer()
77 * DESCRIPTION: set stream buffer pointers
79 void mad_stream_buffer(struct mad_stream *stream,
80 unsigned char const *buffer, unsigned long length)
82 stream->buffer = buffer;
83 stream->bufend = buffer + length;
85 stream->this_frame = buffer;
86 stream->next_frame = buffer;
90 mad_bit_init(&stream->ptr, buffer);
94 * NAME: stream->skip()
95 * DESCRIPTION: arrange to skip bytes before the next frame
97 void mad_stream_skip(struct mad_stream *stream, unsigned long length)
99 stream->skiplen += length;
103 * NAME: stream->sync()
104 * DESCRIPTION: locate the next stream sync word
106 int mad_stream_sync(struct mad_stream *stream)
108 register unsigned char const *ptr, *end;
110 ptr = mad_bit_nextbyte(&stream->ptr);
111 end = stream->bufend;
113 while (ptr < end - 1 &&
114 !(ptr[0] == 0xff && (ptr[1] & 0xe0) == 0xe0))
117 if (end - ptr < MAD_BUFFER_GUARD)
120 mad_bit_init(&stream->ptr, ptr);
126 * NAME: stream->errorstr()
127 * DESCRIPTION: return a string description of the current error condition
129 char const *mad_stream_errorstr(struct mad_stream const *stream)
131 switch (stream->error) {
132 case MAD_ERROR_NONE: return "no error";
134 case MAD_ERROR_BUFLEN: return "input buffer too small (or EOF)";
135 case MAD_ERROR_BUFPTR: return "invalid (null) buffer pointer";
137 case MAD_ERROR_NOMEM: return "not enough memory";
139 case MAD_ERROR_LOSTSYNC: return "lost synchronization";
140 case MAD_ERROR_BADLAYER: return "reserved header layer value";
141 case MAD_ERROR_BADBITRATE: return "forbidden bitrate value";
142 case MAD_ERROR_BADSAMPLERATE: return "reserved sample frequency value";
143 case MAD_ERROR_BADEMPHASIS: return "reserved emphasis value";
145 case MAD_ERROR_BADCRC: return "CRC check failed";
146 case MAD_ERROR_BADBITALLOC: return "forbidden bit allocation value";
147 case MAD_ERROR_BADSCALEFACTOR: return "bad scalefactor index";
148 case MAD_ERROR_BADMODE: return "bad bitrate/mode combination";
149 case MAD_ERROR_BADFRAMELEN: return "bad frame length";
150 case MAD_ERROR_BADBIGVALUES: return "bad big_values count";
151 case MAD_ERROR_BADBLOCKTYPE: return "reserved block_type";
152 case MAD_ERROR_BADSCFSI: return "bad scalefactor selection info";
153 case MAD_ERROR_BADDATAPTR: return "bad main_data_begin pointer";
154 case MAD_ERROR_BADPART3LEN: return "bad audio data length";
155 case MAD_ERROR_BADHUFFTABLE: return "bad Huffman table select";
156 case MAD_ERROR_BADHUFFDATA: return "Huffman data overrun";
157 case MAD_ERROR_BADSTEREO: return "incompatible block_type for JS";