doc/html/changelog.html

   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;changelog&nbsp;&nbsp;</TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
  41                                         <TD           BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;<A CLASS="topnav" HREF="links.html">links</A>&nbsp;&nbsp;</TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
  42                                         <TD           BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;<A CLASS="topnav" HREF="developers.html">developers</A>&nbsp;&nbsp;</TD>
  43                                 </TR>
  44                         </TABLE>
  45                 </TD>
  46         </TR>
  47 </TABLE>
  48
  49 <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>
  50
  51 <TABLE WIDTH="100%" CELLPADDING=0 CELLSPACING=0 BORDER=0>
  52         <TR>
  53                 <TD ALIGN="CENTER" BGCOLOR="#EEEED4">
  54                         <TABLE CELLPADDING=0 CELLSPACING=0 BORDER=0>
  55                                 <TR>
  56                                         <TD HEIGHT=22 BGCOLOR="#EEEED4" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;english&nbsp;&nbsp;</TD><TD BGCOLOR="#EEEED4" ALIGN=CENTER>|</TD>
  57                                         <TD           BGCOLOR="#EEEED4" ALIGN=CENTER NOWRAP>&nbsp;&nbsp;<A CLASS="topnav" HREF="ru/changelog.html">russian</A>&nbsp;&nbsp;</TD>
  58                                 </TR>
  59                         </TABLE>
  60                 </TD>
  61         </TR>
  62 </TABLE>
  63
  64 <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>
  65
  66 <CENTER>
  67
  68 <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>
  69
  70
  71 <TABLE WIDTH="100%" CELLPADDING="5" CELLSPACING="5" BORDER="0">
  72 <TR><TD>
  73         <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>
  74         <TABLE CELLSPACING="0" CELLPADDING="3" WIDTH="100%" BORDER="0" BGCOLOR="#D3D4C5">
  75                 <TR><TD><FONT FACE="Lucida,Verdana,Helvetica,Arial">
  76                 <B><FONT SIZE="+2">changelog</FONT></B>
  77                 </FONT></TD></TR>
  78         </TABLE>
  79         <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>
  80         <TABLE CELLSPACING="0" CELLPADDING="3" WIDTH="100%" BORDER="0" BGCOLOR="#EEEED4">
  81         <TR><TD><FONT FACE="Lucida,Verdana,Helvetica,Arial">
  82
  83         <P>
  84                 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.
  85         </P>
  86
  87         <P>
  88                 <A NAME="flac_1_1_1"><B>FLAC 1.1.1</B></A>
  89         </P>
  90         <P>
  91         <UL>
  92                 <LI>
  93                         General:
  94                         <UL>
  95                                 <LI>First official FLAC-&gt;Ogg bitstream mapping standardized (see new <A HREF="ogg_mapping.html">FLAC-to-Ogg mapping specification</A>)</LI>
  96                                 <LI>Ogg FLAC seeking now works</LI>
  97                                 <LI>New PPC optimizations almost double the decoding speed on OS X</LI>
  98                                 <LI>A native OS X release thanks to updated Project Builder and autotools files</LI>
  99                         </UL>
 100                 </LI>
 101                 <LI>
 102                         FLAC format:
 103                         <UL>
 104                                 <LI>Made invalid the metadata block type 127 so that audio frames can always be distinguished from metadata by seeing 0xff as the first byte.</LI>
 105                         </UL>
 106                 </LI>
 107                 <LI>
 108                         flac:
 109                         <UL>
 110                                 <LI>Print an error when output file already exists instead of automatically overwriting.</LI>
 111                                 <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>
 112                                 <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>
 113                                 <LI>New option <A HREF="documentation.html#flac_options_totally_silent"><TT>--totally-silent</TT></A> to suppress all output.</LI>
 114                                 <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>
 115                                 <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>
 116                                 <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>
 117                                 <LI>Decoder no longer exits with an error when writing to stdout and the pipe is broken.</LI>
 118                                 <LI>Better explanation of common error messages.</LI>
 119                                 <LI>Default extension when writing AIFF files is .aif (before, it was .aiff).</LI>
 120                                 <LI>Write more common representation of SANE numbers in AIFF files.</LI>
 121                                 <LI>Bug fix: calculating ReplayGain on 48kHz streams.</LI>
 122                                 <LI>Bug fix: check for supported block alignments in WAVE files.</LI>
 123                                 <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>
 124                                 <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>
 125                                 <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>
 126                                 <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>
 127                                 <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>
 128                                 <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>
 129                         </UL>
 130                 </LI>
 131                 <LI>
 132                         metaflac:
 133                         <UL>
 134                                 <LI>Renamed the tag editing options as follows (the <TT>...-vc-...</TT> options still work but are deprecated):
 135                                         <UL>
 136                                                 <LI><TT>--show-vc-vendor</TT> becomes <TT>--show-vendor-tag</TT></LI>
 137                                                 <LI><TT>--show-vc-field</TT> becomes <TT>--show-tag</TT></LI>
 138                                                 <LI><TT>--remove-vc-all</TT> becomes <TT>--remove-all-tags</TT></LI>
 139                                                 <LI><TT>--remove-vc-field</TT> becomes <TT>--remove-tag</TT></LI>
 140                                                 <LI><TT>--remove-vc-firstfield</TT> becomes <TT>--remove-first-tag</TT></LI>
 141                                                 <LI><TT>--set-vc-field</TT> becomes <TT>--set-tag</TT></LI>
 142                                                 <LI><TT>--import-vc-from</TT> becomes <TT>--import-tags-from</TT></LI>
 143                                                 <LI><TT>--export-vc-to</TT> becomes <TT>--export-tags-to</TT></LI>
 144                                         </UL>
 145                                 </LI>
 146                                 <LI>Better explanation of common error messages.</LI>
 147                                 <LI>Bug fix: calculating ReplayGain on 48kHz streams.</LI>
 148                                 <LI>Bug fix: incorrect numbers when printing seek points.</LI>
 149                         </UL>
 150                 </LI>
 151                 <LI>
 152                         plugins:
 153                         <UL>
 154                                 <LI>Speed optimization in ReplayGain synthesis.</LI>
 155                                 <LI>Speed optimization in XMMS playback.</LI>
 156                                 <LI>Support for big-endian architectures in XMMS plugin.</LI>
 157                                 <LI>Bug fix: make hard limiter default to off in XMMS plugin.</LI>
 158                                 <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>
 159                                 <LI>Bug fix: small memory leak in XMMS plugin.</LI>
 160                         </UL>
 161                 </LI>
 162                 <LI>
 163                         build system:
 164                         <UL>
 165                                 <LI><TT>ordinals.h</TT> is now static, not a build-generated file anymore.</LI>
 166                         </UL>
 167                 </LI>
 168                 <LI>
 169                         libraries:
 170                         <UL>
 171                                 <LI>libFLAC: PPC+Altivec optimizations of some decoder routines.</LI>
 172                                 <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>
 173                                 <LI>libFLAC: Bug fix: fixed seek routine where infinite loop could happen when seeking past end of stream.</LI>
 174                                 <LI>libFLAC, libFLAC++: added methods to skip single frames, useful for quickly finding frame boundaries (see interface changes below).</LI>
 175                                 <LI>libOggFLAC, libOggFLAC++: New seekable-stream and file encoder and decoder APIs to match native FLAC APIs (see interface changes below).</LI>
 176                         </UL>
 177                 </LI>
 178                 <LI>
 179                         Interface changes:
 180                         <UL>
 181                                 <LI>
 182                                         libFLAC:
 183                                         <UL>
 184                                                 <LI><B>Added</B> FLAC__metadata_get_tags()</LI>
 185                                                 <LI><B>Added</B> callback-based versions of metadata editing functions:
 186                                                         <UL>
 187                                                                 <LI>FLAC__metadata_chain_read_with_callbacks()</LI>
 188                                                                 <LI>FLAC__metadata_chain_write_with_callbacks()</LI>
 189                                                                 <LI>FLAC__metadata_chain_write_with_callbacks_and_tempfile()</LI>
 190                                                                 <LI>FLAC__metadata_chain_check_if_tempfile_needed()</LI>
 191                                                         </UL>
 192                                                 </LI>
 193                                                 <LI><B>Added</B> decoder functions for skipping single frames, also useful for quickly finding frame boundaries:
 194                                                         <UL>
 195                                                                 <LI>FLAC__stream_decoder_skip_single_frame()</LI>
 196                                                                 <LI>FLAC__seekable_stream_decoder_skip_single_frame()</LI>
 197                                                                 <LI>FLAC__file_decoder_skip_single_frame()</LI>
 198                                                         </UL>
 199                                                 </LI>
 200                                                 <LI><B>Added</B> new required tell callback on seekable stream encoder:
 201                                                         <UL>
 202                                                                 <LI>FLAC__SeekableStreamEncoderTellStatus and FLAC__SeekableStreamEncoderTellStatusString[]</LI>
 203                                                                 <LI>FLAC__SeekableStreamEncoderTellCallback</LI>
 204                                                                 <LI>FLAC__seekable_stream_encoder_set_tell_callback()</LI>
 205                                                         </UL>
 206                                                 </LI>
 207                                                 <LI><B>Changed</B> FLAC__SeekableStreamEncoderState by adding FLAC__SEEKABLE_STREAM_ENCODER_TELL_ERROR</LI>
 208                                                 <LI><B>Changed</B> Tell callback is now required to initialize seekable stream encoder</LI>
 209                                                 <LI><B>Deleted</B> erroneous and unimplemented FLAC__file_decoder_process_remaining_frames()</LI>
 210                                         </UL>
 211                                 </LI>
 212                                 <LI>
 213                                         libFLAC++:
 214                                         <UL>
 215                                                 <LI><B>Added</B> FLAC::Metadata::get_tags()</LI>
 216                                                 <LI><B>Added</B> decoder functions for skipping single frames, also useful for quickly finding frame boundaries:
 217                                                         <UL>
 218                                                                 <LI>FLAC::Decoder::Stream::skip_single_frame()</LI>
 219                                                                 <LI>FLAC::Decoder::SeekableStream::skip_single_frame()</LI>
 220                                                                 <LI>FLAC::Decoder::File::skip_single_frame()</LI>
 221                                                         </UL>
 222                                                 </LI>
 223                                                 <LI><B>Added</B> encoder functions for setting metadata:
 224                                                         <UL>
 225                                                                 <LI>FLAC::Encoder::Stream::set_metadata(FLAC::Metadata::Prototype **metadata, unsigned num_blocks)</LI>
 226                                                                 <LI>FLAC::Encoder::SeekableStream::set_metadata(FLAC::Metadata::Prototype **metadata, unsigned num_blocks)</LI>
 227                                                                 <LI>FLAC::Encoder::File::set_metadata(FLAC::Metadata::Prototype **metadata, unsigned num_blocks)</LI>
 228                                                         </UL>
 229                                                 </LI>
 230                                                 <LI><B>Added</B> new required tell callback on seekable stream encoder:
 231                                                         <UL>
 232                                                                 <LI>pure virtual FLAC::Encoder::SeekableStream::tell_callback()</LI>
 233                                                         </UL>
 234                                                 </LI>
 235                                                 <LI><B>Changed</B> Tell callback is now required to initialize seekable stream encoder</LI>
 236                                                 <LI><B>Deleted</B> the following methods:
 237                                                         <UL>
 238                                                                 <LI>FLAC::Decoder::Stream::State::resolved_as_cstring()</LI>
 239                                                                 <LI>FLAC::Encoder::Stream::State::resolved_as_cstring()</LI>
 240                                                         </UL>
 241                                                 </LI>
 242                                         </UL>
 243                                 </LI>
 244                                 <LI>
 245                                         libOggFLAC:
 246                                         <UL>
 247                                                 <LI><B>Added</B> OggFLAC__SeekableStreamDecoder interface</LI>
 248                                                 <LI><B>Added</B> OggFLAC__FileDecoder interface</LI>
 249                                                 <LI><B>Added</B> OggFLAC__SeekableStreamEncoder interface</LI>
 250                                                 <LI><B>Added</B> OggFLAC__FileEncoder interface</LI>
 251                                                 <LI><B>Added</B> OggFLAC__stream_decoder_get_resolved_state_string()</LI>
 252                                                 <LI><B>Added</B> OggFLAC__stream_encoder_get_resolved_state_string()</LI>
 253                                                 <LI><B>Added</B> OggFLAC__stream_encoder_set_metadata_callback()</LI>
 254                                                 <LI><B>Changed</B> OggFLAC__StreamDecoderState by adding OggFLAC__STREAM_DECODER_END_OF_STREAM</LI>
 255                                         </UL>
 256                                 </LI>
 257                                 <LI>
 258                                         libOggFLAC++:
 259                                         <UL>
 260                                                 <LI><B>Added</B> OggFLAC::Decoder::SeekableStream interface</LI>
 261                                                 <LI><B>Added</B> OggFLAC::Decoder::File interface</LI>
 262                                                 <LI><B>Added</B> OggFLAC::Encoder::SeekableStream interface</LI>
 263                                                 <LI><B>Added</B> OggFLAC::Encoder::File interface</LI>
 264                                                 <LI><B>Added</B> OggFLAC::Decoder::Stream::get_resolved_state_string()</LI>
 265                                                 <LI><B>Added</B> OggFLAC::Encoder::Stream::get_resolved_state_string()</LI>
 266                                                 <LI><B>Added</B> pure virtual OggFLAC::Encoder::Stream::metadata_callback()</LI>
 267                                         </UL>
 268                                 </LI>
 269                         </UL>
 270                 </LI>
 271         </UL>
 272         </P>
 273
 274         </FONT>
 275         </TD></TR>
 276         </TABLE>
 277         <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>
 278 </TD></TR>
 279 </TABLE>
 280
 281
 282 </CENTER>
 283
 284 <P>&nbsp;Copyright (c) 2004 Josh Coalson</P>
 285
 286 </BODY>
 287 </HTML>