Subversion Repositories Kolibri OS

Rev

Go to most recent revision | Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
4349 Serge 1
.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
2
.\"
3
.\" Standard preamble:
4
.\" ========================================================================
5
.de Sh \" Subsection heading
6
.br
7
.if t .Sp
8
.ne 5
9
.PP
10
\fB\\$1\fR
11
.PP
12
..
13
.de Sp \" Vertical space (when we can't use .PP)
14
.if t .sp .5v
15
.if n .sp
16
..
17
.de Vb \" Begin verbatim text
18
.ft CW
19
.nf
20
.ne \\$1
21
..
22
.de Ve \" End verbatim text
23
.ft R
24
.fi
25
..
26
.\" Set up some character translations and predefined strings.  \*(-- will
27
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28
.\" double quote, and \*(R" will give a right double quote.  | will give a
29
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
30
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
31
.\" expand to `' in nroff, nothing in troff, for use with C<>.
32
.tr \(*W-|\(bv\*(Tr
33
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
34
.ie n \{\
35
.    ds -- \(*W-
36
.    ds PI pi
37
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
39
.    ds L" ""
40
.    ds R" ""
41
.    ds C` ""
42
.    ds C' ""
43
'br\}
44
.el\{\
45
.    ds -- \|\(em\|
46
.    ds PI \(*p
47
.    ds L" ``
48
.    ds R" ''
49
'br\}
50
.\"
51
.\" If the F register is turned on, we'll generate index entries on stderr for
52
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
53
.\" entries marked with X<> in POD.  Of course, you'll have to process the
54
.\" output yourself in some meaningful fashion.
55
.if \nF \{\
56
.    de IX
57
.    tm Index:\\$1\t\\n%\t"\\$2"
58
..
59
.    nr % 0
60
.    rr F
61
.\}
62
.\"
63
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
64
.\" way too many mistakes in technical documents.
65
.hy 0
66
.if n .na
67
.\"
68
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
70
.    \" fudge factors for nroff and troff
71
.if n \{\
72
.    ds #H 0
73
.    ds #V .8m
74
.    ds #F .3m
75
.    ds #[ \f1
76
.    ds #] \fP
77
.\}
78
.if t \{\
79
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
80
.    ds #V .6m
81
.    ds #F 0
82
.    ds #[ \&
83
.    ds #] \&
84
.\}
85
.    \" simple accents for nroff and troff
86
.if n \{\
87
.    ds ' \&
88
.    ds ` \&
89
.    ds ^ \&
90
.    ds , \&
91
.    ds ~ ~
92
.    ds /
93
.\}
94
.if t \{\
95
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
96
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
97
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
98
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
99
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
100
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
101
.\}
102
.    \" troff and (daisy-wheel) nroff accents
103
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
104
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
105
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
106
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
107
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
108
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
109
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
110
.ds ae a\h'-(\w'a'u*4/10)'e
111
.ds Ae A\h'-(\w'A'u*4/10)'E
112
.    \" corrections for vroff
113
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
114
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
115
.    \" for low resolution devices (crt and lpr)
116
.if \n(.H>23 .if \n(.V>19 \
117
\{\
118
.    ds : e
119
.    ds 8 ss
120
.    ds o a
121
.    ds d- d\h'-1'\(ga
122
.    ds D- D\h'-1'\(hy
123
.    ds th \o'bp'
124
.    ds Th \o'LP'
125
.    ds ae ae
126
.    ds Ae AE
127
.\}
128
.rm #[ #] #H #V #F C
129
.\" ========================================================================
130
.\"
131
.IX Title "FFMPEG-CODECS 1"
132
.TH FFMPEG-CODECS 1 "2013-12-14" " " " "
133
.SH "NAME"
134
ffmpeg\-codecs \- FFmpeg codecs
135
.SH "DESCRIPTION"
136
.IX Header "DESCRIPTION"
137
This document describes the codecs (decoders and encoders) provided by
138
the libavcodec library.
139
.SH "CODEC OPTIONS"
140
.IX Header "CODEC OPTIONS"
141
libavcodec provides some generic global options, which can be set on
142
all the encoders and decoders. In addition each codec may support
143
so-called private options, which are specific for a given codec.
144
.PP
145
Sometimes, a global option may only affect a specific kind of codec,
146
and may be unsensical or ignored by another, so you need to be aware
147
of the meaning of the specified options. Also some options are
148
meant only for decoding or encoding.
149
.PP
150
Options may be set by specifying \-\fIoption\fR \fIvalue\fR in the
151
FFmpeg tools, or by setting the value explicitly in the
152
\&\f(CW\*(C`AVCodecContext\*(C'\fR options or using the \fIlibavutil/opt.h\fR \s-1API\s0
153
for programmatic use.
154
.PP
155
The list of supported options follow:
156
.IP "\fBb\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
157
.IX Item "b integer (encoding,audio,video)"
158
Set bitrate in bits/s. Default value is 200K.
159
.IP "\fBab\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4
160
.IX Item "ab integer (encoding,audio)"
161
Set audio bitrate (in bits/s). Default value is 128K.
162
.IP "\fBbt\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
163
.IX Item "bt integer (encoding,video)"
164
Set video bitrate tolerance (in bits/s). In 1\-pass mode, bitrate
165
tolerance specifies how far ratecontrol is willing to deviate from the
166
target average bitrate value. This is not related to min/max
167
bitrate. Lowering tolerance too much has an adverse effect on quality.
168
.IP "\fBflags\fR \fIflags\fR \fB(\fR\fIdecoding/encoding,audio,video,subtitles\fR\fB)\fR" 4
169
.IX Item "flags flags (decoding/encoding,audio,video,subtitles)"
170
Set generic flags.
171
.Sp
172
Possible values:
173
.RS 4
174
.IP "\fBmv4\fR" 4
175
.IX Item "mv4"
176
Use four motion vector by macroblock (mpeg4).
177
.IP "\fBqpel\fR" 4
178
.IX Item "qpel"
179
Use 1/4 pel motion compensation.
180
.IP "\fBloop\fR" 4
181
.IX Item "loop"
182
Use loop filter.
183
.IP "\fBqscale\fR" 4
184
.IX Item "qscale"
185
Use fixed qscale.
186
.IP "\fBgmc\fR" 4
187
.IX Item "gmc"
188
Use gmc.
189
.IP "\fBmv0\fR" 4
190
.IX Item "mv0"
191
Always try a mb with mv=<0,0>.
192
.IP "\fBinput_preserved\fR" 4
193
.IX Item "input_preserved"
194
.PD 0
195
.IP "\fBpass1\fR" 4
196
.IX Item "pass1"
197
.PD
198
Use internal 2pass ratecontrol in first pass mode.
199
.IP "\fBpass2\fR" 4
200
.IX Item "pass2"
201
Use internal 2pass ratecontrol in second pass mode.
202
.IP "\fBgray\fR" 4
203
.IX Item "gray"
204
Only decode/encode grayscale.
205
.IP "\fBemu_edge\fR" 4
206
.IX Item "emu_edge"
207
Do not draw edges.
208
.IP "\fBpsnr\fR" 4
209
.IX Item "psnr"
210
Set error[?] variables during encoding.
211
.IP "\fBtruncated\fR" 4
212
.IX Item "truncated"
213
.PD 0
214
.IP "\fBnaq\fR" 4
215
.IX Item "naq"
216
.PD
217
Normalize adaptive quantization.
218
.IP "\fBildct\fR" 4
219
.IX Item "ildct"
220
Use interlaced \s-1DCT\s0.
221
.IP "\fBlow_delay\fR" 4
222
.IX Item "low_delay"
223
Force low delay.
224
.IP "\fBglobal_header\fR" 4
225
.IX Item "global_header"
226
Place global headers in extradata instead of every keyframe.
227
.IP "\fBbitexact\fR" 4
228
.IX Item "bitexact"
229
Use only bitexact stuff (except (I)DCT).
230
.IP "\fBaic\fR" 4
231
.IX Item "aic"
232
Apply H263 advanced intra coding / mpeg4 ac prediction.
233
.IP "\fBcbp\fR" 4
234
.IX Item "cbp"
235
Deprecated, use mpegvideo private options instead.
236
.IP "\fBqprd\fR" 4
237
.IX Item "qprd"
238
Deprecated, use mpegvideo private options instead.
239
.IP "\fBilme\fR" 4
240
.IX Item "ilme"
241
Apply interlaced motion estimation.
242
.IP "\fBcgop\fR" 4
243
.IX Item "cgop"
244
Use closed gop.
245
.RE
246
.RS 4
247
.RE
248
.IP "\fBme_method\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
249
.IX Item "me_method integer (encoding,video)"
250
Set motion estimation method.
251
.Sp
252
Possible values:
253
.RS 4
254
.IP "\fBzero\fR" 4
255
.IX Item "zero"
256
zero motion estimation (fastest)
257
.IP "\fBfull\fR" 4
258
.IX Item "full"
259
full motion estimation (slowest)
260
.IP "\fBepzs\fR" 4
261
.IX Item "epzs"
262
\&\s-1EPZS\s0 motion estimation (default)
263
.IP "\fBesa\fR" 4
264
.IX Item "esa"
265
esa motion estimation (alias for full)
266
.IP "\fBtesa\fR" 4
267
.IX Item "tesa"
268
tesa motion estimation
269
.IP "\fBdia\fR" 4
270
.IX Item "dia"
271
dia motion estimation (alias for epzs)
272
.IP "\fBlog\fR" 4
273
.IX Item "log"
274
log motion estimation
275
.IP "\fBphods\fR" 4
276
.IX Item "phods"
277
phods motion estimation
278
.IP "\fBx1\fR" 4
279
.IX Item "x1"
280
X1 motion estimation
281
.IP "\fBhex\fR" 4
282
.IX Item "hex"
283
hex motion estimation
284
.IP "\fBumh\fR" 4
285
.IX Item "umh"
286
umh motion estimation
287
.IP "\fBiter\fR" 4
288
.IX Item "iter"
289
iter motion estimation
290
.RE
291
.RS 4
292
.RE
293
.IP "\fBextradata_size\fR \fIinteger\fR" 4
294
.IX Item "extradata_size integer"
295
Set extradata size.
296
.IP "\fBtime_base\fR \fIrational number\fR" 4
297
.IX Item "time_base rational number"
298
Set codec time base.
299
.Sp
300
It is the fundamental unit of time (in seconds) in terms of which
301
frame timestamps are represented. For fixed-fps content, timebase
302
should be \f(CW\*(C`1 / frame_rate\*(C'\fR and timestamp increments should be
303
identically 1.
304
.IP "\fBg\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
305
.IX Item "g integer (encoding,video)"
306
Set the group of picture size. Default value is 12.
307
.IP "\fBar\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,audio\fR\fB)\fR" 4
308
.IX Item "ar integer (decoding/encoding,audio)"
309
Set audio sampling rate (in Hz).
310
.IP "\fBac\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,audio\fR\fB)\fR" 4
311
.IX Item "ac integer (decoding/encoding,audio)"
312
Set number of audio channels.
313
.IP "\fBcutoff\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4
314
.IX Item "cutoff integer (encoding,audio)"
315
Set cutoff bandwidth.
316
.IP "\fBframe_size\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4
317
.IX Item "frame_size integer (encoding,audio)"
318
Set audio frame size.
319
.Sp
320
Each submitted frame except the last must contain exactly frame_size
321
samples per channel. May be 0 when the codec has
322
\&\s-1CODEC_CAP_VARIABLE_FRAME_SIZE\s0 set, in that case the frame size is not
323
restricted. It is set by some decoders to indicate constant frame
324
size.
325
.IP "\fBframe_number\fR \fIinteger\fR" 4
326
.IX Item "frame_number integer"
327
Set the frame number.
328
.IP "\fBdelay\fR \fIinteger\fR" 4
329
.IX Item "delay integer"
330
.PD 0
331
.IP "\fBqcomp\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
332
.IX Item "qcomp float (encoding,video)"
333
.PD
334
Set video quantizer scale compression (\s-1VBR\s0). It is used as a constant
335
in the ratecontrol equation. Recommended range for default rc_eq:
336
0.0\-1.0.
337
.IP "\fBqblur\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
338
.IX Item "qblur float (encoding,video)"
339
Set video quantizer scale blur (\s-1VBR\s0).
340
.IP "\fBqmin\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
341
.IX Item "qmin integer (encoding,video)"
342
Set min video quantizer scale (\s-1VBR\s0). Must be included between \-1 and
343
69, default value is 2.
344
.IP "\fBqmax\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
345
.IX Item "qmax integer (encoding,video)"
346
Set max video quantizer scale (\s-1VBR\s0). Must be included between \-1 and
347
1024, default value is 31.
348
.IP "\fBqdiff\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
349
.IX Item "qdiff integer (encoding,video)"
350
Set max difference between the quantizer scale (\s-1VBR\s0).
351
.IP "\fBbf\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
352
.IX Item "bf integer (encoding,video)"
353
Set max number of B frames.
354
.IP "\fBb_qfactor\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
355
.IX Item "b_qfactor float (encoding,video)"
356
Set qp factor between P and B frames.
357
.IP "\fBrc_strategy\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
358
.IX Item "rc_strategy integer (encoding,video)"
359
Set ratecontrol method.
360
.IP "\fBb_strategy\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
361
.IX Item "b_strategy integer (encoding,video)"
362
Set strategy to choose between I/P/B\-frames.
363
.IP "\fBps\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
364
.IX Item "ps integer (encoding,video)"
365
Set \s-1RTP\s0 payload size in bytes.
366
.IP "\fBmv_bits\fR \fIinteger\fR" 4
367
.IX Item "mv_bits integer"
368
.PD 0
369
.IP "\fBheader_bits\fR \fIinteger\fR" 4
370
.IX Item "header_bits integer"
371
.IP "\fBi_tex_bits\fR \fIinteger\fR" 4
372
.IX Item "i_tex_bits integer"
373
.IP "\fBp_tex_bits\fR \fIinteger\fR" 4
374
.IX Item "p_tex_bits integer"
375
.IP "\fBi_count\fR \fIinteger\fR" 4
376
.IX Item "i_count integer"
377
.IP "\fBp_count\fR \fIinteger\fR" 4
378
.IX Item "p_count integer"
379
.IP "\fBskip_count\fR \fIinteger\fR" 4
380
.IX Item "skip_count integer"
381
.IP "\fBmisc_bits\fR \fIinteger\fR" 4
382
.IX Item "misc_bits integer"
383
.IP "\fBframe_bits\fR \fIinteger\fR" 4
384
.IX Item "frame_bits integer"
385
.IP "\fBcodec_tag\fR \fIinteger\fR" 4
386
.IX Item "codec_tag integer"
387
.IP "\fBbug\fR \fIflags\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
388
.IX Item "bug flags (decoding,video)"
389
.PD
390
Workaround not auto detected encoder bugs.
391
.Sp
392
Possible values:
393
.RS 4
394
.IP "\fBautodetect\fR" 4
395
.IX Item "autodetect"
396
.PD 0
397
.IP "\fBold_msmpeg4\fR" 4
398
.IX Item "old_msmpeg4"
399
.PD
400
some old lavc generated msmpeg4v3 files (no autodetection)
401
.IP "\fBxvid_ilace\fR" 4
402
.IX Item "xvid_ilace"
403
Xvid interlacing bug (autodetected if fourcc==XVIX)
404
.IP "\fBump4\fR" 4
405
.IX Item "ump4"
406
(autodetected if fourcc==UMP4)
407
.IP "\fBno_padding\fR" 4
408
.IX Item "no_padding"
409
padding bug (autodetected)
410
.IP "\fBamv\fR" 4
411
.IX Item "amv"
412
.PD 0
413
.IP "\fBac_vlc\fR" 4
414
.IX Item "ac_vlc"
415
.PD
416
illegal vlc bug (autodetected per fourcc)
417
.IP "\fBqpel_chroma\fR" 4
418
.IX Item "qpel_chroma"
419
.PD 0
420
.IP "\fBstd_qpel\fR" 4
421
.IX Item "std_qpel"
422
.PD
423
old standard qpel (autodetected per fourcc/version)
424
.IP "\fBqpel_chroma2\fR" 4
425
.IX Item "qpel_chroma2"
426
.PD 0
427
.IP "\fBdirect_blocksize\fR" 4
428
.IX Item "direct_blocksize"
429
.PD
430
direct-qpel-blocksize bug (autodetected per fourcc/version)
431
.IP "\fBedge\fR" 4
432
.IX Item "edge"
433
edge padding bug (autodetected per fourcc/version)
434
.IP "\fBhpel_chroma\fR" 4
435
.IX Item "hpel_chroma"
436
.PD 0
437
.IP "\fBdc_clip\fR" 4
438
.IX Item "dc_clip"
439
.IP "\fBms\fR" 4
440
.IX Item "ms"
441
.PD
442
Workaround various bugs in microsoft broken decoders.
443
.IP "\fBtrunc\fR" 4
444
.IX Item "trunc"
445
trancated frames
446
.RE
447
.RS 4
448
.RE
449
.IP "\fBlelim\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
450
.IX Item "lelim integer (encoding,video)"
451
Set single coefficient elimination threshold for luminance (negative
452
values also consider \s-1DC\s0 coefficient).
453
.IP "\fBcelim\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
454
.IX Item "celim integer (encoding,video)"
455
Set single coefficient elimination threshold for chrominance (negative
456
values also consider dc coefficient)
457
.IP "\fBstrict\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,audio,video\fR\fB)\fR" 4
458
.IX Item "strict integer (decoding/encoding,audio,video)"
459
Specify how strictly to follow the standards.
460
.Sp
461
Possible values:
462
.RS 4
463
.IP "\fBvery\fR" 4
464
.IX Item "very"
465
strictly conform to a older more strict version of the spec or reference software
466
.IP "\fBstrict\fR" 4
467
.IX Item "strict"
468
strictly conform to all the things in the spec no matter what consequences
469
.IP "\fBnormal\fR" 4
470
.IX Item "normal"
471
.PD 0
472
.IP "\fBunofficial\fR" 4
473
.IX Item "unofficial"
474
.PD
475
allow unofficial extensions
476
.IP "\fBexperimental\fR" 4
477
.IX Item "experimental"
478
allow non standardized experimental things, experimental
479
(unfinished/work in progress/not well tested) decoders and encoders.
480
Note: experimental decoders can pose a security risk, do not use this for
481
decoding untrusted input.
482
.RE
483
.RS 4
484
.RE
485
.IP "\fBb_qoffset\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
486
.IX Item "b_qoffset float (encoding,video)"
487
Set \s-1QP\s0 offset between P and B frames.
488
.IP "\fBerr_detect\fR \fIflags\fR \fB(\fR\fIdecoding,audio,video\fR\fB)\fR" 4
489
.IX Item "err_detect flags (decoding,audio,video)"
490
Set error detection flags.
491
.Sp
492
Possible values:
493
.RS 4
494
.IP "\fBcrccheck\fR" 4
495
.IX Item "crccheck"
496
verify embedded CRCs
497
.IP "\fBbitstream\fR" 4
498
.IX Item "bitstream"
499
detect bitstream specification deviations
500
.IP "\fBbuffer\fR" 4
501
.IX Item "buffer"
502
detect improper bitstream length
503
.IP "\fBexplode\fR" 4
504
.IX Item "explode"
505
abort decoding on minor error detection
506
.IP "\fBcareful\fR" 4
507
.IX Item "careful"
508
consider things that violate the spec and have not been seen in the wild as errors
509
.IP "\fBcompliant\fR" 4
510
.IX Item "compliant"
511
consider all spec non compliancies as errors
512
.IP "\fBaggressive\fR" 4
513
.IX Item "aggressive"
514
consider things that a sane encoder should not do as an error
515
.RE
516
.RS 4
517
.RE
518
.IP "\fBhas_b_frames\fR \fIinteger\fR" 4
519
.IX Item "has_b_frames integer"
520
.PD 0
521
.IP "\fBblock_align\fR \fIinteger\fR" 4
522
.IX Item "block_align integer"
523
.IP "\fBmpeg_quant\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
524
.IX Item "mpeg_quant integer (encoding,video)"
525
.PD
526
Use \s-1MPEG\s0 quantizers instead of H.263.
527
.IP "\fBqsquish\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
528
.IX Item "qsquish float (encoding,video)"
529
How to keep quantizer between qmin and qmax (0 = clip, 1 = use
530
differentiable function).
531
.IP "\fBrc_qmod_amp\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
532
.IX Item "rc_qmod_amp float (encoding,video)"
533
Set experimental quantizer modulation.
534
.IP "\fBrc_qmod_freq\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
535
.IX Item "rc_qmod_freq integer (encoding,video)"
536
Set experimental quantizer modulation.
537
.IP "\fBrc_override_count\fR \fIinteger\fR" 4
538
.IX Item "rc_override_count integer"
539
.PD 0
540
.IP "\fBrc_eq\fR \fIstring\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
541
.IX Item "rc_eq string (encoding,video)"
542
.PD
543
Set rate control equation. When computing the expression, besides the
544
standard functions defined in the section 'Expression Evaluation', the
545
following functions are available: bits2qp(bits), qp2bits(qp). Also
546
the following constants are available: iTex pTex tex mv fCode iCount
547
mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex
548
avgTex.
549
.IP "\fBmaxrate\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
550
.IX Item "maxrate integer (encoding,audio,video)"
551
Set max bitrate tolerance (in bits/s). Requires bufsize to be set.
552
.IP "\fBminrate\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
553
.IX Item "minrate integer (encoding,audio,video)"
554
Set min bitrate tolerance (in bits/s). Most useful in setting up a \s-1CBR\s0
555
encode. It is of little use elsewise.
556
.IP "\fBbufsize\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
557
.IX Item "bufsize integer (encoding,audio,video)"
558
Set ratecontrol buffer size (in bits).
559
.IP "\fBrc_buf_aggressivity\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
560
.IX Item "rc_buf_aggressivity float (encoding,video)"
561
Currently useless.
562
.IP "\fBi_qfactor\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
563
.IX Item "i_qfactor float (encoding,video)"
564
Set \s-1QP\s0 factor between P and I frames.
565
.IP "\fBi_qoffset\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
566
.IX Item "i_qoffset float (encoding,video)"
567
Set \s-1QP\s0 offset between P and I frames.
568
.IP "\fBrc_init_cplx\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
569
.IX Item "rc_init_cplx float (encoding,video)"
570
Set initial complexity for 1\-pass encoding.
571
.IP "\fBdct\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
572
.IX Item "dct integer (encoding,video)"
573
Set \s-1DCT\s0 algorithm.
574
.Sp
575
Possible values:
576
.RS 4
577
.IP "\fBauto\fR" 4
578
.IX Item "auto"
579
autoselect a good one (default)
580
.IP "\fBfastint\fR" 4
581
.IX Item "fastint"
582
fast integer
583
.IP "\fBint\fR" 4
584
.IX Item "int"
585
accurate integer
586
.IP "\fBmmx\fR" 4
587
.IX Item "mmx"
588
.PD 0
589
.IP "\fBaltivec\fR" 4
590
.IX Item "altivec"
591
.IP "\fBfaan\fR" 4
592
.IX Item "faan"
593
.PD
594
floating point \s-1AAN\s0 \s-1DCT\s0
595
.RE
596
.RS 4
597
.RE
598
.IP "\fBlumi_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
599
.IX Item "lumi_mask float (encoding,video)"
600
Compress bright areas stronger than medium ones.
601
.IP "\fBtcplx_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
602
.IX Item "tcplx_mask float (encoding,video)"
603
Set temporal complexity masking.
604
.IP "\fBscplx_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
605
.IX Item "scplx_mask float (encoding,video)"
606
Set spatial complexity masking.
607
.IP "\fBp_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
608
.IX Item "p_mask float (encoding,video)"
609
Set inter masking.
610
.IP "\fBdark_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
611
.IX Item "dark_mask float (encoding,video)"
612
Compress dark areas stronger than medium ones.
613
.IP "\fBidct\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
614
.IX Item "idct integer (decoding/encoding,video)"
615
Select \s-1IDCT\s0 implementation.
616
.Sp
617
Possible values:
618
.RS 4
619
.IP "\fBauto\fR" 4
620
.IX Item "auto"
621
.PD 0
622
.IP "\fBint\fR" 4
623
.IX Item "int"
624
.IP "\fBsimple\fR" 4
625
.IX Item "simple"
626
.IP "\fBsimplemmx\fR" 4
627
.IX Item "simplemmx"
628
.IP "\fBarm\fR" 4
629
.IX Item "arm"
630
.IP "\fBaltivec\fR" 4
631
.IX Item "altivec"
632
.IP "\fBsh4\fR" 4
633
.IX Item "sh4"
634
.IP "\fBsimplearm\fR" 4
635
.IX Item "simplearm"
636
.IP "\fBsimplearmv5te\fR" 4
637
.IX Item "simplearmv5te"
638
.IP "\fBsimplearmv6\fR" 4
639
.IX Item "simplearmv6"
640
.IP "\fBsimpleneon\fR" 4
641
.IX Item "simpleneon"
642
.IP "\fBsimplealpha\fR" 4
643
.IX Item "simplealpha"
644
.IP "\fBipp\fR" 4
645
.IX Item "ipp"
646
.IP "\fBxvidmmx\fR" 4
647
.IX Item "xvidmmx"
648
.IP "\fBfaani\fR" 4
649
.IX Item "faani"
650
.PD
651
floating point \s-1AAN\s0 \s-1IDCT\s0
652
.RE
653
.RS 4
654
.RE
655
.IP "\fBslice_count\fR \fIinteger\fR" 4
656
.IX Item "slice_count integer"
657
.PD 0
658
.IP "\fBec\fR \fIflags\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
659
.IX Item "ec flags (decoding,video)"
660
.PD
661
Set error concealment strategy.
662
.Sp
663
Possible values:
664
.RS 4
665
.IP "\fBguess_mvs\fR" 4
666
.IX Item "guess_mvs"
667
iterative motion vector (\s-1MV\s0) search (slow)
668
.IP "\fBdeblock\fR" 4
669
.IX Item "deblock"
670
use strong deblock filter for damaged MBs
671
.RE
672
.RS 4
673
.RE
674
.IP "\fBbits_per_coded_sample\fR \fIinteger\fR" 4
675
.IX Item "bits_per_coded_sample integer"
676
.PD 0
677
.IP "\fBpred\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
678
.IX Item "pred integer (encoding,video)"
679
.PD
680
Set prediction method.
681
.Sp
682
Possible values:
683
.RS 4
684
.IP "\fBleft\fR" 4
685
.IX Item "left"
686
.PD 0
687
.IP "\fBplane\fR" 4
688
.IX Item "plane"
689
.IP "\fBmedian\fR" 4
690
.IX Item "median"
691
.RE
692
.RS 4
693
.RE
694
.IP "\fBaspect\fR \fIrational number\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
695
.IX Item "aspect rational number (encoding,video)"
696
.PD
697
Set sample aspect ratio.
698
.IP "\fBdebug\fR \fIflags\fR \fB(\fR\fIdecoding/encoding,audio,video,subtitles\fR\fB)\fR" 4
699
.IX Item "debug flags (decoding/encoding,audio,video,subtitles)"
700
Print specific debug info.
701
.Sp
702
Possible values:
703
.RS 4
704
.IP "\fBpict\fR" 4
705
.IX Item "pict"
706
picture info
707
.IP "\fBrc\fR" 4
708
.IX Item "rc"
709
rate control
710
.IP "\fBbitstream\fR" 4
711
.IX Item "bitstream"
712
.PD 0
713
.IP "\fBmb_type\fR" 4
714
.IX Item "mb_type"
715
.PD
716
macroblock (\s-1MB\s0) type
717
.IP "\fBqp\fR" 4
718
.IX Item "qp"
719
per-block quantization parameter (\s-1QP\s0)
720
.IP "\fBmv\fR" 4
721
.IX Item "mv"
722
motion vector
723
.IP "\fBdct_coeff\fR" 4
724
.IX Item "dct_coeff"
725
.PD 0
726
.IP "\fBskip\fR" 4
727
.IX Item "skip"
728
.IP "\fBstartcode\fR" 4
729
.IX Item "startcode"
730
.IP "\fBpts\fR" 4
731
.IX Item "pts"
732
.IP "\fBer\fR" 4
733
.IX Item "er"
734
.PD
735
error recognition
736
.IP "\fBmmco\fR" 4
737
.IX Item "mmco"
738
memory management control operations (H.264)
739
.IP "\fBbugs\fR" 4
740
.IX Item "bugs"
741
.PD 0
742
.IP "\fBvis_qp\fR" 4
743
.IX Item "vis_qp"
744
.PD
745
visualize quantization parameter (\s-1QP\s0), lower \s-1QP\s0 are tinted greener
746
.IP "\fBvis_mb_type\fR" 4
747
.IX Item "vis_mb_type"
748
visualize block types
749
.IP "\fBbuffers\fR" 4
750
.IX Item "buffers"
751
picture buffer allocations
752
.IP "\fBthread_ops\fR" 4
753
.IX Item "thread_ops"
754
threading operations
755
.RE
756
.RS 4
757
.RE
758
.IP "\fBvismv\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
759
.IX Item "vismv integer (decoding,video)"
760
Visualize motion vectors (MVs).
761
.Sp
762
Possible values:
763
.RS 4
764
.IP "\fBpf\fR" 4
765
.IX Item "pf"
766
forward predicted MVs of P\-frames
767
.IP "\fBbf\fR" 4
768
.IX Item "bf"
769
forward predicted MVs of B\-frames
770
.IP "\fBbb\fR" 4
771
.IX Item "bb"
772
backward predicted MVs of B\-frames
773
.RE
774
.RS 4
775
.RE
776
.IP "\fBcmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
777
.IX Item "cmp integer (encoding,video)"
778
Set full pel me compare function.
779
.Sp
780
Possible values:
781
.RS 4
782
.IP "\fBsad\fR" 4
783
.IX Item "sad"
784
sum of absolute differences, fast (default)
785
.IP "\fBsse\fR" 4
786
.IX Item "sse"
787
sum of squared errors
788
.IP "\fBsatd\fR" 4
789
.IX Item "satd"
790
sum of absolute Hadamard transformed differences
791
.IP "\fBdct\fR" 4
792
.IX Item "dct"
793
sum of absolute \s-1DCT\s0 transformed differences
794
.IP "\fBpsnr\fR" 4
795
.IX Item "psnr"
796
sum of squared quantization errors (avoid, low quality)
797
.IP "\fBbit\fR" 4
798
.IX Item "bit"
799
number of bits needed for the block
800
.IP "\fBrd\fR" 4
801
.IX Item "rd"
802
rate distortion optimal, slow
803
.IP "\fBzero\fR" 4
804
.IX Item "zero"
805
 
806
.IP "\fBvsad\fR" 4
807
.IX Item "vsad"
808
sum of absolute vertical differences
809
.IP "\fBvsse\fR" 4
810
.IX Item "vsse"
811
sum of squared vertical differences
812
.IP "\fBnsse\fR" 4
813
.IX Item "nsse"
814
noise preserving sum of squared differences
815
.IP "\fBw53\fR" 4
816
.IX Item "w53"
817
5/3 wavelet, only used in snow
818
.IP "\fBw97\fR" 4
819
.IX Item "w97"
820
9/7 wavelet, only used in snow
821
.IP "\fBdctmax\fR" 4
822
.IX Item "dctmax"
823
.PD 0
824
.IP "\fBchroma\fR" 4
825
.IX Item "chroma"
826
.RE
827
.RS 4
828
.RE
829
.IP "\fBsubcmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
830
.IX Item "subcmp integer (encoding,video)"
831
.PD
832
Set sub pel me compare function.
833
.Sp
834
Possible values:
835
.RS 4
836
.IP "\fBsad\fR" 4
837
.IX Item "sad"
838
sum of absolute differences, fast (default)
839
.IP "\fBsse\fR" 4
840
.IX Item "sse"
841
sum of squared errors
842
.IP "\fBsatd\fR" 4
843
.IX Item "satd"
844
sum of absolute Hadamard transformed differences
845
.IP "\fBdct\fR" 4
846
.IX Item "dct"
847
sum of absolute \s-1DCT\s0 transformed differences
848
.IP "\fBpsnr\fR" 4
849
.IX Item "psnr"
850
sum of squared quantization errors (avoid, low quality)
851
.IP "\fBbit\fR" 4
852
.IX Item "bit"
853
number of bits needed for the block
854
.IP "\fBrd\fR" 4
855
.IX Item "rd"
856
rate distortion optimal, slow
857
.IP "\fBzero\fR" 4
858
.IX Item "zero"
859
 
860
.IP "\fBvsad\fR" 4
861
.IX Item "vsad"
862
sum of absolute vertical differences
863
.IP "\fBvsse\fR" 4
864
.IX Item "vsse"
865
sum of squared vertical differences
866
.IP "\fBnsse\fR" 4
867
.IX Item "nsse"
868
noise preserving sum of squared differences
869
.IP "\fBw53\fR" 4
870
.IX Item "w53"
871
5/3 wavelet, only used in snow
872
.IP "\fBw97\fR" 4
873
.IX Item "w97"
874
9/7 wavelet, only used in snow
875
.IP "\fBdctmax\fR" 4
876
.IX Item "dctmax"
877
.PD 0
878
.IP "\fBchroma\fR" 4
879
.IX Item "chroma"
880
.RE
881
.RS 4
882
.RE
883
.IP "\fBmbcmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
884
.IX Item "mbcmp integer (encoding,video)"
885
.PD
886
Set macroblock compare function.
887
.Sp
888
Possible values:
889
.RS 4
890
.IP "\fBsad\fR" 4
891
.IX Item "sad"
892
sum of absolute differences, fast (default)
893
.IP "\fBsse\fR" 4
894
.IX Item "sse"
895
sum of squared errors
896
.IP "\fBsatd\fR" 4
897
.IX Item "satd"
898
sum of absolute Hadamard transformed differences
899
.IP "\fBdct\fR" 4
900
.IX Item "dct"
901
sum of absolute \s-1DCT\s0 transformed differences
902
.IP "\fBpsnr\fR" 4
903
.IX Item "psnr"
904
sum of squared quantization errors (avoid, low quality)
905
.IP "\fBbit\fR" 4
906
.IX Item "bit"
907
number of bits needed for the block
908
.IP "\fBrd\fR" 4
909
.IX Item "rd"
910
rate distortion optimal, slow
911
.IP "\fBzero\fR" 4
912
.IX Item "zero"
913
 
914
.IP "\fBvsad\fR" 4
915
.IX Item "vsad"
916
sum of absolute vertical differences
917
.IP "\fBvsse\fR" 4
918
.IX Item "vsse"
919
sum of squared vertical differences
920
.IP "\fBnsse\fR" 4
921
.IX Item "nsse"
922
noise preserving sum of squared differences
923
.IP "\fBw53\fR" 4
924
.IX Item "w53"
925
5/3 wavelet, only used in snow
926
.IP "\fBw97\fR" 4
927
.IX Item "w97"
928
9/7 wavelet, only used in snow
929
.IP "\fBdctmax\fR" 4
930
.IX Item "dctmax"
931
.PD 0
932
.IP "\fBchroma\fR" 4
933
.IX Item "chroma"
934
.RE
935
.RS 4
936
.RE
937
.IP "\fBildctcmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
938
.IX Item "ildctcmp integer (encoding,video)"
939
.PD
940
Set interlaced dct compare function.
941
.Sp
942
Possible values:
943
.RS 4
944
.IP "\fBsad\fR" 4
945
.IX Item "sad"
946
sum of absolute differences, fast (default)
947
.IP "\fBsse\fR" 4
948
.IX Item "sse"
949
sum of squared errors
950
.IP "\fBsatd\fR" 4
951
.IX Item "satd"
952
sum of absolute Hadamard transformed differences
953
.IP "\fBdct\fR" 4
954
.IX Item "dct"
955
sum of absolute \s-1DCT\s0 transformed differences
956
.IP "\fBpsnr\fR" 4
957
.IX Item "psnr"
958
sum of squared quantization errors (avoid, low quality)
959
.IP "\fBbit\fR" 4
960
.IX Item "bit"
961
number of bits needed for the block
962
.IP "\fBrd\fR" 4
963
.IX Item "rd"
964
rate distortion optimal, slow
965
.IP "\fBzero\fR" 4
966
.IX Item "zero"
967
 
968
.IP "\fBvsad\fR" 4
969
.IX Item "vsad"
970
sum of absolute vertical differences
971
.IP "\fBvsse\fR" 4
972
.IX Item "vsse"
973
sum of squared vertical differences
974
.IP "\fBnsse\fR" 4
975
.IX Item "nsse"
976
noise preserving sum of squared differences
977
.IP "\fBw53\fR" 4
978
.IX Item "w53"
979
5/3 wavelet, only used in snow
980
.IP "\fBw97\fR" 4
981
.IX Item "w97"
982
9/7 wavelet, only used in snow
983
.IP "\fBdctmax\fR" 4
984
.IX Item "dctmax"
985
.PD 0
986
.IP "\fBchroma\fR" 4
987
.IX Item "chroma"
988
.RE
989
.RS 4
990
.RE
991
.IP "\fBdia_size\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
992
.IX Item "dia_size integer (encoding,video)"
993
.PD
994
Set diamond type & size for motion estimation.
995
.IP "\fBlast_pred\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
996
.IX Item "last_pred integer (encoding,video)"
997
Set amount of motion predictors from the previous frame.
998
.IP "\fBpreme\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
999
.IX Item "preme integer (encoding,video)"
1000
Set pre motion estimation.
1001
.IP "\fBprecmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1002
.IX Item "precmp integer (encoding,video)"
1003
Set pre motion estimation compare function.
1004
.Sp
1005
Possible values:
1006
.RS 4
1007
.IP "\fBsad\fR" 4
1008
.IX Item "sad"
1009
sum of absolute differences, fast (default)
1010
.IP "\fBsse\fR" 4
1011
.IX Item "sse"
1012
sum of squared errors
1013
.IP "\fBsatd\fR" 4
1014
.IX Item "satd"
1015
sum of absolute Hadamard transformed differences
1016
.IP "\fBdct\fR" 4
1017
.IX Item "dct"
1018
sum of absolute \s-1DCT\s0 transformed differences
1019
.IP "\fBpsnr\fR" 4
1020
.IX Item "psnr"
1021
sum of squared quantization errors (avoid, low quality)
1022
.IP "\fBbit\fR" 4
1023
.IX Item "bit"
1024
number of bits needed for the block
1025
.IP "\fBrd\fR" 4
1026
.IX Item "rd"
1027
rate distortion optimal, slow
1028
.IP "\fBzero\fR" 4
1029
.IX Item "zero"
1030
 
1031
.IP "\fBvsad\fR" 4
1032
.IX Item "vsad"
1033
sum of absolute vertical differences
1034
.IP "\fBvsse\fR" 4
1035
.IX Item "vsse"
1036
sum of squared vertical differences
1037
.IP "\fBnsse\fR" 4
1038
.IX Item "nsse"
1039
noise preserving sum of squared differences
1040
.IP "\fBw53\fR" 4
1041
.IX Item "w53"
1042
5/3 wavelet, only used in snow
1043
.IP "\fBw97\fR" 4
1044
.IX Item "w97"
1045
9/7 wavelet, only used in snow
1046
.IP "\fBdctmax\fR" 4
1047
.IX Item "dctmax"
1048
.PD 0
1049
.IP "\fBchroma\fR" 4
1050
.IX Item "chroma"
1051
.RE
1052
.RS 4
1053
.RE
1054
.IP "\fBpre_dia_size\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1055
.IX Item "pre_dia_size integer (encoding,video)"
1056
.PD
1057
Set diamond type & size for motion estimation pre\-pass.
1058
.IP "\fBsubq\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1059
.IX Item "subq integer (encoding,video)"
1060
Set sub pel motion estimation quality.
1061
.IP "\fBdtg_active_format\fR \fIinteger\fR" 4
1062
.IX Item "dtg_active_format integer"
1063
.PD 0
1064
.IP "\fBme_range\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1065
.IX Item "me_range integer (encoding,video)"
1066
.PD
1067
Set limit motion vectors range (1023 for DivX player).
1068
.IP "\fBibias\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1069
.IX Item "ibias integer (encoding,video)"
1070
Set intra quant bias.
1071
.IP "\fBpbias\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1072
.IX Item "pbias integer (encoding,video)"
1073
Set inter quant bias.
1074
.IP "\fBcolor_table_id\fR \fIinteger\fR" 4
1075
.IX Item "color_table_id integer"
1076
.PD 0
1077
.IP "\fBglobal_quality\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
1078
.IX Item "global_quality integer (encoding,audio,video)"
1079
.IP "\fBcoder\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1080
.IX Item "coder integer (encoding,video)"
1081
.PD
1082
Possible values:
1083
.RS 4
1084
.IP "\fBvlc\fR" 4
1085
.IX Item "vlc"
1086
variable length coder / huffman coder
1087
.IP "\fBac\fR" 4
1088
.IX Item "ac"
1089
arithmetic coder
1090
.IP "\fBraw\fR" 4
1091
.IX Item "raw"
1092
raw (no encoding)
1093
.IP "\fBrle\fR" 4
1094
.IX Item "rle"
1095
run-length coder
1096
.IP "\fBdeflate\fR" 4
1097
.IX Item "deflate"
1098
deflate-based coder
1099
.RE
1100
.RS 4
1101
.RE
1102
.IP "\fBcontext\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1103
.IX Item "context integer (encoding,video)"
1104
Set context model.
1105
.IP "\fBslice_flags\fR \fIinteger\fR" 4
1106
.IX Item "slice_flags integer"
1107
.PD 0
1108
.IP "\fBxvmc_acceleration\fR \fIinteger\fR" 4
1109
.IX Item "xvmc_acceleration integer"
1110
.IP "\fBmbd\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1111
.IX Item "mbd integer (encoding,video)"
1112
.PD
1113
Set macroblock decision algorithm (high quality mode).
1114
.Sp
1115
Possible values:
1116
.RS 4
1117
.IP "\fBsimple\fR" 4
1118
.IX Item "simple"
1119
use mbcmp (default)
1120
.IP "\fBbits\fR" 4
1121
.IX Item "bits"
1122
use fewest bits
1123
.IP "\fBrd\fR" 4
1124
.IX Item "rd"
1125
use best rate distortion
1126
.RE
1127
.RS 4
1128
.RE
1129
.IP "\fBstream_codec_tag\fR \fIinteger\fR" 4
1130
.IX Item "stream_codec_tag integer"
1131
.PD 0
1132
.IP "\fBsc_threshold\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1133
.IX Item "sc_threshold integer (encoding,video)"
1134
.PD
1135
Set scene change threshold.
1136
.IP "\fBlmin\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1137
.IX Item "lmin integer (encoding,video)"
1138
Set min lagrange factor (\s-1VBR\s0).
1139
.IP "\fBlmax\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1140
.IX Item "lmax integer (encoding,video)"
1141
Set max lagrange factor (\s-1VBR\s0).
1142
.IP "\fBnr\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1143
.IX Item "nr integer (encoding,video)"
1144
Set noise reduction.
1145
.IP "\fBrc_init_occupancy\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1146
.IX Item "rc_init_occupancy integer (encoding,video)"
1147
Set number of bits which should be loaded into the rc buffer before
1148
decoding starts.
1149
.IP "\fBflags2\fR \fIflags\fR \fB(\fR\fIdecoding/encoding,audio,video\fR\fB)\fR" 4
1150
.IX Item "flags2 flags (decoding/encoding,audio,video)"
1151
Possible values:
1152
.RS 4
1153
.IP "\fBfast\fR" 4
1154
.IX Item "fast"
1155
Allow non spec compliant speedup tricks.
1156
.IP "\fBsgop\fR" 4
1157
.IX Item "sgop"
1158
Deprecated, use mpegvideo private options instead.
1159
.IP "\fBnoout\fR" 4
1160
.IX Item "noout"
1161
Skip bitstream encoding.
1162
.IP "\fBignorecrop\fR" 4
1163
.IX Item "ignorecrop"
1164
Ignore cropping information from sps.
1165
.IP "\fBlocal_header\fR" 4
1166
.IX Item "local_header"
1167
Place global headers at every keyframe instead of in extradata.
1168
.IP "\fBchunks\fR" 4
1169
.IX Item "chunks"
1170
Frame data might be split into multiple chunks.
1171
.IP "\fBshowall\fR" 4
1172
.IX Item "showall"
1173
Show all frames before the first keyframe.
1174
.IP "\fBskiprd\fR" 4
1175
.IX Item "skiprd"
1176
Deprecated, use mpegvideo private options instead.
1177
.RE
1178
.RS 4
1179
.RE
1180
.IP "\fBerror\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1181
.IX Item "error integer (encoding,video)"
1182
.PD 0
1183
.IP "\fBqns\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1184
.IX Item "qns integer (encoding,video)"
1185
.PD
1186
Deprecated, use mpegvideo private options instead.
1187
.IP "\fBthreads\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
1188
.IX Item "threads integer (decoding/encoding,video)"
1189
Possible values:
1190
.RS 4
1191
.IP "\fBauto\fR" 4
1192
.IX Item "auto"
1193
detect a good number of threads
1194
.RE
1195
.RS 4
1196
.RE
1197
.IP "\fBme_threshold\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1198
.IX Item "me_threshold integer (encoding,video)"
1199
Set motion estimation threshold.
1200
.IP "\fBmb_threshold\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1201
.IX Item "mb_threshold integer (encoding,video)"
1202
Set macroblock threshold.
1203
.IP "\fBdc\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1204
.IX Item "dc integer (encoding,video)"
1205
Set intra_dc_precision.
1206
.IP "\fBnssew\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1207
.IX Item "nssew integer (encoding,video)"
1208
Set nsse weight.
1209
.IP "\fBskip_top\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
1210
.IX Item "skip_top integer (decoding,video)"
1211
Set number of macroblock rows at the top which are skipped.
1212
.IP "\fBskip_bottom\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
1213
.IX Item "skip_bottom integer (decoding,video)"
1214
Set number of macroblock rows at the bottom which are skipped.
1215
.IP "\fBprofile\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
1216
.IX Item "profile integer (encoding,audio,video)"
1217
Possible values:
1218
.RS 4
1219
.IP "\fBunknown\fR" 4
1220
.IX Item "unknown"
1221
.PD 0
1222
.IP "\fBaac_main\fR" 4
1223
.IX Item "aac_main"
1224
.IP "\fBaac_low\fR" 4
1225
.IX Item "aac_low"
1226
.IP "\fBaac_ssr\fR" 4
1227
.IX Item "aac_ssr"
1228
.IP "\fBaac_ltp\fR" 4
1229
.IX Item "aac_ltp"
1230
.IP "\fBaac_he\fR" 4
1231
.IX Item "aac_he"
1232
.IP "\fBaac_he_v2\fR" 4
1233
.IX Item "aac_he_v2"
1234
.IP "\fBaac_ld\fR" 4
1235
.IX Item "aac_ld"
1236
.IP "\fBaac_eld\fR" 4
1237
.IX Item "aac_eld"
1238
.IP "\fBmpeg2_aac_low\fR" 4
1239
.IX Item "mpeg2_aac_low"
1240
.IP "\fBmpeg2_aac_he\fR" 4
1241
.IX Item "mpeg2_aac_he"
1242
.IP "\fBdts\fR" 4
1243
.IX Item "dts"
1244
.IP "\fBdts_es\fR" 4
1245
.IX Item "dts_es"
1246
.IP "\fBdts_96_24\fR" 4
1247
.IX Item "dts_96_24"
1248
.IP "\fBdts_hd_hra\fR" 4
1249
.IX Item "dts_hd_hra"
1250
.IP "\fBdts_hd_ma\fR" 4
1251
.IX Item "dts_hd_ma"
1252
.RE
1253
.RS 4
1254
.RE
1255
.IP "\fBlevel\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
1256
.IX Item "level integer (encoding,audio,video)"
1257
.PD
1258
Possible values:
1259
.RS 4
1260
.IP "\fBunknown\fR" 4
1261
.IX Item "unknown"
1262
.RE
1263
.RS 4
1264
.RE
1265
.PD 0
1266
.IP "\fBlowres\fR \fIinteger\fR \fB(\fR\fIdecoding,audio,video\fR\fB)\fR" 4
1267
.IX Item "lowres integer (decoding,audio,video)"
1268
.PD
1269
Decode at 1= 1/2, 2=1/4, 3=1/8 resolutions.
1270
.IP "\fBskip_threshold\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1271
.IX Item "skip_threshold integer (encoding,video)"
1272
Set frame skip threshold.
1273
.IP "\fBskip_factor\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1274
.IX Item "skip_factor integer (encoding,video)"
1275
Set frame skip factor.
1276
.IP "\fBskip_exp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1277
.IX Item "skip_exp integer (encoding,video)"
1278
Set frame skip exponent.
1279
.IP "\fBskipcmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1280
.IX Item "skipcmp integer (encoding,video)"
1281
Set frame skip compare function.
1282
.Sp
1283
Possible values:
1284
.RS 4
1285
.IP "\fBsad\fR" 4
1286
.IX Item "sad"
1287
sum of absolute differences, fast (default)
1288
.IP "\fBsse\fR" 4
1289
.IX Item "sse"
1290
sum of squared errors
1291
.IP "\fBsatd\fR" 4
1292
.IX Item "satd"
1293
sum of absolute Hadamard transformed differences
1294
.IP "\fBdct\fR" 4
1295
.IX Item "dct"
1296
sum of absolute \s-1DCT\s0 transformed differences
1297
.IP "\fBpsnr\fR" 4
1298
.IX Item "psnr"
1299
sum of squared quantization errors (avoid, low quality)
1300
.IP "\fBbit\fR" 4
1301
.IX Item "bit"
1302
number of bits needed for the block
1303
.IP "\fBrd\fR" 4
1304
.IX Item "rd"
1305
rate distortion optimal, slow
1306
.IP "\fBzero\fR" 4
1307
.IX Item "zero"
1308
 
1309
.IP "\fBvsad\fR" 4
1310
.IX Item "vsad"
1311
sum of absolute vertical differences
1312
.IP "\fBvsse\fR" 4
1313
.IX Item "vsse"
1314
sum of squared vertical differences
1315
.IP "\fBnsse\fR" 4
1316
.IX Item "nsse"
1317
noise preserving sum of squared differences
1318
.IP "\fBw53\fR" 4
1319
.IX Item "w53"
1320
5/3 wavelet, only used in snow
1321
.IP "\fBw97\fR" 4
1322
.IX Item "w97"
1323
9/7 wavelet, only used in snow
1324
.IP "\fBdctmax\fR" 4
1325
.IX Item "dctmax"
1326
.PD 0
1327
.IP "\fBchroma\fR" 4
1328
.IX Item "chroma"
1329
.RE
1330
.RS 4
1331
.RE
1332
.IP "\fBborder_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1333
.IX Item "border_mask float (encoding,video)"
1334
.PD
1335
Increase the quantizer for macroblocks close to borders.
1336
.IP "\fBmblmin\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1337
.IX Item "mblmin integer (encoding,video)"
1338
Set min macroblock lagrange factor (\s-1VBR\s0).
1339
.IP "\fBmblmax\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1340
.IX Item "mblmax integer (encoding,video)"
1341
Set max macroblock lagrange factor (\s-1VBR\s0).
1342
.IP "\fBmepc\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1343
.IX Item "mepc integer (encoding,video)"
1344
Set motion estimation bitrate penalty compensation (1.0 = 256).
1345
.IP "\fBskip_loop_filter\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
1346
.IX Item "skip_loop_filter integer (decoding,video)"
1347
.PD 0
1348
.IP "\fBskip_idct\fR        \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
1349
.IX Item "skip_idct        integer (decoding,video)"
1350
.IP "\fBskip_frame\fR       \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
1351
.IX Item "skip_frame       integer (decoding,video)"
1352
.PD
1353
Make decoder discard processing depending on the frame type selected
1354
by the option value.
1355
.Sp
1356
\&\fBskip_loop_filter\fR skips frame loop filtering, \fBskip_idct\fR
1357
skips frame IDCT/dequantization, \fBskip_frame\fR skips decoding.
1358
.Sp
1359
Possible values:
1360
.RS 4
1361
.IP "\fBnone\fR" 4
1362
.IX Item "none"
1363
Discard no frame.
1364
.IP "\fBdefault\fR" 4
1365
.IX Item "default"
1366
Discard useless frames like 0\-sized frames.
1367
.IP "\fBnoref\fR" 4
1368
.IX Item "noref"
1369
Discard all non-reference frames.
1370
.IP "\fBbidir\fR" 4
1371
.IX Item "bidir"
1372
Discard all bidirectional frames.
1373
.IP "\fBnokey\fR" 4
1374
.IX Item "nokey"
1375
Discard all frames excepts keyframes.
1376
.IP "\fBall\fR" 4
1377
.IX Item "all"
1378
Discard all frames.
1379
.RE
1380
.RS 4
1381
.Sp
1382
Default value is \fBdefault\fR.
1383
.RE
1384
.IP "\fBbidir_refine\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1385
.IX Item "bidir_refine integer (encoding,video)"
1386
Refine the two motion vectors used in bidirectional macroblocks.
1387
.IP "\fBbrd_scale\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1388
.IX Item "brd_scale integer (encoding,video)"
1389
Downscale frames for dynamic B\-frame decision.
1390
.IP "\fBkeyint_min\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1391
.IX Item "keyint_min integer (encoding,video)"
1392
Set minimum interval between IDR\-frames.
1393
.IP "\fBrefs\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1394
.IX Item "refs integer (encoding,video)"
1395
Set reference frames to consider for motion compensation.
1396
.IP "\fBchromaoffset\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1397
.IX Item "chromaoffset integer (encoding,video)"
1398
Set chroma qp offset from luma.
1399
.IP "\fBtrellis\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
1400
.IX Item "trellis integer (encoding,audio,video)"
1401
Set rate-distortion optimal quantization.
1402
.IP "\fBsc_factor\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1403
.IX Item "sc_factor integer (encoding,video)"
1404
Set value multiplied by qscale for each frame and added to
1405
scene_change_score.
1406
.IP "\fBmv0_threshold\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1407
.IX Item "mv0_threshold integer (encoding,video)"
1408
.PD 0
1409
.IP "\fBb_sensitivity\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1410
.IX Item "b_sensitivity integer (encoding,video)"
1411
.PD
1412
Adjust sensitivity of b_frame_strategy 1.
1413
.IP "\fBcompression_level\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4
1414
.IX Item "compression_level integer (encoding,audio,video)"
1415
.PD 0
1416
.IP "\fBmin_prediction_order\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4
1417
.IX Item "min_prediction_order integer (encoding,audio)"
1418
.IP "\fBmax_prediction_order\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4
1419
.IX Item "max_prediction_order integer (encoding,audio)"
1420
.IP "\fBtimecode_frame_start\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1421
.IX Item "timecode_frame_start integer (encoding,video)"
1422
.PD
1423
Set \s-1GOP\s0 timecode frame start number, in non drop frame format.
1424
.IP "\fBrequest_channels\fR \fIinteger\fR \fB(\fR\fIdecoding,audio\fR\fB)\fR" 4
1425
.IX Item "request_channels integer (decoding,audio)"
1426
Set desired number of audio channels.
1427
.IP "\fBbits_per_raw_sample\fR \fIinteger\fR" 4
1428
.IX Item "bits_per_raw_sample integer"
1429
.PD 0
1430
.IP "\fBchannel_layout\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,audio\fR\fB)\fR" 4
1431
.IX Item "channel_layout integer (decoding/encoding,audio)"
1432
.PD
1433
Possible values:
1434
.RS 4
1435
.RE
1436
.RS 4
1437
.RE
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
.RS 4
1442
.RE
1443
.RS 4
1444
.RE
1445
.IP "\fBrc_max_vbv_use\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1446
.IX Item "rc_max_vbv_use float (encoding,video)"
1447
.PD 0
1448
.IP "\fBrc_min_vbv_use\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1449
.IX Item "rc_min_vbv_use float (encoding,video)"
1450
.IP "\fBticks_per_frame\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,audio,video\fR\fB)\fR" 4
1451
.IX Item "ticks_per_frame integer (decoding/encoding,audio,video)"
1452
.IP "\fBcolor_primaries\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
1453
.IX Item "color_primaries integer (decoding/encoding,video)"
1454
.IP "\fBcolor_trc\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
1455
.IX Item "color_trc integer (decoding/encoding,video)"
1456
.IP "\fBcolorspace\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
1457
.IX Item "colorspace integer (decoding/encoding,video)"
1458
.IP "\fBcolor_range\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
1459
.IX Item "color_range integer (decoding/encoding,video)"
1460
.IP "\fBchroma_sample_location\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
1461
.IX Item "chroma_sample_location integer (decoding/encoding,video)"
1462
.IP "\fBlog_level_offset\fR \fIinteger\fR" 4
1463
.IX Item "log_level_offset integer"
1464
.PD
1465
Set the log level offset.
1466
.IP "\fBslices\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4
1467
.IX Item "slices integer (encoding,video)"
1468
Number of slices, used in parallelized encoding.
1469
.IP "\fBthread_type\fR \fIflags\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
1470
.IX Item "thread_type flags (decoding/encoding,video)"
1471
Select multithreading type.
1472
.Sp
1473
Possible values:
1474
.RS 4
1475
.IP "\fBslice\fR" 4
1476
.IX Item "slice"
1477
.PD 0
1478
.IP "\fBframe\fR" 4
1479
.IX Item "frame"
1480
.RE
1481
.RS 4
1482
.RE
1483
.IP "\fBaudio_service_type\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4
1484
.IX Item "audio_service_type integer (encoding,audio)"
1485
.PD
1486
Set audio service type.
1487
.Sp
1488
Possible values:
1489
.RS 4
1490
.IP "\fBma\fR" 4
1491
.IX Item "ma"
1492
Main Audio Service
1493
.IP "\fBef\fR" 4
1494
.IX Item "ef"
1495
Effects
1496
.IP "\fBvi\fR" 4
1497
.IX Item "vi"
1498
Visually Impaired
1499
.IP "\fBhi\fR" 4
1500
.IX Item "hi"
1501
Hearing Impaired
1502
.IP "\fBdi\fR" 4
1503
.IX Item "di"
1504
Dialogue
1505
.IP "\fBco\fR" 4
1506
.IX Item "co"
1507
Commentary
1508
.IP "\fBem\fR" 4
1509
.IX Item "em"
1510
Emergency
1511
.IP "\fBvo\fR" 4
1512
.IX Item "vo"
1513
Voice Over
1514
.IP "\fBka\fR" 4
1515
.IX Item "ka"
1516
Karaoke
1517
.RE
1518
.RS 4
1519
.RE
1520
.IP "\fBrequest_sample_fmt\fR \fIsample_fmt\fR \fB(\fR\fIdecoding,audio\fR\fB)\fR" 4
1521
.IX Item "request_sample_fmt sample_fmt (decoding,audio)"
1522
Set sample format audio decoders should prefer. Default value is
1523
\&\f(CW\*(C`none\*(C'\fR.
1524
.IP "\fBpkt_timebase\fR \fIrational number\fR" 4
1525
.IX Item "pkt_timebase rational number"
1526
.PD 0
1527
.IP "\fBsub_charenc\fR \fIencoding\fR \fB(\fR\fIdecoding,subtitles\fR\fB)\fR" 4
1528
.IX Item "sub_charenc encoding (decoding,subtitles)"
1529
.PD
1530
Set the input subtitles character encoding.
1531
.IP "\fBfield_order\fR  \fIfield_order\fR \fB(\fR\fIvideo\fR\fB)\fR" 4
1532
.IX Item "field_order  field_order (video)"
1533
Set/override the field order of the video.
1534
Possible values:
1535
.RS 4
1536
.IP "\fBprogressive\fR" 4
1537
.IX Item "progressive"
1538
Progressive video
1539
.IP "\fBtt\fR" 4
1540
.IX Item "tt"
1541
Interlaced video, top field coded and displayed first
1542
.IP "\fBbb\fR" 4
1543
.IX Item "bb"
1544
Interlaced video, bottom field coded and displayed first
1545
.IP "\fBtb\fR" 4
1546
.IX Item "tb"
1547
Interlaced video, top coded first, bottom displayed first
1548
.IP "\fBbt\fR" 4
1549
.IX Item "bt"
1550
Interlaced video, bottom coded first, top displayed first
1551
.RE
1552
.RS 4
1553
.RE
1554
.IP "\fBskip_alpha\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4
1555
.IX Item "skip_alpha integer (decoding,video)"
1556
Set to 1 to disable processing alpha (transparency). This works like the
1557
\&\fBgray\fR flag in the \fBflags\fR option which skips chroma information
1558
instead of alpha. Default is 0.
1559
.SH "DECODERS"
1560
.IX Header "DECODERS"
1561
Decoders are configured elements in FFmpeg which allow the decoding of
1562
multimedia streams.
1563
.PP
1564
When you configure your FFmpeg build, all the supported native decoders
1565
are enabled by default. Decoders requiring an external library must be enabled
1566
manually via the corresponding \f(CW\*(C`\-\-enable\-lib\*(C'\fR option. You can list all
1567
available decoders using the configure option \f(CW\*(C`\-\-list\-decoders\*(C'\fR.
1568
.PP
1569
You can disable all the decoders with the configure option
1570
\&\f(CW\*(C`\-\-disable\-decoders\*(C'\fR and selectively enable / disable single decoders
1571
with the options \f(CW\*(C`\-\-enable\-decoder=\f(CI\s-1DECODER\s0\f(CW\*(C'\fR /
1572
\&\f(CW\*(C`\-\-disable\-decoder=\f(CI\s-1DECODER\s0\f(CW\*(C'\fR.
1573
.PP
1574
The option \f(CW\*(C`\-codecs\*(C'\fR of the ff* tools will display the list of
1575
enabled decoders.
1576
.SH "VIDEO DECODERS"
1577
.IX Header "VIDEO DECODERS"
1578
A description of some of the currently available video decoders
1579
follows.
1580
.Sh "rawvideo"
1581
.IX Subsection "rawvideo"
1582
Raw video decoder.
1583
.PP
1584
This decoder decodes rawvideo streams.
1585
.PP
1586
\fIOptions\fR
1587
.IX Subsection "Options"
1588
.IP "\fBtop\fR \fItop_field_first\fR" 4
1589
.IX Item "top top_field_first"
1590
Specify the assumed field type of the input video.
1591
.RS 4
1592
.IP "\fB\-1\fR" 4
1593
.IX Item "-1"
1594
the video is assumed to be progressive (default)
1595
.IP "\fB0\fR" 4
1596
.IX Item "0"
1597
bottom-field-first is assumed
1598
.IP "\fB1\fR" 4
1599
.IX Item "1"
1600
top-field-first is assumed
1601
.RE
1602
.RS 4
1603
.RE
1604
.SH "AUDIO DECODERS"
1605
.IX Header "AUDIO DECODERS"
1606
.Sh "ffwavesynth"
1607
.IX Subsection "ffwavesynth"
1608
Internal wave synthetizer.
1609
.PP
1610
This decoder generates wave patterns according to predefined sequences. Its
1611
use is purely internal and the format of the data it accepts is not publicly
1612
documented.
1613
.Sh "libcelt"
1614
.IX Subsection "libcelt"
1615
libcelt decoder wrapper.
1616
.PP
1617
libcelt allows libavcodec to decode the Xiph \s-1CELT\s0 ultra-low delay audio codec.
1618
Requires the presence of the libcelt headers and library during configuration.
1619
You need to explicitly configure the build with \f(CW\*(C`\-\-enable\-libcelt\*(C'\fR.
1620
.Sh "libgsm"
1621
.IX Subsection "libgsm"
1622
libgsm decoder wrapper.
1623
.PP
1624
libgsm allows libavcodec to decode the \s-1GSM\s0 full rate audio codec. Requires
1625
the presence of the libgsm headers and library during configuration. You need
1626
to explicitly configure the build with \f(CW\*(C`\-\-enable\-libgsm\*(C'\fR.
1627
.PP
1628
This decoder supports both the ordinary \s-1GSM\s0 and the Microsoft variant.
1629
.Sh "libilbc"
1630
.IX Subsection "libilbc"
1631
libilbc decoder wrapper.
1632
.PP
1633
libilbc allows libavcodec to decode the Internet Low Bitrate Codec (iLBC)
1634
audio codec. Requires the presence of the libilbc headers and library during
1635
configuration. You need to explicitly configure the build with
1636
\&\f(CW\*(C`\-\-enable\-libilbc\*(C'\fR.
1637
.PP
1638
\fIOptions\fR
1639
.IX Subsection "Options"
1640
.PP
1641
The following option is supported by the libilbc wrapper.
1642
.IP "\fBenhance\fR" 4
1643
.IX Item "enhance"
1644
Enable the enhancement of the decoded audio when set to 1. The default
1645
value is 0 (disabled).
1646
.Sh "libopencore-amrnb"
1647
.IX Subsection "libopencore-amrnb"
1648
libopencore-amrnb decoder wrapper.
1649
.PP
1650
libopencore-amrnb allows libavcodec to decode the Adaptive Multi-Rate
1651
Narrowband audio codec. Using it requires the presence of the
1652
libopencore-amrnb headers and library during configuration. You need to
1653
explicitly configure the build with \f(CW\*(C`\-\-enable\-libopencore\-amrnb\*(C'\fR.
1654
.PP
1655
An FFmpeg native decoder for AMR-NB exists, so users can decode AMR-NB
1656
without this library.
1657
.Sh "libopencore-amrwb"
1658
.IX Subsection "libopencore-amrwb"
1659
libopencore-amrwb decoder wrapper.
1660
.PP
1661
libopencore-amrwb allows libavcodec to decode the Adaptive Multi-Rate
1662
Wideband audio codec. Using it requires the presence of the
1663
libopencore-amrwb headers and library during configuration. You need to
1664
explicitly configure the build with \f(CW\*(C`\-\-enable\-libopencore\-amrwb\*(C'\fR.
1665
.PP
1666
An FFmpeg native decoder for AMR-WB exists, so users can decode AMR-WB
1667
without this library.
1668
.Sh "libopus"
1669
.IX Subsection "libopus"
1670
libopus decoder wrapper.
1671
.PP
1672
libopus allows libavcodec to decode the Opus Interactive Audio Codec.
1673
Requires the presence of the libopus headers and library during
1674
configuration. You need to explicitly configure the build with
1675
\&\f(CW\*(C`\-\-enable\-libopus\*(C'\fR.
1676
.SH "SUBTITLES DECODERS"
1677
.IX Header "SUBTITLES DECODERS"
1678
.Sh "dvdsub"
1679
.IX Subsection "dvdsub"
1680
This codec decodes the bitmap subtitles used in DVDs; the same subtitles can
1681
also be found in VobSub file pairs and in some Matroska files.
1682
.PP
1683
\fIOptions\fR
1684
.IX Subsection "Options"
1685
.IP "\fBpalette\fR" 4
1686
.IX Item "palette"
1687
Specify the global palette used by the bitmaps. When stored in VobSub, the
1688
palette is normally specified in the index file; in Matroska, the palette is
1689
stored in the codec extra-data in the same format as in VobSub. In DVDs, the
1690
palette is stored in the \s-1IFO\s0 file, and therefore not available when reading
1691
from dumped \s-1VOB\s0 files.
1692
.Sp
1693
The format for this option is a string containing 16 24\-bits hexadecimal
1694
numbers (without 0x prefix) separated by comas, for example \f(CW\*(C`0d00ee,
1695
ee450d, 101010, eaeaea, 0ce60b, ec14ed, ebff0b, 0d617a, 7b7b7b, d1d1d1,
1696
7b2a0e, 0d950c, 0f007b, cf0dec, cfa80c, 7c127b\*(C'\fR.
1697
.Sh "libzvbi-teletext"
1698
.IX Subsection "libzvbi-teletext"
1699
Libzvbi allows libavcodec to decode \s-1DVB\s0 teletext pages and \s-1DVB\s0 teletext
1700
subtitles. Requires the presence of the libzvbi headers and library during
1701
configuration. You need to explicitly configure the build with
1702
\&\f(CW\*(C`\-\-enable\-libzvbi\*(C'\fR.
1703
.PP
1704
\fIOptions\fR
1705
.IX Subsection "Options"
1706
.IP "\fBtxt_page\fR" 4
1707
.IX Item "txt_page"
1708
List of teletext page numbers to decode. You may use the special * string to
1709
match all pages. Pages that do not match the specified list are dropped.
1710
Default value is *.
1711
.IP "\fBtxt_chop_top\fR" 4
1712
.IX Item "txt_chop_top"
1713
Discards the top teletext line. Default value is 1.
1714
.IP "\fBtxt_format\fR" 4
1715
.IX Item "txt_format"
1716
Specifies the format of the decoded subtitles. The teletext decoder is capable
1717
of decoding the teletext pages to bitmaps or to simple text, you should use
1718
\&\*(L"bitmap\*(R" for teletext pages, because certain graphics and colors cannot be
1719
expressed in simple text. You might use \*(L"text\*(R" for teletext based subtitles if
1720
your application can handle simple text based subtitles. Default value is
1721
bitmap.
1722
.IP "\fBtxt_left\fR" 4
1723
.IX Item "txt_left"
1724
X offset of generated bitmaps, default is 0.
1725
.IP "\fBtxt_top\fR" 4
1726
.IX Item "txt_top"
1727
Y offset of generated bitmaps, default is 0.
1728
.IP "\fBtxt_chop_spaces\fR" 4
1729
.IX Item "txt_chop_spaces"
1730
Chops leading and trailing spaces and removes empty lines from the generated
1731
text. This option is useful for teletext based subtitles where empty spaces may
1732
be present at the start or at the end of the lines or empty lines may be
1733
present between the subtitle lines because of double-sized teletext charactes.
1734
Default value is 1.
1735
.IP "\fBtxt_duration\fR" 4
1736
.IX Item "txt_duration"
1737
Sets the display duration of the decoded teletext pages or subtitles in
1738
miliseconds. Default value is 30000 which is 30 seconds.
1739
.IP "\fBtxt_transparent\fR" 4
1740
.IX Item "txt_transparent"
1741
Force transparent background of the generated teletext bitmaps. Default value
1742
is 0 which means an opaque (black) background.
1743
.SH "ENCODERS"
1744
.IX Header "ENCODERS"
1745
Encoders are configured elements in FFmpeg which allow the encoding of
1746
multimedia streams.
1747
.PP
1748
When you configure your FFmpeg build, all the supported native encoders
1749
are enabled by default. Encoders requiring an external library must be enabled
1750
manually via the corresponding \f(CW\*(C`\-\-enable\-lib\*(C'\fR option. You can list all
1751
available encoders using the configure option \f(CW\*(C`\-\-list\-encoders\*(C'\fR.
1752
.PP
1753
You can disable all the encoders with the configure option
1754
\&\f(CW\*(C`\-\-disable\-encoders\*(C'\fR and selectively enable / disable single encoders
1755
with the options \f(CW\*(C`\-\-enable\-encoder=\f(CI\s-1ENCODER\s0\f(CW\*(C'\fR /
1756
\&\f(CW\*(C`\-\-disable\-encoder=\f(CI\s-1ENCODER\s0\f(CW\*(C'\fR.
1757
.PP
1758
The option \f(CW\*(C`\-codecs\*(C'\fR of the ff* tools will display the list of
1759
enabled encoders.
1760
.SH "AUDIO ENCODERS"
1761
.IX Header "AUDIO ENCODERS"
1762
A description of some of the currently available audio encoders
1763
follows.
1764
.Sh "aac"
1765
.IX Subsection "aac"
1766
Advanced Audio Coding (\s-1AAC\s0) encoder.
1767
.PP
1768
This encoder is an experimental FFmpeg-native \s-1AAC\s0 encoder. Currently only the
1769
low complexity (\s-1AAC\-LC\s0) profile is supported. To use this encoder, you must set
1770
\&\fBstrict\fR option to \fBexperimental\fR or lower.
1771
.PP
1772
As this encoder is experimental, unexpected behavior may exist from time to
1773
time. For a more stable \s-1AAC\s0 encoder, see libvo\-aacenc. However, be warned
1774
that it has a worse quality reported by some users.
1775
.PP
1776
\fIOptions\fR
1777
.IX Subsection "Options"
1778
.IP "\fBb\fR" 4
1779
.IX Item "b"
1780
Set bit rate in bits/s. Setting this automatically activates constant bit rate
1781
(\s-1CBR\s0) mode.
1782
.IP "\fBq\fR" 4
1783
.IX Item "q"
1784
Set quality for variable bit rate (\s-1VBR\s0) mode. This option is valid only using
1785
the \fBffmpeg\fR command-line tool. For library interface users, use
1786
\&\fBglobal_quality\fR.
1787
.IP "\fBstereo_mode\fR" 4
1788
.IX Item "stereo_mode"
1789
Set stereo encoding mode. Possible values:
1790
.RS 4
1791
.IP "\fBauto\fR" 4
1792
.IX Item "auto"
1793
Automatically selected by the encoder.
1794
.IP "\fBms_off\fR" 4
1795
.IX Item "ms_off"
1796
Disable middle/side encoding. This is the default.
1797
.IP "\fBms_force\fR" 4
1798
.IX Item "ms_force"
1799
Force middle/side encoding.
1800
.RE
1801
.RS 4
1802
.RE
1803
.IP "\fBaac_coder\fR" 4
1804
.IX Item "aac_coder"
1805
Set \s-1AAC\s0 encoder coding method. Possible values:
1806
.RS 4
1807
.IP "\fBfaac\fR" 4
1808
.IX Item "faac"
1809
FAAC-inspired method.
1810
.Sp
1811
This method is a simplified reimplementation of the method used in \s-1FAAC\s0, which
1812
sets thresholds proportional to the band energies, and then decreases all the
1813
thresholds with quantizer steps to find the appropriate quantization with
1814
distortion below threshold band by band.
1815
.Sp
1816
The quality of this method is comparable to the two loop searching method
1817
descibed below, but somewhat a little better and slower.
1818
.IP "\fBanmr\fR" 4
1819
.IX Item "anmr"
1820
Average noise to mask ratio (\s-1ANMR\s0) trellis-based solution.
1821
.Sp
1822
This has a theoretic best quality out of all the coding methods, but at the
1823
cost of the slowest speed.
1824
.IP "\fBtwoloop\fR" 4
1825
.IX Item "twoloop"
1826
Two loop searching (\s-1TLS\s0) method.
1827
.Sp
1828
This method first sets quantizers depending on band thresholds and then tries
1829
to find an optimal combination by adding or subtracting a specific value from
1830
all quantizers and adjusting some individual quantizer a little.
1831
.Sp
1832
This method produces similar quality with the \s-1FAAC\s0 method and is the default.
1833
.IP "\fBfast\fR" 4
1834
.IX Item "fast"
1835
Constant quantizer method.
1836
.Sp
1837
This method sets a constant quantizer for all bands. This is the fastest of all
1838
the methods, yet produces the worst quality.
1839
.RE
1840
.RS 4
1841
.RE
1842
.Sh "ac3 and ac3_fixed"
1843
.IX Subsection "ac3 and ac3_fixed"
1844
\&\s-1AC\-3\s0 audio encoders.
1845
.PP
1846
These encoders implement part of \s-1ATSC\s0 A/52:2010 and \s-1ETSI\s0 \s-1TS\s0 102 366, as well as
1847
the undocumented RealAudio 3 (a.k.a. dnet).
1848
.PP
1849
The \fIac3\fR encoder uses floating-point math, while the \fIac3_fixed\fR
1850
encoder only uses fixed-point integer math. This does not mean that one is
1851
always faster, just that one or the other may be better suited to a
1852
particular system. The floating-point encoder will generally produce better
1853
quality audio for a given bitrate. The \fIac3_fixed\fR encoder is not the
1854
default codec for any of the output formats, so it must be specified explicitly
1855
using the option \f(CW\*(C`\-acodec ac3_fixed\*(C'\fR in order to use it.
1856
.PP
1857
\fI\s-1AC\-3\s0 Metadata\fR
1858
.IX Subsection "AC-3 Metadata"
1859
.PP
1860
The \s-1AC\-3\s0 metadata options are used to set parameters that describe the audio,
1861
but in most cases do not affect the audio encoding itself. Some of the options
1862
do directly affect or influence the decoding and playback of the resulting
1863
bitstream, while others are just for informational purposes. A few of the
1864
options will add bits to the output stream that could otherwise be used for
1865
audio data, and will thus affect the quality of the output. Those will be
1866
indicated accordingly with a note in the option list below.
1867
.PP
1868
These parameters are described in detail in several publicly-available
1869
documents.
1870
.IP "*<<\fBhttp://www.atsc.org/cms/standards/a_52\-2010.pdf\fR>>" 4
1871
.IX Item "*<>"
1872
.PD 0
1873
.IP "*<<\fBhttp://www.atsc.org/cms/standards/a_54a_with_corr_1.pdf\fR>>" 4
1874
.IX Item "*<>"
1875
.IP "*<<\fBhttp://www.dolby.com/uploadedFiles/zz\-_Shared_Assets/English_PDFs/Professional/18_Metadata.Guide.pdf\fR>>" 4
1876
.IX Item "*<>"
1877
.IP "*<<\fBhttp://www.dolby.com/uploadedFiles/zz\-_Shared_Assets/English_PDFs/Professional/46_DDEncodingGuidelines.pdf\fR>>" 4
1878
.IX Item "*<>"
1879
.PD
1880
.PP
1881
Metadata Control Options
1882
.IX Subsection "Metadata Control Options"
1883
.IP "\fB\-per_frame_metadata\fR \fIboolean\fR" 4
1884
.IX Item "-per_frame_metadata boolean"
1885
Allow Per-Frame Metadata. Specifies if the encoder should check for changing
1886
metadata for each frame.
1887
.RS 4
1888
.IP "\fB0\fR" 4
1889
.IX Item "0"
1890
The metadata values set at initialization will be used for every frame in the
1891
stream. (default)
1892
.IP "\fB1\fR" 4
1893
.IX Item "1"
1894
Metadata values can be changed before encoding each frame.
1895
.RE
1896
.RS 4
1897
.RE
1898
.PP
1899
Downmix Levels
1900
.IX Subsection "Downmix Levels"
1901
.IP "\fB\-center_mixlev\fR \fIlevel\fR" 4
1902
.IX Item "-center_mixlev level"
1903
Center Mix Level. The amount of gain the decoder should apply to the center
1904
channel when downmixing to stereo. This field will only be written to the
1905
bitstream if a center channel is present. The value is specified as a scale
1906
factor. There are 3 valid values:
1907
.RS 4
1908
.IP "\fB0.707\fR" 4
1909
.IX Item "0.707"
1910
Apply \-3dB gain
1911
.IP "\fB0.595\fR" 4
1912
.IX Item "0.595"
1913
Apply \-4.5dB gain (default)
1914
.IP "\fB0.500\fR" 4
1915
.IX Item "0.500"
1916
Apply \-6dB gain
1917
.RE
1918
.RS 4
1919
.RE
1920
.IP "\fB\-surround_mixlev\fR \fIlevel\fR" 4
1921
.IX Item "-surround_mixlev level"
1922
Surround Mix Level. The amount of gain the decoder should apply to the surround
1923
channel(s) when downmixing to stereo. This field will only be written to the
1924
bitstream if one or more surround channels are present. The value is specified
1925
as a scale factor.  There are 3 valid values:
1926
.RS 4
1927
.IP "\fB0.707\fR" 4
1928
.IX Item "0.707"
1929
Apply \-3dB gain
1930
.IP "\fB0.500\fR" 4
1931
.IX Item "0.500"
1932
Apply \-6dB gain (default)
1933
.IP "\fB0.000\fR" 4
1934
.IX Item "0.000"
1935
Silence Surround Channel(s)
1936
.RE
1937
.RS 4
1938
.RE
1939
.PP
1940
Audio Production Information
1941
.IX Subsection "Audio Production Information"
1942
.PP
1943
Audio Production Information is optional information describing the mixing
1944
environment.  Either none or both of the fields are written to the bitstream.
1945
.IP "\fB\-mixing_level\fR \fInumber\fR" 4
1946
.IX Item "-mixing_level number"
1947
Mixing Level. Specifies peak sound pressure level (\s-1SPL\s0) in the production
1948
environment when the mix was mastered. Valid values are 80 to 111, or \-1 for
1949
unknown or not indicated. The default value is \-1, but that value cannot be
1950
used if the Audio Production Information is written to the bitstream. Therefore,
1951
if the \f(CW\*(C`room_type\*(C'\fR option is not the default value, the \f(CW\*(C`mixing_level\*(C'\fR
1952
option must not be \-1.
1953
.IP "\fB\-room_type\fR \fItype\fR" 4
1954
.IX Item "-room_type type"
1955
Room Type. Describes the equalization used during the final mixing session at
1956
the studio or on the dubbing stage. A large room is a dubbing stage with the
1957
industry standard X\-curve equalization; a small room has flat equalization.
1958
This field will not be written to the bitstream if both the \f(CW\*(C`mixing_level\*(C'\fR
1959
option and the \f(CW\*(C`room_type\*(C'\fR option have the default values.
1960
.RS 4
1961
.IP "\fB0\fR" 4
1962
.IX Item "0"
1963
.PD 0
1964
.IP "\fBnotindicated\fR" 4
1965
.IX Item "notindicated"
1966
.PD
1967
Not Indicated (default)
1968
.IP "\fB1\fR" 4
1969
.IX Item "1"
1970
.PD 0
1971
.IP "\fBlarge\fR" 4
1972
.IX Item "large"
1973
.PD
1974
Large Room
1975
.IP "\fB2\fR" 4
1976
.IX Item "2"
1977
.PD 0
1978
.IP "\fBsmall\fR" 4
1979
.IX Item "small"
1980
.PD
1981
Small Room
1982
.RE
1983
.RS 4
1984
.RE
1985
.PP
1986
Other Metadata Options
1987
.IX Subsection "Other Metadata Options"
1988
.IP "\fB\-copyright\fR \fIboolean\fR" 4
1989
.IX Item "-copyright boolean"
1990
Copyright Indicator. Specifies whether a copyright exists for this audio.
1991
.RS 4
1992
.IP "\fB0\fR" 4
1993
.IX Item "0"
1994
.PD 0
1995
.IP "\fBoff\fR" 4
1996
.IX Item "off"
1997
.PD
1998
No Copyright Exists (default)
1999
.IP "\fB1\fR" 4
2000
.IX Item "1"
2001
.PD 0
2002
.IP "\fBon\fR" 4
2003
.IX Item "on"
2004
.PD
2005
Copyright Exists
2006
.RE
2007
.RS 4
2008
.RE
2009
.IP "\fB\-dialnorm\fR \fIvalue\fR" 4
2010
.IX Item "-dialnorm value"
2011
Dialogue Normalization. Indicates how far the average dialogue level of the
2012
program is below digital 100% full scale (0 dBFS). This parameter determines a
2013
level shift during audio reproduction that sets the average volume of the
2014
dialogue to a preset level. The goal is to match volume level between program
2015
sources. A value of \-31dB will result in no volume level change, relative to
2016
the source volume, during audio reproduction. Valid values are whole numbers in
2017
the range \-31 to \-1, with \-31 being the default.
2018
.IP "\fB\-dsur_mode\fR \fImode\fR" 4
2019
.IX Item "-dsur_mode mode"
2020
Dolby Surround Mode. Specifies whether the stereo signal uses Dolby Surround
2021
(Pro Logic). This field will only be written to the bitstream if the audio
2022
stream is stereo. Using this option does \fB\s-1NOT\s0\fR mean the encoder will actually
2023
apply Dolby Surround processing.
2024
.RS 4
2025
.IP "\fB0\fR" 4
2026
.IX Item "0"
2027
.PD 0
2028
.IP "\fBnotindicated\fR" 4
2029
.IX Item "notindicated"
2030
.PD
2031
Not Indicated (default)
2032
.IP "\fB1\fR" 4
2033
.IX Item "1"
2034
.PD 0
2035
.IP "\fBoff\fR" 4
2036
.IX Item "off"
2037
.PD
2038
Not Dolby Surround Encoded
2039
.IP "\fB2\fR" 4
2040
.IX Item "2"
2041
.PD 0
2042
.IP "\fBon\fR" 4
2043
.IX Item "on"
2044
.PD
2045
Dolby Surround Encoded
2046
.RE
2047
.RS 4
2048
.RE
2049
.IP "\fB\-original\fR \fIboolean\fR" 4
2050
.IX Item "-original boolean"
2051
Original Bit Stream Indicator. Specifies whether this audio is from the
2052
original source and not a copy.
2053
.RS 4
2054
.IP "\fB0\fR" 4
2055
.IX Item "0"
2056
.PD 0
2057
.IP "\fBoff\fR" 4
2058
.IX Item "off"
2059
.PD
2060
Not Original Source
2061
.IP "\fB1\fR" 4
2062
.IX Item "1"
2063
.PD 0
2064
.IP "\fBon\fR" 4
2065
.IX Item "on"
2066
.PD
2067
Original Source (default)
2068
.RE
2069
.RS 4
2070
.RE
2071
.PP
2072
\fIExtended Bitstream Information\fR
2073
.IX Subsection "Extended Bitstream Information"
2074
.PP
2075
The extended bitstream options are part of the Alternate Bit Stream Syntax as
2076
specified in Annex D of the A/52:2010 standard. It is grouped into 2 parts.
2077
If any one parameter in a group is specified, all values in that group will be
2078
written to the bitstream.  Default values are used for those that are written
2079
but have not been specified.  If the mixing levels are written, the decoder
2080
will use these values instead of the ones specified in the \f(CW\*(C`center_mixlev\*(C'\fR
2081
and \f(CW\*(C`surround_mixlev\*(C'\fR options if it supports the Alternate Bit Stream
2082
Syntax.
2083
.PP
2084
Extended Bitstream Information \- Part 1
2085
.IX Subsection "Extended Bitstream Information - Part 1"
2086
.IP "\fB\-dmix_mode\fR \fImode\fR" 4
2087
.IX Item "-dmix_mode mode"
2088
Preferred Stereo Downmix Mode. Allows the user to select either Lt/Rt
2089
(Dolby Surround) or Lo/Ro (normal stereo) as the preferred stereo downmix mode.
2090
.RS 4
2091
.IP "\fB0\fR" 4
2092
.IX Item "0"
2093
.PD 0
2094
.IP "\fBnotindicated\fR" 4
2095
.IX Item "notindicated"
2096
.PD
2097
Not Indicated (default)
2098
.IP "\fB1\fR" 4
2099
.IX Item "1"
2100
.PD 0
2101
.IP "\fBltrt\fR" 4
2102
.IX Item "ltrt"
2103
.PD
2104
Lt/Rt Downmix Preferred
2105
.IP "\fB2\fR" 4
2106
.IX Item "2"
2107
.PD 0
2108
.IP "\fBloro\fR" 4
2109
.IX Item "loro"
2110
.PD
2111
Lo/Ro Downmix Preferred
2112
.RE
2113
.RS 4
2114
.RE
2115
.IP "\fB\-ltrt_cmixlev\fR \fIlevel\fR" 4
2116
.IX Item "-ltrt_cmixlev level"
2117
Lt/Rt Center Mix Level. The amount of gain the decoder should apply to the
2118
center channel when downmixing to stereo in Lt/Rt mode.
2119
.RS 4
2120
.IP "\fB1.414\fR" 4
2121
.IX Item "1.414"
2122
Apply +3dB gain
2123
.IP "\fB1.189\fR" 4
2124
.IX Item "1.189"
2125
Apply +1.5dB gain
2126
.IP "\fB1.000\fR" 4
2127
.IX Item "1.000"
2128
Apply 0dB gain
2129
.IP "\fB0.841\fR" 4
2130
.IX Item "0.841"
2131
Apply \-1.5dB gain
2132
.IP "\fB0.707\fR" 4
2133
.IX Item "0.707"
2134
Apply \-3.0dB gain
2135
.IP "\fB0.595\fR" 4
2136
.IX Item "0.595"
2137
Apply \-4.5dB gain (default)
2138
.IP "\fB0.500\fR" 4
2139
.IX Item "0.500"
2140
Apply \-6.0dB gain
2141
.IP "\fB0.000\fR" 4
2142
.IX Item "0.000"
2143
Silence Center Channel
2144
.RE
2145
.RS 4
2146
.RE
2147
.IP "\fB\-ltrt_surmixlev\fR \fIlevel\fR" 4
2148
.IX Item "-ltrt_surmixlev level"
2149
Lt/Rt Surround Mix Level. The amount of gain the decoder should apply to the
2150
surround channel(s) when downmixing to stereo in Lt/Rt mode.
2151
.RS 4
2152
.IP "\fB0.841\fR" 4
2153
.IX Item "0.841"
2154
Apply \-1.5dB gain
2155
.IP "\fB0.707\fR" 4
2156
.IX Item "0.707"
2157
Apply \-3.0dB gain
2158
.IP "\fB0.595\fR" 4
2159
.IX Item "0.595"
2160
Apply \-4.5dB gain
2161
.IP "\fB0.500\fR" 4
2162
.IX Item "0.500"
2163
Apply \-6.0dB gain (default)
2164
.IP "\fB0.000\fR" 4
2165
.IX Item "0.000"
2166
Silence Surround Channel(s)
2167
.RE
2168
.RS 4
2169
.RE
2170
.IP "\fB\-loro_cmixlev\fR \fIlevel\fR" 4
2171
.IX Item "-loro_cmixlev level"
2172
Lo/Ro Center Mix Level. The amount of gain the decoder should apply to the
2173
center channel when downmixing to stereo in Lo/Ro mode.
2174
.RS 4
2175
.IP "\fB1.414\fR" 4
2176
.IX Item "1.414"
2177
Apply +3dB gain
2178
.IP "\fB1.189\fR" 4
2179
.IX Item "1.189"
2180
Apply +1.5dB gain
2181
.IP "\fB1.000\fR" 4
2182
.IX Item "1.000"
2183
Apply 0dB gain
2184
.IP "\fB0.841\fR" 4
2185
.IX Item "0.841"
2186
Apply \-1.5dB gain
2187
.IP "\fB0.707\fR" 4
2188
.IX Item "0.707"
2189
Apply \-3.0dB gain
2190
.IP "\fB0.595\fR" 4
2191
.IX Item "0.595"
2192
Apply \-4.5dB gain (default)
2193
.IP "\fB0.500\fR" 4
2194
.IX Item "0.500"
2195
Apply \-6.0dB gain
2196
.IP "\fB0.000\fR" 4
2197
.IX Item "0.000"
2198
Silence Center Channel
2199
.RE
2200
.RS 4
2201
.RE
2202
.IP "\fB\-loro_surmixlev\fR \fIlevel\fR" 4
2203
.IX Item "-loro_surmixlev level"
2204
Lo/Ro Surround Mix Level. The amount of gain the decoder should apply to the
2205
surround channel(s) when downmixing to stereo in Lo/Ro mode.
2206
.RS 4
2207
.IP "\fB0.841\fR" 4
2208
.IX Item "0.841"
2209
Apply \-1.5dB gain
2210
.IP "\fB0.707\fR" 4
2211
.IX Item "0.707"
2212
Apply \-3.0dB gain
2213
.IP "\fB0.595\fR" 4
2214
.IX Item "0.595"
2215
Apply \-4.5dB gain
2216
.IP "\fB0.500\fR" 4
2217
.IX Item "0.500"
2218
Apply \-6.0dB gain (default)
2219
.IP "\fB0.000\fR" 4
2220
.IX Item "0.000"
2221
Silence Surround Channel(s)
2222
.RE
2223
.RS 4
2224
.RE
2225
.PP
2226
Extended Bitstream Information \- Part 2
2227
.IX Subsection "Extended Bitstream Information - Part 2"
2228
.IP "\fB\-dsurex_mode\fR \fImode\fR" 4
2229
.IX Item "-dsurex_mode mode"
2230
Dolby Surround \s-1EX\s0 Mode. Indicates whether the stream uses Dolby Surround \s-1EX\s0
2231
(7.1 matrixed to 5.1). Using this option does \fB\s-1NOT\s0\fR mean the encoder will actually
2232
apply Dolby Surround \s-1EX\s0 processing.
2233
.RS 4
2234
.IP "\fB0\fR" 4
2235
.IX Item "0"
2236
.PD 0
2237
.IP "\fBnotindicated\fR" 4
2238
.IX Item "notindicated"
2239
.PD
2240
Not Indicated (default)
2241
.IP "\fB1\fR" 4
2242
.IX Item "1"
2243
.PD 0
2244
.IP "\fBon\fR" 4
2245
.IX Item "on"
2246
.PD
2247
Dolby Surround \s-1EX\s0 Off
2248
.IP "\fB2\fR" 4
2249
.IX Item "2"
2250
.PD 0
2251
.IP "\fBoff\fR" 4
2252
.IX Item "off"
2253
.PD
2254
Dolby Surround \s-1EX\s0 On
2255
.RE
2256
.RS 4
2257
.RE
2258
.IP "\fB\-dheadphone_mode\fR \fImode\fR" 4
2259
.IX Item "-dheadphone_mode mode"
2260
Dolby Headphone Mode. Indicates whether the stream uses Dolby Headphone
2261
encoding (multi\-channel matrixed to 2.0 for use with headphones). Using this
2262
option does \fB\s-1NOT\s0\fR mean the encoder will actually apply Dolby Headphone
2263
processing.
2264
.RS 4
2265
.IP "\fB0\fR" 4
2266
.IX Item "0"
2267
.PD 0
2268
.IP "\fBnotindicated\fR" 4
2269
.IX Item "notindicated"
2270
.PD
2271
Not Indicated (default)
2272
.IP "\fB1\fR" 4
2273
.IX Item "1"
2274
.PD 0
2275
.IP "\fBon\fR" 4
2276
.IX Item "on"
2277
.PD
2278
Dolby Headphone Off
2279
.IP "\fB2\fR" 4
2280
.IX Item "2"
2281
.PD 0
2282
.IP "\fBoff\fR" 4
2283
.IX Item "off"
2284
.PD
2285
Dolby Headphone On
2286
.RE
2287
.RS 4
2288
.RE
2289
.IP "\fB\-ad_conv_type\fR \fItype\fR" 4
2290
.IX Item "-ad_conv_type type"
2291
A/D Converter Type. Indicates whether the audio has passed through \s-1HDCD\s0 A/D
2292
conversion.
2293
.RS 4
2294
.IP "\fB0\fR" 4
2295
.IX Item "0"
2296
.PD 0
2297
.IP "\fBstandard\fR" 4
2298
.IX Item "standard"
2299
.PD
2300
Standard A/D Converter (default)
2301
.IP "\fB1\fR" 4
2302
.IX Item "1"
2303
.PD 0
2304
.IP "\fBhdcd\fR" 4
2305
.IX Item "hdcd"
2306
.PD
2307
\&\s-1HDCD\s0 A/D Converter
2308
.RE
2309
.RS 4
2310
.RE
2311
.PP
2312
\fIOther \s-1AC\-3\s0 Encoding Options\fR
2313
.IX Subsection "Other AC-3 Encoding Options"
2314
.IP "\fB\-stereo_rematrixing\fR \fIboolean\fR" 4
2315
.IX Item "-stereo_rematrixing boolean"
2316
Stereo Rematrixing. Enables/Disables use of rematrixing for stereo input. This
2317
is an optional \s-1AC\-3\s0 feature that increases quality by selectively encoding
2318
the left/right channels as mid/side. This option is enabled by default, and it
2319
is highly recommended that it be left as enabled except for testing purposes.
2320
.PP
2321
\fIFloating-Point-Only \s-1AC\-3\s0 Encoding Options\fR
2322
.IX Subsection "Floating-Point-Only AC-3 Encoding Options"
2323
.PP
2324
These options are only valid for the floating-point encoder and do not exist
2325
for the fixed-point encoder due to the corresponding features not being
2326
implemented in fixed\-point.
2327
.IP "\fB\-channel_coupling\fR \fIboolean\fR" 4
2328
.IX Item "-channel_coupling boolean"
2329
Enables/Disables use of channel coupling, which is an optional \s-1AC\-3\s0 feature
2330
that increases quality by combining high frequency information from multiple
2331
channels into a single channel. The per-channel high frequency information is
2332
sent with less accuracy in both the frequency and time domains. This allows
2333
more bits to be used for lower frequencies while preserving enough information
2334
to reconstruct the high frequencies. This option is enabled by default for the
2335
floating-point encoder and should generally be left as enabled except for
2336
testing purposes or to increase encoding speed.
2337
.RS 4
2338
.IP "\fB\-1\fR" 4
2339
.IX Item "-1"
2340
.PD 0
2341
.IP "\fBauto\fR" 4
2342
.IX Item "auto"
2343
.PD
2344
Selected by Encoder (default)
2345
.IP "\fB0\fR" 4
2346
.IX Item "0"
2347
.PD 0
2348
.IP "\fBoff\fR" 4
2349
.IX Item "off"
2350
.PD
2351
Disable Channel Coupling
2352
.IP "\fB1\fR" 4
2353
.IX Item "1"
2354
.PD 0
2355
.IP "\fBon\fR" 4
2356
.IX Item "on"
2357
.PD
2358
Enable Channel Coupling
2359
.RE
2360
.RS 4
2361
.RE
2362
.IP "\fB\-cpl_start_band\fR \fInumber\fR" 4
2363
.IX Item "-cpl_start_band number"
2364
Coupling Start Band. Sets the channel coupling start band, from 1 to 15. If a
2365
value higher than the bandwidth is used, it will be reduced to 1 less than the
2366
coupling end band. If \fIauto\fR is used, the start band will be determined by
2367
the encoder based on the bit rate, sample rate, and channel layout. This option
2368
has no effect if channel coupling is disabled.
2369
.RS 4
2370
.IP "\fB\-1\fR" 4
2371
.IX Item "-1"
2372
.PD 0
2373
.IP "\fBauto\fR" 4
2374
.IX Item "auto"
2375
.PD
2376
Selected by Encoder (default)
2377
.RE
2378
.RS 4
2379
.RE
2380
.Sh "libmp3lame"
2381
.IX Subsection "libmp3lame"
2382
\&\s-1LAME\s0 (Lame Ain't an \s-1MP3\s0 Encoder) \s-1MP3\s0 encoder wrapper.
2383
.PP
2384
Requires the presence of the libmp3lame headers and library during
2385
configuration. You need to explicitly configure the build with
2386
\&\f(CW\*(C`\-\-enable\-libmp3lame\*(C'\fR.
2387
.PP
2388
See libshine for a fixed-point \s-1MP3\s0 encoder, although with a
2389
lower quality.
2390
.PP
2391
\fIOptions\fR
2392
.IX Subsection "Options"
2393
.PP
2394
The following options are supported by the libmp3lame wrapper. The
2395
\&\fBlame\fR\-equivalent of the options are listed in parentheses.
2396
.IP "\fBb (\fR\fI\-b\fR\fB)\fR" 4
2397
.IX Item "b (-b)"
2398
Set bitrate expressed in bits/s for \s-1CBR\s0. \s-1LAME\s0 \f(CW\*(C`bitrate\*(C'\fR is
2399
expressed in kilobits/s.
2400
.IP "\fBq (\fR\fI\-V\fR\fB)\fR" 4
2401
.IX Item "q (-V)"
2402
Set constant quality setting for \s-1VBR\s0. This option is valid only
2403
using the \fBffmpeg\fR command-line tool. For library interface
2404
users, use \fBglobal_quality\fR.
2405
.IP "\fBcompression_level (\fR\fI\-q\fR\fB)\fR" 4
2406
.IX Item "compression_level (-q)"
2407
Set algorithm quality. Valid arguments are integers in the 0\-9 range,
2408
with 0 meaning highest quality but slowest, and 9 meaning fastest
2409
while producing the worst quality.
2410
.IP "\fBreservoir\fR" 4
2411
.IX Item "reservoir"
2412
Enable use of bit reservoir when set to 1. Default value is 1. \s-1LAME\s0
2413
has this enabled by default, but can be overriden by use
2414
\&\fB\-\-nores\fR option.
2415
.IP "\fBjoint_stereo (\fR\fI\-m j\fR\fB)\fR" 4
2416
.IX Item "joint_stereo (-m j)"
2417
Enable the encoder to use (on a frame by frame basis) either L/R
2418
stereo or mid/side stereo. Default value is 1.
2419
.Sh "libopencore-amrnb"
2420
.IX Subsection "libopencore-amrnb"
2421
OpenCORE Adaptive Multi-Rate Narrowband encoder.
2422
.PP
2423
Requires the presence of the libopencore-amrnb headers and library during
2424
configuration. You need to explicitly configure the build with
2425
\&\f(CW\*(C`\-\-enable\-libopencore\-amrnb \-\-enable\-version3\*(C'\fR.
2426
.PP
2427
This is a mono-only encoder. Officially it only supports 8000Hz sample rate,
2428
but you can override it by setting \fBstrict\fR to \fBunofficial\fR or
2429
lower.
2430
.PP
2431
\fIOptions\fR
2432
.IX Subsection "Options"
2433
.IP "\fBb\fR" 4
2434
.IX Item "b"
2435
Set bitrate in bits per second. Only the following bitrates are supported,
2436
otherwise libavcodec will round to the nearest valid bitrate.
2437
.RS 4
2438
.IP "\fB4750\fR" 4
2439
.IX Item "4750"
2440
.PD 0
2441
.IP "\fB5150\fR" 4
2442
.IX Item "5150"
2443
.IP "\fB5900\fR" 4
2444
.IX Item "5900"
2445
.IP "\fB6700\fR" 4
2446
.IX Item "6700"
2447
.IP "\fB7400\fR" 4
2448
.IX Item "7400"
2449
.IP "\fB7950\fR" 4
2450
.IX Item "7950"
2451
.IP "\fB10200\fR" 4
2452
.IX Item "10200"
2453
.IP "\fB12200\fR" 4
2454
.IX Item "12200"
2455
.RE
2456
.RS 4
2457
.RE
2458
.IP "\fBdtx\fR" 4
2459
.IX Item "dtx"
2460
.PD
2461
Allow discontinuous transmission (generate comfort noise) when set to 1. The
2462
default value is 0 (disabled).
2463
.Sh "libshine"
2464
.IX Subsection "libshine"
2465
Shine Fixed-Point \s-1MP3\s0 encoder wrapper.
2466
.PP
2467
Shine is a fixed-point \s-1MP3\s0 encoder. It has a far better performance on
2468
platforms without an \s-1FPU\s0, e.g. armel CPUs, and some phones and tablets.
2469
However, as it is more targeted on performance than quality, it is not on par
2470
with \s-1LAME\s0 and other production-grade encoders quality\-wise. Also, according to
2471
the project's homepage, this encoder may not be free of bugs as the code was
2472
written a long time ago and the project was dead for at least 5 years.
2473
.PP
2474
This encoder only supports stereo and mono input. This is also CBR\-only.
2475
.PP
2476
The original project (last updated in early 2007) is at
2477
<\fBhttp://sourceforge.net/projects/libshine\-fxp/\fR>. We only support the
2478
updated fork by the Savonet/Liquidsoap project at <\fBhttps://github.com/savonet/shine\fR>.
2479
.PP
2480
Requires the presence of the libshine headers and library during
2481
configuration. You need to explicitly configure the build with
2482
\&\f(CW\*(C`\-\-enable\-libshine\*(C'\fR.
2483
.PP
2484
See also libmp3lame.
2485
.PP
2486
\fIOptions\fR
2487
.IX Subsection "Options"
2488
.PP
2489
The following options are supported by the libshine wrapper. The
2490
\&\fBshineenc\fR\-equivalent of the options are listed in parentheses.
2491
.IP "\fBb (\fR\fI\-b\fR\fB)\fR" 4
2492
.IX Item "b (-b)"
2493
Set bitrate expressed in bits/s for \s-1CBR\s0. \fBshineenc\fR \fB\-b\fR option
2494
is expressed in kilobits/s.
2495
.Sh "libtwolame"
2496
.IX Subsection "libtwolame"
2497
TwoLAME \s-1MP2\s0 encoder wrapper.
2498
.PP
2499
Requires the presence of the libtwolame headers and library during
2500
configuration. You need to explicitly configure the build with
2501
\&\f(CW\*(C`\-\-enable\-libtwolame\*(C'\fR.
2502
.PP
2503
\fIOptions\fR
2504
.IX Subsection "Options"
2505
.PP
2506
The following options are supported by the libtwolame wrapper. The
2507
\&\fBtwolame\fR\-equivalent options follow the FFmpeg ones and are in
2508
parentheses.
2509
.IP "\fBb (\fR\fI\-b\fR\fB)\fR" 4
2510
.IX Item "b (-b)"
2511
Set bitrate expressed in bits/s for \s-1CBR\s0. \fBtwolame\fR \fBb\fR
2512
option is expressed in kilobits/s. Default value is 128k.
2513
.IP "\fBq (\fR\fI\-V\fR\fB)\fR" 4
2514
.IX Item "q (-V)"
2515
Set quality for experimental \s-1VBR\s0 support. Maximum value range is
2516
from \-50 to 50, useful range is from \-10 to 10. The higher the
2517
value, the better the quality. This option is valid only using the
2518
\&\fBffmpeg\fR command-line tool. For library interface users,
2519
use \fBglobal_quality\fR.
2520
.IP "\fBmode (\fR\fI\-\-mode\fR\fB)\fR" 4
2521
.IX Item "mode (--mode)"
2522
Set the mode of the resulting audio. Possible values:
2523
.RS 4
2524
.IP "\fBauto\fR" 4
2525
.IX Item "auto"
2526
Choose mode automatically based on the input. This is the default.
2527
.IP "\fBstereo\fR" 4
2528
.IX Item "stereo"
2529
Stereo
2530
.IP "\fBjoint_stereo\fR" 4
2531
.IX Item "joint_stereo"
2532
Joint stereo
2533
.IP "\fBdual_channel\fR" 4
2534
.IX Item "dual_channel"
2535
Dual channel
2536
.IP "\fBmono\fR" 4
2537
.IX Item "mono"
2538
Mono
2539
.RE
2540
.RS 4
2541
.RE
2542
.IP "\fBpsymodel (\fR\fI\-\-psyc\-mode\fR\fB)\fR" 4
2543
.IX Item "psymodel (--psyc-mode)"
2544
Set psychoacoustic model to use in encoding. The argument must be
2545
an integer between \-1 and 4, inclusive. The higher the value, the
2546
better the quality. The default value is 3.
2547
.IP "\fBenergy_levels (\fR\fI\-\-energy\fR\fB)\fR" 4
2548
.IX Item "energy_levels (--energy)"
2549
Enable energy levels extensions when set to 1. The default value is
2550
 
2551
.IP "\fBerror_protection (\fR\fI\-\-protect\fR\fB)\fR" 4
2552
.IX Item "error_protection (--protect)"
2553
Enable \s-1CRC\s0 error protection when set to 1. The default value is 0
2554
(disabled).
2555
.IP "\fBcopyright (\fR\fI\-\-copyright\fR\fB)\fR" 4
2556
.IX Item "copyright (--copyright)"
2557
Set \s-1MPEG\s0 audio copyright flag when set to 1. The default value is 0
2558
(disabled).
2559
.IP "\fBoriginal (\fR\fI\-\-original\fR\fB)\fR" 4
2560
.IX Item "original (--original)"
2561
Set \s-1MPEG\s0 audio original flag when set to 1. The default value is 0
2562
(disabled).
2563
.Sh "libvo-aacenc"
2564
.IX Subsection "libvo-aacenc"
2565
VisualOn \s-1AAC\s0 encoder.
2566
.PP
2567
Requires the presence of the libvo-aacenc headers and library during
2568
configuration. You need to explicitly configure the build with
2569
\&\f(CW\*(C`\-\-enable\-libvo\-aacenc \-\-enable\-version3\*(C'\fR.
2570
.PP
2571
This encoder is considered to be worse than the
2572
native experimental FFmpeg \s-1AAC\s0 encoder, according to
2573
multiple sources.
2574
.PP
2575
\fIOptions\fR
2576
.IX Subsection "Options"
2577
.PP
2578
The VisualOn \s-1AAC\s0 encoder only support encoding AAC-LC and up to 2
2579
channels. It is also CBR\-only.
2580
.IP "\fBb\fR" 4
2581
.IX Item "b"
2582
Set bit rate in bits/s.
2583
.Sh "libvo-amrwbenc"
2584
.IX Subsection "libvo-amrwbenc"
2585
VisualOn Adaptive Multi-Rate Wideband encoder.
2586
.PP
2587
Requires the presence of the libvo-amrwbenc headers and library during
2588
configuration. You need to explicitly configure the build with
2589
\&\f(CW\*(C`\-\-enable\-libvo\-amrwbenc \-\-enable\-version3\*(C'\fR.
2590
.PP
2591
This is a mono-only encoder. Officially it only supports 16000Hz sample
2592
rate, but you can override it by setting \fBstrict\fR to
2593
\&\fBunofficial\fR or lower.
2594
.PP
2595
\fIOptions\fR
2596
.IX Subsection "Options"
2597
.IP "\fBb\fR" 4
2598
.IX Item "b"
2599
Set bitrate in bits/s. Only the following bitrates are supported, otherwise
2600
libavcodec will round to the nearest valid bitrate.
2601
.RS 4
2602
.IP "\fB6600\fR" 4
2603
.IX Item "6600"
2604
.PD 0
2605
.IP "\fB8850\fR" 4
2606
.IX Item "8850"
2607
.IP "\fB12650\fR" 4
2608
.IX Item "12650"
2609
.IP "\fB14250\fR" 4
2610
.IX Item "14250"
2611
.IP "\fB15850\fR" 4
2612
.IX Item "15850"
2613
.IP "\fB18250\fR" 4
2614
.IX Item "18250"
2615
.IP "\fB19850\fR" 4
2616
.IX Item "19850"
2617
.IP "\fB23050\fR" 4
2618
.IX Item "23050"
2619
.IP "\fB23850\fR" 4
2620
.IX Item "23850"
2621
.RE
2622
.RS 4
2623
.RE
2624
.IP "\fBdtx\fR" 4
2625
.IX Item "dtx"
2626
.PD
2627
Allow discontinuous transmission (generate comfort noise) when set to 1. The
2628
default value is 0 (disabled).
2629
.Sh "libopus"
2630
.IX Subsection "libopus"
2631
libopus Opus Interactive Audio Codec encoder wrapper.
2632
.PP
2633
Requires the presence of the libopus headers and library during
2634
configuration. You need to explicitly configure the build with
2635
\&\f(CW\*(C`\-\-enable\-libopus\*(C'\fR.
2636
.PP
2637
\fIOption Mapping\fR
2638
.IX Subsection "Option Mapping"
2639
.PP
2640
Most libopus options are modeled after the \fBopusenc\fR utility from
2641
opus\-tools. The following is an option mapping chart describing options
2642
supported by the libopus wrapper, and their \fBopusenc\fR\-equivalent
2643
in parentheses.
2644
.IP "\fBb (\fR\fIbitrate\fR\fB)\fR" 4
2645
.IX Item "b (bitrate)"
2646
Set the bit rate in bits/s.  FFmpeg's \fBb\fR option is
2647
expressed in bits/s, while \fBopusenc\fR's \fBbitrate\fR in
2648
kilobits/s.
2649
.IP "\fBvbr (\fR\fIvbr\fR\fB,\fR \fIhard-cbr\fR\fB, and\fR \fIcvbr\fR\fB)\fR" 4
2650
.IX Item "vbr (vbr, hard-cbr, and cvbr)"
2651
Set \s-1VBR\s0 mode. The FFmpeg \fBvbr\fR option has the following
2652
valid arguments, with the their \fBopusenc\fR equivalent options
2653
in parentheses:
2654
.RS 4
2655
.IP "\fBoff (\fR\fIhard-cbr\fR\fB)\fR" 4
2656
.IX Item "off (hard-cbr)"
2657
Use constant bit rate encoding.
2658
.IP "\fBon (\fR\fIvbr\fR\fB)\fR" 4
2659
.IX Item "on (vbr)"
2660
Use variable bit rate encoding (the default).
2661
.IP "\fBconstrained (\fR\fIcvbr\fR\fB)\fR" 4
2662
.IX Item "constrained (cvbr)"
2663
Use constrained variable bit rate encoding.
2664
.RE
2665
.RS 4
2666
.RE
2667
.IP "\fBcompression_level (\fR\fIcomp\fR\fB)\fR" 4
2668
.IX Item "compression_level (comp)"
2669
Set encoding algorithm complexity. Valid options are integers in
2670
the 0\-10 range. 0 gives the fastest encodes but lower quality, while 10
2671
gives the highest quality but slowest encoding. The default is 10.
2672
.IP "\fBframe_duration (\fR\fIframesize\fR\fB)\fR" 4
2673
.IX Item "frame_duration (framesize)"
2674
Set maximum frame size, or duration of a frame in milliseconds. The
2675
argument must be exactly the following: 2.5, 5, 10, 20, 40, 60. Smaller
2676
frame sizes achieve lower latency but less quality at a given bitrate.
2677
Sizes greater than 20ms are only interesting at fairly low bitrates.
2678
The default of FFmpeg is 10ms, but is 20ms in \fBopusenc\fR.
2679
.IP "\fBpacket_loss (\fR\fIexpect-loss\fR\fB)\fR" 4
2680
.IX Item "packet_loss (expect-loss)"
2681
Set expected packet loss percentage. The default is 0.
2682
.IP "\fBapplication (N.A.)\fR" 4
2683
.IX Item "application (N.A.)"
2684
Set intended application type. Valid options are listed below:
2685
.RS 4
2686
.IP "\fBvoip\fR" 4
2687
.IX Item "voip"
2688
Favor improved speech intelligibility.
2689
.IP "\fBaudio\fR" 4
2690
.IX Item "audio"
2691
Favor faithfulness to the input (the default).
2692
.IP "\fBlowdelay\fR" 4
2693
.IX Item "lowdelay"
2694
Restrict to only the lowest delay modes.
2695
.RE
2696
.RS 4
2697
.RE
2698
.IP "\fBcutoff (N.A.)\fR" 4
2699
.IX Item "cutoff (N.A.)"
2700
Set cutoff bandwidth in Hz. The argument must be exactly one of the
2701
following: 4000, 6000, 8000, 12000, or 20000, corresponding to
2702
narrowband, mediumband, wideband, super wideband, and fullband
2703
respectively. The default is 0 (cutoff disabled).
2704
.Sh "libvorbis"
2705
.IX Subsection "libvorbis"
2706
libvorbis encoder wrapper.
2707
.PP
2708
Requires the presence of the libvorbisenc headers and library during
2709
configuration. You need to explicitly configure the build with
2710
\&\f(CW\*(C`\-\-enable\-libvorbis\*(C'\fR.
2711
.PP
2712
\fIOptions\fR
2713
.IX Subsection "Options"
2714
.PP
2715
The following options are supported by the libvorbis wrapper. The
2716
\&\fBoggenc\fR\-equivalent of the options are listed in parentheses.
2717
.PP
2718
To get a more accurate and extensive documentation of the libvorbis
2719
options, consult the libvorbisenc's and \fBoggenc\fR's documentations.
2720
See <\fBhttp://xiph.org/vorbis/\fR>,
2721
<\fBhttp://wiki.xiph.org/Vorbis\-tools\fR>, and \fIoggenc\fR\|(1).
2722
.IP "\fBb (\fR\fI\-b\fR\fB)\fR" 4
2723
.IX Item "b (-b)"
2724
Set bitrate expressed in bits/s for \s-1ABR\s0. \fBoggenc\fR \fB\-b\fR is
2725
expressed in kilobits/s.
2726
.IP "\fBq (\fR\fI\-q\fR\fB)\fR" 4
2727
.IX Item "q (-q)"
2728
Set constant quality setting for \s-1VBR\s0. The value should be a float
2729
number in the range of \-1.0 to 10.0. The higher the value, the better
2730
the quality. The default value is \fB3.0\fR.
2731
.Sp
2732
This option is valid only using the \fBffmpeg\fR command-line tool.
2733
For library interface users, use \fBglobal_quality\fR.
2734
.IP "\fBcutoff (\fR\fI\-\-advanced\-encode\-option lowpass_frequency=N\fR\fB)\fR" 4
2735
.IX Item "cutoff (--advanced-encode-option lowpass_frequency=N)"
2736
Set cutoff bandwidth in Hz, a value of 0 disables cutoff. \fBoggenc\fR's
2737
related option is expressed in kHz. The default value is \fB0\fR (cutoff
2738
disabled).
2739
.IP "\fBminrate (\fR\fI\-m\fR\fB)\fR" 4
2740
.IX Item "minrate (-m)"
2741
Set minimum bitrate expressed in bits/s. \fBoggenc\fR \fB\-m\fR is
2742
expressed in kilobits/s.
2743
.IP "\fBmaxrate (\fR\fI\-M\fR\fB)\fR" 4
2744
.IX Item "maxrate (-M)"
2745
Set maximum bitrate expressed in bits/s. \fBoggenc\fR \fB\-M\fR is
2746
expressed in kilobits/s. This only has effect on \s-1ABR\s0 mode.
2747
.IP "\fBiblock (\fR\fI\-\-advanced\-encode\-option impulse_noisetune=N\fR\fB)\fR" 4
2748
.IX Item "iblock (--advanced-encode-option impulse_noisetune=N)"
2749
Set noise floor bias for impulse blocks. The value is a float number from
2750
\&\-15.0 to 0.0. A negative bias instructs the encoder to pay special attention
2751
to the crispness of transients in the encoded audio. The tradeoff for better
2752
transient response is a higher bitrate.
2753
.Sh "libwavpack"
2754
.IX Subsection "libwavpack"
2755
A wrapper providing WavPack encoding through libwavpack.
2756
.PP
2757
Only lossless mode using 32\-bit integer samples is supported currently.
2758
The \fBcompression_level\fR option can be used to control speed vs.
2759
compression tradeoff, with the values mapped to libwavpack as follows:
2760
.IP "\fB0\fR" 4
2761
.IX Item "0"
2762
Fast mode \- corresponding to the wavpack \fB\-f\fR option.
2763
.IP "\fB1\fR" 4
2764
.IX Item "1"
2765
Normal (default) settings.
2766
.IP "\fB2\fR" 4
2767
.IX Item "2"
2768
High quality \- corresponding to the wavpack \fB\-h\fR option.
2769
.IP "\fB3\fR" 4
2770
.IX Item "3"
2771
Very high quality \- corresponding to the wavpack \fB\-hh\fR option.
2772
.IP "\fB4\-8\fR" 4
2773
.IX Item "4-8"
2774
Same as 3, but with extra processing enabled \- corresponding to the wavpack
2775
\&\fB\-x\fR option. I.e. 4 is the same as \fB\-x2\fR and 8 is the same as
2776
\&\fB\-x6\fR.
2777
.SH "VIDEO ENCODERS"
2778
.IX Header "VIDEO ENCODERS"
2779
A description of some of the currently available video encoders
2780
follows.
2781
.Sh "libtheora"
2782
.IX Subsection "libtheora"
2783
Theora format supported through libtheora.
2784
.PP
2785
Requires the presence of the libtheora headers and library during
2786
configuration. You need to explicitly configure the build with
2787
\&\f(CW\*(C`\-\-enable\-libtheora\*(C'\fR.
2788
.PP
2789
\fIOptions\fR
2790
.IX Subsection "Options"
2791
.PP
2792
The following global options are mapped to internal libtheora options
2793
which affect the quality and the bitrate of the encoded stream.
2794
.IP "\fBb\fR" 4
2795
.IX Item "b"
2796
Set the video bitrate, only works if the \f(CW\*(C`qscale\*(C'\fR flag in
2797
\&\fBflags\fR is not enabled.
2798
.IP "\fBflags\fR" 4
2799
.IX Item "flags"
2800
Used to enable constant quality mode encoding through the
2801
\&\fBqscale\fR flag, and to enable the \f(CW\*(C`pass1\*(C'\fR and \f(CW\*(C`pass2\*(C'\fR
2802
modes.
2803
.IP "\fBg\fR" 4
2804
.IX Item "g"
2805
Set the \s-1GOP\s0 size.
2806
.IP "\fBglobal_quality\fR" 4
2807
.IX Item "global_quality"
2808
Set the global quality in lambda units, only works if the
2809
\&\f(CW\*(C`qscale\*(C'\fR flag in \fBflags\fR is enabled. The value is clipped
2810
in the [0 \- 10*\f(CW\*(C`FF_QP2LAMBDA\*(C'\fR] range, and then multiplied for 6.3
2811
to get a value in the native libtheora range [0\-63]. A higher value
2812
corresponds to a higher quality.
2813
.Sp
2814
For example, to set maximum constant quality encoding with
2815
\&\fBffmpeg\fR:
2816
.Sp
2817
.Vb 1
2818
\&        ffmpeg -i INPUT -flags:v qscale -global_quality:v "10*QP2LAMBDA" -codec:v libtheora OUTPUT.ogg
2819
.Ve
2820
.Sh "libvpx"
2821
.IX Subsection "libvpx"
2822
\&\s-1VP8\s0 format supported through libvpx.
2823
.PP
2824
Requires the presence of the libvpx headers and library during configuration.
2825
You need to explicitly configure the build with \f(CW\*(C`\-\-enable\-libvpx\*(C'\fR.
2826
.PP
2827
\fIOptions\fR
2828
.IX Subsection "Options"
2829
.PP
2830
Mapping from FFmpeg to libvpx options with conversion notes in parentheses.
2831
.IP "\fBthreads\fR" 4
2832
.IX Item "threads"
2833
g_threads
2834
.IP "\fBprofile\fR" 4
2835
.IX Item "profile"
2836
g_profile
2837
.IP "\fBvb\fR" 4
2838
.IX Item "vb"
2839
rc_target_bitrate
2840
.IP "\fBg\fR" 4
2841
.IX Item "g"
2842
kf_max_dist
2843
.IP "\fBkeyint_min\fR" 4
2844
.IX Item "keyint_min"
2845
kf_min_dist
2846
.IP "\fBqmin\fR" 4
2847
.IX Item "qmin"
2848
rc_min_quantizer
2849
.IP "\fBqmax\fR" 4
2850
.IX Item "qmax"
2851
rc_max_quantizer
2852
.IP "\fBbufsize, vb\fR" 4
2853
.IX Item "bufsize, vb"
2854
rc_buf_sz
2855
\&\f(CW\*(C`(bufsize * 1000 / vb)\*(C'\fR
2856
.Sp
2857
rc_buf_optimal_sz
2858
\&\f(CW\*(C`(bufsize * 1000 / vb * 5 / 6)\*(C'\fR
2859
.IP "\fBrc_init_occupancy, vb\fR" 4
2860
.IX Item "rc_init_occupancy, vb"
2861
rc_buf_initial_sz
2862
\&\f(CW\*(C`(rc_init_occupancy * 1000 / vb)\*(C'\fR
2863
.IP "\fBrc_buffer_aggressivity\fR" 4
2864
.IX Item "rc_buffer_aggressivity"
2865
rc_undershoot_pct
2866
.IP "\fBskip_threshold\fR" 4
2867
.IX Item "skip_threshold"
2868
rc_dropframe_thresh
2869
.IP "\fBqcomp\fR" 4
2870
.IX Item "qcomp"
2871
rc_2pass_vbr_bias_pct
2872
.IP "\fBmaxrate, vb\fR" 4
2873
.IX Item "maxrate, vb"
2874
rc_2pass_vbr_maxsection_pct
2875
\&\f(CW\*(C`(maxrate * 100 / vb)\*(C'\fR
2876
.IP "\fBminrate, vb\fR" 4
2877
.IX Item "minrate, vb"
2878
rc_2pass_vbr_minsection_pct
2879
\&\f(CW\*(C`(minrate * 100 / vb)\*(C'\fR
2880
.IP "\fBminrate, maxrate, vb\fR" 4
2881
.IX Item "minrate, maxrate, vb"
2882
\&\f(CW\*(C`VPX_CBR\*(C'\fR
2883
\&\f(CW\*(C`(minrate == maxrate == vb)\*(C'\fR
2884
.IP "\fBcrf\fR" 4
2885
.IX Item "crf"
2886
\&\f(CW\*(C`VPX_CQ\*(C'\fR, \f(CW\*(C`VP8E_SET_CQ_LEVEL\*(C'\fR
2887
.IP "\fBquality\fR" 4
2888
.IX Item "quality"
2889
.RS 4
2890
.PD 0
2891
.IP "\fIbest\fR" 4
2892
.IX Item "best"
2893
.PD
2894
\&\f(CW\*(C`VPX_DL_BEST_QUALITY\*(C'\fR
2895
.IP "\fIgood\fR" 4
2896
.IX Item "good"
2897
\&\f(CW\*(C`VPX_DL_GOOD_QUALITY\*(C'\fR
2898
.IP "\fIrealtime\fR" 4
2899
.IX Item "realtime"
2900
\&\f(CW\*(C`VPX_DL_REALTIME\*(C'\fR
2901
.RE
2902
.RS 4
2903
.RE
2904
.IP "\fBspeed\fR" 4
2905
.IX Item "speed"
2906
\&\f(CW\*(C`VP8E_SET_CPUUSED\*(C'\fR
2907
.IP "\fBnr\fR" 4
2908
.IX Item "nr"
2909
\&\f(CW\*(C`VP8E_SET_NOISE_SENSITIVITY\*(C'\fR
2910
.IP "\fBmb_threshold\fR" 4
2911
.IX Item "mb_threshold"
2912
\&\f(CW\*(C`VP8E_SET_STATIC_THRESHOLD\*(C'\fR
2913
.IP "\fBslices\fR" 4
2914
.IX Item "slices"
2915
\&\f(CW\*(C`VP8E_SET_TOKEN_PARTITIONS\*(C'\fR
2916
.IP "\fBmax-intra-rate\fR" 4
2917
.IX Item "max-intra-rate"
2918
\&\f(CW\*(C`VP8E_SET_MAX_INTRA_BITRATE_PCT\*(C'\fR
2919
.IP "\fBforce_key_frames\fR" 4
2920
.IX Item "force_key_frames"
2921
\&\f(CW\*(C`VPX_EFLAG_FORCE_KF\*(C'\fR
2922
.IP "\fBAlternate reference frame related\fR" 4
2923
.IX Item "Alternate reference frame related"
2924
.RS 4
2925
.PD 0
2926
.IP "\fBvp8flags altref\fR" 4
2927
.IX Item "vp8flags altref"
2928
.PD
2929
\&\f(CW\*(C`VP8E_SET_ENABLEAUTOALTREF\*(C'\fR
2930
.IP "\fIarnr_max_frames\fR" 4
2931
.IX Item "arnr_max_frames"
2932
\&\f(CW\*(C`VP8E_SET_ARNR_MAXFRAMES\*(C'\fR
2933
.IP "\fIarnr_type\fR" 4
2934
.IX Item "arnr_type"
2935
\&\f(CW\*(C`VP8E_SET_ARNR_TYPE\*(C'\fR
2936
.IP "\fIarnr_strength\fR" 4
2937
.IX Item "arnr_strength"
2938
\&\f(CW\*(C`VP8E_SET_ARNR_STRENGTH\*(C'\fR
2939
.IP "\fIrc_lookahead\fR" 4
2940
.IX Item "rc_lookahead"
2941
g_lag_in_frames
2942
.RE
2943
.RS 4
2944
.RE
2945
.IP "\fBvp8flags error_resilient\fR" 4
2946
.IX Item "vp8flags error_resilient"
2947
g_error_resilient
2948
.PP
2949
For more information about libvpx see:
2950
<\fBhttp://www.webmproject.org/\fR>
2951
.Sh "libx264"
2952
.IX Subsection "libx264"
2953
x264 H.264/MPEG\-4 \s-1AVC\s0 encoder wrapper.
2954
.PP
2955
This encoder requires the presence of the libx264 headers and library
2956
during configuration. You need to explicitly configure the build with
2957
\&\f(CW\*(C`\-\-enable\-libx264\*(C'\fR.
2958
.PP
2959
libx264 supports an impressive number of features, including 8x8 and
2960
4x4 adaptive spatial transform, adaptive B\-frame placement, \s-1CAVLC/CABAC\s0
2961
entropy coding, interlacing (\s-1MBAFF\s0), lossless mode, psy optimizations
2962
for detail retention (adaptive quantization, psy\-RD, psy\-trellis).
2963
.PP
2964
Many libx264 encoder options are mapped to FFmpeg global codec
2965
options, while unique encoder options are provided through private
2966
options. Additionally the \fBx264opts\fR and \fBx264\-params\fR
2967
private options allows to pass a list of key=value tuples as accepted
2968
by the libx264 \f(CW\*(C`x264_param_parse\*(C'\fR function.
2969
.PP
2970
The x264 project website is at
2971
<\fBhttp://www.videolan.org/developers/x264.html\fR>.
2972
.PP
2973
\fIOptions\fR
2974
.IX Subsection "Options"
2975
.PP
2976
The following options are supported by the libx264 wrapper. The
2977
\&\fBx264\fR\-equivalent options or values are listed in parentheses
2978
for easy migration.
2979
.PP
2980
To reduce the duplication of documentation, only the private options
2981
and some others requiring special attention are documented here. For
2982
the documentation of the undocumented generic options, see
2983
the Codec Options chapter.
2984
.PP
2985
To get a more accurate and extensive documentation of the libx264
2986
options, invoke the command \fBx264 \-\-full\-help\fR or consult
2987
the libx264 documentation.
2988
.IP "\fBb (\fR\fIbitrate\fR\fB)\fR" 4
2989
.IX Item "b (bitrate)"
2990
Set bitrate in bits/s. Note that FFmpeg's \fBb\fR option is
2991
expressed in bits/s, while \fBx264\fR's \fBbitrate\fR is in
2992
kilobits/s.
2993
.IP "\fBbf (\fR\fIbframes\fR\fB)\fR" 4
2994
.IX Item "bf (bframes)"
2995
.PD 0
2996
.IP "\fBg (\fR\fIkeyint\fR\fB)\fR" 4
2997
.IX Item "g (keyint)"
2998
.IP "\fBqmax (\fR\fIqpmax\fR\fB)\fR" 4
2999
.IX Item "qmax (qpmax)"
3000
.IP "\fBqmin (\fR\fIqpmin\fR\fB)\fR" 4
3001
.IX Item "qmin (qpmin)"
3002
.IP "\fBqdiff (\fR\fIqpstep\fR\fB)\fR" 4
3003
.IX Item "qdiff (qpstep)"
3004
.IP "\fBqblur (\fR\fIqblur\fR\fB)\fR" 4
3005
.IX Item "qblur (qblur)"
3006
.IP "\fBqcomp (\fR\fIqcomp\fR\fB)\fR" 4
3007
.IX Item "qcomp (qcomp)"
3008
.IP "\fBrefs (\fR\fIref\fR\fB)\fR" 4
3009
.IX Item "refs (ref)"
3010
.IP "\fBsc_threshold (\fR\fIscenecut\fR\fB)\fR" 4
3011
.IX Item "sc_threshold (scenecut)"
3012
.IP "\fBtrellis (\fR\fItrellis\fR\fB)\fR" 4
3013
.IX Item "trellis (trellis)"
3014
.IP "\fBnr  (\fR\fInr\fR\fB)\fR" 4
3015
.IX Item "nr  (nr)"
3016
.IP "\fBme_range (\fR\fImerange\fR\fB)\fR" 4
3017
.IX Item "me_range (merange)"
3018
.IP "\fBme_method (\fR\fIme\fR\fB)\fR" 4
3019
.IX Item "me_method (me)"
3020
.PD
3021
Set motion estimation method. Possible values in the decreasing order
3022
of speed:
3023
.RS 4
3024
.IP "\fBdia (\fR\fIdia\fR\fB)\fR" 4
3025
.IX Item "dia (dia)"
3026
.PD 0
3027
.IP "\fBepzs (\fR\fIdia\fR\fB)\fR" 4
3028
.IX Item "epzs (dia)"
3029
.PD
3030
Diamond search with radius 1 (fastest). \fBepzs\fR is an alias for
3031
\&\fBdia\fR.
3032
.IP "\fBhex (\fR\fIhex\fR\fB)\fR" 4
3033
.IX Item "hex (hex)"
3034
Hexagonal search with radius 2.
3035
.IP "\fBumh (\fR\fIumh\fR\fB)\fR" 4
3036
.IX Item "umh (umh)"
3037
Uneven multi-hexagon search.
3038
.IP "\fBesa (\fR\fIesa\fR\fB)\fR" 4
3039
.IX Item "esa (esa)"
3040
Exhaustive search.
3041
.IP "\fBtesa (\fR\fItesa\fR\fB)\fR" 4
3042
.IX Item "tesa (tesa)"
3043
Hadamard exhaustive search (slowest).
3044
.RE
3045
.RS 4
3046
.RE
3047
.IP "\fBsubq (\fR\fIsubme\fR\fB)\fR" 4
3048
.IX Item "subq (subme)"
3049
.PD 0
3050
.IP "\fBb_strategy (\fR\fIb\-adapt\fR\fB)\fR" 4
3051
.IX Item "b_strategy (b-adapt)"
3052
.IP "\fBkeyint_min (\fR\fImin-keyint\fR\fB)\fR" 4
3053
.IX Item "keyint_min (min-keyint)"
3054
.IP "\fBcoder\fR" 4
3055
.IX Item "coder"
3056
.PD
3057
Set entropy encoder. Possible values:
3058
.RS 4
3059
.IP "\fBac\fR" 4
3060
.IX Item "ac"
3061
Enable \s-1CABAC\s0.
3062
.IP "\fBvlc\fR" 4
3063
.IX Item "vlc"
3064
Enable \s-1CAVLC\s0 and disable \s-1CABAC\s0. It generates the same effect as
3065
\&\fBx264\fR's \fB\-\-no\-cabac\fR option.
3066
.RE
3067
.RS 4
3068
.RE
3069
.IP "\fBcmp\fR" 4
3070
.IX Item "cmp"
3071
Set full pixel motion estimation comparation algorithm. Possible values:
3072
.RS 4
3073
.IP "\fBchroma\fR" 4
3074
.IX Item "chroma"
3075
Enable chroma in motion estimation.
3076
.IP "\fBsad\fR" 4
3077
.IX Item "sad"
3078
Ignore chroma in motion estimation. It generates the same effect as
3079
\&\fBx264\fR's \fB\-\-no\-chroma\-me\fR option.
3080
.RE
3081
.RS 4
3082
.RE
3083
.IP "\fBthreads (\fR\fIthreads\fR\fB)\fR" 4
3084
.IX Item "threads (threads)"
3085
.PD 0
3086
.IP "\fBthread_type\fR" 4
3087
.IX Item "thread_type"
3088
.PD
3089
Set multithreading technique. Possible values:
3090
.RS 4
3091
.IP "\fBslice\fR" 4
3092
.IX Item "slice"
3093
Slice-based multithreading. It generates the same effect as
3094
\&\fBx264\fR's \fB\-\-sliced\-threads\fR option.
3095
.IP "\fBframe\fR" 4
3096
.IX Item "frame"
3097
Frame-based multithreading.
3098
.RE
3099
.RS 4
3100
.RE
3101
.IP "\fBflags\fR" 4
3102
.IX Item "flags"
3103
Set encoding flags. It can be used to disable closed \s-1GOP\s0 and enable
3104
open \s-1GOP\s0 by setting it to \f(CW\*(C`\-cgop\*(C'\fR. The result is similar to
3105
the behavior of \fBx264\fR's \fB\-\-open\-gop\fR option.
3106
.IP "\fBrc_init_occupancy (\fR\fIvbv-init\fR\fB)\fR" 4
3107
.IX Item "rc_init_occupancy (vbv-init)"
3108
.PD 0
3109
.IP "\fBpreset (\fR\fIpreset\fR\fB)\fR" 4
3110
.IX Item "preset (preset)"
3111
.PD
3112
Set the encoding preset.
3113
.IP "\fBtune (\fR\fItune\fR\fB)\fR" 4
3114
.IX Item "tune (tune)"
3115
Set tuning of the encoding params.
3116
.IP "\fBprofile (\fR\fIprofile\fR\fB)\fR" 4
3117
.IX Item "profile (profile)"
3118
Set profile restrictions.
3119
.IP "\fBfastfirstpass\fR" 4
3120
.IX Item "fastfirstpass"
3121
Enable fast settings when encoding first pass, when set to 1. When set
3122
to 0, it has the same effect of \fBx264\fR's
3123
\&\fB\-\-slow\-firstpass\fR option.
3124
.IP "\fBcrf (\fR\fIcrf\fR\fB)\fR" 4
3125
.IX Item "crf (crf)"
3126
Set the quality for constant quality mode.
3127
.IP "\fBcrf_max (\fR\fIcrf-max\fR\fB)\fR" 4
3128
.IX Item "crf_max (crf-max)"
3129
In \s-1CRF\s0 mode, prevents \s-1VBV\s0 from lowering quality beyond this point.
3130
.IP "\fBqp (\fR\fIqp\fR\fB)\fR" 4
3131
.IX Item "qp (qp)"
3132
Set constant quantization rate control method parameter.
3133
.IP "\fBaq-mode (\fR\fIaq-mode\fR\fB)\fR" 4
3134
.IX Item "aq-mode (aq-mode)"
3135
Set \s-1AQ\s0 method. Possible values:
3136
.RS 4
3137
.IP "\fBnone (\fR\fI0\fR\fB)\fR" 4
3138
.IX Item "none (0)"
3139
Disabled.
3140
.IP "\fBvariance (\fR\fI1\fR\fB)\fR" 4
3141
.IX Item "variance (1)"
3142
Variance \s-1AQ\s0 (complexity mask).
3143
.IP "\fBautovariance (\fR\fI2\fR\fB)\fR" 4
3144
.IX Item "autovariance (2)"
3145
Auto-variance \s-1AQ\s0 (experimental).
3146
.RE
3147
.RS 4
3148
.RE
3149
.IP "\fBaq-strength (\fR\fIaq-strength\fR\fB)\fR" 4
3150
.IX Item "aq-strength (aq-strength)"
3151
Set \s-1AQ\s0 strength, reduce blocking and blurring in flat and textured areas.
3152
.IP "\fBpsy\fR" 4
3153
.IX Item "psy"
3154
Use psychovisual optimizations when set to 1. When set to 0, it has the
3155
same effect as \fBx264\fR's \fB\-\-no\-psy\fR option.
3156
.IP "\fBpsy-rd  (\fR\fIpsy-rd\fR\fB)\fR" 4
3157
.IX Item "psy-rd  (psy-rd)"
3158
Set strength of psychovisual optimization, in
3159
\&\fIpsy-rd\fR:\fIpsy-trellis\fR format.
3160
.IP "\fBrc-lookahead (\fR\fIrc-lookahead\fR\fB)\fR" 4
3161
.IX Item "rc-lookahead (rc-lookahead)"
3162
Set number of frames to look ahead for frametype and ratecontrol.
3163
.IP "\fBweightb\fR" 4
3164
.IX Item "weightb"
3165
Enable weighted prediction for B\-frames when set to 1. When set to 0,
3166
it has the same effect as \fBx264\fR's \fB\-\-no\-weightb\fR option.
3167
.IP "\fBweightp (\fR\fIweightp\fR\fB)\fR" 4
3168
.IX Item "weightp (weightp)"
3169
Set weighted prediction method for P\-frames. Possible values:
3170
.RS 4
3171
.IP "\fBnone (\fR\fI0\fR\fB)\fR" 4
3172
.IX Item "none (0)"
3173
Disabled
3174
.IP "\fBsimple (\fR\fI1\fR\fB)\fR" 4
3175
.IX Item "simple (1)"
3176
Enable only weighted refs
3177
.IP "\fBsmart (\fR\fI2\fR\fB)\fR" 4
3178
.IX Item "smart (2)"
3179
Enable both weighted refs and duplicates
3180
.RE
3181
.RS 4
3182
.RE
3183
.IP "\fBssim (\fR\fIssim\fR\fB)\fR" 4
3184
.IX Item "ssim (ssim)"
3185
Enable calculation and printing \s-1SSIM\s0 stats after the encoding.
3186
.IP "\fBintra-refresh (\fR\fIintra-refresh\fR\fB)\fR" 4
3187
.IX Item "intra-refresh (intra-refresh)"
3188
Enable the use of Periodic Intra Refresh instead of \s-1IDR\s0 frames when set
3189
to 1.
3190
.IP "\fBbluray-compat (\fR\fIbluray-compat\fR\fB)\fR" 4
3191
.IX Item "bluray-compat (bluray-compat)"
3192
Configure the encoder to be compatible with the bluray standard.
3193
It is a shorthand for setting \*(L"bluray\-compat=1 force\-cfr=1\*(R".
3194
.IP "\fBb\-bias (\fR\fIb\-bias\fR\fB)\fR" 4
3195
.IX Item "b-bias (b-bias)"
3196
Set the influence on how often B\-frames are used.
3197
.IP "\fBb\-pyramid (\fR\fIb\-pyramid\fR\fB)\fR" 4
3198
.IX Item "b-pyramid (b-pyramid)"
3199
Set method for keeping of some B\-frames as references. Possible values:
3200
.RS 4
3201
.IP "\fBnone (\fR\fInone\fR\fB)\fR" 4
3202
.IX Item "none (none)"
3203
Disabled.
3204
.IP "\fBstrict (\fR\fIstrict\fR\fB)\fR" 4
3205
.IX Item "strict (strict)"
3206
Strictly hierarchical pyramid.
3207
.IP "\fBnormal (\fR\fInormal\fR\fB)\fR" 4
3208
.IX Item "normal (normal)"
3209
Non-strict (not Blu-ray compatible).
3210
.RE
3211
.RS 4
3212
.RE
3213
.IP "\fBmixed-refs\fR" 4
3214
.IX Item "mixed-refs"
3215
Enable the use of one reference per partition, as opposed to one
3216
reference per macroblock when set to 1. When set to 0, it has the
3217
same effect as \fBx264\fR's \fB\-\-no\-mixed\-refs\fR option.
3218
.IP "\fB8x8dct\fR" 4
3219
.IX Item "8x8dct"
3220
Enable adaptive spatial transform (high profile 8x8 transform)
3221
when set to 1. When set to 0, it has the same effect as
3222
\&\fBx264\fR's \fB\-\-no\-8x8dct\fR option.
3223
.IP "\fBfast-pskip\fR" 4
3224
.IX Item "fast-pskip"
3225
Enable early \s-1SKIP\s0 detection on P\-frames when set to 1. When set
3226
to 0, it has the same effect as \fBx264\fR's
3227
\&\fB\-\-no\-fast\-pskip\fR option.
3228
.IP "\fBaud (\fR\fIaud\fR\fB)\fR" 4
3229
.IX Item "aud (aud)"
3230
Enable use of access unit delimiters when set to 1.
3231
.IP "\fBmbtree\fR" 4
3232
.IX Item "mbtree"
3233
Enable use macroblock tree ratecontrol when set to 1. When set
3234
to 0, it has the same effect as \fBx264\fR's
3235
\&\fB\-\-no\-mbtree\fR option.
3236
.IP "\fBdeblock (\fR\fIdeblock\fR\fB)\fR" 4
3237
.IX Item "deblock (deblock)"
3238
Set loop filter parameters, in \fIalpha\fR:\fIbeta\fR form.
3239
.IP "\fBcplxblur (\fR\fIcplxblur\fR\fB)\fR" 4
3240
.IX Item "cplxblur (cplxblur)"
3241
Set fluctuations reduction in \s-1QP\s0 (before curve compression).
3242
.IP "\fBpartitions (\fR\fIpartitions\fR\fB)\fR" 4
3243
.IX Item "partitions (partitions)"
3244
Set partitions to consider as a comma-separated list of. Possible
3245
values in the list:
3246
.RS 4
3247
.IP "\fBp8x8\fR" 4
3248
.IX Item "p8x8"
3249
8x8 P\-frame partition.
3250
.IP "\fBp4x4\fR" 4
3251
.IX Item "p4x4"
3252
4x4 P\-frame partition.
3253
.IP "\fBb8x8\fR" 4
3254
.IX Item "b8x8"
3255
4x4 B\-frame partition.
3256
.IP "\fBi8x8\fR" 4
3257
.IX Item "i8x8"
3258
8x8 I\-frame partition.
3259
.IP "\fBi4x4\fR" 4
3260
.IX Item "i4x4"
3261
4x4 I\-frame partition.
3262
(Enabling \fBp4x4\fR requires \fBp8x8\fR to be enabled. Enabling
3263
\&\fBi8x8\fR requires adaptive spatial transform (\fB8x8dct\fR
3264
option) to be enabled.)
3265
.IP "\fBnone (\fR\fInone\fR\fB)\fR" 4
3266
.IX Item "none (none)"
3267
Do not consider any partitions.
3268
.IP "\fBall (\fR\fIall\fR\fB)\fR" 4
3269
.IX Item "all (all)"
3270
Consider every partition.
3271
.RE
3272
.RS 4
3273
.RE
3274
.IP "\fBdirect-pred (\fR\fIdirect\fR\fB)\fR" 4
3275
.IX Item "direct-pred (direct)"
3276
Set direct \s-1MV\s0 prediction mode. Possible values:
3277
.RS 4
3278
.IP "\fBnone (\fR\fInone\fR\fB)\fR" 4
3279
.IX Item "none (none)"
3280
Disable \s-1MV\s0 prediction.
3281
.IP "\fBspatial (\fR\fIspatial\fR\fB)\fR" 4
3282
.IX Item "spatial (spatial)"
3283
Enable spatial predicting.
3284
.IP "\fBtemporal (\fR\fItemporal\fR\fB)\fR" 4
3285
.IX Item "temporal (temporal)"
3286
Enable temporal predicting.
3287
.IP "\fBauto (\fR\fIauto\fR\fB)\fR" 4
3288
.IX Item "auto (auto)"
3289
Automatically decided.
3290
.RE
3291
.RS 4
3292
.RE
3293
.IP "\fBslice-max-size (\fR\fIslice-max-size\fR\fB)\fR" 4
3294
.IX Item "slice-max-size (slice-max-size)"
3295
Set the limit of the size of each slice in bytes. If not specified
3296
but \s-1RTP\s0 payload size (\fBps\fR) is specified, that is used.
3297
.IP "\fBstats (\fR\fIstats\fR\fB)\fR" 4
3298
.IX Item "stats (stats)"
3299
Set the file name for multi-pass stats.
3300
.IP "\fBnal-hrd (\fR\fInal-hrd\fR\fB)\fR" 4
3301
.IX Item "nal-hrd (nal-hrd)"
3302
Set signal \s-1HRD\s0 information (requires \fBvbv-bufsize\fR to be set).
3303
Possible values:
3304
.RS 4
3305
.IP "\fBnone (\fR\fInone\fR\fB)\fR" 4
3306
.IX Item "none (none)"
3307
Disable \s-1HRD\s0 information signaling.
3308
.IP "\fBvbr (\fR\fIvbr\fR\fB)\fR" 4
3309
.IX Item "vbr (vbr)"
3310
Variable bit rate.
3311
.IP "\fBcbr (\fR\fIcbr\fR\fB)\fR" 4
3312
.IX Item "cbr (cbr)"
3313
Constant bit rate (not allowed in \s-1MP4\s0 container).
3314
.RE
3315
.RS 4
3316
.RE
3317
.IP "\fBx264opts (N.A.)\fR" 4
3318
.IX Item "x264opts (N.A.)"
3319
Set any x264 option, see \fBx264 \-\-fullhelp\fR for a list.
3320
.Sp
3321
Argument is a list of \fIkey\fR=\fIvalue\fR couples separated by
3322
\&\*(L":\*(R". In \fIfilter\fR and \fIpsy-rd\fR options that use \*(L":\*(R" as a separator
3323
themselves, use \*(L",\*(R" instead. They accept it as well since long ago but this
3324
is kept undocumented for some reason.
3325
.Sp
3326
For example to specify libx264 encoding options with \fBffmpeg\fR:
3327
.Sp
3328
.Vb 1
3329
\&        ffmpeg -i foo.mpg -vcodec libx264 -x264opts keyint=123:min-keyint=20 -an out.mkv
3330
.Ve
3331
.IP "\fBx264\-params (N.A.)\fR" 4
3332
.IX Item "x264-params (N.A.)"
3333
Override the x264 configuration using a :\-separated list of key=value
3334
parameters.
3335
.Sp
3336
This option is functionally the same as the \fBx264opts\fR, but is
3337
duplicated for compability with the Libav fork.
3338
.Sp
3339
For example to specify libx264 encoding options with \fBffmpeg\fR:
3340
.Sp
3341
.Vb 3
3342
\&        ffmpeg -i INPUT -c:v libx264 -x264-params level=30:bframes=0:weightp=0:\e
3343
\&        cabac=0:ref=1:vbv-maxrate=768:vbv-bufsize=2000:analyse=all:me=umh:\e
3344
\&        no-fast-pskip=1:subq=6:8x8dct=0:trellis=0 OUTPUT
3345
.Ve
3346
.PP
3347
Encoding ffpresets for common usages are provided so they can be used with the
3348
general presets system (e.g. passing the \fBpre\fR option).
3349
.Sh "libxvid"
3350
.IX Subsection "libxvid"
3351
Xvid \s-1MPEG\-4\s0 Part 2 encoder wrapper.
3352
.PP
3353
This encoder requires the presence of the libxvidcore headers and library
3354
during configuration. You need to explicitly configure the build with
3355
\&\f(CW\*(C`\-\-enable\-libxvid \-\-enable\-gpl\*(C'\fR.
3356
.PP
3357
The native \f(CW\*(C`mpeg4\*(C'\fR encoder supports the \s-1MPEG\-4\s0 Part 2 format, so
3358
users can encode to this format without this library.
3359
.PP
3360
\fIOptions\fR
3361
.IX Subsection "Options"
3362
.PP
3363
The following options are supported by the libxvid wrapper. Some of
3364
the following options are listed but are not documented, and
3365
correspond to shared codec options. See the Codec
3366
Options chapter for their documentation. The other shared options
3367
which are not listed have no effect for the libxvid encoder.
3368
.IP "\fBb\fR" 4
3369
.IX Item "b"
3370
.PD 0
3371
.IP "\fBg\fR" 4
3372
.IX Item "g"
3373
.IP "\fBqmin\fR" 4
3374
.IX Item "qmin"
3375
.IP "\fBqmax\fR" 4
3376
.IX Item "qmax"
3377
.IP "\fBmpeg_quant\fR" 4
3378
.IX Item "mpeg_quant"
3379
.IP "\fBthreads\fR" 4
3380
.IX Item "threads"
3381
.IP "\fBbf\fR" 4
3382
.IX Item "bf"
3383
.IP "\fBb_qfactor\fR" 4
3384
.IX Item "b_qfactor"
3385
.IP "\fBb_qoffset\fR" 4
3386
.IX Item "b_qoffset"
3387
.IP "\fBflags\fR" 4
3388
.IX Item "flags"
3389
.PD
3390
Set specific encoding flags. Possible values:
3391
.RS 4
3392
.IP "\fBmv4\fR" 4
3393
.IX Item "mv4"
3394
Use four motion vector by macroblock.
3395
.IP "\fBaic\fR" 4
3396
.IX Item "aic"
3397
Enable high quality \s-1AC\s0 prediction.
3398
.IP "\fBgray\fR" 4
3399
.IX Item "gray"
3400
Only encode grayscale.
3401
.IP "\fBgmc\fR" 4
3402
.IX Item "gmc"
3403
Enable the use of global motion compensation (\s-1GMC\s0).
3404
.IP "\fBqpel\fR" 4
3405
.IX Item "qpel"
3406
Enable quarter-pixel motion compensation.
3407
.IP "\fBcgop\fR" 4
3408
.IX Item "cgop"
3409
Enable closed \s-1GOP\s0.
3410
.IP "\fBglobal_header\fR" 4
3411
.IX Item "global_header"
3412
Place global headers in extradata instead of every keyframe.
3413
.RE
3414
.RS 4
3415
.RE
3416
.IP "\fBtrellis\fR" 4
3417
.IX Item "trellis"
3418
.PD 0
3419
.IP "\fBme_method\fR" 4
3420
.IX Item "me_method"
3421
.PD
3422
Set motion estimation method. Possible values in decreasing order of
3423
speed and increasing order of quality:
3424
.RS 4
3425
.IP "\fBzero\fR" 4
3426
.IX Item "zero"
3427
Use no motion estimation (default).
3428
.IP "\fBphods\fR" 4
3429
.IX Item "phods"
3430
.PD 0
3431
.IP "\fBx1\fR" 4
3432
.IX Item "x1"
3433
.IP "\fBlog\fR" 4
3434
.IX Item "log"
3435
.PD
3436
Enable advanced diamond zonal search for 16x16 blocks and half-pixel
3437
refinement for 16x16 blocks. \fBx1\fR and \fBlog\fR are aliases for
3438
\&\fBphods\fR.
3439
.IP "\fBepzs\fR" 4
3440
.IX Item "epzs"
3441
Enable all of the things described above, plus advanced diamond zonal
3442
search for 8x8 blocks, half-pixel refinement for 8x8 blocks, and motion
3443
estimation on chroma planes.
3444
.IP "\fBfull\fR" 4
3445
.IX Item "full"
3446
Enable all of the things described above, plus extended 16x16 and 8x8
3447
blocks search.
3448
.RE
3449
.RS 4
3450
.RE
3451
.IP "\fBmbd\fR" 4
3452
.IX Item "mbd"
3453
Set macroblock decision algorithm. Possible values in the increasing
3454
order of quality:
3455
.RS 4
3456
.IP "\fBsimple\fR" 4
3457
.IX Item "simple"
3458
Use macroblock comparing function algorithm (default).
3459
.IP "\fBbits\fR" 4
3460
.IX Item "bits"
3461
Enable rate distortion-based half pixel and quarter pixel refinement for
3462
16x16 blocks.
3463
.IP "\fBrd\fR" 4
3464
.IX Item "rd"
3465
Enable all of the things described above, plus rate distortion-based
3466
half pixel and quarter pixel refinement for 8x8 blocks, and rate
3467
distortion-based search using square pattern.
3468
.RE
3469
.RS 4
3470
.RE
3471
.IP "\fBlumi_aq\fR" 4
3472
.IX Item "lumi_aq"
3473
Enable lumi masking adaptive quantization when set to 1. Default is 0
3474
(disabled).
3475
.IP "\fBvariance_aq\fR" 4
3476
.IX Item "variance_aq"
3477
Enable variance adaptive quantization when set to 1. Default is 0
3478
(disabled).
3479
.Sp
3480
When combined with \fBlumi_aq\fR, the resulting quality will not
3481
be better than any of the two specified individually. In other
3482
words, the resulting quality will be the worse one of the two
3483
effects.
3484
.IP "\fBssim\fR" 4
3485
.IX Item "ssim"
3486
Set structural similarity (\s-1SSIM\s0) displaying method. Possible values:
3487
.RS 4
3488
.IP "\fBoff\fR" 4
3489
.IX Item "off"
3490
Disable displaying of \s-1SSIM\s0 information.
3491
.IP "\fBavg\fR" 4
3492
.IX Item "avg"
3493
Output average \s-1SSIM\s0 at the end of encoding to stdout. The format of
3494
showing the average \s-1SSIM\s0 is:
3495
.Sp
3496
.Vb 1
3497
\&        Average SSIM: %f
3498
.Ve
3499
.Sp
3500
For users who are not familiar with C, \f(CW%f\fR means a float number, or
3501
a decimal (e.g. 0.939232).
3502
.IP "\fBframe\fR" 4
3503
.IX Item "frame"
3504
Output both per-frame \s-1SSIM\s0 data during encoding and average \s-1SSIM\s0 at
3505
the end of encoding to stdout. The format of per-frame information
3506
is:
3507
.Sp
3508
.Vb 1
3509
\&               SSIM: avg: %1.3f min: %1.3f max: %1.3f
3510
.Ve
3511
.Sp
3512
For users who are not familiar with C, \f(CW%1\fR.3f means a float number
3513
rounded to 3 digits after the dot (e.g. 0.932).
3514
.RE
3515
.RS 4
3516
.RE
3517
.IP "\fBssim_acc\fR" 4
3518
.IX Item "ssim_acc"
3519
Set \s-1SSIM\s0 accuracy. Valid options are integers within the range of
3520
0\-4, while 0 gives the most accurate result and 4 computes the
3521
fastest.
3522
.Sh "png"
3523
.IX Subsection "png"
3524
\&\s-1PNG\s0 image encoder.
3525
.PP
3526
\fIPrivate options\fR
3527
.IX Subsection "Private options"
3528
.IP "\fBdpi\fR \fIinteger\fR" 4
3529
.IX Item "dpi integer"
3530
Set physical density of pixels, in dots per inch, unset by default
3531
.IP "\fBdpm\fR \fIinteger\fR" 4
3532
.IX Item "dpm integer"
3533
Set physical density of pixels, in dots per meter, unset by default
3534
.Sh "ProRes"
3535
.IX Subsection "ProRes"
3536
Apple ProRes encoder.
3537
.PP
3538
FFmpeg contains 2 ProRes encoders, the prores-aw and prores-ks encoder.
3539
The used encoder can be choosen with the \f(CW\*(C`\-vcodec\*(C'\fR option.
3540
.PP
3541
\fIPrivate Options for prores-ks\fR
3542
.IX Subsection "Private Options for prores-ks"
3543
.IP "\fBprofile\fR \fIinteger\fR" 4
3544
.IX Item "profile integer"
3545
Select the ProRes profile to encode
3546
.RS 4
3547
.IP "\fBproxy\fR" 4
3548
.IX Item "proxy"
3549
.PD 0
3550
.IP "\fBlt\fR" 4
3551
.IX Item "lt"
3552
.IP "\fBstandard\fR" 4
3553
.IX Item "standard"
3554
.IP "\fBhq\fR" 4
3555
.IX Item "hq"
3556
.IP "\fB4444\fR" 4
3557
.IX Item "4444"
3558
.RE
3559
.RS 4
3560
.RE
3561
.IP "\fBquant_mat\fR \fIinteger\fR" 4
3562
.IX Item "quant_mat integer"
3563
.PD
3564
Select quantization matrix.
3565
.RS 4
3566
.IP "\fBauto\fR" 4
3567
.IX Item "auto"
3568
.PD 0
3569
.IP "\fBdefault\fR" 4
3570
.IX Item "default"
3571
.IP "\fBproxy\fR" 4
3572
.IX Item "proxy"
3573
.IP "\fBlt\fR" 4
3574
.IX Item "lt"
3575
.IP "\fBstandard\fR" 4
3576
.IX Item "standard"
3577
.IP "\fBhq\fR" 4
3578
.IX Item "hq"
3579
.RE
3580
.RS 4
3581
.PD
3582
.Sp
3583
If set to \fIauto\fR, the matrix matching the profile will be picked.
3584
If not set, the matrix providing the highest quality, \fIdefault\fR, will be
3585
picked.
3586
.RE
3587
.IP "\fBbits_per_mb\fR \fIinteger\fR" 4
3588
.IX Item "bits_per_mb integer"
3589
How many bits to allot for coding one macroblock. Different profiles use
3590
between 200 and 2400 bits per macroblock, the maximum is 8000.
3591
.IP "\fBmbs_per_slice\fR \fIinteger\fR" 4
3592
.IX Item "mbs_per_slice integer"
3593
Number of macroblocks in each slice (1\-8); the default value (8)
3594
should be good in almost all situations.
3595
.IP "\fBvendor\fR \fIstring\fR" 4
3596
.IX Item "vendor string"
3597
Override the 4\-byte vendor \s-1ID\s0.
3598
A custom vendor \s-1ID\s0 like \fIapl0\fR would claim the stream was produced by
3599
the Apple encoder.
3600
.IP "\fBalpha_bits\fR \fIinteger\fR" 4
3601
.IX Item "alpha_bits integer"
3602
Specify number of bits for alpha component.
3603
Possible values are \fI0\fR, \fI8\fR and \fI16\fR.
3604
Use \fI0\fR to disable alpha plane coding.
3605
.PP
3606
\fISpeed considerations\fR
3607
.IX Subsection "Speed considerations"
3608
.PP
3609
In the default mode of operation the encoder has to honor frame constraints
3610
(i.e. not produc frames with size bigger than requested) while still making
3611
output picture as good as possible.
3612
A frame containing a lot of small details is harder to compress and the encoder
3613
would spend more time searching for appropriate quantizers for each slice.
3614
.PP
3615
Setting a higher \fBbits_per_mb\fR limit will improve the speed.
3616
.PP
3617
For the fastest encoding speed set the \fBqscale\fR parameter (4 is the
3618
recommended value) and do not set a size constraint.
3619
.SH "SEE ALSO"
3620
.IX Header "SEE ALSO"
3621
\&\fIffmpeg\fR\|(1), \fIffplay\fR\|(1), \fIffprobe\fR\|(1), \fIffserver\fR\|(1), \fIlibavcodec\fR\|(3)
3622
.SH "AUTHORS"
3623
.IX Header "AUTHORS"
3624
The FFmpeg developers.
3625
.PP
3626
For details about the authorship, see the Git history of the project
3627
(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command
3628
\&\fBgit log\fR in the FFmpeg source directory, or browsing the
3629
online repository at <\fBhttp://source.ffmpeg.org\fR>.
3630
.PP
3631
Maintainers for the specific components are listed in the file
3632
\&\fI\s-1MAINTAINERS\s0\fR in the source code tree.