"Fossies" - the Fresh Open Source Software Archive

Member "faac-1_30/docs/faac.html" (16 Oct 2019, 7322 Bytes) of package /linux/misc/faac-1_30.tar.gz:


As a special service "Fossies" has tried to format the requested source page into HTML format using (guessed) HTML source code syntax highlighting (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 <html>
    2 
    3 <head>
    4 <title>
    5 FAAC - Freeware Advanced Audio Coder
    6 </title>
    7 </head>
    8 
    9 </body>
   10 
   11 <h3>
   12 <center>
   13 FAAC 1.18 beta (<a href="http://www.audiocoding.com/">www.audiocoding.com</a>)
   14 </center>
   15 </h3>
   16 <br>
   17 
   18 <a name="toc">
   19 <h3>
   20 Contents
   21 </h3>
   22 <menu>
   23 <li><a href="#usage">Usage</a>
   24 <menu>
   25 <li><a href="#opts">options</a>
   26 <li><a href="#notes">notes</a>
   27 </menu>
   28 <li><a href="#copyrights">Copyrights</a>
   29 <li><a href="#patents">Patents</a>
   30 <li><a href="#people">People</a>
   31 </menu>
   32 
   33 <br><br>
   34 <a name="usage">
   35 <h3>
   36 Usage
   37 </h3>
   38 (More up to date info can be found at
   39 <a href="http://www.audiocoding.com/wiki/index.php?page=FAAC">
   40 FAAC wiki page</a> by Hans-J&uuml;rgen Bardenhagen)<br><br>
   41 <kbd>faac [options] &lt;infile&gt; &lt;outfile&gt;</kbd>
   42 <br><br>
   43 
   44 <a name="opts">
   45 <b>Options:</b><br>
   46 <menu>
   47 <li>
   48 <kbd>-a X</kbd>
   49     Set average bitrate to approximately X kbps per channel
   50     (i.e. using -a 64 averages at 128 kbps/stereo).
   51 <li>
   52 <kbd>-c &lt;bandwidth&gt;</kbd>
   53     Set the bandwidth in Hz (default value depends on sample rate)
   54 <li>
   55 <kbd>-q &lt;quality&gt;</kbd>
   56     Set quantizer quality (default: 100, averages at approx. 128 kbps VBR for
   57     a normal stereo input file at 16 bit and 44.1 kHz sample rate).
   58 <li>
   59 <kbd>--tns</kbd>
   60     Enable TNS coding.
   61 <li>
   62 <kbd>--notns</kbd>
   63     Disable TNS coding.
   64 <li>
   65 <kbd>-n</kbd>
   66     Disable mid/side coding.
   67 <li>
   68 <kbd>-m X</kbd>
   69     AAC MPEG version, X can be 2 or 4 (default: MPEG-2, so for
   70     the sake of interoperability with non-standard compliant players
   71     like QuickTime 6 you should set it to "4").
   72 <li>
   73 <kbd>-o X</kbd>
   74     AAC object type, X can be LC, MAIN or LTP (default: LC, for the
   75     same reason as with the MPEG version don't use Main or LTP).
   76 <li>
   77 <kbd>-r</kbd>
   78     RAW AAC output file (i.e. without ADTS headers).
   79 <li>
   80 <kbd>-P</kbd>
   81     Raw PCM input mode.
   82 <li>
   83 <kbd>-R</kbd>
   84     Raw PCM input sample rate in Hz (default: 44100 Hz).
   85 <li>
   86 <kbd>-B</kbd>
   87     Raw PCM input bit depth (default: 16 bits, also possible 8 bits).
   88 <li>
   89 <kbd>-C</kbd>
   90     Raw PCM input channels (default: 2).
   91 </menu>
   92 
   93 <kbd>- &lt;stdin&gt;</kbd>
   94   If you simply use a hyphen/minus sign instead of an input
   95   file name, FAAC can encode directly from stdin, thus enabling piping
   96   within other applications like foobar2000 or mp4live.
   97 <br><br>
   98 
   99 <a name="notes">
  100 <strong>Note:</strong> VBR output bitrate depends on -q
  101 <em><strong>AND</strong></em> -c, so you should only vary the default
  102 setting -q 100 -c 16000 if you know what you're doing and/or want to
  103 experiment with other cutoff frequencies at a given quality setting.
  104 <br><br>
  105 The ABR setting with -a is an approximate average bitrate that does not use 
  106 a bit reservoir, i.e -a 64 and -q 100 at 44.1 kHz will result in exactly 
  107 the same output file.<br>
  108 <br>
  109 The following list should give some orientation for useful -q and -c settings,
  110 based on FAAC v1.17. The resulting VBR bitrates are referring to an average
  111 sounding stereo file with 16bit, 44.1 kHz, i.e. 
  112 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>
  113 <br>
  114 -q 130 -c 22000 -m 4 (~218 kbps)<br>
  115 -q 120 -c 20000 -m 4 (~194 kbps)<br>
  116 -q 110 -c 18000 -m 4 (~158 kbps)<br>
  117 -q 100 -c 16000 -m 4 (~129 kbps)<br>
  118 -q 90 -c 14000 -m 4 (~103 kbps)<br>
  119 -q 80 -c 12000 -m 4 (~79 kbps)<br>
  120 -q 70 -c 10000 -m 4 (~62 kbps)<br>
  121 <br>
  122 The added -m 4 switch does not change the bitrate or sound of course,
  123 but is recommended for most AAC/MP4 players that use an updated FAAD2-based
  124 plugin from this year (Winamp 2.x, foobar2000 etc.) or can't decode
  125 MPEG-2 AAC LC files like QuickTime 6. Philips Expanium users should not use
  126 this switch, because their CD portable does not know MPEG-4 AAC files.
  127 <br>
  128 
  129 
  130 <br><br><br>
  131 <a name="copyrights">
  132 <h3>
  133 Copyrights
  134 </h3>
  135 FAAC - Freeware Advanced Audio Coder
  136 (<a href="http://www.audiocoding.com/">www.audiocoding.com</a>)
  137 <pre>
  138     Portions Copyright &copy; 1999,2000,2001 Menno Bakker
  139     Portions Copyright &copy; 2002,2003 Krzysztof Nikiel
  140 </pre>
  141 FAAC is based on the ISO MPEG-4 reference code. For this base code the
  142 following license applies:
  143 <br>
  144 <pre>
  145 This software module was originally developed by
  146 
  147 FirstName LastName (CompanyName)
  148 
  149 and edited by
  150 
  151 FirstName LastName (CompanyName)
  152 FirstName LastName (CompanyName)
  153 
  154 in the course of development of the MPEG-2 NBC/MPEG-4 Audio standard
  155 ISO/IEC 13818-7, 14496-1,2 and 3. This software module is an
  156 implementation of a part of one or more MPEG-2 NBC/MPEG-4 Audio tools
  157 as specified by the MPEG-2 NBC/MPEG-4 Audio standard. ISO/IEC gives
  158 users of the MPEG-2 NBC/MPEG-4 Audio standards free license to this
  159 software module or modifications thereof for use in hardware or
  160 software products claiming conformance to the MPEG-2 NBC/ MPEG-4 Audio
  161 standards. Those intending to use this software module in hardware or
  162 software products are advised that this use may infringe existing
  163 patents. The original developer of this software module and his/her
  164 company, the subsequent editors and their companies, and ISO/IEC have
  165 no liability for use of this software module or modifications thereof
  166 in an implementation. Copyright is not released for non MPEG-2
  167 NBC/MPEG-4 Audio conforming products. The original developer retains
  168 full right to use the code for his/her own purpose, assign or donate
  169 the code to a third party and to inhibit third party from using the
  170 code for non MPEG-2 NBC/MPEG-4 Audio conforming products. This
  171 copyright notice must be included in all copies or derivative works.
  172 
  173 Copyright &copy; 1997.
  174 </pre>
  175 
  176 <br>
  177 For the changes made for the FAAC project the GNU Library General
  178 Public License (LGPL), version 2 1991 applies. For the changes the
  179 following statement applies:
  180 <br>
  181 
  182 <pre>
  183 FAAC - Freeware Advanced Audio Coder
  184 Copyright &copy; 1999,2000,2001,2002,2003 <a href="#people">FAAC developers</a>
  185 
  186 This library is free software; you can redistribute it and/or
  187 modify it under the terms of the GNU Lesser General Public
  188 License as published by the Free Software Foundation; either
  189 version 2.1 of the License, or (at your option) any later version.
  190 
  191 This library is distributed in the hope that it will be useful,
  192 but WITHOUT ANY WARRANTY; without even the implied warranty of
  193 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  194 Lesser General Public License for more details.
  195 
  196 You should have received a copy of the GNU Lesser General Public
  197 License along with this library; if not, write to the Free Software
  198 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  199 </pre>
  200 
  201 <br>
  202 <a name="patents">
  203 <h3>
  204 Patents
  205 </h3>
  206 Please note that the use of this software may require the payment of
  207 patent royalties. You need to consider this issue before you start
  208 building derivative works. We are not warranting or indemnifying you in
  209 any way for patent royalities! YOU ARE SOLELY RESPONSIBLE FOR YOUR OWN
  210 ACTIONS!
  211 <br>
  212 
  213 
  214 <br><br><br>
  215 <a name="people">
  216 <h3>
  217 People
  218 </h3>
  219 
  220 <i>Currently maintained by</i> M. Bakker (menno)</a><br><br>
  221 
  222 <i>Other contributors:</i><br>
  223 Tony Lenox<br>
  224 RageOMatic<br>
  225 thebard<br>
  226 Ivan Dimkovic<br>
  227 Krzysztof Nikiel (knik)<br>
  228 Janne Hyvärinen (ca5e)<br>
  229 Stuart Espey (stux)<br>
  230 Andrew Voznytsa<br>
  231 Måns Rullgård<br>
  232 Bill May<br>
  233 
  234 <br><br>
  235 
  236 <h6>
  237 <center><i>
  238 Copyright &copy; 2003 <a href="http://www.audiocoding.com/">AudioCoding.com</a>
  239 <br></i></center>
  240 </h6>
  241 
  242 </body>
  243 </html>