libFLAC/lpc.c: Fix signed integer overflow
[flac.git] / doc / html / documentation_tools_flac.html
index ea1b8a1..8496aca 100644 (file)
@@ -1,12 +1,12 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <!-- Copyright (c) 2000-2009  Josh Coalson -->
-<!-- Copyright (c) 2011-2013  Xiph.Org Foundation -->
+<!-- Copyright (c) 2011-2016  Xiph.Org Foundation -->
 <!-- Permission is granted to copy, distribute and/or modify this document -->
 <!-- under the terms of the GNU Free Documentation License, Version 1.1 -->
 <!-- or any later version published by the Free Software Foundation; -->
 <!-- with no invariant sections. -->
 <!-- A copy of the license can be found at http://www.gnu.org/copyleft/fdl.html -->
-<html>
+<html xmlns="http://www.w3.org/1999/xhtml">
 <head>
        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
        <meta name="author" content="Josh Coalson" />
                        <tr>
                                <td nowrap="nowrap" align="right" valign="top" bgcolor="#F4F4CC">
                                        <a name="flac_options_skip" />
-                                       <span class="argument">--skip={#|mm:ss.ss}</span>
+                                       <span class="argument">--skip={#|mm:ss.ss}<br />--skip={#|mm:ss,ss}</span>
                                </td>
                                <td>
                                        Skip over the first # of samples of the input.  This works for both encoding and decoding, but not testing.  The alternative form <span class="argument">mm:ss.ss</span> can be used to specify minutes, seconds, and fractions of a second.<br />
                                        <br />
+                                       Note that the use of either a dot or a comma depends on the locale used for the system.<br />
+                                       <br />
                                        Examples:<br />
                                        <br />
                                        <span class="argument">--skip=123</span> : skip the first 123 samples of the input<br />
-                                       <span class="argument">--skip=1:23.45</span> : skip the first 1 minute and 23.45 seconds of the input
+                                       <span class="argument">--skip=1:23.45</span> : skip the first 1 minute and 23.45 seconds of the input, with a locale using the point as decimal separator<br />
+                                       <span class="argument">--skip=1:23,45</span> : skip the first 1 minute and 23.45 seconds of the input, with a locale using the comma as decimal separator
                                </td>
                        </tr>
                        <tr>
                                <td nowrap="nowrap" align="right" valign="top" bgcolor="#F4F4CC">
                                        <a name="flac_options_until" />
-                                       <span class="argument">--until={#|[+|-]mm:ss.ss}</span>
+                                       <span class="argument">--until={#|[+|-]mm:ss.ss}<br />--until={#|[+|-]mm:ss,ss}</span>
                                </td>
                                <td>
                                        Stop at the given sample number for each input file.  This works for both encoding and decoding, but not testing.  The given sample number is not included in the decoded output.  The alternative form <span class="argument">mm:ss.ss</span> can be used to specify minutes, seconds, and fractions of a second.  If a <span class="argument">+</span> sign is at the beginning, the <span class="argument">--until</span> point is relative to the <span class="argument">--skip</span> point.  If a <span class="argument">-</span> sign is at the beginning, the <span class="argument">--until</span> point is relative to end of the audio.<br />
                                        <br />
+                                       Note that the use of either a dot or a comma depends on the locale used for the system.<br />
+                                       <br />
                                        Examples:<br />
                                        <br />
                                        <span class="argument">--until=123</span> : decode only the first 123 samples of the input (samples 0-122, stopping at 123)<br />
                                        <span class="argument">--until=1:23.45</span> : decode only the first 1 minute and 23.45 seconds of the input<br />
+                                       <span class="argument">--until=1:23,45</span> : decode only the first 1 minute and 23.45 seconds of the input, if your locale setting uses a comma as decimal separator<br />
                                        <span class="argument">--skip=1:00 --until=+1:23.45</span> : decode 1:00.00 to 2:23.45<br />
                                        <span class="argument">--until=-1:23.45</span> : decode everything except the last 1 minute and 23.45 seconds<br />
                                        <span class="argument">--until=-0:00</span> : decode until the end of the input (the same as not specifying <span class="argument">--until</span>)
                                        <span class="argument">-V</span>, <span class="argument">--verify</span>
                                </td>
                                <td>
-                                       Verify the encoding process.  With this option, <span class="commandname">flac</span> will create a parallel decoder that decodes the output of the encoder and compares the result against the original.  It will abort immediately with an error if a mismatch occurs.  <span class="argument">-V</span> increases the total encoding time but is guaranteed to catch any unforseen bug in the encoding process.
+                                       Verify the encoding process.  With this option, <span class="commandname">flac</span> will create a parallel decoder that decodes the output of the encoder and compares the result against the original.  It will abort immediately with an error if a mismatch occurs.  <span class="argument">-V</span> increases the total encoding time but is guaranteed to catch any unforeseen bug in the encoding process.
                                </td>
                        </tr>
                        <tr>
                                        <span class="argument">--replay-gain</span>
                                </td>
                                <td>
-                                       Calculate <a href="http://www.replaygain.org/">ReplayGain</a> values and store them as FLAC tags, similar to <a href="http://packages.qa.debian.org/v/vorbisgain.html">VorbisGain</a>.  Title gains/peaks will be computed for each input file, and an album gain/peak will be computed for all files.  All input files must have the same resolution, sample rate, and number of channels.  Only mono and stereo files are allowed, and the sample rate must be one of 8, 11.025, 12, 16, 22.05, 24, 32, 44.1, or 48 kHz.  Also note that this option may leave a few extra bytes in a <span class="code">PADDING</span> block as the exact size of the tags is not known until all files are processed.<br />
+                                       Calculate <a href="http://wiki.hydrogenaud.io/index.php?title=ReplayGain_specification">ReplayGain</a> values and store them as FLAC tags, similar to <a href="http://packages.qa.debian.org/v/vorbisgain.html">VorbisGain</a>.  Title gains/peaks will be computed for each input file, and an album gain/peak will be computed for all files.  All input files must have the same resolution, sample rate, and number of channels.  Only mono and stereo files are allowed, and the sample rate must be one of 8, 11.025, 12, 16, 22.05, 24, 32, 44.1, or 48 kHz.  Also note that this option may leave a few extra bytes in a <span class="code">PADDING</span> block as the exact size of the tags is not known until all files are processed.<br />
                                        <br />
                                        Note that this option cannot be used when encoding to standard output (stdout).
                                </td>
                                        <br />
                                        <span class="argument">DESCRIPTION</span> is optional; the default is an empty string.<br />
                                        <br />
-                                       The next part specfies the resolution and color information.  If the <span class="argument">MIME-TYPE</span> is <tt>image/jpeg</tt>, <tt>image/png</tt>, or <tt>image/gif</tt>, you can usually leave this empty and they can be detected from the file.  Otherwise, you must specify the width in pixels, height in pixels, and color depth in bits-per-pixel.  If the image has indexed colors you should also specify the number of colors used.  When manually specified, it is not checked against the file for accuracy.<br />
+                                       The next part specifies the resolution and color information.  If the <span class="argument">MIME-TYPE</span> is <tt>image/jpeg</tt>, <tt>image/png</tt>, or <tt>image/gif</tt>, you can usually leave this empty and they can be detected from the file.  Otherwise, you must specify the width in pixels, height in pixels, and color depth in bits-per-pixel.  If the image has indexed colors you should also specify the number of colors used.  When manually specified, it is not checked against the file for accuracy.<br />
                                        <br />
                                        <span class="argument">FILE</span> is the path to the picture file to be imported, or the URL if MIME type is --&gt;<br />
                                        <br />
                                        <span class="argument">-6</span>, <span class="argument">--compression-level-6</span>
                                </td>
                                <td>
-                                       Synonymous with <span class="argument">-l 8 -b 4096 -m -r 6</span>
+                                       Synonymous with <span class="argument">-l 8 -b 4096 -m -r 6 -A tukey(0.5);partial_tukey(2)</span>
                                </td>
                        </tr>
                        <tr>
                                        <span class="argument">-7</span>, <span class="argument">--compression-level-7</span>
                                </td>
                                <td>
-                                       Synonymous with <span class="argument">-l 8 -b 4096 -m -e -r 6</span>
+                                       Synonymous with <span class="argument">-l 12 -b 4096 -m -r 6 -A tukey(0.5);partial_tukey(2)</span>
                                </td>
                        </tr>
                        <tr>
                                        <span class="argument">-8</span>, <span class="argument">--compression-level-8</span>
                                </td>
                                <td>
-                                       Synonymous with <span class="argument">-l 12 -b 4096 -m -e -r 6</span>
+                                       Synonymous with <span class="argument">-l 12 -b 4096 -m -r 6 -A tukey(0.5);partial_tukey(2);punchout_tukey(3)</span>
                                </td>
                        </tr>
                        <tr>
                                        <span class="argument">-A "function"</span>, <span class="argument">--apodization="function"</span>
                                </td>
                                <td>
-                                       Window audio data with given the apodization function.  The functions are: bartlett, bartlett_hann, blackman, blackman_harris_4term_92db, connes, flattop, gauss(STDDEV), hamming, hann, kaiser_bessel, nuttall, rectangle, triangle, tukey(P), welch.<br />
+                                       Window audio data with given the apodization function.  The functions are: bartlett, bartlett_hann, blackman, blackman_harris_4term_92db, connes, flattop, gauss(STDDEV), hamming, hann, kaiser_bessel, nuttall, rectangle, triangle, tukey(P), partial_tukey(n[/ov[/P]]), punchout_tukey(n[/ov[/P]]), welch.<br />
                                        For gauss(STDDEV), STDDEV is the standard deviation (0&lt;STDDEV&lt;=0.5).<br />
                                        For tukey(P), P specifies the fraction of the window that is tapered (0&lt;=P&lt;=1; P=0 corresponds to "rectangle" and P=1 corresponds to "hann").<br />
+                                       For partial_tukey(n) and punchout_tukey(n), n apodization functions are added that span different parts of each block. Values of 2 to 6 seem to yield sane results. If necessary, an overlap can be specified, as can be the taper parameter, for example partial_tukey(2/0.2) or partial_tukey(2/0.2/0.5). ov should be smaller than 1 and can be negative.<br />
+                                       Please note that P, STDDEV and ov are locale specific, so a comma as decimal separator might be required instead of a dot.<br />
                                        More than one -A option (up to 32) may be used.  Any function that is specified erroneously is silently dropped.  The encoder chooses suitable defaults in the absence of any -A options; any -A option specified replaces the default(s).<br />
                                        When more than one function is specified, then for every subframe the encoder will try each of them separately and choose the window that results in the smallest compressed subframe.  Multiple functions can greatly increase the encoding time.<br />
                                </td>
                                        <span class="argument">--no-mid-side</span><br />
                                        <span class="argument">--no-ogg</span><br />
                                        <span class="argument">--no-padding</span><br />
+                                       <span class="argument">--no-preserve-modtime</span><br />
                                        <span class="argument">--no-qlp-coeff-prec-search</span><br />
                                        <span class="argument">--no-residual-gnuplot</span><br />
                                        <span class="argument">--no-residual-text</span><br />
                        <td align="left">
                                Copyright (c) 2000-2009  Josh Coalson
                                <br/>
-                               Copyright (c) 2011-2013  Xiph.Org Foundation
-                       </td>
-                       <td width="1%" align="right">
-                               <a href="http://validator.w3.org/check?uri=referer"><img src="http://www.w3.org/Icons/valid-xhtml10" alt="Valid XHTML 1.0!" height="31" width="88" border="0" hspace="0" /></a>
+                               Copyright (c) 2011-2016  Xiph.Org Foundation
                        </td>
                </tr>
        </table>