[FFmpeg-cvslog] doc/encoders: add doc for AAC encoder

[Timothy Gu]

ffmpeg | branch: release/1.2 | Timothy Gu <timothygu99 at gmail.com> | Sun Sep  8 16:32:22 2013 -0700| [6db67ac2a4faa138c2799ec399f56211329fc012] | committer: Timothy Gu

doc/encoders: add doc for AAC encoder

Thanks-to: Kostya Shishkov <kostya.shishkov at gmail.com>
Signed-off-by: Timothy Gu <timothygu99 at gmail.com>
Signed-off-by: Stefano Sabatini <stefasab at gmail.com>
(cherry picked from commit 0e11790cf7eef3b0f38a64486da1e3fb8c7f14b8)

Signed-off-by: Timothy Gu <timothygu99 at gmail.com>

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=6db67ac2a4faa138c2799ec399f56211329fc012
---

 doc/encoders.texi |   90 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 90 insertions(+)

diff --git a/doc/encoders.texi b/doc/encoders.texi
index b3a3ffb..a2ad496 100644
--- a/doc/encoders.texi
+++ b/doc/encoders.texi
@@ -25,6 +25,95 @@ enabled encoders.
 A description of some of the currently available audio encoders
 follows.
 
+ at anchor{aacenc}
+ at section aac
+
+Advanced Audio Coding (AAC) encoder.
+
+This encoder is an experimental FFmpeg-native AAC encoder. Currently only the
+low complexity (AAC-LC) profile is supported. To use this encoder, you must set
+ at option{strict} option to @samp{experimental} or lower.
+
+As this encoder is experimental, unexpected behavior may exist from time to
+time. For a more stable AAC encoder, see @ref{libvo-aacenc}. However, be warned
+that it has a worse quality reported by some users.
+
+ at c Comment this out until somebody writes the respective documentation.
+ at c See also @ref{libfaac}, @ref{libaacplus}, and @ref{libfdk-aac-enc}.
+
+ at subsection Options
+
+ at table @option
+ at item b
+Set bit rate in bits/s. Setting this automatically activates constant bit rate
+(CBR) mode.
+
+ at item q
+Set quality for variable bit rate (VBR) mode. This option is valid only using
+the @command{ffmpeg} command-line tool. For library interface users, use
+ at option{global_quality}.
+
+ at item stereo_mode
+Set stereo encoding mode. Possible values:
+
+ at table @samp
+ at item auto
+Automatically selected by the encoder.
+
+ at item ms_off
+Disable middle/side encoding. This is the default.
+
+ at item ms_force
+Force middle/side encoding.
+ at end table
+
+ at item aac_coder
+Set AAC encoder coding method. Possible values:
+
+ at table @samp
+ at item 0
+FAAC-inspired method.
+
+This method is a simplified reimplementation of the method used in FAAC, which
+sets thresholds proportional to the band energies, and then decreases all the
+thresholds with quantizer steps to find the appropriate quantization with
+distortion below threshold band by band.
+
+The quality of this method is comparable to the two loop searching method
+descibed below, but somewhat a little better and slower.
+
+ at item 1
+Average noise to mask ratio (ANMR) trellis-based solution.
+
+This has a theoretic best quality out of all the coding methods, but at the
+cost of the slowest speed.
+
+ at item 2
+Two loop searching (TLS) method.
+
+This method first sets quantizers depending on band thresholds and then tries
+to find an optimal combination by adding or subtracting a specific value from
+all quantizers and adjusting some individual quantizer a little.
+
+This method produces similar quality with the FAAC method and is the default.
+
+ at item 3
+Constant quantizer method.
+
+This method sets a constant quantizer for all bands. This is the fastest of all
+the methods, yet produces the worst quality.
+
+ at end table
+
+ at end table
+
+ at subsection Tips and Tricks
+
+According to some reports
+(e.g. @url{http://d.hatena.ne.jp/kamedo2/20120729/1343545890}), setting the
+ at option{cutoff} option to 15000 Hz greatly improves the quality of the output
+quality. As a result, we encourage you to do the same.
+
 @section ac3 and ac3_fixed
 
 AC-3 audio encoders.
@@ -549,6 +638,7 @@ Set MPEG audio original flag when set to 1. The default value is 0
 
 @end table
 
+ at anchor{libvo-aacenc}
 @section libvo-aacenc
 
 VisualOn AAC encoder