Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / flac / 63ee53d94d0965a901b0e4eda1a642708ec7041e / . / doc / html / changelog.html
blob: b3d501e526ccfdae126040bbc910b1e83001729f [file] [log] [blame]
Josh Coalson71ed9692004-07-23 05:08:01 +0000[diff] [blame]1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<!-- Copyright (c) 2004 Josh Coalson -->
3<!-- Permission is granted to copy, distribute and/or modify this document -->
4<!-- under the terms of the GNU Free Documentation License, Version 1.1 -->
5<!-- or any later version published by the Free Software Foundation; -->
6<!-- with no invariant sections. -->
7<!-- A copy of the license can be found at http://www.gnu.org/copyleft/fdl.html -->
8<HTML>
9<HEAD>
10 <TITLE>FLAC - changelog</TITLE>
11</HEAD>
12
13<BODY MARGINWIDTH="0" MARGINHEIGHT="0" LEFTMARGIN="0" RIGHTMARGIN="0" TOPMARGIN="0" BGCOLOR="#99CC99" TEXT="#000000" LINK="#336699" VLINK="#336699" ALINK="#336699">
14
15<TABLE BORDER=0 WIDTH="100%" CELLPADDING=1 CELLSPACING=0>
16 <TR>
17 <TD ALIGN="CENTER" BGCOLOR="#000000"><A HREF="http://flac.sourceforge.net/"><IMG SRC="images/logo130.gif" ALIGN=CENTER ALT="FLAC Logo" BORDER=0 HSPACE=0></a></TD>
18 </TR>
19</TABLE>
20
21<TABLE WIDTH="100%" CELLPADDING="0" CELLSPACING="0" BORDER="0"><TR BGCOLOR="#99CC99"><TD><IMG SRC="images/1x1.gif" WIDTH="1" HEIGHT="25" ALT=""></TD></TR></TABLE>
22
23<TABLE WIDTH="100%" CELLPADDING="0" CELLSPACING="0" BORDER="0"><TR BGCOLOR="#000000"><TD><IMG SRC="images/1x1.gif" WIDTH="1" HEIGHT="2" ALT=""></TD></TR></TABLE>
24
25<TABLE WIDTH="100%" CELLPADDING=0 CELLSPACING=0 BORDER=0>
26 <TR>
27 <TD ALIGN="CENTER" BGCOLOR="#D3D4C5">
28 <TABLE CELLPADDING=0 CELLSPACING=0 BORDER=0>
29 <TR>
30 <TD HEIGHT=22 BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;<A CLASS="topnav" HREF="index.html">home</A>&nbsp;&nbsp;</TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
31 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;<A CLASS="topnav" HREF="faq.html">faq</A>&nbsp;&nbsp;</TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
32 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;<A CLASS="topnav" HREF="news.html">news</A>&nbsp;&nbsp;</TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
33 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;<A CLASS="topnav" HREF="download.html">download</A>&nbsp;&nbsp;</TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
34 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;<A CLASS="topnav" HREF="features.html">features</A>&nbsp;&nbsp;</TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
35 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;<A CLASS="topnav" HREF="goals.html">goals</A>&nbsp;&nbsp;</TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
36 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;<A CLASS="topnav" HREF="format.html">format</A>&nbsp;&nbsp;</TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
37 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;<A CLASS="topnav" HREF="id.html">id</A>&nbsp;&nbsp;</TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
38 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;<A CLASS="topnav" HREF="comparison.html">comparison</A>&nbsp;&nbsp;</TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
39 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;<A CLASS="topnav" HREF="documentation.html">documentation</A>&nbsp;&nbsp;</TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
40 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;<A CLASS="topnav" HREF="developers.html">developers</A>&nbsp;&nbsp;</TD>
41 </TR>
42 </TABLE>
43 </TD>
44 </TR>
45</TABLE>
46
47<TABLE WIDTH="100%" CELLPADDING="0" CELLSPACING="0" BORDER="0"><TR BGCOLOR="#000000"><TD><IMG SRC="images/1x1.gif" WIDTH="1" HEIGHT="2" ALT=""></TD></TR></TABLE>
48
49<TABLE WIDTH="100%" CELLPADDING=0 CELLSPACING=0 BORDER=0>
50 <TR>
51 <TD ALIGN="CENTER" BGCOLOR="#EEEED4">
52 <TABLE CELLPADDING=0 CELLSPACING=0 BORDER=0>
53 <TR>
54 <TD HEIGHT=22 BGCOLOR="#EEEED4" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;english&nbsp;&nbsp;</TD><TD BGCOLOR="#EEEED4" ALIGN=CENTER>|</TD>
55 <TD BGCOLOR="#EEEED4" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;<A CLASS="topnav" HREF="ru/changelog.html">russian</A>&nbsp;&nbsp;</TD>
56 </TR>
57 </TABLE>
58 </TD>
59 </TR>
60</TABLE>
61
62<TABLE WIDTH="100%" CELLPADDING="0" CELLSPACING="0" BORDER="0"><TR BGCOLOR="#000000"><TD><IMG SRC="images/1x1.gif" WIDTH="1" HEIGHT="2" ALT=""></TD></TR></TABLE>
63
64<CENTER>
65
66<TABLE WIDTH="100%" CELLPADDING="0" CELLSPACING="0" BORDER="0"><TR BGCOLOR="#99CC99"><TD><IMG SRC="images/1x1.gif" WIDTH="1" HEIGHT="15" ALT=""></TD></TR></TABLE>
67
68
69<TABLE WIDTH="100%" CELLPADDING="5" CELLSPACING="5" BORDER="0">
70<TR><TD>
71 <TABLE WIDTH="100%" CELLPADDING="0" CELLSPACING="0" BORDER="0"><TR BGCOLOR="#000000"><TD><IMG SRC="images/1x1.gif" WIDTH="1" HEIGHT="1" ALT=""></TD></TR></TABLE>
72 <TABLE CELLSPACING="0" CELLPADDING="3" WIDTH="100%" BORDER="0" BGCOLOR="#D3D4C5">
73 <TR><TD><FONT FACE="Lucida,Verdana,Helvetica,Arial">
74 <B><FONT SIZE="+2">changelog</FONT></B>
75 </FONT></TD></TR>
76 </TABLE>
77 <TABLE WIDTH="100%" CELLPADDING="0" CELLSPACING="0" BORDER="0"><TR BGCOLOR="#000000"><TD><IMG SRC="images/1x1.gif" WIDTH="1" HEIGHT="1" ALT=""></TD></TR></TABLE>
78 <TABLE CELLSPACING="0" CELLPADDING="3" WIDTH="100%" BORDER="0" BGCOLOR="#EEEED4">
79 <TR><TD><FONT FACE="Lucida,Verdana,Helvetica,Arial">
80
81 <P>
82 This is an informal changelog, a summary of changes in each release. Particulary important for developers is the precise description of changes to the library interfaces.
83 </P>
84
85 <P>
86 <A NAME="flac_1_1_1"><B>FLAC 1.1.1</B></A>
87 </P>
88 <P>
89 <UL>
90 <LI>
91 General:
92 <UL>
93 <LI>Ogg FLAC seeking now works</LI>
94 </UL>
95 </LI>
96 <LI>
97 FLAC format:
98 <UL>
99 <LI>Make invalid the metadata block type 127 so that audio frames can always be distinguished from metadata by seeing 0xff as the first byte.</LI>
100 </UL>
101 </LI>
102 <LI>
103 flac:
104 <UL>
105 <LI>Print an error when output file already exists instead of automatically overwriting.</LI>
106 <LI>New option <A HREF="documentation.html#flac_options_force"><TT>-f</TT> (<TT>--force</TT>)</A> to force overwriting if the output file already exists.</LI>
107 <LI>New option <A HREF="documentation.html#flac_options_cue"><TT>--cue</TT></A> to select a specific section to decode using cuesheet track/index points.</LI>
108 <LI>New option <A HREF="documentation.html#flac_options_totally_silent"><TT>--totally-silent</TT></A> to suppress all output.</LI>
109 <LI>New (but undocumented) option <TT>--apply-replaygain-which-is-not-lossless</TT> which applies ReplayGain to the decoded output. See <A HREF="http://www.hydrogenaudio.org/forums/index.php?showtopic=17293&st=11">this thread</A> for usage and caveats.</LI>
110 <LI>When encoding to Ogg FLAC, use a random serial number (instead of 0 as was done before) when a serial number is not specified.</LI>
111 <LI>When encoding multiple Ogg FLAC streams, <TT>--serial-number</TT> or random serial number sets the first number, which is then incremented for subsequent streams (before, the same serial number was used for all streams).</LI>
112 <LI>Decoder no longer exits with an error when writing to stdout and the pipe is broken.</LI>
113 <LI>Better explanation of common error messages.</LI>
114 <LI>Default extension when writing AIFF files is .aif (before, it was .aiff).</LI>
115 <LI>Write more common representation of SANE numbers in AIFF files.</LI>
116 <LI>Bug fix: calculating ReplayGain on 48kHz streams.</LI>
117 <LI>Bug fix: check for supported block alignments in WAVE files.</LI>
118 <LI>Bug fix: <A HREF="http://sourceforge.net/tracker/index.php?func=detail&aid=679166&group_id=13478&atid=113478">#679166</A>: flac doesn't respect RIFF subchunk padding byte.</LI>
119 <LI>Bug fix: <A HREF="http://sourceforge.net/tracker/index.php?func=detail&aid=828391&group_id=13478&atid=113478">#828391</A>: --add-replay-gain segfaults.</LI>
120 <LI>Bug fix: <A HREF="http://sourceforge.net/tracker/index.php?func=detail&aid=851155&group_id=13478&atid=113478">#851155</A>: Can't seek to position in flac file.</LI>
121 <LI>Bug fix: <A HREF="http://sourceforge.net/tracker/index.php?func=detail&aid=851756&group_id=13478&atid=113478">#851756</A>: flac --skip --until reads entire file.</LI>
122 <LI>Bug fix: <A HREF="http://sourceforge.net/tracker/index.php?func=detail&aid=877122&group_id=13478&atid=113478">#877122</A>: problem parsing cuesheet with CATALOG entry.</LI>
123 <LI>Bug fix: <A HREF="http://sourceforge.net/tracker/index.php?func=detail&aid=896057&group_id=13478&atid=113478">#896057</A>: parsing ISRC number from cuesheet.</LI>
124 </UL>
125 </LI>
126 <LI>
127 metaflac:
128 <UL>
129 <LI>Better explanation of common error messages.</LI>
130 <LI>Bug fix: calculating ReplayGain on 48kHz streams.</LI>
131 <LI>Bug fix: incorrect numbers when printing seek points.</LI>
132 </UL>
133 </LI>
134 <LI>
135 plugins:
136 <UL>
137 <LI>Speed optimization in ReplayGain synthesis.</LI>
138 <LI>Speed optimization in XMMS playback.</LI>
139 <LI>Support for big-endian architectures in XMMS plugin.</LI>
140 <LI>Bug fix: make hard limiter default to off in XMMS plugin.</LI>
141 <LI>Bug fix: stream length calculation bug in XMMS plugin, debian bug #200435; <A HREF="http://sourceforge.net/mailarchive/forum.php?thread_id=2733072&forum_id=6312">see also</A>.</LI>
142 <LI>Bug fix: small memory leak in XMMS plugin.</LI>
143 </UL>
144 </LI>
145 <LI>
146 build system:
147 <UL>
148 <LI><TT>ordinals.h</TT> is now static, not a build-generated file anymore.</LI>
149 </UL>
150 </LI>
151 <LI>
152 libraries:
153 <UL>
154 <LI>libFLAC: Make stream encoder encode the blocksize and sample rate in the frame header if at all possible (not in STREAMINFO), even if subset encoding was not requested.</LI>
155 <LI>libFLAC: Bug fix: fixed seek routine where infinite loop could happen when seeking past end of stream.</LI>
156 <LI>libFLAC, libFLAC++: added methods to skip single frames, useful for quickly finding frame boundaries (see interface changes below).</LI>
157 <LI>libOggFLAC, libOggFLAC++: New seekable-stream and file encoder and decoder APIs to match native FLAC APIs (see interface changes below).</LI>
158 </UL>
159 </LI>
160 <LI>
161 Interface changes:
162 <UL>
163 <LI>
164 libFLAC:
165 <UL>
166 <LI><B>Added</B> callback-based versions of metadata editing functions:
167 <UL>
168 <LI>FLAC__metadata_chain_read_with_callbacks()</LI>
169 <LI>FLAC__metadata_chain_write_with_callbacks()</LI>
170 <LI>FLAC__metadata_chain_write_with_callbacks_and_tempfile()</LI>
171 <LI>FLAC__metadata_chain_check_if_tempfile_needed()</LI>
172 </UL>
173 </LI>
174 <LI><B>Added</B> decoder functions for skipping single frames, also useful for quickly finding frame boundaries:
175 <UL>
176 <LI>FLAC__stream_decoder_skip_single_frame()</LI>
177 <LI>FLAC__seekable_stream_decoder_skip_single_frame()</LI>
178 <LI>FLAC__file_decoder_skip_single_frame()</LI>
179 </UL>
180 </LI>
181 <LI><B>Added</B> new required tell callback on seekable stream encoder:
182 <UL>
183 <LI>FLAC__SeekableStreamEncoderTellStatus and FLAC__SeekableStreamEncoderTellStatusString[]</LI>
184 <LI>FLAC__SeekableStreamEncoderTellCallback</LI>
185 <LI>FLAC__seekable_stream_encoder_set_tell_callback()</LI>
186 </UL>
187 </LI>
188 <LI><B>Changed</B> FLAC__SeekableStreamEncoderState by adding FLAC__SEEKABLE_STREAM_ENCODER_TELL_ERROR</LI>
189 <LI><B>Changed</B> Tell callback is now required to initialize seekable stream encoder</LI>
190 <LI><B>Deleted</B> erroneous and unimplemented FLAC__file_decoder_process_remaining_frames()</LI>
191 </UL>
192 </LI>
193 <LI>
194 libFLAC++:
195 <UL>
196 <LI><B>Added</B> decoder functions for skipping single frames, also useful for quickly finding frame boundaries:
197 <UL>
198 <LI>FLAC::Decoder::Stream::skip_single_frame()</LI>
199 <LI>FLAC::Decoder::SeekableStream::skip_single_frame()</LI>
200 <LI>FLAC::Decoder::File::skip_single_frame()</LI>
201 </UL>
202 </LI>
203 <LI><B>Added</B> encoder functions for setting metadata:
204 <UL>
205 <LI>FLAC::Encoder::Stream::set_metadata(FLAC::Metadata::Prototype **metadata, unsigned num_blocks)</LI>
206 <LI>FLAC::Encoder::SeekableStream::set_metadata(FLAC::Metadata::Prototype **metadata, unsigned num_blocks)</LI>
207 <LI>FLAC::Encoder::File::set_metadata(FLAC::Metadata::Prototype **metadata, unsigned num_blocks)</LI>
208 </UL>
209 </LI>
210 <LI><B>Added</B> new required tell callback on seekable stream encoder:
211 <UL>
212 <LI>pure virtual FLAC::Encoder::SeekableStream::tell_callback()</LI>
213 </UL>
214 </LI>
215 <LI><B>Changed</B> Tell callback is now required to initialize seekable stream encoder</LI>
216 <LI><B>Deleted</B> the following methods:
217 <UL>
218 <LI>FLAC::Decoder::Stream::State::resolved_as_cstring()</LI>
219 <LI>FLAC::Encoder::Stream::State::resolved_as_cstring()</LI>
220 </UL>
221 </LI>
222 </UL>
223 </LI>
224 <LI>
225 libOggFLAC:
226 <UL>
227 <LI><B>Added</B> OggFLAC__SeekableStreamDecoder interface</LI>
228 <LI><B>Added</B> OggFLAC__FileDecoder interface</LI>
229 <LI><B>Added</B> OggFLAC__SeekableStreamEncoder interface</LI>
230 <LI><B>Added</B> OggFLAC__FileEncoder interface</LI>
231 <LI><B>Added</B> OggFLAC__stream_decoder_get_resolved_state_string()</LI>
232 <LI><B>Added</B> OggFLAC__stream_encoder_get_resolved_state_string()</LI>
233 <LI><B>Added</B> OggFLAC__stream_encoder_set_metadata_callback()</LI>
234 <LI><B>Changed</B> OggFLAC__StreamDecoderState by adding OggFLAC__STREAM_DECODER_END_OF_STREAM</LI>
235 </UL>
236 </LI>
237 <LI>
238 libOggFLAC++:
239 <UL>
240 <LI><B>Added</B> OggFLAC::Decoder::SeekableStream interface</LI>
241 <LI><B>Added</B> OggFLAC::Decoder::File interface</LI>
242 <LI><B>Added</B> OggFLAC::Encoder::SeekableStream interface</LI>
243 <LI><B>Added</B> OggFLAC::Encoder::File interface</LI>
244 <LI><B>Added</B> OggFLAC::Decoder::Stream::get_resolved_state_string()</LI>
245 <LI><B>Added</B> OggFLAC::Encoder::Stream::get_resolved_state_string()</LI>
246 <LI><B>Added</B> pure virtual OggFLAC::Encoder::Stream::metadata_callback()</LI>
247 </UL>
248 </LI>
249 </UL>
250 </LI>
251 </UL>
252 </P>
253
254 </FONT>
255 </TD></TR>
256 </TABLE>
257 <TABLE WIDTH="100%" CELLPADDING="0" CELLSPACING="0" BORDER="0"><TR BGCOLOR="#000000"><TD><IMG SRC="images/1x1.gif" WIDTH="1" HEIGHT="1" ALT=""></TD></TR></TABLE>
258</TD></TR>
259</TABLE>
260
261
262</CENTER>
263
264<P>&nbsp;Copyright (c) 2000,2001,2002,2003,2004 Josh Coalson</P>
265
266</BODY>
267</HTML>