summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorStefano Sabatini <stefasab@gmail.com>2023-08-26 02:53:28 +0200
committerStefano Sabatini <stefasab@gmail.com>2023-10-06 09:49:47 +0200
commitd0f071dfe743a410ff385c832b9c3ff47fd73c94 (patch)
tree3dbfbe8a71362bfaae2da4cabf461a1767dea4ae
parent6f421d9d4eb8425ce2ecb1f7f18b79ede3c60de9 (diff)
doc/encoders/libx264: clarify meaning of level option
In particular, clarify that it can either be set as a field of AVCodecContext or as an x264 option, using a different specification. Should address trac issue: http://trac.ffmpeg.org/ticket/3947
-rw-r--r--doc/encoders.texi14
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/encoders.texi b/doc/encoders.texi
index d7d9584a0c..bf9a41c22e 100644
--- a/doc/encoders.texi
+++ b/doc/encoders.texi
@@ -2446,6 +2446,20 @@ Quantizer curve compression factor
@item refs (@emph{ref})
Number of reference frames each P-frame can use. The range is from @var{0-16}.
+@item level (@emph{level})
+Set the @code{x264_param_t.i_level_idc} value in case the value is
+positive, it is ignored otherwise.
+
+This value can be set using the @code{AVCodecContext} API (e.g. by
+setting the @code{AVCodecContext} value directly), and is specified as
+an integer mapped on a corresponding level (e.g. the value 31 maps
+to H.264 level IDC "3.1", as defined in the @code{x264_levels}
+table). It is ignored when set to a non positive value.
+
+Alternatively it can be set as a private option, overriding the value
+set in @code{AVCodecContext}, and in this case must be specified as
+the level IDC identifier (e.g. "3.1"), as defined by H.264 Annex A.
+
@item sc_threshold (@emph{scenecut})
Sets the threshold for the scene change detection.