Mercurial > hg > pmhd

comparison ffmpeg/doc/ffmpeg-codecs.1 @ 10:6840f77b83aa

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
commit
author Yading Song <yading.song@eecs.qmul.ac.uk>
date Sun, 21 Apr 2013 10:55:35 +0200
parents
children
comparison
equal deleted inserted replaced
9:ed610a0bbf83 10:6840f77b83aa
1 .\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14)
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sp \" Vertical space (when we can't use .PP)
6 .if t .sp .5v
7 .if n .sp
8 ..
9 .de Vb \" Begin verbatim text
10 .ft CW
11 .nf
12 .ne \\$1
13 ..
14 .de Ve \" End verbatim text
15 .ft R
16 .fi
17 ..
18 .\" Set up some character translations and predefined strings. \*(-- will
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20 .\" double quote, and \*(R" will give a right double quote. \*(C+ will
21 .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
22 .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
23 .\" nothing in troff, for use with C<>.
24 .tr \(*W-
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26 .ie n \{\
27 . ds -- \(*W-
28 . ds PI pi
29 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
31 . ds L" ""
32 . ds R" ""
33 . ds C` ""
34 . ds C' ""
35 'br\}
36 .el\{\
37 . ds -- \|\(em\|
38 . ds PI \(*p
39 . ds L" ``
40 . ds R" ''
41 'br\}
42 .\"
43 .\" Escape single quotes in literal strings from groff's Unicode transform.
44 .ie \n(.g .ds Aq \(aq
45 .el .ds Aq '
46 .\"
47 .\" If the F register is turned on, we'll generate index entries on stderr for
48 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
49 .\" entries marked with X<> in POD. Of course, you'll have to process the
50 .\" output yourself in some meaningful fashion.
51 .ie \nF \{\
52 . de IX
53 . tm Index:\\$1\t\\n%\t"\\$2"
54 ..
55 . nr % 0
56 . rr F
57 .\}
58 .el \{\
59 . de IX
60 ..
61 .\}
62 .\"
63 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
64 .\" Fear. Run. Save yourself. No user-serviceable parts.
65 . \" fudge factors for nroff and troff
66 .if n \{\
67 . ds #H 0
68 . ds #V .8m
69 . ds #F .3m
70 . ds #[ \f1
71 . ds #] \fP
72 .\}
73 .if t \{\
74 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
75 . ds #V .6m
76 . ds #F 0
77 . ds #[ \&
78 . ds #] \&
79 .\}
80 . \" simple accents for nroff and troff
81 .if n \{\
82 . ds ' \&
83 . ds ` \&
84 . ds ^ \&
85 . ds , \&
86 . ds ~ ~
87 . ds /
88 .\}
89 .if t \{\
90 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
91 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
92 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
93 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
94 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
95 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
96 .\}
97 . \" troff and (daisy-wheel) nroff accents
98 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
99 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
100 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
101 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
102 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
103 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
104 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
105 .ds ae a\h'-(\w'a'u*4/10)'e
106 .ds Ae A\h'-(\w'A'u*4/10)'E
107 . \" corrections for vroff
108 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
109 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
110 . \" for low resolution devices (crt and lpr)
111 .if \n(.H>23 .if \n(.V>19 \
112 \{\
113 . ds : e
114 . ds 8 ss
115 . ds o a
116 . ds d- d\h'-1'\(ga
117 . ds D- D\h'-1'\(hy
118 . ds th \o'bp'
119 . ds Th \o'LP'
120 . ds ae ae
121 . ds Ae AE
122 .\}
123 .rm #[ #] #H #V #F C
124 .\" ========================================================================
125 .\"
126 .IX Title "FFMPEG-CODECS 1"
127 .TH FFMPEG-CODECS 1 "2013-04-21" " " " "
128 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
129 .\" way too many mistakes in technical documents.
130 .if n .ad l
131 .nh
132 .SH "NAME"
133 ffmpeg\-codecs \- FFmpeg codecs
134 .SH "DESCRIPTION"
135 .IX Header "DESCRIPTION"
136 This document describes the codecs (decoders and encoders) provided by
137 the libavcodec library.
138 .SH "CODEC OPTIONS"
139 .IX Header "CODEC OPTIONS"
140 libavcodec provides some generic global options, which can be set on
141 all the encoders and decoders. In addition each codec may support
142 so-called private options, which are specific for a given codec.
143 .PP
144 Sometimes, a global option may only affect a specific kind of codec,
145 and may be unsensical or ignored by another, so you need to be aware
146 of the meaning of the specified options. Also some options are
147 meant only for decoding or encoding.
148 .PP
149 Options may be set by specifying \-\fIoption\fR \fIvalue\fR in the
150 FFmpeg tools, or by setting the value explicitly in the
151 \&\f(CW\*(C`AVCodecContext\*(C'\fR options or using the \fIlibavutil/opt.h\fR \s-1API\s0
152 for programmatic use.
153 .PP
154 The list of supported options follow:
155 .IP "\fBb\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
156 .IX Item "b integer (encoding,audio,video)"
157 Set bitrate in bits/s. Default value is 200K.
158 .IP "\fBab\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4
159 .IX Item "ab integer (encoding,audio)"
160 Set audio bitrate (in bits/s). Default value is 128K.
161 .IP "\fBbt\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
162 .IX Item "bt integer (encoding,video)"
163 Set video bitrate tolerance (in bits/s). In 1\-pass mode, bitrate
164 tolerance specifies how far ratecontrol is willing to deviate from the
165 target average bitrate value. This is not related to min/max
166 bitrate. Lowering tolerance too much has an adverse effect on quality.
167 .IP "\fBflags\fR \fIflags\fR \fB(\fR\fIdecoding/encoding,audio,video,subtitles\fR\fB)\fR" 4
168 .IX Item "flags flags (decoding/encoding,audio,video,subtitles)"
169 Set generic flags.
170 .Sp
171 Possible values:
172 .RS 4
173 .IP "\fBmv4\fR" 4
174 .IX Item "mv4"
175 Use four motion vector by macroblock (mpeg4).
176 .IP "\fBqpel\fR" 4
177 .IX Item "qpel"
178 Use 1/4 pel motion compensation.
179 .IP "\fBloop\fR" 4
180 .IX Item "loop"
181 Use loop filter.
182 .IP "\fBqscale\fR" 4
183 .IX Item "qscale"
184 Use fixed qscale.
185 .IP "\fBgmc\fR" 4
186 .IX Item "gmc"
187 Use gmc.
188 .IP "\fBmv0\fR" 4
189 .IX Item "mv0"
190 Always try a mb with mv=<0,0>.
191 .IP "\fBinput_preserved\fR" 4
192 .IX Item "input_preserved"
193 .PD 0
194 .IP "\fBpass1\fR" 4
195 .IX Item "pass1"
196 .PD
197 Use internal 2pass ratecontrol in first pass mode.
198 .IP "\fBpass2\fR" 4
199 .IX Item "pass2"
200 Use internal 2pass ratecontrol in second pass mode.
201 .IP "\fBgray\fR" 4
202 .IX Item "gray"
203 Only decode/encode grayscale.
204 .IP "\fBemu_edge\fR" 4
205 .IX Item "emu_edge"
206 Do not draw edges.
207 .IP "\fBpsnr\fR" 4
208 .IX Item "psnr"
209 Set error[?] variables during encoding.
210 .IP "\fBtruncated\fR" 4
211 .IX Item "truncated"
212 .PD 0
213 .IP "\fBnaq\fR" 4
214 .IX Item "naq"
215 .PD
216 Normalize adaptive quantization.
217 .IP "\fBildct\fR" 4
218 .IX Item "ildct"
219 Use interlaced \s-1DCT\s0.
220 .IP "\fBlow_delay\fR" 4
221 .IX Item "low_delay"
222 Force low delay.
223 .IP "\fBglobal_header\fR" 4
224 .IX Item "global_header"
225 Place global headers in extradata instead of every keyframe.
226 .IP "\fBbitexact\fR" 4
227 .IX Item "bitexact"
228 Use only bitexact stuff (except (I)DCT).
229 .IP "\fBaic\fR" 4
230 .IX Item "aic"
231 Apply H263 advanced intra coding / mpeg4 ac prediction.
232 .IP "\fBcbp\fR" 4
233 .IX Item "cbp"
234 Deprecated, use mpegvideo private options instead.
235 .IP "\fBqprd\fR" 4
236 .IX Item "qprd"
237 Deprecated, use mpegvideo private options instead.
238 .IP "\fBilme\fR" 4
239 .IX Item "ilme"
240 Apply interlaced motion estimation.
241 .IP "\fBcgop\fR" 4
242 .IX Item "cgop"
243 Use closed gop.
244 .RE
245 .RS 4
246 .RE
247 .IP "\fBsub_id\fR \fIinteger\fR" 4
248 .IX Item "sub_id integer"
249 Deprecated, currently unused.
250 .IP "\fBme_method\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
251 .IX Item "me_method integer (encoding,video)"
252 Set motion estimation method.
253 .Sp
254 Possible values:
255 .RS 4
256 .IP "\fBzero\fR" 4
257 .IX Item "zero"
258 zero motion estimation (fastest)
259 .IP "\fBfull\fR" 4
260 .IX Item "full"
261 full motion estimation (slowest)
262 .IP "\fBepzs\fR" 4
263 .IX Item "epzs"
264 \&\s-1EPZS\s0 motion estimation (default)
265 .IP "\fBesa\fR" 4
266 .IX Item "esa"
267 esa motion estimation (alias for full)
268 .IP "\fBtesa\fR" 4
269 .IX Item "tesa"
270 tesa motion estimation
271 .IP "\fBdia\fR" 4
272 .IX Item "dia"
273 dia motion estimation (alias for epzs)
274 .IP "\fBlog\fR" 4
275 .IX Item "log"
276 log motion estimation
277 .IP "\fBphods\fR" 4
278 .IX Item "phods"
279 phods motion estimation
280 .IP "\fBx1\fR" 4
281 .IX Item "x1"
282 X1 motion estimation
283 .IP "\fBhex\fR" 4
284 .IX Item "hex"
285 hex motion estimation
286 .IP "\fBumh\fR" 4
287 .IX Item "umh"
288 umh motion estimation
289 .IP "\fBiter\fR" 4
290 .IX Item "iter"
291 iter motion estimation
292 .RE
293 .RS 4
294 .RE
295 .IP "\fBextradata_size\fR \fIinteger\fR" 4
296 .IX Item "extradata_size integer"
297 Set extradata size.
298 .IP "\fBtime_base\fR \fIrational number\fR" 4
299 .IX Item "time_base rational number"
300 Set codec time base.
301 .Sp
302 It is the fundamental unit of time (in seconds) in terms of which
303 frame timestamps are represented. For fixed-fps content, timebase
304 should be \f(CW\*(C`1 / frame_rate\*(C'\fR and timestamp increments should be
305 identically 1.
306 .IP "\fBg\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
307 .IX Item "g integer (encoding,video)"
308 Set the group of picture size. Default value is 12.
309 .IP "\fBar\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,audio\fR\fB)\fR" 4
310 .IX Item "ar integer (decoding/encoding,audio)"
311 Set audio sampling rate (in Hz).
312 .IP "\fBac\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,audio\fR\fB)\fR" 4
313 .IX Item "ac integer (decoding/encoding,audio)"
314 Set number of audio channels.
315 .IP "\fBcutoff\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4
316 .IX Item "cutoff integer (encoding,audio)"
317 Set cutoff bandwidth.
318 .IP "\fBframe_size\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4
319 .IX Item "frame_size integer (encoding,audio)"
320 Set audio frame size.
321 .Sp
322 Each submitted frame except the last must contain exactly frame_size
323 samples per channel. May be 0 when the codec has
324 \&\s-1CODEC_CAP_VARIABLE_FRAME_SIZE\s0 set, in that case the frame size is not
325 restricted. It is set by some decoders to indicate constant frame
326 size.
327 .IP "\fBframe_number\fR \fIinteger\fR" 4
328 .IX Item "frame_number integer"
329 Set the frame number.
330 .IP "\fBdelay\fR \fIinteger\fR" 4
331 .IX Item "delay integer"
332 .PD 0
333 .IP "\fBqcomp\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
334 .IX Item "qcomp float (encoding,video)"
335 .PD
336 Set video quantizer scale compression (\s-1VBR\s0). It is used as a constant
337 in the ratecontrol equation. Recommended range for default rc_eq:
338 0.0\-1.0.
339 .IP "\fBqblur\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
340 .IX Item "qblur float (encoding,video)"
341 Set video quantizer scale blur (\s-1VBR\s0).
342 .IP "\fBqmin\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
343 .IX Item "qmin integer (encoding,video)"
344 Set min video quantizer scale (\s-1VBR\s0). Must be included between \-1 and
345 69, default value is 2.
346 .IP "\fBqmax\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
347 .IX Item "qmax integer (encoding,video)"
348 Set max video quantizer scale (\s-1VBR\s0). Must be included between \-1 and
349 1024, default value is 31.
350 .IP "\fBqdiff\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
351 .IX Item "qdiff integer (encoding,video)"
352 Set max difference between the quantizer scale (\s-1VBR\s0).
353 .IP "\fBbf\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
354 .IX Item "bf integer (encoding,video)"
355 Set max number of B frames.
356 .IP "\fBb_qfactor\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
357 .IX Item "b_qfactor float (encoding,video)"
358 Set qp factor between P and B frames.
359 .IP "\fBrc_strategy\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
360 .IX Item "rc_strategy integer (encoding,video)"
361 Set ratecontrol method.
362 .IP "\fBb_strategy\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
363 .IX Item "b_strategy integer (encoding,video)"
364 Set strategy to choose between I/P/B\-frames.
365 .IP "\fBps\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
366 .IX Item "ps integer (encoding,video)"
367 Set \s-1RTP\s0 payload size in bytes.
368 .IP "\fBmv_bits\fR \fIinteger\fR" 4
369 .IX Item "mv_bits integer"
370 .PD 0
371 .IP "\fBheader_bits\fR \fIinteger\fR" 4
372 .IX Item "header_bits integer"
373 .IP "\fBi_tex_bits\fR \fIinteger\fR" 4
374 .IX Item "i_tex_bits integer"
375 .IP "\fBp_tex_bits\fR \fIinteger\fR" 4
376 .IX Item "p_tex_bits integer"
377 .IP "\fBi_count\fR \fIinteger\fR" 4
378 .IX Item "i_count integer"
379 .IP "\fBp_count\fR \fIinteger\fR" 4
380 .IX Item "p_count integer"
381 .IP "\fBskip_count\fR \fIinteger\fR" 4
382 .IX Item "skip_count integer"
383 .IP "\fBmisc_bits\fR \fIinteger\fR" 4
384 .IX Item "misc_bits integer"
385 .IP "\fBframe_bits\fR \fIinteger\fR" 4
386 .IX Item "frame_bits integer"
387 .IP "\fBcodec_tag\fR \fIinteger\fR" 4
388 .IX Item "codec_tag integer"
389 .IP "\fBbug\fR \fIflags\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
390 .IX Item "bug flags (decoding,video)"
391 .PD
392 Workaround not auto detected encoder bugs.
393 .Sp
394 Possible values:
395 .RS 4
396 .IP "\fBautodetect\fR" 4
397 .IX Item "autodetect"
398 .PD 0
399 .IP "\fBold_msmpeg4\fR" 4
400 .IX Item "old_msmpeg4"
401 .PD
402 some old lavc generated msmpeg4v3 files (no autodetection)
403 .IP "\fBxvid_ilace\fR" 4
404 .IX Item "xvid_ilace"
405 Xvid interlacing bug (autodetected if fourcc==XVIX)
406 .IP "\fBump4\fR" 4
407 .IX Item "ump4"
408 (autodetected if fourcc==UMP4)
409 .IP "\fBno_padding\fR" 4
410 .IX Item "no_padding"
411 padding bug (autodetected)
412 .IP "\fBamv\fR" 4
413 .IX Item "amv"
414 .PD 0
415 .IP "\fBac_vlc\fR" 4
416 .IX Item "ac_vlc"
417 .PD
418 illegal vlc bug (autodetected per fourcc)
419 .IP "\fBqpel_chroma\fR" 4
420 .IX Item "qpel_chroma"
421 .PD 0
422 .IP "\fBstd_qpel\fR" 4
423 .IX Item "std_qpel"
424 .PD
425 old standard qpel (autodetected per fourcc/version)
426 .IP "\fBqpel_chroma2\fR" 4
427 .IX Item "qpel_chroma2"
428 .PD 0
429 .IP "\fBdirect_blocksize\fR" 4
430 .IX Item "direct_blocksize"
431 .PD
432 direct-qpel-blocksize bug (autodetected per fourcc/version)
433 .IP "\fBedge\fR" 4
434 .IX Item "edge"
435 edge padding bug (autodetected per fourcc/version)
436 .IP "\fBhpel_chroma\fR" 4
437 .IX Item "hpel_chroma"
438 .PD 0
439 .IP "\fBdc_clip\fR" 4
440 .IX Item "dc_clip"
441 .IP "\fBms\fR" 4
442 .IX Item "ms"
443 .PD
444 Workaround various bugs in microsoft broken decoders.
445 .IP "\fBtrunc\fR" 4
446 .IX Item "trunc"
447 trancated frames
448 .RE
449 .RS 4
450 .RE
451 .IP "\fBlelim\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
452 .IX Item "lelim integer (encoding,video)"
453 Set single coefficient elimination threshold for luminance (negative
454 values also consider \s-1DC\s0 coefficient).
455 .IP "\fBcelim\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
456 .IX Item "celim integer (encoding,video)"
457 Set single coefficient elimination threshold for chrominance (negative
458 values also consider dc coefficient)
459 .IP "\fBstrict\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,audio,video\fR\fB)\fR" 4
460 .IX Item "strict integer (decoding/encoding,audio,video)"
461 Specify how strictly to follow the standards.
462 .Sp
463 Possible values:
464 .RS 4
465 .IP "\fBvery\fR" 4
466 .IX Item "very"
467 strictly conform to a older more strict version of the spec or reference software
468 .IP "\fBstrict\fR" 4
469 .IX Item "strict"
470 strictly conform to all the things in the spec no matter what consequences
471 .IP "\fBnormal\fR" 4
472 .IX Item "normal"
473 .PD 0
474 .IP "\fBunofficial\fR" 4
475 .IX Item "unofficial"
476 .PD
477 allow unofficial extensions
478 .IP "\fBexperimental\fR" 4
479 .IX Item "experimental"
480 allow non standardized experimental things
481 .RE
482 .RS 4
483 .RE
484 .IP "\fBb_qoffset\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
485 .IX Item "b_qoffset float (encoding,video)"
486 Set \s-1QP\s0 offset between P and B frames.
487 .IP "\fBerr_detect\fR \fIflags\fR \fB(\fR\fIdecoding,audio,video\fR\fB)\fR" 4
488 .IX Item "err_detect flags (decoding,audio,video)"
489 Set error detection flags.
490 .Sp
491 Possible values:
492 .RS 4
493 .IP "\fBcrccheck\fR" 4
494 .IX Item "crccheck"
495 verify embedded CRCs
496 .IP "\fBbitstream\fR" 4
497 .IX Item "bitstream"
498 detect bitstream specification deviations
499 .IP "\fBbuffer\fR" 4
500 .IX Item "buffer"
501 detect improper bitstream length
502 .IP "\fBexplode\fR" 4
503 .IX Item "explode"
504 abort decoding on minor error detection
505 .IP "\fBcareful\fR" 4
506 .IX Item "careful"
507 consider things that violate the spec and have not been seen in the wild as errors
508 .IP "\fBcompliant\fR" 4
509 .IX Item "compliant"
510 consider all spec non compliancies as errors
511 .IP "\fBaggressive\fR" 4
512 .IX Item "aggressive"
513 consider things that a sane encoder should not do as an error
514 .RE
515 .RS 4
516 .RE
517 .IP "\fBhas_b_frames\fR \fIinteger\fR" 4
518 .IX Item "has_b_frames integer"
519 .PD 0
520 .IP "\fBblock_align\fR \fIinteger\fR" 4
521 .IX Item "block_align integer"
522 .IP "\fBmpeg_quant\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
523 .IX Item "mpeg_quant integer (encoding,video)"
524 .PD
525 Use \s-1MPEG\s0 quantizers instead of H.263.
526 .IP "\fBqsquish\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
527 .IX Item "qsquish float (encoding,video)"
528 How to keep quantizer between qmin and qmax (0 = clip, 1 = use
529 differentiable function).
530 .IP "\fBrc_qmod_amp\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
531 .IX Item "rc_qmod_amp float (encoding,video)"
532 Set experimental quantizer modulation.
533 .IP "\fBrc_qmod_freq\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
534 .IX Item "rc_qmod_freq integer (encoding,video)"
535 Set experimental quantizer modulation.
536 .IP "\fBrc_override_count\fR \fIinteger\fR" 4
537 .IX Item "rc_override_count integer"
538 .PD 0
539 .IP "\fBrc_eq\fR \fIstring\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
540 .IX Item "rc_eq string (encoding,video)"
541 .PD
542 Set rate control equation. When computing the expression, besides the
543 standard functions defined in the section 'Expression Evaluation', the
544 following functions are available: bits2qp(bits), qp2bits(qp). Also
545 the following constants are available: iTex pTex tex mv fCode iCount
546 mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex
547 avgTex.
548 .IP "\fBmaxrate\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
549 .IX Item "maxrate integer (encoding,audio,video)"
550 Set max bitrate tolerance (in bits/s). Requires bufsize to be set.
551 .IP "\fBminrate\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
552 .IX Item "minrate integer (encoding,audio,video)"
553 Set min bitrate tolerance (in bits/s). Most useful in setting up a \s-1CBR\s0
554 encode. It is of little use elsewise.
555 .IP "\fBbufsize\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
556 .IX Item "bufsize integer (encoding,audio,video)"
557 Set ratecontrol buffer size (in bits).
558 .IP "\fBrc_buf_aggressivity\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
559 .IX Item "rc_buf_aggressivity float (encoding,video)"
560 Currently useless.
561 .IP "\fBi_qfactor\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
562 .IX Item "i_qfactor float (encoding,video)"
563 Set \s-1QP\s0 factor between P and I frames.
564 .IP "\fBi_qoffset\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
565 .IX Item "i_qoffset float (encoding,video)"
566 Set \s-1QP\s0 offset between P and I frames.
567 .IP "\fBrc_init_cplx\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
568 .IX Item "rc_init_cplx float (encoding,video)"
569 Set initial complexity for 1\-pass encoding.
570 .IP "\fBdct\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
571 .IX Item "dct integer (encoding,video)"
572 Set \s-1DCT\s0 algorithm.
573 .Sp
574 Possible values:
575 .RS 4
576 .IP "\fBauto\fR" 4
577 .IX Item "auto"
578 autoselect a good one (default)
579 .IP "\fBfastint\fR" 4
580 .IX Item "fastint"
581 fast integer
582 .IP "\fBint\fR" 4
583 .IX Item "int"
584 accurate integer
585 .IP "\fBmmx\fR" 4
586 .IX Item "mmx"
587 .PD 0
588 .IP "\fBaltivec\fR" 4
589 .IX Item "altivec"
590 .IP "\fBfaan\fR" 4
591 .IX Item "faan"
592 .PD
593 floating point \s-1AAN\s0 \s-1DCT\s0
594 .RE
595 .RS 4
596 .RE
597 .IP "\fBlumi_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
598 .IX Item "lumi_mask float (encoding,video)"
599 Compress bright areas stronger than medium ones.
600 .IP "\fBtcplx_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
601 .IX Item "tcplx_mask float (encoding,video)"
602 Set temporal complexity masking.
603 .IP "\fBscplx_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
604 .IX Item "scplx_mask float (encoding,video)"
605 Set spatial complexity masking.
606 .IP "\fBp_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
607 .IX Item "p_mask float (encoding,video)"
608 Set inter masking.
609 .IP "\fBdark_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
610 .IX Item "dark_mask float (encoding,video)"
611 Compress dark areas stronger than medium ones.
612 .IP "\fBidct\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
613 .IX Item "idct integer (decoding/encoding,video)"
614 Select \s-1IDCT\s0 implementation.
615 .Sp
616 Possible values:
617 .RS 4
618 .IP "\fBauto\fR" 4
619 .IX Item "auto"
620 .PD 0
621 .IP "\fBint\fR" 4
622 .IX Item "int"
623 .IP "\fBsimple\fR" 4
624 .IX Item "simple"
625 .IP "\fBsimplemmx\fR" 4
626 .IX Item "simplemmx"
627 .IP "\fBlibmpeg2mmx\fR" 4
628 .IX Item "libmpeg2mmx"
629 .IP "\fBmmi\fR" 4
630 .IX Item "mmi"
631 .IP "\fBarm\fR" 4
632 .IX Item "arm"
633 .IP "\fBaltivec\fR" 4
634 .IX Item "altivec"
635 .IP "\fBsh4\fR" 4
636 .IX Item "sh4"
637 .IP "\fBsimplearm\fR" 4
638 .IX Item "simplearm"
639 .IP "\fBsimplearmv5te\fR" 4
640 .IX Item "simplearmv5te"
641 .IP "\fBsimplearmv6\fR" 4
642 .IX Item "simplearmv6"
643 .IP "\fBsimpleneon\fR" 4
644 .IX Item "simpleneon"
645 .IP "\fBsimplealpha\fR" 4
646 .IX Item "simplealpha"
647 .IP "\fBh264\fR" 4
648 .IX Item "h264"
649 .IP "\fBvp3\fR" 4
650 .IX Item "vp3"
651 .IP "\fBipp\fR" 4
652 .IX Item "ipp"
653 .IP "\fBxvidmmx\fR" 4
654 .IX Item "xvidmmx"
655 .IP "\fBfaani\fR" 4
656 .IX Item "faani"
657 .PD
658 floating point \s-1AAN\s0 \s-1IDCT\s0
659 .RE
660 .RS 4
661 .RE
662 .IP "\fBslice_count\fR \fIinteger\fR" 4
663 .IX Item "slice_count integer"
664 .PD 0
665 .IP "\fBec\fR \fIflags\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
666 .IX Item "ec flags (decoding,video)"
667 .PD
668 Set error concealment strategy.
669 .Sp
670 Possible values:
671 .RS 4
672 .IP "\fBguess_mvs\fR" 4
673 .IX Item "guess_mvs"
674 iterative motion vector (\s-1MV\s0) search (slow)
675 .IP "\fBdeblock\fR" 4
676 .IX Item "deblock"
677 use strong deblock filter for damaged MBs
678 .RE
679 .RS 4
680 .RE
681 .IP "\fBbits_per_coded_sample\fR \fIinteger\fR" 4
682 .IX Item "bits_per_coded_sample integer"
683 .PD 0
684 .IP "\fBpred\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
685 .IX Item "pred integer (encoding,video)"
686 .PD
687 Set prediction method.
688 .Sp
689 Possible values:
690 .RS 4
691 .IP "\fBleft\fR" 4
692 .IX Item "left"
693 .PD 0
694 .IP "\fBplane\fR" 4
695 .IX Item "plane"
696 .IP "\fBmedian\fR" 4
697 .IX Item "median"
698 .RE
699 .RS 4
700 .RE
701 .IP "\fBaspect\fR \fIrational number\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
702 .IX Item "aspect rational number (encoding,video)"
703 .PD
704 Set sample aspect ratio.
705 .IP "\fBdebug\fR \fIflags\fR \fB(\fR\fIdecoding/encoding,audio,video,subtitles\fR\fB)\fR" 4
706 .IX Item "debug flags (decoding/encoding,audio,video,subtitles)"
707 Print specific debug info.
708 .Sp
709 Possible values:
710 .RS 4
711 .IP "\fBpict\fR" 4
712 .IX Item "pict"
713 picture info
714 .IP "\fBrc\fR" 4
715 .IX Item "rc"
716 rate control
717 .IP "\fBbitstream\fR" 4
718 .IX Item "bitstream"
719 .PD 0
720 .IP "\fBmb_type\fR" 4
721 .IX Item "mb_type"
722 .PD
723 macroblock (\s-1MB\s0) type
724 .IP "\fBqp\fR" 4
725 .IX Item "qp"
726 per-block quantization parameter (\s-1QP\s0)
727 .IP "\fBmv\fR" 4
728 .IX Item "mv"
729 motion vector
730 .IP "\fBdct_coeff\fR" 4
731 .IX Item "dct_coeff"
732 .PD 0
733 .IP "\fBskip\fR" 4
734 .IX Item "skip"
735 .IP "\fBstartcode\fR" 4
736 .IX Item "startcode"
737 .IP "\fBpts\fR" 4
738 .IX Item "pts"
739 .IP "\fBer\fR" 4
740 .IX Item "er"
741 .PD
742 error recognition
743 .IP "\fBmmco\fR" 4
744 .IX Item "mmco"
745 memory management control operations (H.264)
746 .IP "\fBbugs\fR" 4
747 .IX Item "bugs"
748 .PD 0
749 .IP "\fBvis_qp\fR" 4
750 .IX Item "vis_qp"
751 .PD
752 visualize quantization parameter (\s-1QP\s0), lower \s-1QP\s0 are tinted greener
753 .IP "\fBvis_mb_type\fR" 4
754 .IX Item "vis_mb_type"
755 visualize block types
756 .IP "\fBbuffers\fR" 4
757 .IX Item "buffers"
758 picture buffer allocations
759 .IP "\fBthread_ops\fR" 4
760 .IX Item "thread_ops"
761 threading operations
762 .RE
763 .RS 4
764 .RE
765 .IP "\fBvismv\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
766 .IX Item "vismv integer (decoding,video)"
767 Visualize motion vectors (MVs).
768 .Sp
769 Possible values:
770 .RS 4
771 .IP "\fBpf\fR" 4
772 .IX Item "pf"
773 forward predicted MVs of P\-frames
774 .IP "\fBbf\fR" 4
775 .IX Item "bf"
776 forward predicted MVs of B\-frames
777 .IP "\fBbb\fR" 4
778 .IX Item "bb"
779 backward predicted MVs of B\-frames
780 .RE
781 .RS 4
782 .RE
783 .IP "\fBcmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
784 .IX Item "cmp integer (encoding,video)"
785 Set full pel me compare function.
786 .Sp
787 Possible values:
788 .RS 4
789 .IP "\fBsad\fR" 4
790 .IX Item "sad"
791 sum of absolute differences, fast (default)
792 .IP "\fBsse\fR" 4
793 .IX Item "sse"
794 sum of squared errors
795 .IP "\fBsatd\fR" 4
796 .IX Item "satd"
797 sum of absolute Hadamard transformed differences
798 .IP "\fBdct\fR" 4
799 .IX Item "dct"
800 sum of absolute \s-1DCT\s0 transformed differences
801 .IP "\fBpsnr\fR" 4
802 .IX Item "psnr"
803 sum of squared quantization errors (avoid, low quality)
804 .IP "\fBbit\fR" 4
805 .IX Item "bit"
806 number of bits needed for the block
807 .IP "\fBrd\fR" 4
808 .IX Item "rd"
809 rate distortion optimal, slow
810 .IP "\fBzero\fR" 4
811 .IX Item "zero"
812 0
813 .IP "\fBvsad\fR" 4
814 .IX Item "vsad"
815 sum of absolute vertical differences
816 .IP "\fBvsse\fR" 4
817 .IX Item "vsse"
818 sum of squared vertical differences
819 .IP "\fBnsse\fR" 4
820 .IX Item "nsse"
821 noise preserving sum of squared differences
822 .IP "\fBw53\fR" 4
823 .IX Item "w53"
824 5/3 wavelet, only used in snow
825 .IP "\fBw97\fR" 4
826 .IX Item "w97"
827 9/7 wavelet, only used in snow
828 .IP "\fBdctmax\fR" 4
829 .IX Item "dctmax"
830 .PD 0
831 .IP "\fBchroma\fR" 4
832 .IX Item "chroma"
833 .RE
834 .RS 4
835 .RE
836 .IP "\fBsubcmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
837 .IX Item "subcmp integer (encoding,video)"
838 .PD
839 Set sub pel me compare function.
840 .Sp
841 Possible values:
842 .RS 4
843 .IP "\fBsad\fR" 4
844 .IX Item "sad"
845 sum of absolute differences, fast (default)
846 .IP "\fBsse\fR" 4
847 .IX Item "sse"
848 sum of squared errors
849 .IP "\fBsatd\fR" 4
850 .IX Item "satd"
851 sum of absolute Hadamard transformed differences
852 .IP "\fBdct\fR" 4
853 .IX Item "dct"
854 sum of absolute \s-1DCT\s0 transformed differences
855 .IP "\fBpsnr\fR" 4
856 .IX Item "psnr"
857 sum of squared quantization errors (avoid, low quality)
858 .IP "\fBbit\fR" 4
859 .IX Item "bit"
860 number of bits needed for the block
861 .IP "\fBrd\fR" 4
862 .IX Item "rd"
863 rate distortion optimal, slow
864 .IP "\fBzero\fR" 4
865 .IX Item "zero"
866 0
867 .IP "\fBvsad\fR" 4
868 .IX Item "vsad"
869 sum of absolute vertical differences
870 .IP "\fBvsse\fR" 4
871 .IX Item "vsse"
872 sum of squared vertical differences
873 .IP "\fBnsse\fR" 4
874 .IX Item "nsse"
875 noise preserving sum of squared differences
876 .IP "\fBw53\fR" 4
877 .IX Item "w53"
878 5/3 wavelet, only used in snow
879 .IP "\fBw97\fR" 4
880 .IX Item "w97"
881 9/7 wavelet, only used in snow
882 .IP "\fBdctmax\fR" 4
883 .IX Item "dctmax"
884 .PD 0
885 .IP "\fBchroma\fR" 4
886 .IX Item "chroma"
887 .RE
888 .RS 4
889 .RE
890 .IP "\fBmbcmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
891 .IX Item "mbcmp integer (encoding,video)"
892 .PD
893 Set macroblock compare function.
894 .Sp
895 Possible values:
896 .RS 4
897 .IP "\fBsad\fR" 4
898 .IX Item "sad"
899 sum of absolute differences, fast (default)
900 .IP "\fBsse\fR" 4
901 .IX Item "sse"
902 sum of squared errors
903 .IP "\fBsatd\fR" 4
904 .IX Item "satd"
905 sum of absolute Hadamard transformed differences
906 .IP "\fBdct\fR" 4
907 .IX Item "dct"
908 sum of absolute \s-1DCT\s0 transformed differences
909 .IP "\fBpsnr\fR" 4
910 .IX Item "psnr"
911 sum of squared quantization errors (avoid, low quality)
912 .IP "\fBbit\fR" 4
913 .IX Item "bit"
914 number of bits needed for the block
915 .IP "\fBrd\fR" 4
916 .IX Item "rd"
917 rate distortion optimal, slow
918 .IP "\fBzero\fR" 4
919 .IX Item "zero"
920 0
921 .IP "\fBvsad\fR" 4
922 .IX Item "vsad"
923 sum of absolute vertical differences
924 .IP "\fBvsse\fR" 4
925 .IX Item "vsse"
926 sum of squared vertical differences
927 .IP "\fBnsse\fR" 4
928 .IX Item "nsse"
929 noise preserving sum of squared differences
930 .IP "\fBw53\fR" 4
931 .IX Item "w53"
932 5/3 wavelet, only used in snow
933 .IP "\fBw97\fR" 4
934 .IX Item "w97"
935 9/7 wavelet, only used in snow
936 .IP "\fBdctmax\fR" 4
937 .IX Item "dctmax"
938 .PD 0
939 .IP "\fBchroma\fR" 4
940 .IX Item "chroma"
941 .RE
942 .RS 4
943 .RE
944 .IP "\fBildctcmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
945 .IX Item "ildctcmp integer (encoding,video)"
946 .PD
947 Set interlaced dct compare function.
948 .Sp
949 Possible values:
950 .RS 4
951 .IP "\fBsad\fR" 4
952 .IX Item "sad"
953 sum of absolute differences, fast (default)
954 .IP "\fBsse\fR" 4
955 .IX Item "sse"
956 sum of squared errors
957 .IP "\fBsatd\fR" 4
958 .IX Item "satd"
959 sum of absolute Hadamard transformed differences
960 .IP "\fBdct\fR" 4
961 .IX Item "dct"
962 sum of absolute \s-1DCT\s0 transformed differences
963 .IP "\fBpsnr\fR" 4
964 .IX Item "psnr"
965 sum of squared quantization errors (avoid, low quality)
966 .IP "\fBbit\fR" 4
967 .IX Item "bit"
968 number of bits needed for the block
969 .IP "\fBrd\fR" 4
970 .IX Item "rd"
971 rate distortion optimal, slow
972 .IP "\fBzero\fR" 4
973 .IX Item "zero"
974 0
975 .IP "\fBvsad\fR" 4
976 .IX Item "vsad"
977 sum of absolute vertical differences
978 .IP "\fBvsse\fR" 4
979 .IX Item "vsse"
980 sum of squared vertical differences
981 .IP "\fBnsse\fR" 4
982 .IX Item "nsse"
983 noise preserving sum of squared differences
984 .IP "\fBw53\fR" 4
985 .IX Item "w53"
986 5/3 wavelet, only used in snow
987 .IP "\fBw97\fR" 4
988 .IX Item "w97"
989 9/7 wavelet, only used in snow
990 .IP "\fBdctmax\fR" 4
991 .IX Item "dctmax"
992 .PD 0
993 .IP "\fBchroma\fR" 4
994 .IX Item "chroma"
995 .RE
996 .RS 4
997 .RE
998 .IP "\fBdia_size\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
999 .IX Item "dia_size integer (encoding,video)"
1000 .PD
1001 Set diamond type & size for motion estimation.
1002 .IP "\fBlast_pred\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1003 .IX Item "last_pred integer (encoding,video)"
1004 Set amount of motion predictors from the previous frame.
1005 .IP "\fBpreme\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1006 .IX Item "preme integer (encoding,video)"
1007 Set pre motion estimation.
1008 .IP "\fBprecmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1009 .IX Item "precmp integer (encoding,video)"
1010 Set pre motion estimation compare function.
1011 .Sp
1012 Possible values:
1013 .RS 4
1014 .IP "\fBsad\fR" 4
1015 .IX Item "sad"
1016 sum of absolute differences, fast (default)
1017 .IP "\fBsse\fR" 4
1018 .IX Item "sse"
1019 sum of squared errors
1020 .IP "\fBsatd\fR" 4
1021 .IX Item "satd"
1022 sum of absolute Hadamard transformed differences
1023 .IP "\fBdct\fR" 4
1024 .IX Item "dct"
1025 sum of absolute \s-1DCT\s0 transformed differences
1026 .IP "\fBpsnr\fR" 4
1027 .IX Item "psnr"
1028 sum of squared quantization errors (avoid, low quality)
1029 .IP "\fBbit\fR" 4
1030 .IX Item "bit"
1031 number of bits needed for the block
1032 .IP "\fBrd\fR" 4
1033 .IX Item "rd"
1034 rate distortion optimal, slow
1035 .IP "\fBzero\fR" 4
1036 .IX Item "zero"
1037 0
1038 .IP "\fBvsad\fR" 4
1039 .IX Item "vsad"
1040 sum of absolute vertical differences
1041 .IP "\fBvsse\fR" 4
1042 .IX Item "vsse"
1043 sum of squared vertical differences
1044 .IP "\fBnsse\fR" 4
1045 .IX Item "nsse"
1046 noise preserving sum of squared differences
1047 .IP "\fBw53\fR" 4
1048 .IX Item "w53"
1049 5/3 wavelet, only used in snow
1050 .IP "\fBw97\fR" 4
1051 .IX Item "w97"
1052 9/7 wavelet, only used in snow
1053 .IP "\fBdctmax\fR" 4
1054 .IX Item "dctmax"
1055 .PD 0
1056 .IP "\fBchroma\fR" 4
1057 .IX Item "chroma"
1058 .RE
1059 .RS 4
1060 .RE
1061 .IP "\fBpre_dia_size\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1062 .IX Item "pre_dia_size integer (encoding,video)"
1063 .PD
1064 Set diamond type & size for motion estimation pre-pass.
1065 .IP "\fBsubq\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1066 .IX Item "subq integer (encoding,video)"
1067 Set sub pel motion estimation quality.
1068 .IP "\fBdtg_active_format\fR \fIinteger\fR" 4
1069 .IX Item "dtg_active_format integer"
1070 .PD 0
1071 .IP "\fBme_range\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1072 .IX Item "me_range integer (encoding,video)"
1073 .PD
1074 Set limit motion vectors range (1023 for DivX player).
1075 .IP "\fBibias\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1076 .IX Item "ibias integer (encoding,video)"
1077 Set intra quant bias.
1078 .IP "\fBpbias\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1079 .IX Item "pbias integer (encoding,video)"
1080 Set inter quant bias.
1081 .IP "\fBcolor_table_id\fR \fIinteger\fR" 4
1082 .IX Item "color_table_id integer"
1083 .PD 0
1084 .IP "\fBglobal_quality\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
1085 .IX Item "global_quality integer (encoding,audio,video)"
1086 .IP "\fBcoder\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1087 .IX Item "coder integer (encoding,video)"
1088 .PD
1089 Possible values:
1090 .RS 4
1091 .IP "\fBvlc\fR" 4
1092 .IX Item "vlc"
1093 variable length coder / huffman coder
1094 .IP "\fBac\fR" 4
1095 .IX Item "ac"
1096 arithmetic coder
1097 .IP "\fBraw\fR" 4
1098 .IX Item "raw"
1099 raw (no encoding)
1100 .IP "\fBrle\fR" 4
1101 .IX Item "rle"
1102 run-length coder
1103 .IP "\fBdeflate\fR" 4
1104 .IX Item "deflate"
1105 deflate-based coder
1106 .RE
1107 .RS 4
1108 .RE
1109 .IP "\fBcontext\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1110 .IX Item "context integer (encoding,video)"
1111 Set context model.
1112 .IP "\fBslice_flags\fR \fIinteger\fR" 4
1113 .IX Item "slice_flags integer"
1114 .PD 0
1115 .IP "\fBxvmc_acceleration\fR \fIinteger\fR" 4
1116 .IX Item "xvmc_acceleration integer"
1117 .IP "\fBmbd\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1118 .IX Item "mbd integer (encoding,video)"
1119 .PD
1120 Set macroblock decision algorithm (high quality mode).
1121 .Sp
1122 Possible values:
1123 .RS 4
1124 .IP "\fBsimple\fR" 4
1125 .IX Item "simple"
1126 use mbcmp (default)
1127 .IP "\fBbits\fR" 4
1128 .IX Item "bits"
1129 use fewest bits
1130 .IP "\fBrd\fR" 4
1131 .IX Item "rd"
1132 use best rate distortion
1133 .RE
1134 .RS 4
1135 .RE
1136 .IP "\fBstream_codec_tag\fR \fIinteger\fR" 4
1137 .IX Item "stream_codec_tag integer"
1138 .PD 0
1139 .IP "\fBsc_threshold\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1140 .IX Item "sc_threshold integer (encoding,video)"
1141 .PD
1142 Set scene change threshold.
1143 .IP "\fBlmin\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1144 .IX Item "lmin integer (encoding,video)"
1145 Set min lagrange factor (\s-1VBR\s0).
1146 .IP "\fBlmax\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1147 .IX Item "lmax integer (encoding,video)"
1148 Set max lagrange factor (\s-1VBR\s0).
1149 .IP "\fBnr\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1150 .IX Item "nr integer (encoding,video)"
1151 Set noise reduction.
1152 .IP "\fBrc_init_occupancy\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1153 .IX Item "rc_init_occupancy integer (encoding,video)"
1154 Set number of bits which should be loaded into the rc buffer before
1155 decoding starts.
1156 .IP "\fBinter_threshold\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1157 .IX Item "inter_threshold integer (encoding,video)"
1158 .PD 0
1159 .IP "\fBflags2\fR \fIflags\fR \fB(\fR\fIdecoding/encoding,audio,video\fR\fB)\fR" 4
1160 .IX Item "flags2 flags (decoding/encoding,audio,video)"
1161 .PD
1162 Possible values:
1163 .RS 4
1164 .IP "\fBfast\fR" 4
1165 .IX Item "fast"
1166 allow non spec compliant speedup tricks
1167 .IP "\fBsgop\fR" 4
1168 .IX Item "sgop"
1169 Deprecated, use mpegvideo private options instead
1170 .IP "\fBnoout\fR" 4
1171 .IX Item "noout"
1172 skip bitstream encoding
1173 .IP "\fBlocal_header\fR" 4
1174 .IX Item "local_header"
1175 place global headers at every keyframe instead of in extradata
1176 .IP "\fBchunks\fR" 4
1177 .IX Item "chunks"
1178 Frame data might be split into multiple chunks
1179 .IP "\fBshowall\fR" 4
1180 .IX Item "showall"
1181 Show all frames before the first keyframe
1182 .IP "\fBskiprd\fR" 4
1183 .IX Item "skiprd"
1184 Deprecated, use mpegvideo private options instead
1185 .RE
1186 .RS 4
1187 .RE
1188 .IP "\fBerror\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1189 .IX Item "error integer (encoding,video)"
1190 .PD 0
1191 .IP "\fBqns\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1192 .IX Item "qns integer (encoding,video)"
1193 .PD
1194 Deprecated, use mpegvideo private options instead.
1195 .IP "\fBthreads\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
1196 .IX Item "threads integer (decoding/encoding,video)"
1197 Possible values:
1198 .RS 4
1199 .IP "\fBauto\fR" 4
1200 .IX Item "auto"
1201 detect a good number of threads
1202 .RE
1203 .RS 4
1204 .RE
1205 .IP "\fBme_threshold\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1206 .IX Item "me_threshold integer (encoding,video)"
1207 Set motion estimation threshold.
1208 .IP "\fBmb_threshold\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1209 .IX Item "mb_threshold integer (encoding,video)"
1210 Set macroblock threshold.
1211 .IP "\fBdc\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1212 .IX Item "dc integer (encoding,video)"
1213 Set intra_dc_precision.
1214 .IP "\fBnssew\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1215 .IX Item "nssew integer (encoding,video)"
1216 Set nsse weight.
1217 .IP "\fBskip_top\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
1218 .IX Item "skip_top integer (decoding,video)"
1219 Set number of macroblock rows at the top which are skipped.
1220 .IP "\fBskip_bottom\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
1221 .IX Item "skip_bottom integer (decoding,video)"
1222 Set number of macroblock rows at the bottom which are skipped.
1223 .IP "\fBprofile\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
1224 .IX Item "profile integer (encoding,audio,video)"
1225 Possible values:
1226 .RS 4
1227 .IP "\fBunknown\fR" 4
1228 .IX Item "unknown"
1229 .PD 0
1230 .IP "\fBaac_main\fR" 4
1231 .IX Item "aac_main"
1232 .IP "\fBaac_low\fR" 4
1233 .IX Item "aac_low"
1234 .IP "\fBaac_ssr\fR" 4
1235 .IX Item "aac_ssr"
1236 .IP "\fBaac_ltp\fR" 4
1237 .IX Item "aac_ltp"
1238 .IP "\fBaac_he\fR" 4
1239 .IX Item "aac_he"
1240 .IP "\fBaac_he_v2\fR" 4
1241 .IX Item "aac_he_v2"
1242 .IP "\fBaac_ld\fR" 4
1243 .IX Item "aac_ld"
1244 .IP "\fBaac_eld\fR" 4
1245 .IX Item "aac_eld"
1246 .IP "\fBdts\fR" 4
1247 .IX Item "dts"
1248 .IP "\fBdts_es\fR" 4
1249 .IX Item "dts_es"
1250 .IP "\fBdts_96_24\fR" 4
1251 .IX Item "dts_96_24"
1252 .IP "\fBdts_hd_hra\fR" 4
1253 .IX Item "dts_hd_hra"
1254 .IP "\fBdts_hd_ma\fR" 4
1255 .IX Item "dts_hd_ma"
1256 .RE
1257 .RS 4
1258 .RE
1259 .IP "\fBlevel\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
1260 .IX Item "level integer (encoding,audio,video)"
1261 .PD
1262 Possible values:
1263 .RS 4
1264 .IP "\fBunknown\fR" 4
1265 .IX Item "unknown"
1266 .RE
1267 .RS 4
1268 .RE
1269 .PD 0
1270 .IP "\fBlowres\fR \fIinteger\fR \fB(\fR\fIdecoding,audio,video\fR\fB)\fR" 4
1271 .IX Item "lowres integer (decoding,audio,video)"
1272 .PD
1273 Decode at 1= 1/2, 2=1/4, 3=1/8 resolutions.
1274 .IP "\fBskip_threshold\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1275 .IX Item "skip_threshold integer (encoding,video)"
1276 Set frame skip threshold.
1277 .IP "\fBskip_factor\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1278 .IX Item "skip_factor integer (encoding,video)"
1279 Set frame skip factor.
1280 .IP "\fBskip_exp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1281 .IX Item "skip_exp integer (encoding,video)"
1282 Set frame skip exponent.
1283 .IP "\fBskipcmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1284 .IX Item "skipcmp integer (encoding,video)"
1285 Set frame skip compare function.
1286 .Sp
1287 Possible values:
1288 .RS 4
1289 .IP "\fBsad\fR" 4
1290 .IX Item "sad"
1291 sum of absolute differences, fast (default)
1292 .IP "\fBsse\fR" 4
1293 .IX Item "sse"
1294 sum of squared errors
1295 .IP "\fBsatd\fR" 4
1296 .IX Item "satd"
1297 sum of absolute Hadamard transformed differences
1298 .IP "\fBdct\fR" 4
1299 .IX Item "dct"
1300 sum of absolute \s-1DCT\s0 transformed differences
1301 .IP "\fBpsnr\fR" 4
1302 .IX Item "psnr"
1303 sum of squared quantization errors (avoid, low quality)
1304 .IP "\fBbit\fR" 4
1305 .IX Item "bit"
1306 number of bits needed for the block
1307 .IP "\fBrd\fR" 4
1308 .IX Item "rd"
1309 rate distortion optimal, slow
1310 .IP "\fBzero\fR" 4
1311 .IX Item "zero"
1312 0
1313 .IP "\fBvsad\fR" 4
1314 .IX Item "vsad"
1315 sum of absolute vertical differences
1316 .IP "\fBvsse\fR" 4
1317 .IX Item "vsse"
1318 sum of squared vertical differences
1319 .IP "\fBnsse\fR" 4
1320 .IX Item "nsse"
1321 noise preserving sum of squared differences
1322 .IP "\fBw53\fR" 4
1323 .IX Item "w53"
1324 5/3 wavelet, only used in snow
1325 .IP "\fBw97\fR" 4
1326 .IX Item "w97"
1327 9/7 wavelet, only used in snow
1328 .IP "\fBdctmax\fR" 4
1329 .IX Item "dctmax"
1330 .PD 0
1331 .IP "\fBchroma\fR" 4
1332 .IX Item "chroma"
1333 .RE
1334 .RS 4
1335 .RE
1336 .IP "\fBborder_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1337 .IX Item "border_mask float (encoding,video)"
1338 .PD
1339 Increase the quantizer for macroblocks close to borders.
1340 .IP "\fBmblmin\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1341 .IX Item "mblmin integer (encoding,video)"
1342 Set min macroblock lagrange factor (\s-1VBR\s0).
1343 .IP "\fBmblmax\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1344 .IX Item "mblmax integer (encoding,video)"
1345 Set max macroblock lagrange factor (\s-1VBR\s0).
1346 .IP "\fBmepc\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1347 .IX Item "mepc integer (encoding,video)"
1348 Set motion estimation bitrate penalty compensation (1.0 = 256).
1349 .IP "\fBskip_loop_filter\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
1350 .IX Item "skip_loop_filter integer (decoding,video)"
1351 .PD 0
1352 .IP "\fBskip_idct\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
1353 .IX Item "skip_idct integer (decoding,video)"
1354 .IP "\fBskip_frame\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
1355 .IX Item "skip_frame integer (decoding,video)"
1356 .PD
1357 Make decoder discard processing depending on the frame type selected
1358 by the option value.
1359 .Sp
1360 \&\fBskip_loop_filter\fR skips frame loop filtering, \fBskip_idct\fR
1361 skips frame IDCT/dequantization, \fBskip_frame\fR skips decoding.
1362 .Sp
1363 Possible values:
1364 .RS 4
1365 .IP "\fBnone\fR" 4
1366 .IX Item "none"
1367 Discard no frame.
1368 .IP "\fBdefault\fR" 4
1369 .IX Item "default"
1370 Discard useless frames like 0\-sized frames.
1371 .IP "\fBnoref\fR" 4
1372 .IX Item "noref"
1373 Discard all non-reference frames.
1374 .IP "\fBbidir\fR" 4
1375 .IX Item "bidir"
1376 Discard all bidirectional frames.
1377 .IP "\fBnokey\fR" 4
1378 .IX Item "nokey"
1379 Discard all frames excepts keyframes.
1380 .IP "\fBall\fR" 4
1381 .IX Item "all"
1382 Discard all frames.
1383 .RE
1384 .RS 4
1385 .Sp
1386 Default value is \fBdefault\fR.
1387 .RE
1388 .IP "\fBbidir_refine\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1389 .IX Item "bidir_refine integer (encoding,video)"
1390 Refine the two motion vectors used in bidirectional macroblocks.
1391 .IP "\fBbrd_scale\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1392 .IX Item "brd_scale integer (encoding,video)"
1393 Downscale frames for dynamic B\-frame decision.
1394 .IP "\fBkeyint_min\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1395 .IX Item "keyint_min integer (encoding,video)"
1396 Set minimum interval between IDR-frames.
1397 .IP "\fBrefs\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1398 .IX Item "refs integer (encoding,video)"
1399 Set reference frames to consider for motion compensation.
1400 .IP "\fBchromaoffset\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1401 .IX Item "chromaoffset integer (encoding,video)"
1402 Set chroma qp offset from luma.
1403 .IP "\fBtrellis\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
1404 .IX Item "trellis integer (encoding,audio,video)"
1405 Set rate-distortion optimal quantization.
1406 .IP "\fBsc_factor\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1407 .IX Item "sc_factor integer (encoding,video)"
1408 Set value multiplied by qscale for each frame and added to
1409 scene_change_score.
1410 .IP "\fBmv0_threshold\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1411 .IX Item "mv0_threshold integer (encoding,video)"
1412 .PD 0
1413 .IP "\fBb_sensitivity\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1414 .IX Item "b_sensitivity integer (encoding,video)"
1415 .PD
1416 Adjust sensitivity of b_frame_strategy 1.
1417 .IP "\fBcompression_level\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
1418 .IX Item "compression_level integer (encoding,audio,video)"
1419 .PD 0
1420 .IP "\fBmin_prediction_order\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4
1421 .IX Item "min_prediction_order integer (encoding,audio)"
1422 .IP "\fBmax_prediction_order\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4
1423 .IX Item "max_prediction_order integer (encoding,audio)"
1424 .IP "\fBtimecode_frame_start\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1425 .IX Item "timecode_frame_start integer (encoding,video)"
1426 .PD
1427 Set \s-1GOP\s0 timecode frame start number, in non drop frame format.
1428 .IP "\fBrequest_channels\fR \fIinteger\fR \fB(\fR\fIdecoding,audio\fR\fB)\fR" 4
1429 .IX Item "request_channels integer (decoding,audio)"
1430 Set desired number of audio channels.
1431 .IP "\fBbits_per_raw_sample\fR \fIinteger\fR" 4
1432 .IX Item "bits_per_raw_sample integer"
1433 .PD 0
1434 .IP "\fBchannel_layout\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,audio\fR\fB)\fR" 4
1435 .IX Item "channel_layout integer (decoding/encoding,audio)"
1436 .PD
1437 Possible values:
1438 .IP "\fBrequest_channel_layout\fR \fIinteger\fR \fB(\fR\fIdecoding,audio\fR\fB)\fR" 4
1439 .IX Item "request_channel_layout integer (decoding,audio)"
1440 Possible values:
1441 .IP "\fBrc_max_vbv_use\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1442 .IX Item "rc_max_vbv_use float (encoding,video)"
1443 .PD 0
1444 .IP "\fBrc_min_vbv_use\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1445 .IX Item "rc_min_vbv_use float (encoding,video)"
1446 .IP "\fBticks_per_frame\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,audio,video\fR\fB)\fR" 4
1447 .IX Item "ticks_per_frame integer (decoding/encoding,audio,video)"
1448 .IP "\fBcolor_primaries\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
1449 .IX Item "color_primaries integer (decoding/encoding,video)"
1450 .IP "\fBcolor_trc\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
1451 .IX Item "color_trc integer (decoding/encoding,video)"
1452 .IP "\fBcolorspace\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
1453 .IX Item "colorspace integer (decoding/encoding,video)"
1454 .IP "\fBcolor_range\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
1455 .IX Item "color_range integer (decoding/encoding,video)"
1456 .IP "\fBchroma_sample_location\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
1457 .IX Item "chroma_sample_location integer (decoding/encoding,video)"
1458 .IP "\fBlog_level_offset\fR \fIinteger\fR" 4
1459 .IX Item "log_level_offset integer"
1460 .PD
1461 Set the log level offset.
1462 .IP "\fBslices\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1463 .IX Item "slices integer (encoding,video)"
1464 Number of slices, used in parallelized encoding.
1465 .IP "\fBthread_type\fR \fIflags\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
1466 .IX Item "thread_type flags (decoding/encoding,video)"
1467 Select multithreading type.
1468 .Sp
1469 Possible values:
1470 .RS 4
1471 .IP "\fBslice\fR" 4
1472 .IX Item "slice"
1473 .PD 0
1474 .IP "\fBframe\fR" 4
1475 .IX Item "frame"
1476 .RE
1477 .RS 4
1478 .RE
1479 .IP "\fBaudio_service_type\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4
1480 .IX Item "audio_service_type integer (encoding,audio)"
1481 .PD
1482 Set audio service type.
1483 .Sp
1484 Possible values:
1485 .RS 4
1486 .IP "\fBma\fR" 4
1487 .IX Item "ma"
1488 Main Audio Service
1489 .IP "\fBef\fR" 4
1490 .IX Item "ef"
1491 Effects
1492 .IP "\fBvi\fR" 4
1493 .IX Item "vi"
1494 Visually Impaired
1495 .IP "\fBhi\fR" 4
1496 .IX Item "hi"
1497 Hearing Impaired
1498 .IP "\fBdi\fR" 4
1499 .IX Item "di"
1500 Dialogue
1501 .IP "\fBco\fR" 4
1502 .IX Item "co"
1503 Commentary
1504 .IP "\fBem\fR" 4
1505 .IX Item "em"
1506 Emergency
1507 .IP "\fBvo\fR" 4
1508 .IX Item "vo"
1509 Voice Over
1510 .IP "\fBka\fR" 4
1511 .IX Item "ka"
1512 Karaoke
1513 .RE
1514 .RS 4
1515 .RE
1516 .IP "\fBrequest_sample_fmt\fR \fIsample_fmt\fR \fB(\fR\fIdecoding,audio\fR\fB)\fR" 4
1517 .IX Item "request_sample_fmt sample_fmt (decoding,audio)"
1518 Set sample format audio decoders should prefer. Default value is
1519 \&\f(CW\*(C`none\*(C'\fR.
1520 .IP "\fBpkt_timebase\fR \fIrational number\fR" 4
1521 .IX Item "pkt_timebase rational number"
1522 .PD 0
1523 .IP "\fBsub_charenc\fR \fIencoding\fR \fB(\fR\fIdecoding,subtitles\fR\fB)\fR" 4
1524 .IX Item "sub_charenc encoding (decoding,subtitles)"
1525 .PD
1526 Set the input subtitles character encoding.
1527 .SH "DECODERS"
1528 .IX Header "DECODERS"
1529 Decoders are configured elements in FFmpeg which allow the decoding of
1530 multimedia streams.
1531 .PP
1532 When you configure your FFmpeg build, all the supported native decoders
1533 are enabled by default. Decoders requiring an external library must be enabled
1534 manually via the corresponding \f(CW\*(C`\-\-enable\-lib\*(C'\fR option. You can list all
1535 available decoders using the configure option \f(CW\*(C`\-\-list\-decoders\*(C'\fR.
1536 .PP
1537 You can disable all the decoders with the configure option
1538 \&\f(CW\*(C`\-\-disable\-decoders\*(C'\fR and selectively enable / disable single decoders
1539 with the options \f(CW\*(C`\-\-enable\-decoder=\f(CIDECODER\f(CW\*(C'\fR /
1540 \&\f(CW\*(C`\-\-disable\-decoder=\f(CIDECODER\f(CW\*(C'\fR.
1541 .PP
1542 The option \f(CW\*(C`\-codecs\*(C'\fR of the ff* tools will display the list of
1543 enabled decoders.
1544 .SH "VIDEO DECODERS"
1545 .IX Header "VIDEO DECODERS"
1546 A description of some of the currently available video decoders
1547 follows.
1548 .SS "rawvideo"
1549 .IX Subsection "rawvideo"
1550 Raw video decoder.
1551 .PP
1552 This decoder decodes rawvideo streams.
1553 .PP
1554 \fIOptions\fR
1555 .IX Subsection "Options"
1556 .IP "\fBtop\fR \fItop_field_first\fR" 4
1557 .IX Item "top top_field_first"
1558 Specify the assumed field type of the input video.
1559 .RS 4
1560 .IP "\fB\-1\fR" 4
1561 .IX Item "-1"
1562 the video is assumed to be progressive (default)
1563 .IP "\fB0\fR" 4
1564 .IX Item "0"
1565 bottom-field-first is assumed
1566 .IP "\fB1\fR" 4
1567 .IX Item "1"
1568 top-field-first is assumed
1569 .RE
1570 .RS 4
1571 .RE
1572 .SH "AUDIO DECODERS"
1573 .IX Header "AUDIO DECODERS"
1574 .SS "ffwavesynth"
1575 .IX Subsection "ffwavesynth"
1576 Internal wave synthetizer.
1577 .PP
1578 This decoder generates wave patterns according to predefined sequences. Its
1579 use is purely internal and the format of the data it accepts is not publicly
1580 documented.
1581 .SH "SUBTITLES DECODERS"
1582 .IX Header "SUBTITLES DECODERS"
1583 .SS "dvdsub"
1584 .IX Subsection "dvdsub"
1585 This codec decodes the bitmap subtitles used in DVDs; the same subtitles can
1586 also be found in VobSub file pairs and in some Matroska files.
1587 .PP
1588 \fIOptions\fR
1589 .IX Subsection "Options"
1590 .IP "\fBpalette\fR" 4
1591 .IX Item "palette"
1592 Specify the global palette used by the bitmaps. When stored in VobSub, the
1593 palette is normally specified in the index file; in Matroska, the palette is
1594 stored in the codec extra-data in the same format as in VobSub. In DVDs, the
1595 palette is stored in the \s-1IFO\s0 file, and therefore not available when reading
1596 from dumped \s-1VOB\s0 files.
1597 .Sp
1598 The format for this option is a string containing 16 24\-bits hexadecimal
1599 numbers (without 0x prefix) separated by comas, for example \f(CW\*(C`0d00ee,
1600 ee450d, 101010, eaeaea, 0ce60b, ec14ed, ebff0b, 0d617a, 7b7b7b, d1d1d1,
1601 7b2a0e, 0d950c, 0f007b, cf0dec, cfa80c, 7c127b\*(C'\fR.
1602 .SH "ENCODERS"
1603 .IX Header "ENCODERS"
1604 Encoders are configured elements in FFmpeg which allow the encoding of
1605 multimedia streams.
1606 .PP
1607 When you configure your FFmpeg build, all the supported native encoders
1608 are enabled by default. Encoders requiring an external library must be enabled
1609 manually via the corresponding \f(CW\*(C`\-\-enable\-lib\*(C'\fR option. You can list all
1610 available encoders using the configure option \f(CW\*(C`\-\-list\-encoders\*(C'\fR.
1611 .PP
1612 You can disable all the encoders with the configure option
1613 \&\f(CW\*(C`\-\-disable\-encoders\*(C'\fR and selectively enable / disable single encoders
1614 with the options \f(CW\*(C`\-\-enable\-encoder=\f(CIENCODER\f(CW\*(C'\fR /
1615 \&\f(CW\*(C`\-\-disable\-encoder=\f(CIENCODER\f(CW\*(C'\fR.
1616 .PP
1617 The option \f(CW\*(C`\-codecs\*(C'\fR of the ff* tools will display the list of
1618 enabled encoders.
1619 .SH "AUDIO ENCODERS"
1620 .IX Header "AUDIO ENCODERS"
1621 A description of some of the currently available audio encoders
1622 follows.
1623 .SS "ac3 and ac3_fixed"
1624 .IX Subsection "ac3 and ac3_fixed"
1625 \&\s-1AC\-3\s0 audio encoders.
1626 .PP
1627 These encoders implement part of \s-1ATSC\s0 A/52:2010 and \s-1ETSI\s0 \s-1TS\s0 102 366, as well as
1628 the undocumented RealAudio 3 (a.k.a. dnet).
1629 .PP
1630 The \fIac3\fR encoder uses floating-point math, while the \fIac3_fixed\fR
1631 encoder only uses fixed-point integer math. This does not mean that one is
1632 always faster, just that one or the other may be better suited to a
1633 particular system. The floating-point encoder will generally produce better
1634 quality audio for a given bitrate. The \fIac3_fixed\fR encoder is not the
1635 default codec for any of the output formats, so it must be specified explicitly
1636 using the option \f(CW\*(C`\-acodec ac3_fixed\*(C'\fR in order to use it.
1637 .PP
1638 \fI\s-1AC\-3\s0 Metadata\fR
1639 .IX Subsection "AC-3 Metadata"
1640 .PP
1641 The \s-1AC\-3\s0 metadata options are used to set parameters that describe the audio,
1642 but in most cases do not affect the audio encoding itself. Some of the options
1643 do directly affect or influence the decoding and playback of the resulting
1644 bitstream, while others are just for informational purposes. A few of the
1645 options will add bits to the output stream that could otherwise be used for
1646 audio data, and will thus affect the quality of the output. Those will be
1647 indicated accordingly with a note in the option list below.
1648 .PP
1649 These parameters are described in detail in several publicly-available
1650 documents.
1651 .IP "*<<\fBhttp://www.atsc.org/cms/standards/a_52\-2010.pdf\fR>>" 4
1652 .IX Item "*<<http://www.atsc.org/cms/standards/a_52-2010.pdf>>"
1653 .PD 0
1654 .IP "*<<\fBhttp://www.atsc.org/cms/standards/a_54a_with_corr_1.pdf\fR>>" 4
1655 .IX Item "*<<http://www.atsc.org/cms/standards/a_54a_with_corr_1.pdf>>"
1656 .IP "*<<\fBhttp://www.dolby.com/uploadedFiles/zz\-_Shared_Assets/English_PDFs/Professional/18_Metadata.Guide.pdf\fR>>" 4
1657 .IX Item "*<<http://www.dolby.com/uploadedFiles/zz-_Shared_Assets/English_PDFs/Professional/18_Metadata.Guide.pdf>>"
1658 .IP "*<<\fBhttp://www.dolby.com/uploadedFiles/zz\-_Shared_Assets/English_PDFs/Professional/46_DDEncodingGuidelines.pdf\fR>>" 4
1659 .IX Item "*<<http://www.dolby.com/uploadedFiles/zz-_Shared_Assets/English_PDFs/Professional/46_DDEncodingGuidelines.pdf>>"
1660 .PD
1661 .PP
1662 Metadata Control Options
1663 .IX Subsection "Metadata Control Options"
1664 .IP "\fB\-per_frame_metadata\fR \fIboolean\fR" 4
1665 .IX Item "-per_frame_metadata boolean"
1666 Allow Per-Frame Metadata. Specifies if the encoder should check for changing
1667 metadata for each frame.
1668 .RS 4
1669 .IP "\fB0\fR" 4
1670 .IX Item "0"
1671 The metadata values set at initialization will be used for every frame in the
1672 stream. (default)
1673 .IP "\fB1\fR" 4
1674 .IX Item "1"
1675 Metadata values can be changed before encoding each frame.
1676 .RE
1677 .RS 4
1678 .RE
1679 .PP
1680 Downmix Levels
1681 .IX Subsection "Downmix Levels"
1682 .IP "\fB\-center_mixlev\fR \fIlevel\fR" 4
1683 .IX Item "-center_mixlev level"
1684 Center Mix Level. The amount of gain the decoder should apply to the center
1685 channel when downmixing to stereo. This field will only be written to the
1686 bitstream if a center channel is present. The value is specified as a scale
1687 factor. There are 3 valid values:
1688 .RS 4
1689 .IP "\fB0.707\fR" 4
1690 .IX Item "0.707"
1691 Apply \-3dB gain
1692 .IP "\fB0.595\fR" 4
1693 .IX Item "0.595"
1694 Apply \-4.5dB gain (default)
1695 .IP "\fB0.500\fR" 4
1696 .IX Item "0.500"
1697 Apply \-6dB gain
1698 .RE
1699 .RS 4
1700 .RE
1701 .IP "\fB\-surround_mixlev\fR \fIlevel\fR" 4
1702 .IX Item "-surround_mixlev level"
1703 Surround Mix Level. The amount of gain the decoder should apply to the surround
1704 channel(s) when downmixing to stereo. This field will only be written to the
1705 bitstream if one or more surround channels are present. The value is specified
1706 as a scale factor. There are 3 valid values:
1707 .RS 4
1708 .IP "\fB0.707\fR" 4
1709 .IX Item "0.707"
1710 Apply \-3dB gain
1711 .IP "\fB0.500\fR" 4
1712 .IX Item "0.500"
1713 Apply \-6dB gain (default)
1714 .IP "\fB0.000\fR" 4
1715 .IX Item "0.000"
1716 Silence Surround Channel(s)
1717 .RE
1718 .RS 4
1719 .RE
1720 .PP
1721 Audio Production Information
1722 .IX Subsection "Audio Production Information"
1723 .PP
1724 Audio Production Information is optional information describing the mixing
1725 environment. Either none or both of the fields are written to the bitstream.
1726 .IP "\fB\-mixing_level\fR \fInumber\fR" 4
1727 .IX Item "-mixing_level number"
1728 Mixing Level. Specifies peak sound pressure level (\s-1SPL\s0) in the production
1729 environment when the mix was mastered. Valid values are 80 to 111, or \-1 for
1730 unknown or not indicated. The default value is \-1, but that value cannot be
1731 used if the Audio Production Information is written to the bitstream. Therefore,
1732 if the \f(CW\*(C`room_type\*(C'\fR option is not the default value, the \f(CW\*(C`mixing_level\*(C'\fR
1733 option must not be \-1.
1734 .IP "\fB\-room_type\fR \fItype\fR" 4
1735 .IX Item "-room_type type"
1736 Room Type. Describes the equalization used during the final mixing session at
1737 the studio or on the dubbing stage. A large room is a dubbing stage with the
1738 industry standard X\-curve equalization; a small room has flat equalization.
1739 This field will not be written to the bitstream if both the \f(CW\*(C`mixing_level\*(C'\fR
1740 option and the \f(CW\*(C`room_type\*(C'\fR option have the default values.
1741 .RS 4
1742 .IP "\fB0\fR" 4
1743 .IX Item "0"
1744 .PD 0
1745 .IP "\fBnotindicated\fR" 4
1746 .IX Item "notindicated"
1747 .PD
1748 Not Indicated (default)
1749 .IP "\fB1\fR" 4
1750 .IX Item "1"
1751 .PD 0
1752 .IP "\fBlarge\fR" 4
1753 .IX Item "large"
1754 .PD
1755 Large Room
1756 .IP "\fB2\fR" 4
1757 .IX Item "2"
1758 .PD 0
1759 .IP "\fBsmall\fR" 4
1760 .IX Item "small"
1761 .PD
1762 Small Room
1763 .RE
1764 .RS 4
1765 .RE
1766 .PP
1767 Other Metadata Options
1768 .IX Subsection "Other Metadata Options"
1769 .IP "\fB\-copyright\fR \fIboolean\fR" 4
1770 .IX Item "-copyright boolean"
1771 Copyright Indicator. Specifies whether a copyright exists for this audio.
1772 .RS 4
1773 .IP "\fB0\fR" 4
1774 .IX Item "0"
1775 .PD 0
1776 .IP "\fBoff\fR" 4
1777 .IX Item "off"
1778 .PD
1779 No Copyright Exists (default)
1780 .IP "\fB1\fR" 4
1781 .IX Item "1"
1782 .PD 0
1783 .IP "\fBon\fR" 4
1784 .IX Item "on"
1785 .PD
1786 Copyright Exists
1787 .RE
1788 .RS 4
1789 .RE
1790 .IP "\fB\-dialnorm\fR \fIvalue\fR" 4
1791 .IX Item "-dialnorm value"
1792 Dialogue Normalization. Indicates how far the average dialogue level of the
1793 program is below digital 100% full scale (0 dBFS). This parameter determines a
1794 level shift during audio reproduction that sets the average volume of the
1795 dialogue to a preset level. The goal is to match volume level between program
1796 sources. A value of \-31dB will result in no volume level change, relative to
1797 the source volume, during audio reproduction. Valid values are whole numbers in
1798 the range \-31 to \-1, with \-31 being the default.
1799 .IP "\fB\-dsur_mode\fR \fImode\fR" 4
1800 .IX Item "-dsur_mode mode"
1801 Dolby Surround Mode. Specifies whether the stereo signal uses Dolby Surround
1802 (Pro Logic). This field will only be written to the bitstream if the audio
1803 stream is stereo. Using this option does \fB\s-1NOT\s0\fR mean the encoder will actually
1804 apply Dolby Surround processing.
1805 .RS 4
1806 .IP "\fB0\fR" 4
1807 .IX Item "0"
1808 .PD 0
1809 .IP "\fBnotindicated\fR" 4
1810 .IX Item "notindicated"
1811 .PD
1812 Not Indicated (default)
1813 .IP "\fB1\fR" 4
1814 .IX Item "1"
1815 .PD 0
1816 .IP "\fBoff\fR" 4
1817 .IX Item "off"
1818 .PD
1819 Not Dolby Surround Encoded
1820 .IP "\fB2\fR" 4
1821 .IX Item "2"
1822 .PD 0
1823 .IP "\fBon\fR" 4
1824 .IX Item "on"
1825 .PD
1826 Dolby Surround Encoded
1827 .RE
1828 .RS 4
1829 .RE
1830 .IP "\fB\-original\fR \fIboolean\fR" 4
1831 .IX Item "-original boolean"
1832 Original Bit Stream Indicator. Specifies whether this audio is from the
1833 original source and not a copy.
1834 .RS 4
1835 .IP "\fB0\fR" 4
1836 .IX Item "0"
1837 .PD 0
1838 .IP "\fBoff\fR" 4
1839 .IX Item "off"
1840 .PD
1841 Not Original Source
1842 .IP "\fB1\fR" 4
1843 .IX Item "1"
1844 .PD 0
1845 .IP "\fBon\fR" 4
1846 .IX Item "on"
1847 .PD
1848 Original Source (default)
1849 .RE
1850 .RS 4
1851 .RE
1852 .PP
1853 \fIExtended Bitstream Information\fR
1854 .IX Subsection "Extended Bitstream Information"
1855 .PP
1856 The extended bitstream options are part of the Alternate Bit Stream Syntax as
1857 specified in Annex D of the A/52:2010 standard. It is grouped into 2 parts.
1858 If any one parameter in a group is specified, all values in that group will be
1859 written to the bitstream. Default values are used for those that are written
1860 but have not been specified. If the mixing levels are written, the decoder
1861 will use these values instead of the ones specified in the \f(CW\*(C`center_mixlev\*(C'\fR
1862 and \f(CW\*(C`surround_mixlev\*(C'\fR options if it supports the Alternate Bit Stream
1863 Syntax.
1864 .PP
1865 Extended Bitstream Information \- Part 1
1866 .IX Subsection "Extended Bitstream Information - Part 1"
1867 .IP "\fB\-dmix_mode\fR \fImode\fR" 4
1868 .IX Item "-dmix_mode mode"
1869 Preferred Stereo Downmix Mode. Allows the user to select either Lt/Rt
1870 (Dolby Surround) or Lo/Ro (normal stereo) as the preferred stereo downmix mode.
1871 .RS 4
1872 .IP "\fB0\fR" 4
1873 .IX Item "0"
1874 .PD 0
1875 .IP "\fBnotindicated\fR" 4
1876 .IX Item "notindicated"
1877 .PD
1878 Not Indicated (default)
1879 .IP "\fB1\fR" 4
1880 .IX Item "1"
1881 .PD 0
1882 .IP "\fBltrt\fR" 4
1883 .IX Item "ltrt"
1884 .PD
1885 Lt/Rt Downmix Preferred
1886 .IP "\fB2\fR" 4
1887 .IX Item "2"
1888 .PD 0
1889 .IP "\fBloro\fR" 4
1890 .IX Item "loro"
1891 .PD
1892 Lo/Ro Downmix Preferred
1893 .RE
1894 .RS 4
1895 .RE
1896 .IP "\fB\-ltrt_cmixlev\fR \fIlevel\fR" 4
1897 .IX Item "-ltrt_cmixlev level"
1898 Lt/Rt Center Mix Level. The amount of gain the decoder should apply to the
1899 center channel when downmixing to stereo in Lt/Rt mode.
1900 .RS 4
1901 .IP "\fB1.414\fR" 4
1902 .IX Item "1.414"
1903 Apply +3dB gain
1904 .IP "\fB1.189\fR" 4
1905 .IX Item "1.189"
1906 Apply +1.5dB gain
1907 .IP "\fB1.000\fR" 4
1908 .IX Item "1.000"
1909 Apply 0dB gain
1910 .IP "\fB0.841\fR" 4
1911 .IX Item "0.841"
1912 Apply \-1.5dB gain
1913 .IP "\fB0.707\fR" 4
1914 .IX Item "0.707"
1915 Apply \-3.0dB gain
1916 .IP "\fB0.595\fR" 4
1917 .IX Item "0.595"
1918 Apply \-4.5dB gain (default)
1919 .IP "\fB0.500\fR" 4
1920 .IX Item "0.500"
1921 Apply \-6.0dB gain
1922 .IP "\fB0.000\fR" 4
1923 .IX Item "0.000"
1924 Silence Center Channel
1925 .RE
1926 .RS 4
1927 .RE
1928 .IP "\fB\-ltrt_surmixlev\fR \fIlevel\fR" 4
1929 .IX Item "-ltrt_surmixlev level"
1930 Lt/Rt Surround Mix Level. The amount of gain the decoder should apply to the
1931 surround channel(s) when downmixing to stereo in Lt/Rt mode.
1932 .RS 4
1933 .IP "\fB0.841\fR" 4
1934 .IX Item "0.841"
1935 Apply \-1.5dB gain
1936 .IP "\fB0.707\fR" 4
1937 .IX Item "0.707"
1938 Apply \-3.0dB gain
1939 .IP "\fB0.595\fR" 4
1940 .IX Item "0.595"
1941 Apply \-4.5dB gain
1942 .IP "\fB0.500\fR" 4
1943 .IX Item "0.500"
1944 Apply \-6.0dB gain (default)
1945 .IP "\fB0.000\fR" 4
1946 .IX Item "0.000"
1947 Silence Surround Channel(s)
1948 .RE
1949 .RS 4
1950 .RE
1951 .IP "\fB\-loro_cmixlev\fR \fIlevel\fR" 4
1952 .IX Item "-loro_cmixlev level"
1953 Lo/Ro Center Mix Level. The amount of gain the decoder should apply to the
1954 center channel when downmixing to stereo in Lo/Ro mode.
1955 .RS 4
1956 .IP "\fB1.414\fR" 4
1957 .IX Item "1.414"
1958 Apply +3dB gain
1959 .IP "\fB1.189\fR" 4
1960 .IX Item "1.189"
1961 Apply +1.5dB gain
1962 .IP "\fB1.000\fR" 4
1963 .IX Item "1.000"
1964 Apply 0dB gain
1965 .IP "\fB0.841\fR" 4
1966 .IX Item "0.841"
1967 Apply \-1.5dB gain
1968 .IP "\fB0.707\fR" 4
1969 .IX Item "0.707"
1970 Apply \-3.0dB gain
1971 .IP "\fB0.595\fR" 4
1972 .IX Item "0.595"
1973 Apply \-4.5dB gain (default)
1974 .IP "\fB0.500\fR" 4
1975 .IX Item "0.500"
1976 Apply \-6.0dB gain
1977 .IP "\fB0.000\fR" 4
1978 .IX Item "0.000"
1979 Silence Center Channel
1980 .RE
1981 .RS 4
1982 .RE
1983 .IP "\fB\-loro_surmixlev\fR \fIlevel\fR" 4
1984 .IX Item "-loro_surmixlev level"
1985 Lo/Ro Surround Mix Level. The amount of gain the decoder should apply to the
1986 surround channel(s) when downmixing to stereo in Lo/Ro mode.
1987 .RS 4
1988 .IP "\fB0.841\fR" 4
1989 .IX Item "0.841"
1990 Apply \-1.5dB gain
1991 .IP "\fB0.707\fR" 4
1992 .IX Item "0.707"
1993 Apply \-3.0dB gain
1994 .IP "\fB0.595\fR" 4
1995 .IX Item "0.595"
1996 Apply \-4.5dB gain
1997 .IP "\fB0.500\fR" 4
1998 .IX Item "0.500"
1999 Apply \-6.0dB gain (default)
2000 .IP "\fB0.000\fR" 4
2001 .IX Item "0.000"
2002 Silence Surround Channel(s)
2003 .RE
2004 .RS 4
2005 .RE
2006 .PP
2007 Extended Bitstream Information \- Part 2
2008 .IX Subsection "Extended Bitstream Information - Part 2"
2009 .IP "\fB\-dsurex_mode\fR \fImode\fR" 4
2010 .IX Item "-dsurex_mode mode"
2011 Dolby Surround \s-1EX\s0 Mode. Indicates whether the stream uses Dolby Surround \s-1EX\s0
2012 (7.1 matrixed to 5.1). Using this option does \fB\s-1NOT\s0\fR mean the encoder will actually
2013 apply Dolby Surround \s-1EX\s0 processing.
2014 .RS 4
2015 .IP "\fB0\fR" 4
2016 .IX Item "0"
2017 .PD 0
2018 .IP "\fBnotindicated\fR" 4
2019 .IX Item "notindicated"
2020 .PD
2021 Not Indicated (default)
2022 .IP "\fB1\fR" 4
2023 .IX Item "1"
2024 .PD 0
2025 .IP "\fBon\fR" 4
2026 .IX Item "on"
2027 .PD
2028 Dolby Surround \s-1EX\s0 Off
2029 .IP "\fB2\fR" 4
2030 .IX Item "2"
2031 .PD 0
2032 .IP "\fBoff\fR" 4
2033 .IX Item "off"
2034 .PD
2035 Dolby Surround \s-1EX\s0 On
2036 .RE
2037 .RS 4
2038 .RE
2039 .IP "\fB\-dheadphone_mode\fR \fImode\fR" 4
2040 .IX Item "-dheadphone_mode mode"
2041 Dolby Headphone Mode. Indicates whether the stream uses Dolby Headphone
2042 encoding (multi-channel matrixed to 2.0 for use with headphones). Using this
2043 option does \fB\s-1NOT\s0\fR mean the encoder will actually apply Dolby Headphone
2044 processing.
2045 .RS 4
2046 .IP "\fB0\fR" 4
2047 .IX Item "0"
2048 .PD 0
2049 .IP "\fBnotindicated\fR" 4
2050 .IX Item "notindicated"
2051 .PD
2052 Not Indicated (default)
2053 .IP "\fB1\fR" 4
2054 .IX Item "1"
2055 .PD 0
2056 .IP "\fBon\fR" 4
2057 .IX Item "on"
2058 .PD
2059 Dolby Headphone Off
2060 .IP "\fB2\fR" 4
2061 .IX Item "2"
2062 .PD 0
2063 .IP "\fBoff\fR" 4
2064 .IX Item "off"
2065 .PD
2066 Dolby Headphone On
2067 .RE
2068 .RS 4
2069 .RE
2070 .IP "\fB\-ad_conv_type\fR \fItype\fR" 4
2071 .IX Item "-ad_conv_type type"
2072 A/D Converter Type. Indicates whether the audio has passed through \s-1HDCD\s0 A/D
2073 conversion.
2074 .RS 4
2075 .IP "\fB0\fR" 4
2076 .IX Item "0"
2077 .PD 0
2078 .IP "\fBstandard\fR" 4
2079 .IX Item "standard"
2080 .PD
2081 Standard A/D Converter (default)
2082 .IP "\fB1\fR" 4
2083 .IX Item "1"
2084 .PD 0
2085 .IP "\fBhdcd\fR" 4
2086 .IX Item "hdcd"
2087 .PD
2088 \&\s-1HDCD\s0 A/D Converter
2089 .RE
2090 .RS 4
2091 .RE
2092 .PP
2093 \fIOther \s-1AC\-3\s0 Encoding Options\fR
2094 .IX Subsection "Other AC-3 Encoding Options"
2095 .IP "\fB\-stereo_rematrixing\fR \fIboolean\fR" 4
2096 .IX Item "-stereo_rematrixing boolean"
2097 Stereo Rematrixing. Enables/Disables use of rematrixing for stereo input. This
2098 is an optional \s-1AC\-3\s0 feature that increases quality by selectively encoding
2099 the left/right channels as mid/side. This option is enabled by default, and it
2100 is highly recommended that it be left as enabled except for testing purposes.
2101 .PP
2102 \fIFloating-Point-Only \s-1AC\-3\s0 Encoding Options\fR
2103 .IX Subsection "Floating-Point-Only AC-3 Encoding Options"
2104 .PP
2105 These options are only valid for the floating-point encoder and do not exist
2106 for the fixed-point encoder due to the corresponding features not being
2107 implemented in fixed-point.
2108 .IP "\fB\-channel_coupling\fR \fIboolean\fR" 4
2109 .IX Item "-channel_coupling boolean"
2110 Enables/Disables use of channel coupling, which is an optional \s-1AC\-3\s0 feature
2111 that increases quality by combining high frequency information from multiple
2112 channels into a single channel. The per-channel high frequency information is
2113 sent with less accuracy in both the frequency and time domains. This allows
2114 more bits to be used for lower frequencies while preserving enough information
2115 to reconstruct the high frequencies. This option is enabled by default for the
2116 floating-point encoder and should generally be left as enabled except for
2117 testing purposes or to increase encoding speed.
2118 .RS 4
2119 .IP "\fB\-1\fR" 4
2120 .IX Item "-1"
2121 .PD 0
2122 .IP "\fBauto\fR" 4
2123 .IX Item "auto"
2124 .PD
2125 Selected by Encoder (default)
2126 .IP "\fB0\fR" 4
2127 .IX Item "0"
2128 .PD 0
2129 .IP "\fBoff\fR" 4
2130 .IX Item "off"
2131 .PD
2132 Disable Channel Coupling
2133 .IP "\fB1\fR" 4
2134 .IX Item "1"
2135 .PD 0
2136 .IP "\fBon\fR" 4
2137 .IX Item "on"
2138 .PD
2139 Enable Channel Coupling
2140 .RE
2141 .RS 4
2142 .RE
2143 .IP "\fB\-cpl_start_band\fR \fInumber\fR" 4
2144 .IX Item "-cpl_start_band number"
2145 Coupling Start Band. Sets the channel coupling start band, from 1 to 15. If a
2146 value higher than the bandwidth is used, it will be reduced to 1 less than the
2147 coupling end band. If \fIauto\fR is used, the start band will be determined by
2148 the encoder based on the bit rate, sample rate, and channel layout. This option
2149 has no effect if channel coupling is disabled.
2150 .RS 4
2151 .IP "\fB\-1\fR" 4
2152 .IX Item "-1"
2153 .PD 0
2154 .IP "\fBauto\fR" 4
2155 .IX Item "auto"
2156 .PD
2157 Selected by Encoder (default)
2158 .RE
2159 .RS 4
2160 .RE
2161 .SH "VIDEO ENCODERS"
2162 .IX Header "VIDEO ENCODERS"
2163 A description of some of the currently available video encoders
2164 follows.
2165 .SS "libtheora"
2166 .IX Subsection "libtheora"
2167 Theora format supported through libtheora.
2168 .PP
2169 Requires the presence of the libtheora headers and library during
2170 configuration. You need to explicitly configure the build with
2171 \&\f(CW\*(C`\-\-enable\-libtheora\*(C'\fR.
2172 .PP
2173 \fIOptions\fR
2174 .IX Subsection "Options"
2175 .PP
2176 The following global options are mapped to internal libtheora options
2177 which affect the quality and the bitrate of the encoded stream.
2178 .IP "\fBb\fR" 4
2179 .IX Item "b"
2180 Set the video bitrate, only works if the \f(CW\*(C`qscale\*(C'\fR flag in
2181 \&\fBflags\fR is not enabled.
2182 .IP "\fBflags\fR" 4
2183 .IX Item "flags"
2184 Used to enable constant quality mode encoding through the
2185 \&\fBqscale\fR flag, and to enable the \f(CW\*(C`pass1\*(C'\fR and \f(CW\*(C`pass2\*(C'\fR
2186 modes.
2187 .IP "\fBg\fR" 4
2188 .IX Item "g"
2189 Set the \s-1GOP\s0 size.
2190 .IP "\fBglobal_quality\fR" 4
2191 .IX Item "global_quality"
2192 Set the global quality in lambda units, only works if the
2193 \&\f(CW\*(C`qscale\*(C'\fR flag in \fBflags\fR is enabled. The value is clipped
2194 in the [0 \- 10*\f(CW\*(C`FF_QP2LAMBDA\*(C'\fR] range, and then multiplied for 6.3
2195 to get a value in the native libtheora range [0\-63]. A higher value
2196 corresponds to a higher quality.
2197 .Sp
2198 For example, to set maximum constant quality encoding with
2199 \&\fBffmpeg\fR:
2200 .Sp
2201 .Vb 1
2202 \& ffmpeg \-i INPUT \-flags:v qscale \-global_quality:v "10*QP2LAMBDA" \-codec:v libtheora OUTPUT.ogg
2203 .Ve
2204 .SS "libvpx"
2205 .IX Subsection "libvpx"
2206 \&\s-1VP8\s0 format supported through libvpx.
2207 .PP
2208 Requires the presence of the libvpx headers and library during configuration.
2209 You need to explicitly configure the build with \f(CW\*(C`\-\-enable\-libvpx\*(C'\fR.
2210 .PP
2211 \fIOptions\fR
2212 .IX Subsection "Options"
2213 .PP
2214 Mapping from FFmpeg to libvpx options with conversion notes in parentheses.
2215 .IP "\fBthreads\fR" 4
2216 .IX Item "threads"
2217 g_threads
2218 .IP "\fBprofile\fR" 4
2219 .IX Item "profile"
2220 g_profile
2221 .IP "\fBvb\fR" 4
2222 .IX Item "vb"
2223 rc_target_bitrate
2224 .IP "\fBg\fR" 4
2225 .IX Item "g"
2226 kf_max_dist
2227 .IP "\fBkeyint_min\fR" 4
2228 .IX Item "keyint_min"
2229 kf_min_dist
2230 .IP "\fBqmin\fR" 4
2231 .IX Item "qmin"
2232 rc_min_quantizer
2233 .IP "\fBqmax\fR" 4
2234 .IX Item "qmax"
2235 rc_max_quantizer
2236 .IP "\fBbufsize, vb\fR" 4
2237 .IX Item "bufsize, vb"
2238 rc_buf_sz
2239 \&\f(CW\*(C`(bufsize * 1000 / vb)\*(C'\fR
2240 .Sp
2241 rc_buf_optimal_sz
2242 \&\f(CW\*(C`(bufsize * 1000 / vb * 5 / 6)\*(C'\fR
2243 .IP "\fBrc_init_occupancy, vb\fR" 4
2244 .IX Item "rc_init_occupancy, vb"
2245 rc_buf_initial_sz
2246 \&\f(CW\*(C`(rc_init_occupancy * 1000 / vb)\*(C'\fR
2247 .IP "\fBrc_buffer_aggressivity\fR" 4
2248 .IX Item "rc_buffer_aggressivity"
2249 rc_undershoot_pct
2250 .IP "\fBskip_threshold\fR" 4
2251 .IX Item "skip_threshold"
2252 rc_dropframe_thresh
2253 .IP "\fBqcomp\fR" 4
2254 .IX Item "qcomp"
2255 rc_2pass_vbr_bias_pct
2256 .IP "\fBmaxrate, vb\fR" 4
2257 .IX Item "maxrate, vb"
2258 rc_2pass_vbr_maxsection_pct
2259 \&\f(CW\*(C`(maxrate * 100 / vb)\*(C'\fR
2260 .IP "\fBminrate, vb\fR" 4
2261 .IX Item "minrate, vb"
2262 rc_2pass_vbr_minsection_pct
2263 \&\f(CW\*(C`(minrate * 100 / vb)\*(C'\fR
2264 .IP "\fBminrate, maxrate, vb\fR" 4
2265 .IX Item "minrate, maxrate, vb"
2266 \&\f(CW\*(C`VPX_CBR\*(C'\fR
2267 \&\f(CW\*(C`(minrate == maxrate == vb)\*(C'\fR
2268 .IP "\fBcrf\fR" 4
2269 .IX Item "crf"
2270 \&\f(CW\*(C`VPX_CQ\*(C'\fR, \f(CW\*(C`VP8E_SET_CQ_LEVEL\*(C'\fR
2271 .IP "\fBquality\fR" 4
2272 .IX Item "quality"
2273 .RS 4
2274 .PD 0
2275 .IP "\fIbest\fR" 4
2276 .IX Item "best"
2277 .PD
2278 \&\f(CW\*(C`VPX_DL_BEST_QUALITY\*(C'\fR
2279 .IP "\fIgood\fR" 4
2280 .IX Item "good"
2281 \&\f(CW\*(C`VPX_DL_GOOD_QUALITY\*(C'\fR
2282 .IP "\fIrealtime\fR" 4
2283 .IX Item "realtime"
2284 \&\f(CW\*(C`VPX_DL_REALTIME\*(C'\fR
2285 .RE
2286 .RS 4
2287 .RE
2288 .IP "\fBspeed\fR" 4
2289 .IX Item "speed"
2290 \&\f(CW\*(C`VP8E_SET_CPUUSED\*(C'\fR
2291 .IP "\fBnr\fR" 4
2292 .IX Item "nr"
2293 \&\f(CW\*(C`VP8E_SET_NOISE_SENSITIVITY\*(C'\fR
2294 .IP "\fBmb_threshold\fR" 4
2295 .IX Item "mb_threshold"
2296 \&\f(CW\*(C`VP8E_SET_STATIC_THRESHOLD\*(C'\fR
2297 .IP "\fBslices\fR" 4
2298 .IX Item "slices"
2299 \&\f(CW\*(C`VP8E_SET_TOKEN_PARTITIONS\*(C'\fR
2300 .IP "\fBmax-intra-rate\fR" 4
2301 .IX Item "max-intra-rate"
2302 \&\f(CW\*(C`VP8E_SET_MAX_INTRA_BITRATE_PCT\*(C'\fR
2303 .IP "\fBforce_key_frames\fR" 4
2304 .IX Item "force_key_frames"
2305 \&\f(CW\*(C`VPX_EFLAG_FORCE_KF\*(C'\fR
2306 .IP "\fBAlternate reference frame related\fR" 4
2307 .IX Item "Alternate reference frame related"
2308 .RS 4
2309 .PD 0
2310 .IP "\fBvp8flags altref\fR" 4
2311 .IX Item "vp8flags altref"
2312 .PD
2313 \&\f(CW\*(C`VP8E_SET_ENABLEAUTOALTREF\*(C'\fR
2314 .IP "\fIarnr_max_frames\fR" 4
2315 .IX Item "arnr_max_frames"
2316 \&\f(CW\*(C`VP8E_SET_ARNR_MAXFRAMES\*(C'\fR
2317 .IP "\fIarnr_type\fR" 4
2318 .IX Item "arnr_type"
2319 \&\f(CW\*(C`VP8E_SET_ARNR_TYPE\*(C'\fR
2320 .IP "\fIarnr_strength\fR" 4
2321 .IX Item "arnr_strength"
2322 \&\f(CW\*(C`VP8E_SET_ARNR_STRENGTH\*(C'\fR
2323 .IP "\fIrc_lookahead\fR" 4
2324 .IX Item "rc_lookahead"
2325 g_lag_in_frames
2326 .RE
2327 .RS 4
2328 .RE
2329 .IP "\fBvp8flags error_resilient\fR" 4
2330 .IX Item "vp8flags error_resilient"
2331 g_error_resilient
2332 .PP
2333 For more information about libvpx see:
2334 <\fBhttp://www.webmproject.org/\fR>
2335 .SS "libx264"
2336 .IX Subsection "libx264"
2337 x264 H.264/MPEG\-4 \s-1AVC\s0 encoder wrapper
2338 .PP
2339 Requires the presence of the libx264 headers and library during
2340 configuration. You need to explicitly configure the build with
2341 \&\f(CW\*(C`\-\-enable\-libx264\*(C'\fR.
2342 .PP
2343 x264 supports an impressive number of features, including 8x8 and 4x4 adaptive
2344 spatial transform, adaptive B\-frame placement, \s-1CAVLC/CABAC\s0 entropy coding,
2345 interlacing (\s-1MBAFF\s0), lossless mode, psy optimizations for detail retention
2346 (adaptive quantization, psy-RD, psy-trellis).
2347 .PP
2348 The FFmpeg wrapper provides a mapping for most of them using global options
2349 that match those of the encoders and provides private options for the unique
2350 encoder options. Additionally an expert override is provided to directly pass
2351 a list of key=value tuples as accepted by x264_param_parse.
2352 .PP
2353 \fIOption Mapping\fR
2354 .IX Subsection "Option Mapping"
2355 .PP
2356 The following options are supported by the x264 wrapper, the x264\-equivalent
2357 options follow the FFmpeg ones.
2358 .IP "\fBb : bitrate\fR" 4
2359 .IX Item "b : bitrate"
2360 FFmpeg \f(CW\*(C`b\*(C'\fR option is expressed in bits/s, x264 \f(CW\*(C`bitrate\*(C'\fR in kilobits/s.
2361 .IP "\fBbf : bframes\fR" 4
2362 .IX Item "bf : bframes"
2363 Maximum number of B\-frames.
2364 .IP "\fBg : keyint\fR" 4
2365 .IX Item "g : keyint"
2366 Maximum \s-1GOP\s0 size.
2367 .IP "\fBqmin : qpmin\fR" 4
2368 .IX Item "qmin : qpmin"
2369 .PD 0
2370 .IP "\fBqmax : qpmax\fR" 4
2371 .IX Item "qmax : qpmax"
2372 .IP "\fBqdiff : qpstep\fR" 4
2373 .IX Item "qdiff : qpstep"
2374 .IP "\fBqblur : qblur\fR" 4
2375 .IX Item "qblur : qblur"
2376 .IP "\fBqcomp : qcomp\fR" 4
2377 .IX Item "qcomp : qcomp"
2378 .IP "\fBrefs : ref\fR" 4
2379 .IX Item "refs : ref"
2380 .IP "\fBsc_threshold : scenecut\fR" 4
2381 .IX Item "sc_threshold : scenecut"
2382 .IP "\fBtrellis : trellis\fR" 4
2383 .IX Item "trellis : trellis"
2384 .IP "\fBnr : nr\fR" 4
2385 .IX Item "nr : nr"
2386 .PD
2387 Noise reduction.
2388 .IP "\fBme_range : merange\fR" 4
2389 .IX Item "me_range : merange"
2390 .PD 0
2391 .IP "\fBme_method : me\fR" 4
2392 .IX Item "me_method : me"
2393 .IP "\fBsubq : subme\fR" 4
2394 .IX Item "subq : subme"
2395 .IP "\fBb_strategy : b\-adapt\fR" 4
2396 .IX Item "b_strategy : b-adapt"
2397 .IP "\fBkeyint_min : keyint-min\fR" 4
2398 .IX Item "keyint_min : keyint-min"
2399 .IP "\fBcoder : cabac\fR" 4
2400 .IX Item "coder : cabac"
2401 .PD
2402 Set coder to \f(CW\*(C`ac\*(C'\fR to use \s-1CABAC\s0.
2403 .IP "\fBcmp : chroma-me\fR" 4
2404 .IX Item "cmp : chroma-me"
2405 Set to \f(CW\*(C`chroma\*(C'\fR to use chroma motion estimation.
2406 .IP "\fBthreads : threads\fR" 4
2407 .IX Item "threads : threads"
2408 .PD 0
2409 .IP "\fBthread_type : sliced_threads\fR" 4
2410 .IX Item "thread_type : sliced_threads"
2411 .PD
2412 Set to \f(CW\*(C`slice\*(C'\fR to use sliced threading instead of frame threading.
2413 .IP "\fBflags \-cgop : open-gop\fR" 4
2414 .IX Item "flags -cgop : open-gop"
2415 Set \f(CW\*(C`\-cgop\*(C'\fR to use recovery points to close GOPs.
2416 .IP "\fBrc_init_occupancy : vbv-init\fR" 4
2417 .IX Item "rc_init_occupancy : vbv-init"
2418 Initial buffer occupancy.
2419 .PP
2420 \fIPrivate Options\fR
2421 .IX Subsection "Private Options"
2422 .IP "\fB\-preset\fR \fIstring\fR" 4
2423 .IX Item "-preset string"
2424 Set the encoding preset (cf. x264 \-\-fullhelp).
2425 .IP "\fB\-tune\fR \fIstring\fR" 4
2426 .IX Item "-tune string"
2427 Tune the encoding params (cf. x264 \-\-fullhelp).
2428 .IP "\fB\-profile\fR \fIstring\fR" 4
2429 .IX Item "-profile string"
2430 Set profile restrictions (cf. x264 \-\-fullhelp).
2431 .IP "\fB\-fastfirstpass\fR \fIinteger\fR" 4
2432 .IX Item "-fastfirstpass integer"
2433 Use fast settings when encoding first pass.
2434 .IP "\fB\-crf\fR \fIfloat\fR" 4
2435 .IX Item "-crf float"
2436 Select the quality for constant quality mode.
2437 .IP "\fB\-crf_max\fR \fIfloat\fR" 4
2438 .IX Item "-crf_max float"
2439 In \s-1CRF\s0 mode, prevents \s-1VBV\s0 from lowering quality beyond this point.
2440 .IP "\fB\-qp\fR \fIinteger\fR" 4
2441 .IX Item "-qp integer"
2442 Constant quantization parameter rate control method.
2443 .IP "\fB\-aq\-mode\fR \fIinteger\fR" 4
2444 .IX Item "-aq-mode integer"
2445 \&\s-1AQ\s0 method
2446 .Sp
2447 Possible values:
2448 .RS 4
2449 .IP "\fBnone\fR" 4
2450 .IX Item "none"
2451 .PD 0
2452 .IP "\fBvariance\fR" 4
2453 .IX Item "variance"
2454 .PD
2455 Variance \s-1AQ\s0 (complexity mask).
2456 .IP "\fBautovariance\fR" 4
2457 .IX Item "autovariance"
2458 Auto-variance \s-1AQ\s0 (experimental).
2459 .RE
2460 .RS 4
2461 .RE
2462 .IP "\fB\-aq\-strength\fR \fIfloat\fR" 4
2463 .IX Item "-aq-strength float"
2464 \&\s-1AQ\s0 strength, reduces blocking and blurring in flat and textured areas.
2465 .IP "\fB\-psy\fR \fIinteger\fR" 4
2466 .IX Item "-psy integer"
2467 Use psychovisual optimizations.
2468 .IP "\fB\-psy\-rd\fR \fIstring\fR" 4
2469 .IX Item "-psy-rd string"
2470 Strength of psychovisual optimization, in <psy\-rd>:<psy\-trellis> format.
2471 .IP "\fB\-rc\-lookahead\fR \fIinteger\fR" 4
2472 .IX Item "-rc-lookahead integer"
2473 Number of frames to look ahead for frametype and ratecontrol.
2474 .IP "\fB\-weightb\fR \fIinteger\fR" 4
2475 .IX Item "-weightb integer"
2476 Weighted prediction for B\-frames.
2477 .IP "\fB\-weightp\fR \fIinteger\fR" 4
2478 .IX Item "-weightp integer"
2479 Weighted prediction analysis method.
2480 .Sp
2481 Possible values:
2482 .RS 4
2483 .IP "\fBnone\fR" 4
2484 .IX Item "none"
2485 .PD 0
2486 .IP "\fBsimple\fR" 4
2487 .IX Item "simple"
2488 .IP "\fBsmart\fR" 4
2489 .IX Item "smart"
2490 .RE
2491 .RS 4
2492 .RE
2493 .IP "\fB\-ssim\fR \fIinteger\fR" 4
2494 .IX Item "-ssim integer"
2495 .PD
2496 Calculate and print \s-1SSIM\s0 stats.
2497 .IP "\fB\-intra\-refresh\fR \fIinteger\fR" 4
2498 .IX Item "-intra-refresh integer"
2499 Use Periodic Intra Refresh instead of \s-1IDR\s0 frames.
2500 .IP "\fB\-b\-bias\fR \fIinteger\fR" 4
2501 .IX Item "-b-bias integer"
2502 Influences how often B\-frames are used.
2503 .IP "\fB\-b\-pyramid\fR \fIinteger\fR" 4
2504 .IX Item "-b-pyramid integer"
2505 Keep some B\-frames as references.
2506 .Sp
2507 Possible values:
2508 .RS 4
2509 .IP "\fBnone\fR" 4
2510 .IX Item "none"
2511 .PD 0
2512 .IP "\fBstrict\fR" 4
2513 .IX Item "strict"
2514 .PD
2515 Strictly hierarchical pyramid.
2516 .IP "\fBnormal\fR" 4
2517 .IX Item "normal"
2518 Non-strict (not Blu-ray compatible).
2519 .RE
2520 .RS 4
2521 .RE
2522 .IP "\fB\-mixed\-refs\fR \fIinteger\fR" 4
2523 .IX Item "-mixed-refs integer"
2524 One reference per partition, as opposed to one reference per macroblock.
2525 .IP "\fB\-8x8dct\fR \fIinteger\fR" 4
2526 .IX Item "-8x8dct integer"
2527 High profile 8x8 transform.
2528 .IP "\fB\-fast\-pskip\fR \fIinteger\fR" 4
2529 .IX Item "-fast-pskip integer"
2530 .PD 0
2531 .IP "\fB\-aud\fR \fIinteger\fR" 4
2532 .IX Item "-aud integer"
2533 .PD
2534 Use access unit delimiters.
2535 .IP "\fB\-mbtree\fR \fIinteger\fR" 4
2536 .IX Item "-mbtree integer"
2537 Use macroblock tree ratecontrol.
2538 .IP "\fB\-deblock\fR \fIstring\fR" 4
2539 .IX Item "-deblock string"
2540 Loop filter parameters, in <alpha:beta> form.
2541 .IP "\fB\-cplxblur\fR \fIfloat\fR" 4
2542 .IX Item "-cplxblur float"
2543 Reduce fluctuations in \s-1QP\s0 (before curve compression).
2544 .IP "\fB\-partitions\fR \fIstring\fR" 4
2545 .IX Item "-partitions string"
2546 A comma-separated list of partitions to consider, possible values: p8x8, p4x4, b8x8, i8x8, i4x4, none, all.
2547 .IP "\fB\-direct\-pred\fR \fIinteger\fR" 4
2548 .IX Item "-direct-pred integer"
2549 Direct \s-1MV\s0 prediction mode
2550 .Sp
2551 Possible values:
2552 .RS 4
2553 .IP "\fBnone\fR" 4
2554 .IX Item "none"
2555 .PD 0
2556 .IP "\fBspatial\fR" 4
2557 .IX Item "spatial"
2558 .IP "\fBtemporal\fR" 4
2559 .IX Item "temporal"
2560 .IP "\fBauto\fR" 4
2561 .IX Item "auto"
2562 .RE
2563 .RS 4
2564 .RE
2565 .IP "\fB\-slice\-max\-size\fR \fIinteger\fR" 4
2566 .IX Item "-slice-max-size integer"
2567 .PD
2568 Limit the size of each slice in bytes.
2569 .IP "\fB\-stats\fR \fIstring\fR" 4
2570 .IX Item "-stats string"
2571 Filename for 2 pass stats.
2572 .IP "\fB\-nal\-hrd\fR \fIinteger\fR" 4
2573 .IX Item "-nal-hrd integer"
2574 Signal \s-1HRD\s0 information (requires vbv-bufsize; cbr not allowed in .mp4).
2575 .Sp
2576 Possible values:
2577 .RS 4
2578 .IP "\fBnone\fR" 4
2579 .IX Item "none"
2580 .PD 0
2581 .IP "\fBvbr\fR" 4
2582 .IX Item "vbr"
2583 .IP "\fBcbr\fR" 4
2584 .IX Item "cbr"
2585 .RE
2586 .RS 4
2587 .RE
2588 .IP "\fBx264opts\fR \fIoptions\fR" 4
2589 .IX Item "x264opts options"
2590 .PD
2591 Allow to set any x264 option, see \f(CW\*(C`x264 \-\-fullhelp\*(C'\fR for a list.
2592 .Sp
2593 \&\fIoptions\fR is a list of \fIkey\fR=\fIvalue\fR couples separated by
2594 \&\*(L":\*(R". In \fIfilter\fR and \fIpsy-rd\fR options that use \*(L":\*(R" as a separator
2595 themselves, use \*(L",\*(R" instead. They accept it as well since long ago but this
2596 is kept undocumented for some reason.
2597 .Sp
2598 For example to specify libx264 encoding options with \fBffmpeg\fR:
2599 .Sp
2600 .Vb 1
2601 \& ffmpeg \-i foo.mpg \-vcodec libx264 \-x264opts keyint=123:min\-keyint=20 \-an out.mkv
2602 .Ve
2603 .Sp
2604 For more information about libx264 and the supported options see:
2605 <\fBhttp://www.videolan.org/developers/x264.html\fR>
2606 .IP "\fB\-x264\-params\fR \fIstring\fR" 4
2607 .IX Item "-x264-params string"
2608 Override the x264 configuration using a :\-separated list of key=value parameters.
2609 .Sp
2610 .Vb 1
2611 \& \-x264\-params level=30:bframes=0:weightp=0:cabac=0:ref=1:vbv\-maxrate=768:vbv\-bufsize=2000:analyse=all:me=umh:no\-fast\-pskip=1:subq=6:8x8dct=0:trellis=0
2612 .Ve
2613 .PP
2614 Encoding avpresets for common usages are provided so they can be used with the
2615 general presets system (e.g. passing the \f(CW\*(C`\-pre\*(C'\fR option).
2616 .SS "ProRes"
2617 .IX Subsection "ProRes"
2618 Apple ProRes encoder.
2619 .PP
2620 FFmpeg contains 2 ProRes encoders, the prores-aw and prores-ks encoder.
2621 The used encoder can be choosen with the \f(CW\*(C`\-vcodec\*(C'\fR option.
2622 .PP
2623 \fIPrivate Options for prores-ks\fR
2624 .IX Subsection "Private Options for prores-ks"
2625 .IP "\fBprofile\fR \fIinteger\fR" 4
2626 .IX Item "profile integer"
2627 Select the ProRes profile to encode
2628 .RS 4
2629 .IP "\fBproxy\fR" 4
2630 .IX Item "proxy"
2631 .PD 0
2632 .IP "\fBlt\fR" 4
2633 .IX Item "lt"
2634 .IP "\fBstandard\fR" 4
2635 .IX Item "standard"
2636 .IP "\fBhq\fR" 4
2637 .IX Item "hq"
2638 .RE
2639 .RS 4
2640 .RE
2641 .IP "\fBquant_mat\fR \fIinteger\fR" 4
2642 .IX Item "quant_mat integer"
2643 .PD
2644 Select quantization matrix.
2645 .RS 4
2646 .IP "\fBauto\fR" 4
2647 .IX Item "auto"
2648 .PD 0
2649 .IP "\fBdefault\fR" 4
2650 .IX Item "default"
2651 .IP "\fBproxy\fR" 4
2652 .IX Item "proxy"
2653 .IP "\fBlt\fR" 4
2654 .IX Item "lt"
2655 .IP "\fBstandard\fR" 4
2656 .IX Item "standard"
2657 .IP "\fBhq\fR" 4
2658 .IX Item "hq"
2659 .RE
2660 .RS 4
2661 .PD
2662 .Sp
2663 If set to \fIauto\fR, the matrix matching the profile will be picked.
2664 If not set, the matrix providing the highest quality, \fIdefault\fR, will be
2665 picked.
2666 .RE
2667 .IP "\fBbits_per_mb\fR \fIinteger\fR" 4
2668 .IX Item "bits_per_mb integer"
2669 How many bits to allot for coding one macroblock. Different profiles use
2670 between 200 and 2400 bits per macroblock, the maximum is 8000.
2671 .IP "\fBmbs_per_slice\fR \fIinteger\fR" 4
2672 .IX Item "mbs_per_slice integer"
2673 Number of macroblocks in each slice (1\-8); the default value (8)
2674 should be good in almost all situations.
2675 .IP "\fBvendor\fR \fIstring\fR" 4
2676 .IX Item "vendor string"
2677 Override the 4\-byte vendor \s-1ID\s0.
2678 A custom vendor \s-1ID\s0 like \fIapl0\fR would claim the stream was produced by
2679 the Apple encoder.
2680 .PP
2681 \fISpeed considerations\fR
2682 .IX Subsection "Speed considerations"
2683 .PP
2684 In the default mode of operation the encoder has to honor frame constraints
2685 (i.e. not produc frames with size bigger than requested) while still making
2686 output picture as good as possible.
2687 A frame containing a lot of small details is harder to compress and the encoder
2688 would spend more time searching for appropriate quantizers for each slice.
2689 .PP
2690 Setting a higher \fBbits_per_mb\fR limit will improve the speed.
2691 .PP
2692 For the fastest encoding speed set the \fBqscale\fR parameter (4 is the
2693 recommended value) and do not set a size constraint.
2694 .SH "SEE ALSO"
2695 .IX Header "SEE ALSO"
2696 \&\fIffmpeg\fR\|(1), \fIffplay\fR\|(1), \fIffprobe\fR\|(1), \fIffserver\fR\|(1), \fIlibavcodec\fR\|(3)
2697 .SH "AUTHORS"
2698 .IX Header "AUTHORS"
2699 The FFmpeg developers.
2700 .PP
2701 For details about the authorship, see the Git history of the project
2702 (git://source.ffmpeg.org/ffmpeg), e.g. by typing the command
2703 \&\fBgit log\fR in the FFmpeg source directory, or browsing the
2704 online repository at <\fBhttp://source.ffmpeg.org\fR>.
2705 .PP
2706 Maintainers for the specific components are listed in the file
2707 \&\fI\s-1MAINTAINERS\s0\fR in the source code tree.