[FFmpeg-cvslog] doc: document the prores encoder options

[Anton Khirnov]

ffmpeg | branch: master | Anton Khirnov <anton at khirnov.net> | Sat Mar 23 00:13:44 2013 +0100| [f223ad1e000d56ef5231a3b1fc00495b538a9ed6] | committer: Anton Khirnov

doc: document the prores encoder options

Adapted from the author's blag.

Signed-off-by: Luca Barbato <lu_zero at gentoo.org>
Signed-off-by: Anton Khirnov <anton at khirnov.net>

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

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

diff --git a/doc/encoders.texi b/doc/encoders.texi
index a7cf248..8db1481 100644
--- a/doc/encoders.texi
+++ b/doc/encoders.texi
@@ -594,4 +594,62 @@ Override the x264 configuration using a :-separated list of key=value parameters
 Encoding avpresets for common usages are provided so they can be used with the
 general presets system (e.g. passing the @code{-pre} option).
 
+ at section ProRes
+
+Apple ProRes encoder.
+
+ at subsection Private Options
+
+ at table @option
+ at item profile @var{integer}
+Select the ProRes profile to encode
+ at table @samp
+ at item proxy
+ at item lt
+ at item standard
+ at item hq
+ at end table
+
+ at item quant_mat @var{integer}
+Select quantization matrix.
+ at table @samp
+ at item auto
+ at item default
+ at item proxy
+ at item lt
+ at item standard
+ at item hq
+ at end table
+If set to @var{auto}, the matrix matching the profile will be picked.
+If not set, the matrix providing the highest quality, @var{default}, will be
+picked.
+
+ at item bits_per_mb @var{integer}
+How many bits to allot for coding one macroblock. Different profiles use
+between 200 and 2400 bits per macroblock, the maximum is 8000.
+
+ at item mbs_per_slice @var{integer}
+Number of macroblocks in each slice (1-8); the default value (8)
+should be good in almost all situations.
+
+ at item vendor @var{string}
+Override the 4-byte vendor ID.
+A custom vendor ID like @var{apl0} would claim the stream was produced by
+the Apple encoder.
+
+ at end table
+
+ at subsection Speed considerations
+
+In the default mode of operation the encoder has to honor frame constraints
+(i.e. not produc frames with size bigger than requested) while still making
+output picture as good as possible.
+A frame containing a lot of small details is harder to compress and the encoder
+would spend more time searching for appropriate quantizers for each slice.
+
+Setting a higher @option{bits_per_mb} limit will improve the speed.
+
+For the fastest encoding speed set the @option{qscale} parameter (4 is the
+recommended value) and do not set a size constraint.
+
 @c man end VIDEO ENCODERS