ref: ff038d9f0dd3ffc5e50ab8315a314ee70506e6b9
parent: 53f6e943ca263b4896002a8b969ac28220f78afb
author: knik <knik>
date: Thu Jun 26 15:42:33 EDT 2003
new faac readme
--- /dev/null
+++ b/docs/faac.html
@@ -1,0 +1,229 @@
+<html>
+
+<head>
+<title>
+FAAC - Freeware Advanced Audio Coder
+</title>
+</head>
+
+</body>
+
+<h3>
+<center>
+FAAC 1.18 beta (<a href="http://www.audiocoding.com/">www.audiocoding.com</a>)
+</center>
+</h3>
+<br>
+
+<a name="toc">
+<h3>
+Contents
+</h3>
+<menu>
+<li><a href="#usage">Usage</a>
+<menu>
+<li><a href="#opts">options</a>
+<li><a href="#notes">notes</a>
+</menu>
+<li><a href="#copyrights">Copyrights</a>
+<li><a href="#people">People</a>
+</menu>
+
+<br><br>
+<a name="usage">
+<h3>
+Usage
+</h3>
+<kbd>faac [options] <infile> <outfile></kbd>
+<br><br>
+
+<a name="opts">
+<b>Options:</b><br>
+<menu>
+<li>
+<kbd>-a X</kbd>
+ Set average bitrate to approximately X kbps per channel
+ (i.e. using -a 64 averages at 128 kbps/stereo).
+<li>
+<kbd>-c <bandwidth></kbd>
+ Set the bandwidth in Hz (default value depends on sample rate)
+<li>
+<kbd>-q <quality></kbd>
+ Set quantizer quality (default: 100, averages at approx. 128 kbps VBR for
+ a normal stereo input file at 16 bit and 44.1 kHz sample rate).
+<li>
+<kbd>--tns</kbd>
+ Enable TNS coding.
+<li>
+<kbd>--notns</kbd>
+ Disable TNS coding.
+<li>
+<kbd>-n</kbd>
+ Disable mid/side coding.
+<li>
+<kbd>-m X</kbd>
+ AAC MPEG version, X can be 2 or 4 (default: MPEG-2, so for
+ the sake of interoperability with non-standard compliant players
+ like QuickTime 6 you should set it to "4").
+<li>
+<kbd>-o X</kbd>
+ AAC object type, X can be LC, MAIN or LTP (default: LC, for the
+ same reason as with the MPEG version don't use Main or LTP).
+<li>
+<kbd>-r</kbd>
+ RAW AAC output file (i.e. without ADTS headers).
+<li>
+<kbd>-P</kbd>
+ Raw PCM input mode.
+<li>
+<kbd>-R</kbd>
+ Raw PCM input sample rate in Hz (default: 44100 Hz).
+<li>
+<kbd>-B</kbd>
+ Raw PCM input bit depth (default: 16 bits, also possible 8 bits).
+<li>
+<kbd>-C</kbd>
+ Raw PCM input channels (default: 2).
+</menu>
+
+<kbd>- <stdin></kbd>
+ If you simply use a hyphen/minus sign instead of an input
+ file name, FAAC can encode directly from stdin, thus enabling piping
+ within other applications like foobar2000 or mp4live.
+<br><br>
+
+<a name="notes">
+<strong>Note:</strong> VBR output bitrate depends on -q
+<em><strong>AND</strong></em> -c, so you should only vary the default
+setting -q 100 -c 16000 if you know what you're doing and/or want to
+experiment with other cutoff frequencies at a given quality setting.
+<br><br>
+The ABR setting with -a is an approximate average bitrate that does not use
+a bit reservoir, i.e -a 64 and -q 100 at 44.1 kHz will result in exactly
+the same output file.<br>
+<br>
+The following list should give some orientation for useful -q and -c settings,
+based on FAAC v1.17. The resulting VBR bitrates are referring to an average
+sounding stereo file with 16bit, 44.1 kHz, i.e.
+ct_reference.wav in this case. Multiplexing these AAC files to MP4 with e.g. mp4creator will result in a ~3 kbps lower bitrate because of the stripped ADTS headers:<br>
+<br>
+-q 130 -c 22000 -m 4 (~218 kbps)<br>
+-q 120 -c 20000 -m 4 (~194 kbps)<br>
+-q 110 -c 18000 -m 4 (~158 kbps)<br>
+-q 100 -c 16000 -m 4 (~129 kbps)<br>
+-q 90 -c 14000 -m 4 (~103 kbps)<br>
+-q 80 -c 12000 -m 4 (~79 kbps)<br>
+-q 70 -c 10000 -m 4 (~62 kbps)<br>
+<br>
+The added -m 4 switch does not change the bitrate or sound of course,
+but is recommended for most AAC/MP4 players that use an updated FAAD2-based
+plugin from this year (Winamp 2.x, foobar2000 etc.) or can't decode
+MPEG-2 AAC LC files like QuickTime 6. Philips Expanium users should not use
+this switch, because their CD portable does not know MPEG-4 AAC files.
+<br>
+
+
+<br><br><br>
+<a name="copyrights">
+<h3>
+Copyrights
+</h3>
+FAAC - Freeware Advanced Audio Coder
+(<a href="http://www.audiocoding.com/">www.audiocoding.com</a>)
+<pre>
+ Portions Copyright © 2001 Menno Bakker
+ Portions Copyright © 2002,2003 Krzysztof Nikiel
+</pre>
+FAAC is based on the ISO MPEG-4 reference code. For this base code the
+following license applies:
+<br>
+<pre>
+This software module was originally developed by
+
+FirstName LastName (CompanyName)
+
+and edited by
+
+FirstName LastName (CompanyName)
+FirstName LastName (CompanyName)
+
+in the course of development of the MPEG-2 NBC/MPEG-4 Audio standard
+ISO/IEC 13818-7, 14496-1,2 and 3. This software module is an
+implementation of a part of one or more MPEG-2 NBC/MPEG-4 Audio tools
+as specified by the MPEG-2 NBC/MPEG-4 Audio standard. ISO/IEC gives
+users of the MPEG-2 NBC/MPEG-4 Audio standards free license to this
+software module or modifications thereof for use in hardware or
+software products claiming conformance to the MPEG-2 NBC/ MPEG-4 Audio
+standards. Those intending to use this software module in hardware or
+software products are advised that this use may infringe existing
+patents. The original developer of this software module and his/her
+company, the subsequent editors and their companies, and ISO/IEC have
+no liability for use of this software module or modifications thereof
+in an implementation. Copyright is not released for non MPEG-2
+NBC/MPEG-4 Audio conforming products. The original developer retains
+full right to use the code for his/her own purpose, assign or donate
+the code to a third party and to inhibit third party from using the
+code for non MPEG-2 NBC/MPEG-4 Audio conforming products. This
+copyright notice must be included in all copies or derivative works.
+
+Copyright © 1997.
+</pre>
+
+<br>
+For the changes made for the FAAC project the GNU Library General
+Public License (LGPL), version 2 1991 applies. For the changes the
+following statement applies:
+<br>
+
+<pre>
+FAAC - Freeware Advanced Audio Coder
+Copyright © 2001,2003 <a href="http://www.audiocoding.com/">AudioCoding.com</a>
+
+This library is free software; you can redistribute it and/or
+modify it under the terms of the GNU Lesser General Public
+License as published by the Free Software Foundation; either
+version 2.1 of the License, or (at your option) any later version.
+
+This library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public
+License along with this library; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+</pre>
+
+<br>
+Please note that the use of this software may require the payment of
+patent royalties. You need to consider this issue before you start
+building derivative works. We are not warranting or indemnifying you in
+any way for patent royalities! YOU ARE SOLELY RESPONSIBLE FOR YOUR OWN
+ACTIONS!
+<br>
+
+
+<br><br><br>
+<a name="people">
+<h3>
+People
+</h3>
+
+<i>Currently maintained by</i> M. Bakker</a><br><br>
+
+<i>Other contributors:</i><br>
+Tony Lenox<br>
+RageOMatic<br>
+thebard<br>
+Ivan Dimkovic<br>
+Krzysztof Nikiel<br>
+<br><br>
+
+<h6>
+<center><i>
+Copyright © 2003 <a href="http://www.audiocoding.com/">AudioCoding.com</a>
+<br></i></center>
+</h6>
+
+</body>
+</html>