[FFmpeg-devel] [PATCH] doc/encoders: Add libopus encoder doc

Timothy Gu timothygu99 at gmail.com
Fri Jul 5 04:20:46 CEST 2013

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

diff --git a/doc/encoders.texi b/doc/encoders.texi
index afe4952..350648d 100644
--- a/doc/encoders.texi
+++ b/doc/encoders.texi
@@ -600,6 +600,79 @@ default value is 0 (disabled).
 @end table
+ at section libopus
+libopus Opus Interactive Audio Codec encoder wrapper.
+Requires the presence of the libopus headers and library during
+configuration. You need to explicitly configure the build with
+ at code{--enable-libopus}.
+ at subsection Option Mapping
+Most libopus options are modeled after the @command{opusenc} utility from
+opus-tools. The following is an option mapping chart describing options
+supported by the libopus wrapper, and their @command{opusenc}-equivalent
+in parentheses.
+ at table
+ at item @option{b} (@emph{bitrate})
+Set the bit rate in bits/s.  FFmpeg's @option{b} option is
+expressed in bits/s, while @command{opusenc}'s @option{bitrate} in
+ at item @option{vbr} (@emph{vbr}, @emph{hard-cbr}, and @emph{cvbr})
+Set VBR mode. The FFmpeg @option{vbr} option has the following
+valid arguments, with the their @command{opusenc} equivalent in
+ at table
+ at item @samp{off} (@emph{hard-cbr})
+Use constant bit rate encoding.
+ at item @samp{on} (@emph{vbr})
+Use variable bit rate encoding (the default).
+ at item @samp{constrained} (@emph{cvbr})
+Use constrained variable bit rate encoding.
+ at end table
+ at item @option{compression_level} (@emph{comp})
+Set encoding algorithm complexity. Valid options are integers in
+the 0-10 range. 0 gives the fastest encodes but lower quality, while 10
+gives the highest quality but slowest encoding. The default is 10.
+ at item @option{frame_duration} (@emph{framesize})
+Set maximum frame size, or duration of a frame in milliseconds. The
+argument must be exactly the following: 2.5, 5, 10, 20, 40, 60. Smaller
+frame sizes achieve lower latency but less quality at a given bitrate.
+Sizes greater than 20ms are only interesting at fairly low bitrates.
+The default of FFmpeg is 10ms, but is 20ms in @command{opusenc}.
+ at item @option{packet_loss} (@emph{expect-loss})
+Set expected packet loss percentage. The default is 0.
+ at item @option{application} (N.A.)
+Set intended application type. Valid options are listed below:
+ at table @samp
+ at item voip
+Favor improved speech intelligibility.
+ at item audio
+Favor faithfulness to the input (the default).
+ at item lowdelay
+Restrict to only the lowest delay modes.
+ at end table
+ at item @option{cutoff} (N.A.)
+Set cutoff bandwidth in Hz. The argument must be exactly one of the
+following: 4000, 6000, 8000, 12000, or 20000, corresponding to
+narrowband, mediumband, wideband, super wideband, and fullband
+respectively. The default is 0 (cutoff disabled).
+ at end multitable
 @section libwavpack
 A wrapper providing WavPack encoding through libwavpack.

More information about the ffmpeg-devel mailing list