[FFmpeg-cvslog] doc/encoders: add libvorbis doc

[Timothy Gu]

ffmpeg | branch: master | Timothy Gu <timothygu99 at gmail.com> | Wed Oct 16 20:33:48 2013 -0700| [0be74cf0f5b18a16a41b5db90bc0a554e2f2036b] | committer: Stefano Sabatini

doc/encoders: add libvorbis doc

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

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

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

diff --git a/doc/encoders.texi b/doc/encoders.texi
index a96c1fc..0c01364 100644
--- a/doc/encoders.texi
+++ b/doc/encoders.texi
@@ -771,6 +771,58 @@ respectively. The default is 0 (cutoff disabled).
 
 @end table
 
+ at section libvorbis
+
+libvorbis encoder wrapper.
+
+Requires the presence of the libvorbisenc headers and library during
+configuration. You need to explicitly configure the build with
+ at code{--enable-libvorbis}.
+
+ at subsection Options
+
+The following options are supported by the libvorbis wrapper. The
+ at command{oggenc}-equivalent of the options are listed in parentheses.
+
+To get a more accurate and extensive documentation of the libvorbis
+options, consult the libvorbisenc's and @command{oggenc}'s documentations.
+See @url{http://xiph.org/vorbis/},
+ at url{http://wiki.xiph.org/Vorbis-tools}, and oggenc(1).
+
+ at table @option
+ at item b (@emph{-b})
+Set bitrate expressed in bits/s for ABR. @command{oggenc} @option{-b} is
+expressed in kilobits/s.
+
+ at item q (@emph{-q})
+Set constant quality setting for VBR. The value should be a float
+number in the range of -1.0 to 10.0. The higher the value, the better
+the quality. The default value is @samp{3.0}.
+
+This option is valid only using the @command{ffmpeg} command-line tool.
+For library interface users, use @option{global_quality}.
+
+ at item cutoff (@emph{--advanced-encode-option lowpass_frequency=N})
+Set cutoff bandwidth in Hz, a value of 0 disables cutoff. @command{oggenc}'s
+related option is expressed in kHz. The default value is @samp{0} (cutoff
+disabled).
+
+ at item minrate (@emph{-m})
+Set minimum bitrate expressed in bits/s. @command{oggenc} @option{-m} is
+expressed in kilobits/s.
+
+ at item maxrate (@emph{-M})
+Set maximum bitrate expressed in bits/s. @command{oggenc} @option{-M} is
+expressed in kilobits/s. This only has effect on ABR mode.
+
+ at item iblock (@emph{--advanced-encode-option impulse_noisetune=N})
+Set noise floor bias for impulse blocks. The value is a float number from
+-15.0 to 0.0. A negative bias instructs the encoder to pay special attention
+to the crispness of transients in the encoded audio. The tradeoff for better
+transient response is a higher bitrate.
+
+ at end table
+
 @section libwavpack
 
 A wrapper providing WavPack encoding through libwavpack.