avcodec/options_table: add entries for MPEG4 video profiles
[ffmpeg.git] / doc / codecs.texi
1 @anchor{codec-options}
2 @chapter Codec Options
3 @c man begin CODEC OPTIONS
4
5 libavcodec provides some generic global options, which can be set on
6 all the encoders and decoders. In addition each codec may support
7 so-called private options, which are specific for a given codec.
8
9 Sometimes, a global option may only affect a specific kind of codec,
10 and may be nonsensical or ignored by another, so you need to be aware
11 of the meaning of the specified options. Also some options are
12 meant only for decoding or encoding.
13
14 Options may be set by specifying -@var{option} @var{value} in the
15 FFmpeg tools, or by setting the value explicitly in the
16 @code{AVCodecContext} options or using the @file{libavutil/opt.h} API
17 for programmatic use.
18
19 The list of supported options follow:
20
21 @table @option
22 @item b @var{integer} (@emph{encoding,audio,video})
23 Set bitrate in bits/s. Default value is 200K.
24
25 @item ab @var{integer} (@emph{encoding,audio})
26 Set audio bitrate (in bits/s). Default value is 128K.
27
28 @item bt @var{integer} (@emph{encoding,video})
29 Set video bitrate tolerance (in bits/s). In 1-pass mode, bitrate
30 tolerance specifies how far ratecontrol is willing to deviate from the
31 target average bitrate value. This is not related to min/max
32 bitrate. Lowering tolerance too much has an adverse effect on quality.
33
34 @item flags @var{flags} (@emph{decoding/encoding,audio,video,subtitles})
35 Set generic flags.
36
37 Possible values:
38 @table @samp
39 @item mv4
40 Use four motion vector by macroblock (mpeg4).
41 @item qpel
42 Use 1/4 pel motion compensation.
43 @item loop
44 Use loop filter.
45 @item qscale
46 Use fixed qscale.
47 @item gmc
48 Use gmc.
49 @item mv0
50 Always try a mb with mv=<0,0>.
51 @item input_preserved
52
53 @item pass1
54 Use internal 2pass ratecontrol in first pass mode.
55 @item pass2
56 Use internal 2pass ratecontrol in second pass mode.
57 @item gray
58 Only decode/encode grayscale.
59 @item emu_edge
60 Do not draw edges.
61 @item psnr
62 Set error[?] variables during encoding.
63 @item truncated
64
65 @item naq
66 Normalize adaptive quantization.
67 @item ildct
68 Use interlaced DCT.
69 @item low_delay
70 Force low delay.
71 @item global_header
72 Place global headers in extradata instead of every keyframe.
73 @item bitexact
74 Only write platform-, build- and time-independent data. (except (I)DCT).
75 This ensures that file and data checksums are reproducible and match between
76 platforms. Its primary use is for regression testing.
77 @item aic
78 Apply H263 advanced intra coding / mpeg4 ac prediction.
79 @item cbp
80 Deprecated, use mpegvideo private options instead.
81 @item qprd
82 Deprecated, use mpegvideo private options instead.
83 @item ilme
84 Apply interlaced motion estimation.
85 @item cgop
86 Use closed gop.
87 @end table
88
89 @item me_method @var{integer} (@emph{encoding,video})
90 Set motion estimation method.
91
92 Possible values:
93 @table @samp
94 @item zero
95 zero motion estimation (fastest)
96 @item full
97 full motion estimation (slowest)
98 @item epzs
99 EPZS motion estimation (default)
100 @item esa
101 esa motion estimation (alias for full)
102 @item tesa
103 tesa motion estimation
104 @item dia
105 dia motion estimation (alias for epzs)
106 @item log
107 log motion estimation
108 @item phods
109 phods motion estimation
110 @item x1
111 X1 motion estimation
112 @item hex
113 hex motion estimation
114 @item umh
115 umh motion estimation
116 @item iter
117 iter motion estimation
118 @end table
119
120 @item extradata_size @var{integer}
121 Set extradata size.
122
123 @item time_base @var{rational number}
124 Set codec time base.
125
126 It is the fundamental unit of time (in seconds) in terms of which
127 frame timestamps are represented. For fixed-fps content, timebase
128 should be @code{1 / frame_rate} and timestamp increments should be
129 identically 1.
130
131 @item g @var{integer} (@emph{encoding,video})
132 Set the group of picture size. Default value is 12.
133
134 @item ar @var{integer} (@emph{decoding/encoding,audio})
135 Set audio sampling rate (in Hz).
136
137 @item ac @var{integer} (@emph{decoding/encoding,audio})
138 Set number of audio channels.
139
140 @item cutoff @var{integer} (@emph{encoding,audio})
141 Set cutoff bandwidth.
142
143 @item frame_size @var{integer} (@emph{encoding,audio})
144 Set audio frame size.
145
146 Each submitted frame except the last must contain exactly frame_size
147 samples per channel. May be 0 when the codec has
148 CODEC_CAP_VARIABLE_FRAME_SIZE set, in that case the frame size is not
149 restricted. It is set by some decoders to indicate constant frame
150 size.
151
152 @item frame_number @var{integer}
153 Set the frame number.
154
155 @item delay @var{integer}
156
157 @item qcomp @var{float} (@emph{encoding,video})
158 Set video quantizer scale compression (VBR). It is used as a constant
159 in the ratecontrol equation. Recommended range for default rc_eq:
160 0.0-1.0.
161
162 @item qblur @var{float} (@emph{encoding,video})
163 Set video quantizer scale blur (VBR).
164
165 @item qmin @var{integer} (@emph{encoding,video})
166 Set min video quantizer scale (VBR). Must be included between -1 and
167 69, default value is 2.
168
169 @item qmax @var{integer} (@emph{encoding,video})
170 Set max video quantizer scale (VBR). Must be included between -1 and
171 1024, default value is 31.
172
173 @item qdiff @var{integer} (@emph{encoding,video})
174 Set max difference between the quantizer scale (VBR).
175
176 @item bf @var{integer} (@emph{encoding,video})
177 Set max number of B frames between non-B-frames.
178
179 Must be an integer between -1 and 16. 0 means that B-frames are
180 disabled. If a value of -1 is used, it will choose an automatic value
181 depending on the encoder.
182
183 Default value is 0.
184
185 @item b_qfactor @var{float} (@emph{encoding,video})
186 Set qp factor between P and B frames.
187
188 @item rc_strategy @var{integer} (@emph{encoding,video})
189 Set ratecontrol method.
190
191 @item b_strategy @var{integer} (@emph{encoding,video})
192 Set strategy to choose between I/P/B-frames.
193
194 @item ps @var{integer} (@emph{encoding,video})
195 Set RTP payload size in bytes.
196
197 @item mv_bits @var{integer}
198 @item header_bits @var{integer}
199 @item i_tex_bits @var{integer}
200 @item p_tex_bits @var{integer}
201 @item i_count @var{integer}
202 @item p_count @var{integer}
203 @item skip_count @var{integer}
204 @item misc_bits @var{integer}
205 @item frame_bits @var{integer}
206 @item codec_tag @var{integer}
207 @item bug @var{flags} (@emph{decoding,video})
208 Workaround not auto detected encoder bugs.
209
210 Possible values:
211 @table @samp
212 @item autodetect
213
214 @item old_msmpeg4
215 some old lavc generated msmpeg4v3 files (no autodetection)
216 @item xvid_ilace
217 Xvid interlacing bug (autodetected if fourcc==XVIX)
218 @item ump4
219 (autodetected if fourcc==UMP4)
220 @item no_padding
221 padding bug (autodetected)
222 @item amv
223
224 @item ac_vlc
225 illegal vlc bug (autodetected per fourcc)
226 @item qpel_chroma
227
228 @item std_qpel
229 old standard qpel (autodetected per fourcc/version)
230 @item qpel_chroma2
231
232 @item direct_blocksize
233 direct-qpel-blocksize bug (autodetected per fourcc/version)
234 @item edge
235 edge padding bug (autodetected per fourcc/version)
236 @item hpel_chroma
237
238 @item dc_clip
239
240 @item ms
241 Workaround various bugs in microsoft broken decoders.
242 @item trunc
243 trancated frames
244 @end table
245
246 @item lelim @var{integer} (@emph{encoding,video})
247 Set single coefficient elimination threshold for luminance (negative
248 values also consider DC coefficient).
249
250 @item celim @var{integer} (@emph{encoding,video})
251 Set single coefficient elimination threshold for chrominance (negative
252 values also consider dc coefficient)
253
254 @item strict @var{integer} (@emph{decoding/encoding,audio,video})
255 Specify how strictly to follow the standards.
256
257 Possible values:
258 @table @samp
259 @item very
260 strictly conform to a older more strict version of the spec or reference software
261 @item strict
262 strictly conform to all the things in the spec no matter what consequences
263 @item normal
264
265 @item unofficial
266 allow unofficial extensions
267 @item experimental
268 allow non standardized experimental things, experimental
269 (unfinished/work in progress/not well tested) decoders and encoders.
270 Note: experimental decoders can pose a security risk, do not use this for
271 decoding untrusted input.
272 @end table
273
274 @item b_qoffset @var{float} (@emph{encoding,video})
275 Set QP offset between P and B frames.
276
277 @item err_detect @var{flags} (@emph{decoding,audio,video})
278 Set error detection flags.
279
280 Possible values:
281 @table @samp
282 @item crccheck
283 verify embedded CRCs
284 @item bitstream
285 detect bitstream specification deviations
286 @item buffer
287 detect improper bitstream length
288 @item explode
289 abort decoding on minor error detection
290 @item ignore_err
291 ignore decoding errors, and continue decoding.
292 This is useful if you want to analyze the content of a video and thus want
293 everything to be decoded no matter what. This option will not result in a video
294 that is pleasing to watch in case of errors.
295 @item careful
296 consider things that violate the spec and have not been seen in the wild as errors
297 @item compliant
298 consider all spec non compliancies as errors
299 @item aggressive
300 consider things that a sane encoder should not do as an error
301 @end table
302
303 @item has_b_frames @var{integer}
304
305 @item block_align @var{integer}
306
307 @item mpeg_quant @var{integer} (@emph{encoding,video})
308 Use MPEG quantizers instead of H.263.
309
310 @item qsquish @var{float} (@emph{encoding,video})
311 How to keep quantizer between qmin and qmax (0 = clip, 1 = use
312 differentiable function).
313
314 @item rc_qmod_amp @var{float} (@emph{encoding,video})
315 Set experimental quantizer modulation.
316
317 @item rc_qmod_freq @var{integer} (@emph{encoding,video})
318 Set experimental quantizer modulation.
319
320 @item rc_override_count @var{integer}
321
322 @item rc_eq @var{string} (@emph{encoding,video})
323 Set rate control equation. When computing the expression, besides the
324 standard functions defined in the section 'Expression Evaluation', the
325 following functions are available: bits2qp(bits), qp2bits(qp). Also
326 the following constants are available: iTex pTex tex mv fCode iCount
327 mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex
328 avgTex.
329
330 @item maxrate @var{integer} (@emph{encoding,audio,video})
331 Set max bitrate tolerance (in bits/s). Requires bufsize to be set.
332
333 @item minrate @var{integer} (@emph{encoding,audio,video})
334 Set min bitrate tolerance (in bits/s). Most useful in setting up a CBR
335 encode. It is of little use elsewise.
336
337 @item bufsize @var{integer} (@emph{encoding,audio,video})
338 Set ratecontrol buffer size (in bits).
339
340 @item rc_buf_aggressivity @var{float} (@emph{encoding,video})
341 Currently useless.
342
343 @item i_qfactor @var{float} (@emph{encoding,video})
344 Set QP factor between P and I frames.
345
346 @item i_qoffset @var{float} (@emph{encoding,video})
347 Set QP offset between P and I frames.
348
349 @item rc_init_cplx @var{float} (@emph{encoding,video})
350 Set initial complexity for 1-pass encoding.
351
352 @item dct @var{integer} (@emph{encoding,video})
353 Set DCT algorithm.
354
355 Possible values:
356 @table @samp
357 @item auto
358 autoselect a good one (default)
359 @item fastint
360 fast integer
361 @item int
362 accurate integer
363 @item mmx
364
365 @item altivec
366
367 @item faan
368 floating point AAN DCT
369 @end table
370
371 @item lumi_mask @var{float} (@emph{encoding,video})
372 Compress bright areas stronger than medium ones.
373
374 @item tcplx_mask @var{float} (@emph{encoding,video})
375 Set temporal complexity masking.
376
377 @item scplx_mask @var{float} (@emph{encoding,video})
378 Set spatial complexity masking.
379
380 @item p_mask @var{float} (@emph{encoding,video})
381 Set inter masking.
382
383 @item dark_mask @var{float} (@emph{encoding,video})
384 Compress dark areas stronger than medium ones.
385
386 @item idct @var{integer} (@emph{decoding/encoding,video})
387 Select IDCT implementation.
388
389 Possible values:
390 @table @samp
391 @item auto
392
393 @item int
394
395 @item simple
396
397 @item simplemmx
398
399 @item simpleauto
400 Automatically pick a IDCT compatible with the simple one
401
402 @item arm
403
404 @item altivec
405
406 @item sh4
407
408 @item simplearm
409
410 @item simplearmv5te
411
412 @item simplearmv6
413
414 @item simpleneon
415
416 @item simplealpha
417
418 @item ipp
419
420 @item xvidmmx
421
422 @item faani
423 floating point AAN IDCT
424 @end table
425
426 @item slice_count @var{integer}
427
428 @item ec @var{flags} (@emph{decoding,video})
429 Set error concealment strategy.
430
431 Possible values:
432 @table @samp
433 @item guess_mvs
434 iterative motion vector (MV) search (slow)
435 @item deblock
436 use strong deblock filter for damaged MBs
437 @item favor_inter
438 favor predicting from the previous frame instead of the current
439 @end table
440
441 @item bits_per_coded_sample @var{integer}
442
443 @item pred @var{integer} (@emph{encoding,video})
444 Set prediction method.
445
446 Possible values:
447 @table @samp
448 @item left
449
450 @item plane
451
452 @item median
453
454 @end table
455
456 @item aspect @var{rational number} (@emph{encoding,video})
457 Set sample aspect ratio.
458
459 @item debug @var{flags} (@emph{decoding/encoding,audio,video,subtitles})
460 Print specific debug info.
461
462 Possible values:
463 @table @samp
464 @item pict
465 picture info
466 @item rc
467 rate control
468 @item bitstream
469
470 @item mb_type
471 macroblock (MB) type
472 @item qp
473 per-block quantization parameter (QP)
474 @item mv
475 motion vector
476 @item dct_coeff
477
478 @item skip
479
480 @item startcode
481
482 @item pts
483
484 @item er
485 error recognition
486 @item mmco
487 memory management control operations (H.264)
488 @item bugs
489
490 @item vis_qp
491 visualize quantization parameter (QP), lower QP are tinted greener
492 @item vis_mb_type
493 visualize block types
494 @item buffers
495 picture buffer allocations
496 @item thread_ops
497 threading operations
498 @end table
499
500 @item vismv @var{integer} (@emph{decoding,video})
501 Visualize motion vectors (MVs).
502
503 This option is deprecated, see the codecview filter instead.
504
505 Possible values:
506 @table @samp
507 @item pf
508 forward predicted MVs of P-frames
509 @item bf
510 forward predicted MVs of B-frames
511 @item bb
512 backward predicted MVs of B-frames
513 @end table
514
515 @item cmp @var{integer} (@emph{encoding,video})
516 Set full pel me compare function.
517
518 Possible values:
519 @table @samp
520 @item sad
521 sum of absolute differences, fast (default)
522 @item sse
523 sum of squared errors
524 @item satd
525 sum of absolute Hadamard transformed differences
526 @item dct
527 sum of absolute DCT transformed differences
528 @item psnr
529 sum of squared quantization errors (avoid, low quality)
530 @item bit
531 number of bits needed for the block
532 @item rd
533 rate distortion optimal, slow
534 @item zero
535 0
536 @item vsad
537 sum of absolute vertical differences
538 @item vsse
539 sum of squared vertical differences
540 @item nsse
541 noise preserving sum of squared differences
542 @item w53
543 5/3 wavelet, only used in snow
544 @item w97
545 9/7 wavelet, only used in snow
546 @item dctmax
547
548 @item chroma
549
550 @end table
551
552 @item subcmp @var{integer} (@emph{encoding,video})
553 Set sub pel me compare function.
554
555 Possible values:
556 @table @samp
557 @item sad
558 sum of absolute differences, fast (default)
559 @item sse
560 sum of squared errors
561 @item satd
562 sum of absolute Hadamard transformed differences
563 @item dct
564 sum of absolute DCT transformed differences
565 @item psnr
566 sum of squared quantization errors (avoid, low quality)
567 @item bit
568 number of bits needed for the block
569 @item rd
570 rate distortion optimal, slow
571 @item zero
572 0
573 @item vsad
574 sum of absolute vertical differences
575 @item vsse
576 sum of squared vertical differences
577 @item nsse
578 noise preserving sum of squared differences
579 @item w53
580 5/3 wavelet, only used in snow
581 @item w97
582 9/7 wavelet, only used in snow
583 @item dctmax
584
585 @item chroma
586
587 @end table
588
589 @item mbcmp @var{integer} (@emph{encoding,video})
590 Set macroblock compare function.
591
592 Possible values:
593 @table @samp
594 @item sad
595 sum of absolute differences, fast (default)
596 @item sse
597 sum of squared errors
598 @item satd
599 sum of absolute Hadamard transformed differences
600 @item dct
601 sum of absolute DCT transformed differences
602 @item psnr
603 sum of squared quantization errors (avoid, low quality)
604 @item bit
605 number of bits needed for the block
606 @item rd
607 rate distortion optimal, slow
608 @item zero
609 0
610 @item vsad
611 sum of absolute vertical differences
612 @item vsse
613 sum of squared vertical differences
614 @item nsse
615 noise preserving sum of squared differences
616 @item w53
617 5/3 wavelet, only used in snow
618 @item w97
619 9/7 wavelet, only used in snow
620 @item dctmax
621
622 @item chroma
623
624 @end table
625
626 @item ildctcmp @var{integer} (@emph{encoding,video})
627 Set interlaced dct compare function.
628
629 Possible values:
630 @table @samp
631 @item sad
632 sum of absolute differences, fast (default)
633 @item sse
634 sum of squared errors
635 @item satd
636 sum of absolute Hadamard transformed differences
637 @item dct
638 sum of absolute DCT transformed differences
639 @item psnr
640 sum of squared quantization errors (avoid, low quality)
641 @item bit
642 number of bits needed for the block
643 @item rd
644 rate distortion optimal, slow
645 @item zero
646 0
647 @item vsad
648 sum of absolute vertical differences
649 @item vsse
650 sum of squared vertical differences
651 @item nsse
652 noise preserving sum of squared differences
653 @item w53
654 5/3 wavelet, only used in snow
655 @item w97
656 9/7 wavelet, only used in snow
657 @item dctmax
658
659 @item chroma
660
661 @end table
662
663 @item dia_size @var{integer} (@emph{encoding,video})
664 Set diamond type & size for motion estimation.
665
666 @item last_pred @var{integer} (@emph{encoding,video})
667 Set amount of motion predictors from the previous frame.
668
669 @item preme @var{integer} (@emph{encoding,video})
670 Set pre motion estimation.
671
672 @item precmp @var{integer} (@emph{encoding,video})
673 Set pre motion estimation compare function.
674
675 Possible values:
676 @table @samp
677 @item sad
678 sum of absolute differences, fast (default)
679 @item sse
680 sum of squared errors
681 @item satd
682 sum of absolute Hadamard transformed differences
683 @item dct
684 sum of absolute DCT transformed differences
685 @item psnr
686 sum of squared quantization errors (avoid, low quality)
687 @item bit
688 number of bits needed for the block
689 @item rd
690 rate distortion optimal, slow
691 @item zero
692 0
693 @item vsad
694 sum of absolute vertical differences
695 @item vsse
696 sum of squared vertical differences
697 @item nsse
698 noise preserving sum of squared differences
699 @item w53
700 5/3 wavelet, only used in snow
701 @item w97
702 9/7 wavelet, only used in snow
703 @item dctmax
704
705 @item chroma
706
707 @end table
708
709 @item pre_dia_size @var{integer} (@emph{encoding,video})
710 Set diamond type & size for motion estimation pre-pass.
711
712 @item subq @var{integer} (@emph{encoding,video})
713 Set sub pel motion estimation quality.
714
715 @item dtg_active_format @var{integer}
716
717 @item me_range @var{integer} (@emph{encoding,video})
718 Set limit motion vectors range (1023 for DivX player).
719
720 @item ibias @var{integer} (@emph{encoding,video})
721 Set intra quant bias.
722
723 @item pbias @var{integer} (@emph{encoding,video})
724 Set inter quant bias.
725
726 @item color_table_id @var{integer}
727
728 @item global_quality @var{integer} (@emph{encoding,audio,video})
729
730 @item coder @var{integer} (@emph{encoding,video})
731
732 Possible values:
733 @table @samp
734 @item vlc
735 variable length coder / huffman coder
736 @item ac
737 arithmetic coder
738 @item raw
739 raw (no encoding)
740 @item rle
741 run-length coder
742 @item deflate
743 deflate-based coder
744 @end table
745
746 @item context @var{integer} (@emph{encoding,video})
747 Set context model.
748
749 @item slice_flags @var{integer}
750
751 @item xvmc_acceleration @var{integer}
752
753 @item mbd @var{integer} (@emph{encoding,video})
754 Set macroblock decision algorithm (high quality mode).
755
756 Possible values:
757 @table @samp
758 @item simple
759 use mbcmp (default)
760 @item bits
761 use fewest bits
762 @item rd
763 use best rate distortion
764 @end table
765
766 @item stream_codec_tag @var{integer}
767
768 @item sc_threshold @var{integer} (@emph{encoding,video})
769 Set scene change threshold.
770
771 @item lmin @var{integer} (@emph{encoding,video})
772 Set min lagrange factor (VBR).
773
774 @item lmax @var{integer} (@emph{encoding,video})
775 Set max lagrange factor (VBR).
776
777 @item nr @var{integer} (@emph{encoding,video})
778 Set noise reduction.
779
780 @item rc_init_occupancy @var{integer} (@emph{encoding,video})
781 Set number of bits which should be loaded into the rc buffer before
782 decoding starts.
783
784 @item flags2 @var{flags} (@emph{decoding/encoding,audio,video})
785
786 Possible values:
787 @table @samp
788 @item fast
789 Allow non spec compliant speedup tricks.
790 @item sgop
791 Deprecated, use mpegvideo private options instead.
792 @item noout
793 Skip bitstream encoding.
794 @item ignorecrop
795 Ignore cropping information from sps.
796 @item local_header
797 Place global headers at every keyframe instead of in extradata.
798 @item chunks
799 Frame data might be split into multiple chunks.
800 @item showall
801 Show all frames before the first keyframe.
802 @item skiprd
803 Deprecated, use mpegvideo private options instead.
804 @item export_mvs
805 Export motion vectors into frame side-data (see @code{AV_FRAME_DATA_MOTION_VECTORS})
806 for codecs that support it. See also @file{doc/examples/export_mvs.c}.
807 @end table
808
809 @item error @var{integer} (@emph{encoding,video})
810
811 @item qns @var{integer} (@emph{encoding,video})
812 Deprecated, use mpegvideo private options instead.
813
814 @item threads @var{integer} (@emph{decoding/encoding,video})
815
816 Possible values:
817 @table @samp
818 @item auto
819 detect a good number of threads
820 @end table
821
822 @item me_threshold @var{integer} (@emph{encoding,video})
823 Set motion estimation threshold.
824
825 @item mb_threshold @var{integer} (@emph{encoding,video})
826 Set macroblock threshold.
827
828 @item dc @var{integer} (@emph{encoding,video})
829 Set intra_dc_precision.
830
831 @item nssew @var{integer} (@emph{encoding,video})
832 Set nsse weight.
833
834 @item skip_top @var{integer} (@emph{decoding,video})
835 Set number of macroblock rows at the top which are skipped.
836
837 @item skip_bottom @var{integer} (@emph{decoding,video})
838 Set number of macroblock rows at the bottom which are skipped.
839
840 @item profile @var{integer} (@emph{encoding,audio,video})
841
842 Possible values:
843 @table @samp
844 @item unknown
845
846 @item aac_main
847
848 @item aac_low
849
850 @item aac_ssr
851
852 @item aac_ltp
853
854 @item aac_he
855
856 @item aac_he_v2
857
858 @item aac_ld
859
860 @item aac_eld
861
862 @item mpeg2_aac_low
863
864 @item mpeg2_aac_he
865
866 @item mpeg4_sp
867
868 @item mpeg4_core
869
870 @item mpeg4_main
871
872 @item mpeg4_asp
873
874 @item dts
875
876 @item dts_es
877
878 @item dts_96_24
879
880 @item dts_hd_hra
881
882 @item dts_hd_ma
883
884 @end table
885
886 @item level @var{integer} (@emph{encoding,audio,video})
887
888 Possible values:
889 @table @samp
890 @item unknown
891
892 @end table
893
894 @item lowres @var{integer} (@emph{decoding,audio,video})
895 Decode at 1= 1/2, 2=1/4, 3=1/8 resolutions.
896
897 @item skip_threshold @var{integer} (@emph{encoding,video})
898 Set frame skip threshold.
899
900 @item skip_factor @var{integer} (@emph{encoding,video})
901 Set frame skip factor.
902
903 @item skip_exp @var{integer} (@emph{encoding,video})
904 Set frame skip exponent.
905 Negative values behave identical to the corresponding positive ones, except
906 that the score is normalized.
907 Positive values exist primarily for compatibility reasons and are not so useful.
908
909 @item skipcmp @var{integer} (@emph{encoding,video})
910 Set frame skip compare function.
911
912 Possible values:
913 @table @samp
914 @item sad
915 sum of absolute differences, fast (default)
916 @item sse
917 sum of squared errors
918 @item satd
919 sum of absolute Hadamard transformed differences
920 @item dct
921 sum of absolute DCT transformed differences
922 @item psnr
923 sum of squared quantization errors (avoid, low quality)
924 @item bit
925 number of bits needed for the block
926 @item rd
927 rate distortion optimal, slow
928 @item zero
929 0
930 @item vsad
931 sum of absolute vertical differences
932 @item vsse
933 sum of squared vertical differences
934 @item nsse
935 noise preserving sum of squared differences
936 @item w53
937 5/3 wavelet, only used in snow
938 @item w97
939 9/7 wavelet, only used in snow
940 @item dctmax
941
942 @item chroma
943
944 @end table
945
946 @item border_mask @var{float} (@emph{encoding,video})
947 Increase the quantizer for macroblocks close to borders.
948
949 @item mblmin @var{integer} (@emph{encoding,video})
950 Set min macroblock lagrange factor (VBR).
951
952 @item mblmax @var{integer} (@emph{encoding,video})
953 Set max macroblock lagrange factor (VBR).
954
955 @item mepc @var{integer} (@emph{encoding,video})
956 Set motion estimation bitrate penalty compensation (1.0 = 256).
957
958 @item skip_loop_filter @var{integer} (@emph{decoding,video})
959 @item skip_idct        @var{integer} (@emph{decoding,video})
960 @item skip_frame       @var{integer} (@emph{decoding,video})
961
962 Make decoder discard processing depending on the frame type selected
963 by the option value.
964
965 @option{skip_loop_filter} skips frame loop filtering, @option{skip_idct}
966 skips frame IDCT/dequantization, @option{skip_frame} skips decoding.
967
968 Possible values:
969 @table @samp
970 @item none
971 Discard no frame.
972
973 @item default
974 Discard useless frames like 0-sized frames.
975
976 @item noref
977 Discard all non-reference frames.
978
979 @item bidir
980 Discard all bidirectional frames.
981
982 @item nokey
983 Discard all frames excepts keyframes.
984
985 @item all
986 Discard all frames.
987 @end table
988
989 Default value is @samp{default}.
990
991 @item bidir_refine @var{integer} (@emph{encoding,video})
992 Refine the two motion vectors used in bidirectional macroblocks.
993
994 @item brd_scale @var{integer} (@emph{encoding,video})
995 Downscale frames for dynamic B-frame decision.
996
997 @item keyint_min @var{integer} (@emph{encoding,video})
998 Set minimum interval between IDR-frames.
999
1000 @item refs @var{integer} (@emph{encoding,video})
1001 Set reference frames to consider for motion compensation.
1002
1003 @item chromaoffset @var{integer} (@emph{encoding,video})
1004 Set chroma qp offset from luma.
1005
1006 @item trellis @var{integer} (@emph{encoding,audio,video})
1007 Set rate-distortion optimal quantization.
1008
1009 @item sc_factor @var{integer} (@emph{encoding,video})
1010 Set value multiplied by qscale for each frame and added to
1011 scene_change_score.
1012
1013 @item mv0_threshold @var{integer} (@emph{encoding,video})
1014 @item b_sensitivity @var{integer} (@emph{encoding,video})
1015 Adjust sensitivity of b_frame_strategy 1.
1016
1017 @item compression_level @var{integer} (@emph{encoding,audio,video})
1018 @item min_prediction_order @var{integer} (@emph{encoding,audio})
1019 @item max_prediction_order @var{integer} (@emph{encoding,audio})
1020 @item timecode_frame_start @var{integer} (@emph{encoding,video})
1021 Set GOP timecode frame start number, in non drop frame format.
1022
1023 @item request_channels @var{integer} (@emph{decoding,audio})
1024 Set desired number of audio channels.
1025
1026 @item bits_per_raw_sample @var{integer}
1027 @item channel_layout @var{integer} (@emph{decoding/encoding,audio})
1028
1029 Possible values:
1030 @table @samp
1031 @end table
1032 @item request_channel_layout @var{integer} (@emph{decoding,audio})
1033
1034 Possible values:
1035 @table @samp
1036 @end table
1037 @item rc_max_vbv_use @var{float} (@emph{encoding,video})
1038 @item rc_min_vbv_use @var{float} (@emph{encoding,video})
1039 @item ticks_per_frame @var{integer} (@emph{decoding/encoding,audio,video})
1040 @item color_primaries @var{integer} (@emph{decoding/encoding,video})
1041 @item color_trc @var{integer} (@emph{decoding/encoding,video})
1042 @item colorspace @var{integer} (@emph{decoding/encoding,video})
1043 @item color_range @var{integer} (@emph{decoding/encoding,video})
1044 @item chroma_sample_location @var{integer} (@emph{decoding/encoding,video})
1045
1046 @item log_level_offset @var{integer}
1047 Set the log level offset.
1048
1049 @item slices @var{integer} (@emph{encoding,video})
1050 Number of slices, used in parallelized encoding.
1051
1052 @item thread_type @var{flags} (@emph{decoding/encoding,video})
1053 Select which multithreading methods to use.
1054
1055 Use of @samp{frame} will increase decoding delay by one frame per
1056 thread, so clients which cannot provide future frames should not use
1057 it.
1058
1059 Possible values:
1060 @table @samp
1061 @item slice
1062 Decode more than one part of a single frame at once.
1063
1064 Multithreading using slices works only when the video was encoded with
1065 slices.
1066
1067 @item frame
1068 Decode more than one frame at once.
1069 @end table
1070
1071 Default value is @samp{slice+frame}.
1072
1073 @item audio_service_type @var{integer} (@emph{encoding,audio})
1074 Set audio service type.
1075
1076 Possible values:
1077 @table @samp
1078 @item ma
1079 Main Audio Service
1080 @item ef
1081 Effects
1082 @item vi
1083 Visually Impaired
1084 @item hi
1085 Hearing Impaired
1086 @item di
1087 Dialogue
1088 @item co
1089 Commentary
1090 @item em
1091 Emergency
1092 @item vo
1093 Voice Over
1094 @item ka
1095 Karaoke
1096 @end table
1097
1098 @item request_sample_fmt @var{sample_fmt} (@emph{decoding,audio})
1099 Set sample format audio decoders should prefer. Default value is
1100 @code{none}.
1101
1102 @item pkt_timebase @var{rational number}
1103
1104 @item sub_charenc @var{encoding} (@emph{decoding,subtitles})
1105 Set the input subtitles character encoding.
1106
1107 @item field_order  @var{field_order} (@emph{video})
1108 Set/override the field order of the video.
1109 Possible values:
1110 @table @samp
1111 @item progressive
1112 Progressive video
1113 @item tt
1114 Interlaced video, top field coded and displayed first
1115 @item bb
1116 Interlaced video, bottom field coded and displayed first
1117 @item tb
1118 Interlaced video, top coded first, bottom displayed first
1119 @item bt
1120 Interlaced video, bottom coded first, top displayed first
1121 @end table
1122
1123 @item skip_alpha @var{integer} (@emph{decoding,video})
1124 Set to 1 to disable processing alpha (transparency). This works like the
1125 @samp{gray} flag in the @option{flags} option which skips chroma information
1126 instead of alpha. Default is 0.
1127
1128 @item codec_whitelist @var{list} (@emph{input})
1129 "," separated List of allowed decoders. By default all are allowed.
1130
1131 @item dump_separator @var{string} (@emph{input})
1132 Separator used to separate the fields printed on the command line about the
1133 Stream parameters.
1134 For example to separate the fields with newlines and indention:
1135 @example
1136 ffprobe -dump_separator "
1137                           "  -i ~/videos/matrixbench_mpeg2.mpg
1138 @end example
1139
1140 @end table
1141
1142 @c man end CODEC OPTIONS
1143
1144 @ifclear config-writeonly
1145 @include decoders.texi
1146 @end ifclear
1147 @ifclear config-readonly
1148 @include encoders.texi
1149 @end ifclear