[FFmpeg-devel] [PATCH] doc/encoders: add libshine doc

Timothy Gu timothygu99 at gmail.com
Sun Oct 27 04:26:34 CET 2013

Signed-off-by: Timothy Gu <timothygu99 at gmail.com>
 doc/encoders.texi | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/doc/encoders.texi b/doc/encoders.texi
index 0c01364..db48998 100644
--- a/doc/encoders.texi
+++ b/doc/encoders.texi
@@ -494,6 +494,7 @@ Selected by Encoder (default)
 @end table
+ at anchor{libmp3lame}
 @section libmp3lame
 LAME (Lame Ain't an MP3 Encoder) MP3 encoder wrapper.
@@ -502,6 +503,8 @@ Requires the presence of the libmp3lame headers and library during
 configuration. You need to explicitly configure the build with
+ at xref{libshine} for a fixed-point MP3 encoder, although with a lower quality.
 @subsection Options
 The following options are supported by the libmp3lame wrapper. The
@@ -570,6 +573,42 @@ default value is 0 (disabled).
 @end table
+ at anchor{libshine}
+ at section libshine
+Shine Fixed-Point MP3 encoder wrapper.
+Shine is a fixed-point MP3 encoder. It has a far better performance on
+platforms without an FPU, e.g. armel CPUs, and some phones and tablets.
+However, as it is more targeted on performance than quality, it is not on par
+with LAME and other production-grade encoders quality-wise. Also, according to
+the project's homepage, this encoder may not be free of bugs as the code was
+written a long time ago and the project was dead for at least 5 years.
+This encoder only supports stereo and mono input. This is also CBR-only.
+The original project (last updated in early 2007) is at
+ at url{http://sourceforge.net/projects/libshine-fxp/}. We only support the
+updated fork by the Savonet/Liquidsoap project at @url{https://github.com/savonet/shine}.
+Requires the presence of the libshine headers and library during
+configuration. You need to explicitly configure the build with
+ at code{--enable-libshine}.
+See also @ref{libmp3lame}.
+ at subsection Options
+The following options are supported by the libshine wrapper. The
+ at command{shineenc}-equivalent of the options are listed in parentheses.
+ at table @option
+ at item b (@emph{-b})
+Set bitrate expressed in bits/s for CBR. @command{shineenc} @option{-b} option
+is expressed in kilobits/s.
+ at end table
 @section libtwolame
 TwoLAME MP2 encoder wrapper.

More information about the ffmpeg-devel mailing list