3 @c man begin CODEC OPTIONS
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.
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.
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
19 The list of supported options follow:
22 @item b @var{integer} (@emph{encoding,audio,video})
23 Set bitrate in bits/s. Default value is 200K.
25 @item ab @var{integer} (@emph{encoding,audio})
26 Set audio bitrate (in bits/s). Default value is 128K.
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.
34 @item flags @var{flags} (@emph{decoding/encoding,audio,video,subtitles})
40 Use four motion vector by macroblock (mpeg4).
42 Use 1/4 pel motion compensation.
48 Use internal 2pass ratecontrol in first pass mode.
50 Use internal 2pass ratecontrol in second pass mode.
52 Only decode/encode grayscale.
56 Set error[?] variables during encoding.
58 Input bitstream might be randomly truncated.
60 Don't output frames whose parameters differ from first decoded frame in stream.
61 Error AVERROR_INPUT_CHANGED is returned when a frame is dropped.
68 Place global headers in extradata instead of every keyframe.
70 Only write platform-, build- and time-independent data. (except (I)DCT).
71 This ensures that file and data checksums are reproducible and match between
72 platforms. Its primary use is for regression testing.
74 Apply H263 advanced intra coding / mpeg4 ac prediction.
76 Deprecated, use mpegvideo private options instead.
78 Deprecated, use mpegvideo private options instead.
80 Apply interlaced motion estimation.
84 Output even potentially corrupted frames.
87 @item me_method @var{integer} (@emph{encoding,video})
88 Set motion estimation method.
93 zero motion estimation (fastest)
95 full motion estimation (slowest)
97 EPZS motion estimation (default)
99 esa motion estimation (alias for full)
101 tesa motion estimation
103 dia motion estimation (alias for epzs)
105 log motion estimation
107 phods motion estimation
111 hex motion estimation
113 umh motion estimation
115 iter motion estimation
118 @item extradata_size @var{integer}
121 @item time_base @var{rational number}
124 It is the fundamental unit of time (in seconds) in terms of which
125 frame timestamps are represented. For fixed-fps content, timebase
126 should be @code{1 / frame_rate} and timestamp increments should be
129 @item g @var{integer} (@emph{encoding,video})
130 Set the group of picture (GOP) size. Default value is 12.
132 @item ar @var{integer} (@emph{decoding/encoding,audio})
133 Set audio sampling rate (in Hz).
135 @item ac @var{integer} (@emph{decoding/encoding,audio})
136 Set number of audio channels.
138 @item cutoff @var{integer} (@emph{encoding,audio})
139 Set cutoff bandwidth. (Supported only by selected encoders, see
140 their respective documentation sections.)
142 @item frame_size @var{integer} (@emph{encoding,audio})
143 Set audio frame size.
145 Each submitted frame except the last must contain exactly frame_size
146 samples per channel. May be 0 when the codec has
147 CODEC_CAP_VARIABLE_FRAME_SIZE set, in that case the frame size is not
148 restricted. It is set by some decoders to indicate constant frame
151 @item frame_number @var{integer}
152 Set the frame number.
154 @item delay @var{integer}
156 @item qcomp @var{float} (@emph{encoding,video})
157 Set video quantizer scale compression (VBR). It is used as a constant
158 in the ratecontrol equation. Recommended range for default rc_eq:
161 @item qblur @var{float} (@emph{encoding,video})
162 Set video quantizer scale blur (VBR).
164 @item qmin @var{integer} (@emph{encoding,video})
165 Set min video quantizer scale (VBR). Must be included between -1 and
166 69, default value is 2.
168 @item qmax @var{integer} (@emph{encoding,video})
169 Set max video quantizer scale (VBR). Must be included between -1 and
170 1024, default value is 31.
172 @item qdiff @var{integer} (@emph{encoding,video})
173 Set max difference between the quantizer scale (VBR).
175 @item bf @var{integer} (@emph{encoding,video})
176 Set max number of B frames between non-B-frames.
178 Must be an integer between -1 and 16. 0 means that B-frames are
179 disabled. If a value of -1 is used, it will choose an automatic value
180 depending on the encoder.
184 @item b_qfactor @var{float} (@emph{encoding,video})
185 Set qp factor between P and B frames.
187 @item rc_strategy @var{integer} (@emph{encoding,video})
188 Set ratecontrol method.
190 @item b_strategy @var{integer} (@emph{encoding,video})
191 Set strategy to choose between I/P/B-frames.
193 @item ps @var{integer} (@emph{encoding,video})
194 Set RTP payload size in bytes.
196 @item mv_bits @var{integer}
197 @item header_bits @var{integer}
198 @item i_tex_bits @var{integer}
199 @item p_tex_bits @var{integer}
200 @item i_count @var{integer}
201 @item p_count @var{integer}
202 @item skip_count @var{integer}
203 @item misc_bits @var{integer}
204 @item frame_bits @var{integer}
205 @item codec_tag @var{integer}
206 @item bug @var{flags} (@emph{decoding,video})
207 Workaround not auto detected encoder bugs.
214 some old lavc generated msmpeg4v3 files (no autodetection)
216 Xvid interlacing bug (autodetected if fourcc==XVIX)
218 (autodetected if fourcc==UMP4)
220 padding bug (autodetected)
224 illegal vlc bug (autodetected per fourcc)
228 old standard qpel (autodetected per fourcc/version)
231 @item direct_blocksize
232 direct-qpel-blocksize bug (autodetected per fourcc/version)
234 edge padding bug (autodetected per fourcc/version)
240 Workaround various bugs in microsoft broken decoders.
245 @item lelim @var{integer} (@emph{encoding,video})
246 Set single coefficient elimination threshold for luminance (negative
247 values also consider DC coefficient).
249 @item celim @var{integer} (@emph{encoding,video})
250 Set single coefficient elimination threshold for chrominance (negative
251 values also consider dc coefficient)
253 @item strict @var{integer} (@emph{decoding/encoding,audio,video})
254 Specify how strictly to follow the standards.
259 strictly conform to an older more strict version of the spec or reference software
261 strictly conform to all the things in the spec no matter what consequences
265 allow unofficial extensions
267 allow non standardized experimental things, experimental
268 (unfinished/work in progress/not well tested) decoders and encoders.
269 Note: experimental decoders can pose a security risk, do not use this for
270 decoding untrusted input.
273 @item b_qoffset @var{float} (@emph{encoding,video})
274 Set QP offset between P and B frames.
276 @item err_detect @var{flags} (@emph{decoding,audio,video})
277 Set error detection flags.
284 detect bitstream specification deviations
286 detect improper bitstream length
288 abort decoding on minor error detection
290 ignore decoding errors, and continue decoding.
291 This is useful if you want to analyze the content of a video and thus want
292 everything to be decoded no matter what. This option will not result in a video
293 that is pleasing to watch in case of errors.
295 consider things that violate the spec and have not been seen in the wild as errors
297 consider all spec non compliancies as errors
299 consider things that a sane encoder should not do as an error
302 @item has_b_frames @var{integer}
304 @item block_align @var{integer}
306 @item mpeg_quant @var{integer} (@emph{encoding,video})
307 Use MPEG quantizers instead of H.263.
309 @item qsquish @var{float} (@emph{encoding,video})
310 How to keep quantizer between qmin and qmax (0 = clip, 1 = use
311 differentiable function).
313 @item rc_qmod_amp @var{float} (@emph{encoding,video})
314 Set experimental quantizer modulation.
316 @item rc_qmod_freq @var{integer} (@emph{encoding,video})
317 Set experimental quantizer modulation.
319 @item rc_override_count @var{integer}
321 @item rc_eq @var{string} (@emph{encoding,video})
322 Set rate control equation. When computing the expression, besides the
323 standard functions defined in the section 'Expression Evaluation', the
324 following functions are available: bits2qp(bits), qp2bits(qp). Also
325 the following constants are available: iTex pTex tex mv fCode iCount
326 mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex
329 @item maxrate @var{integer} (@emph{encoding,audio,video})
330 Set max bitrate tolerance (in bits/s). Requires bufsize to be set.
332 @item minrate @var{integer} (@emph{encoding,audio,video})
333 Set min bitrate tolerance (in bits/s). Most useful in setting up a CBR
334 encode. It is of little use elsewise.
336 @item bufsize @var{integer} (@emph{encoding,audio,video})
337 Set ratecontrol buffer size (in bits).
339 @item rc_buf_aggressivity @var{float} (@emph{encoding,video})
342 @item i_qfactor @var{float} (@emph{encoding,video})
343 Set QP factor between P and I frames.
345 @item i_qoffset @var{float} (@emph{encoding,video})
346 Set QP offset between P and I frames.
348 @item rc_init_cplx @var{float} (@emph{encoding,video})
349 Set initial complexity for 1-pass encoding.
351 @item dct @var{integer} (@emph{encoding,video})
357 autoselect a good one (default)
367 floating point AAN DCT
370 @item lumi_mask @var{float} (@emph{encoding,video})
371 Compress bright areas stronger than medium ones.
373 @item tcplx_mask @var{float} (@emph{encoding,video})
374 Set temporal complexity masking.
376 @item scplx_mask @var{float} (@emph{encoding,video})
377 Set spatial complexity masking.
379 @item p_mask @var{float} (@emph{encoding,video})
382 @item dark_mask @var{float} (@emph{encoding,video})
383 Compress dark areas stronger than medium ones.
385 @item idct @var{integer} (@emph{decoding/encoding,video})
386 Select IDCT implementation.
399 Automatically pick a IDCT compatible with the simple one
422 floating point AAN IDCT
425 @item slice_count @var{integer}
427 @item ec @var{flags} (@emph{decoding,video})
428 Set error concealment strategy.
433 iterative motion vector (MV) search (slow)
435 use strong deblock filter for damaged MBs
437 favor predicting from the previous frame instead of the current
440 @item bits_per_coded_sample @var{integer}
442 @item pred @var{integer} (@emph{encoding,video})
443 Set prediction method.
455 @item aspect @var{rational number} (@emph{encoding,video})
456 Set sample aspect ratio.
458 @item sar @var{rational number} (@emph{encoding,video})
459 Set sample aspect ratio. Alias to @var{aspect}.
461 @item debug @var{flags} (@emph{decoding/encoding,audio,video,subtitles})
462 Print specific debug info.
475 per-block quantization parameter (QP)
479 display complexity metadata for the upcoming frame, GoP or for a given duration.
488 memory management control operations (H.264)
492 picture buffer allocations
496 skip motion compensation
499 @item cmp @var{integer} (@emph{encoding,video})
500 Set full pel me compare function.
505 sum of absolute differences, fast (default)
507 sum of squared errors
509 sum of absolute Hadamard transformed differences
511 sum of absolute DCT transformed differences
513 sum of squared quantization errors (avoid, low quality)
515 number of bits needed for the block
517 rate distortion optimal, slow
521 sum of absolute vertical differences
523 sum of squared vertical differences
525 noise preserving sum of squared differences
527 5/3 wavelet, only used in snow
529 9/7 wavelet, only used in snow
536 @item subcmp @var{integer} (@emph{encoding,video})
537 Set sub pel me compare function.
542 sum of absolute differences, fast (default)
544 sum of squared errors
546 sum of absolute Hadamard transformed differences
548 sum of absolute DCT transformed differences
550 sum of squared quantization errors (avoid, low quality)
552 number of bits needed for the block
554 rate distortion optimal, slow
558 sum of absolute vertical differences
560 sum of squared vertical differences
562 noise preserving sum of squared differences
564 5/3 wavelet, only used in snow
566 9/7 wavelet, only used in snow
573 @item mbcmp @var{integer} (@emph{encoding,video})
574 Set macroblock compare function.
579 sum of absolute differences, fast (default)
581 sum of squared errors
583 sum of absolute Hadamard transformed differences
585 sum of absolute DCT transformed differences
587 sum of squared quantization errors (avoid, low quality)
589 number of bits needed for the block
591 rate distortion optimal, slow
595 sum of absolute vertical differences
597 sum of squared vertical differences
599 noise preserving sum of squared differences
601 5/3 wavelet, only used in snow
603 9/7 wavelet, only used in snow
610 @item ildctcmp @var{integer} (@emph{encoding,video})
611 Set interlaced dct compare function.
616 sum of absolute differences, fast (default)
618 sum of squared errors
620 sum of absolute Hadamard transformed differences
622 sum of absolute DCT transformed differences
624 sum of squared quantization errors (avoid, low quality)
626 number of bits needed for the block
628 rate distortion optimal, slow
632 sum of absolute vertical differences
634 sum of squared vertical differences
636 noise preserving sum of squared differences
638 5/3 wavelet, only used in snow
640 9/7 wavelet, only used in snow
647 @item dia_size @var{integer} (@emph{encoding,video})
648 Set diamond type & size for motion estimation.
650 @item last_pred @var{integer} (@emph{encoding,video})
651 Set amount of motion predictors from the previous frame.
653 @item preme @var{integer} (@emph{encoding,video})
654 Set pre motion estimation.
656 @item precmp @var{integer} (@emph{encoding,video})
657 Set pre motion estimation compare function.
662 sum of absolute differences, fast (default)
664 sum of squared errors
666 sum of absolute Hadamard transformed differences
668 sum of absolute DCT transformed differences
670 sum of squared quantization errors (avoid, low quality)
672 number of bits needed for the block
674 rate distortion optimal, slow
678 sum of absolute vertical differences
680 sum of squared vertical differences
682 noise preserving sum of squared differences
684 5/3 wavelet, only used in snow
686 9/7 wavelet, only used in snow
693 @item pre_dia_size @var{integer} (@emph{encoding,video})
694 Set diamond type & size for motion estimation pre-pass.
696 @item subq @var{integer} (@emph{encoding,video})
697 Set sub pel motion estimation quality.
699 @item dtg_active_format @var{integer}
701 @item me_range @var{integer} (@emph{encoding,video})
702 Set limit motion vectors range (1023 for DivX player).
704 @item ibias @var{integer} (@emph{encoding,video})
705 Set intra quant bias.
707 @item pbias @var{integer} (@emph{encoding,video})
708 Set inter quant bias.
710 @item color_table_id @var{integer}
712 @item global_quality @var{integer} (@emph{encoding,audio,video})
714 @item coder @var{integer} (@emph{encoding,video})
719 variable length coder / huffman coder
730 @item context @var{integer} (@emph{encoding,video})
733 @item slice_flags @var{integer}
735 @item mbd @var{integer} (@emph{encoding,video})
736 Set macroblock decision algorithm (high quality mode).
745 use best rate distortion
748 @item stream_codec_tag @var{integer}
750 @item sc_threshold @var{integer} (@emph{encoding,video})
751 Set scene change threshold.
753 @item lmin @var{integer} (@emph{encoding,video})
754 Set min lagrange factor (VBR).
756 @item lmax @var{integer} (@emph{encoding,video})
757 Set max lagrange factor (VBR).
759 @item nr @var{integer} (@emph{encoding,video})
762 @item rc_init_occupancy @var{integer} (@emph{encoding,video})
763 Set number of bits which should be loaded into the rc buffer before
766 @item flags2 @var{flags} (@emph{decoding/encoding,audio,video,subtitles})
771 Allow non spec compliant speedup tricks.
773 Skip bitstream encoding.
775 Ignore cropping information from sps.
777 Place global headers at every keyframe instead of in extradata.
779 Frame data might be split into multiple chunks.
781 Show all frames before the first keyframe.
783 Export motion vectors into frame side-data (see @code{AV_FRAME_DATA_MOTION_VECTORS})
784 for codecs that support it. See also @file{doc/examples/export_mvs.c}.
786 Do not skip samples and export skip information as frame side data.
787 @item ass_ro_flush_noop
788 Do not reset ASS ReadOrder field on flush.
791 @item export_side_data @var{flags} (@emph{decoding/encoding,audio,video,subtitles})
796 Export motion vectors into frame side-data (see @code{AV_FRAME_DATA_MOTION_VECTORS})
797 for codecs that support it. See also @file{doc/examples/export_mvs.c}.
799 Export encoder Producer Reference Time into packet side-data (see @code{AV_PKT_DATA_PRFT})
800 for codecs that support it.
803 @item error @var{integer} (@emph{encoding,video})
805 @item qns @var{integer} (@emph{encoding,video})
806 Deprecated, use mpegvideo private options instead.
808 @item threads @var{integer} (@emph{decoding/encoding,video})
809 Set the number of threads to be used, in case the selected codec
810 implementation supports multi-threading.
815 automatically select the number of threads to set
818 Default value is @samp{auto}.
820 @item me_threshold @var{integer} (@emph{encoding,video})
821 Set motion estimation threshold.
823 @item mb_threshold @var{integer} (@emph{encoding,video})
824 Set macroblock threshold.
826 @item dc @var{integer} (@emph{encoding,video})
827 Set intra_dc_precision.
829 @item nssew @var{integer} (@emph{encoding,video})
832 @item skip_top @var{integer} (@emph{decoding,video})
833 Set number of macroblock rows at the top which are skipped.
835 @item skip_bottom @var{integer} (@emph{decoding,video})
836 Set number of macroblock rows at the bottom which are skipped.
838 @item profile @var{integer} (@emph{encoding,audio,video})
864 Encoder specific profiles are documented in the relevant encoder documentation.
866 @item level @var{integer} (@emph{encoding,audio,video})
874 @item lowres @var{integer} (@emph{decoding,audio,video})
875 Decode at 1= 1/2, 2=1/4, 3=1/8 resolutions.
877 @item skip_threshold @var{integer} (@emph{encoding,video})
878 Set frame skip threshold.
880 @item skip_factor @var{integer} (@emph{encoding,video})
881 Set frame skip factor.
883 @item skip_exp @var{integer} (@emph{encoding,video})
884 Set frame skip exponent.
885 Negative values behave identical to the corresponding positive ones, except
886 that the score is normalized.
887 Positive values exist primarily for compatibility reasons and are not so useful.
889 @item skipcmp @var{integer} (@emph{encoding,video})
890 Set frame skip compare function.
895 sum of absolute differences, fast (default)
897 sum of squared errors
899 sum of absolute Hadamard transformed differences
901 sum of absolute DCT transformed differences
903 sum of squared quantization errors (avoid, low quality)
905 number of bits needed for the block
907 rate distortion optimal, slow
911 sum of absolute vertical differences
913 sum of squared vertical differences
915 noise preserving sum of squared differences
917 5/3 wavelet, only used in snow
919 9/7 wavelet, only used in snow
926 @item border_mask @var{float} (@emph{encoding,video})
927 Increase the quantizer for macroblocks close to borders.
929 @item mblmin @var{integer} (@emph{encoding,video})
930 Set min macroblock lagrange factor (VBR).
932 @item mblmax @var{integer} (@emph{encoding,video})
933 Set max macroblock lagrange factor (VBR).
935 @item mepc @var{integer} (@emph{encoding,video})
936 Set motion estimation bitrate penalty compensation (1.0 = 256).
938 @item skip_loop_filter @var{integer} (@emph{decoding,video})
939 @item skip_idct @var{integer} (@emph{decoding,video})
940 @item skip_frame @var{integer} (@emph{decoding,video})
942 Make decoder discard processing depending on the frame type selected
945 @option{skip_loop_filter} skips frame loop filtering, @option{skip_idct}
946 skips frame IDCT/dequantization, @option{skip_frame} skips decoding.
954 Discard useless frames like 0-sized frames.
957 Discard all non-reference frames.
960 Discard all bidirectional frames.
963 Discard all frames excepts keyframes.
966 Discard all frames except I frames.
972 Default value is @samp{default}.
974 @item bidir_refine @var{integer} (@emph{encoding,video})
975 Refine the two motion vectors used in bidirectional macroblocks.
977 @item brd_scale @var{integer} (@emph{encoding,video})
978 Downscale frames for dynamic B-frame decision.
980 @item keyint_min @var{integer} (@emph{encoding,video})
981 Set minimum interval between IDR-frames.
983 @item refs @var{integer} (@emph{encoding,video})
984 Set reference frames to consider for motion compensation.
986 @item chromaoffset @var{integer} (@emph{encoding,video})
987 Set chroma qp offset from luma.
989 @item trellis @var{integer} (@emph{encoding,audio,video})
990 Set rate-distortion optimal quantization.
992 @item mv0_threshold @var{integer} (@emph{encoding,video})
993 @item b_sensitivity @var{integer} (@emph{encoding,video})
994 Adjust sensitivity of b_frame_strategy 1.
996 @item compression_level @var{integer} (@emph{encoding,audio,video})
997 @item min_prediction_order @var{integer} (@emph{encoding,audio})
998 @item max_prediction_order @var{integer} (@emph{encoding,audio})
999 @item timecode_frame_start @var{integer} (@emph{encoding,video})
1000 Set GOP timecode frame start number, in non drop frame format.
1002 @item request_channels @var{integer} (@emph{decoding,audio})
1003 Set desired number of audio channels.
1005 @item bits_per_raw_sample @var{integer}
1006 @item channel_layout @var{integer} (@emph{decoding/encoding,audio})
1011 @item request_channel_layout @var{integer} (@emph{decoding,audio})
1016 @item rc_max_vbv_use @var{float} (@emph{encoding,video})
1017 @item rc_min_vbv_use @var{float} (@emph{encoding,video})
1018 @item ticks_per_frame @var{integer} (@emph{decoding/encoding,audio,video})
1020 @item color_primaries @var{integer} (@emph{decoding/encoding,video})
1048 @item color_trc @var{integer} (@emph{decoding/encoding,video})
1093 @item colorspace @var{integer} (@emph{decoding/encoding,video})
1120 @item color_range @var{integer} (@emph{decoding/encoding,video})
1121 If used as input parameter, it serves as a hint to the decoder, which
1122 color_range the input has.
1133 @item chroma_sample_location @var{integer} (@emph{decoding/encoding,video})
1150 @item log_level_offset @var{integer}
1151 Set the log level offset.
1153 @item slices @var{integer} (@emph{encoding,video})
1154 Number of slices, used in parallelized encoding.
1156 @item thread_type @var{flags} (@emph{decoding/encoding,video})
1157 Select which multithreading methods to use.
1159 Use of @samp{frame} will increase decoding delay by one frame per
1160 thread, so clients which cannot provide future frames should not use
1166 Decode more than one part of a single frame at once.
1168 Multithreading using slices works only when the video was encoded with
1172 Decode more than one frame at once.
1175 Default value is @samp{slice+frame}.
1177 @item audio_service_type @var{integer} (@emph{encoding,audio})
1178 Set audio service type.
1202 @item request_sample_fmt @var{sample_fmt} (@emph{decoding,audio})
1203 Set sample format audio decoders should prefer. Default value is
1206 @item pkt_timebase @var{rational number}
1208 @item sub_charenc @var{encoding} (@emph{decoding,subtitles})
1209 Set the input subtitles character encoding.
1211 @item field_order @var{field_order} (@emph{video})
1212 Set/override the field order of the video.
1218 Interlaced video, top field coded and displayed first
1220 Interlaced video, bottom field coded and displayed first
1222 Interlaced video, top coded first, bottom displayed first
1224 Interlaced video, bottom coded first, top displayed first
1227 @item skip_alpha @var{bool} (@emph{decoding,video})
1228 Set to 1 to disable processing alpha (transparency). This works like the
1229 @samp{gray} flag in the @option{flags} option which skips chroma information
1230 instead of alpha. Default is 0.
1232 @item codec_whitelist @var{list} (@emph{input})
1233 "," separated list of allowed decoders. By default all are allowed.
1235 @item dump_separator @var{string} (@emph{input})
1236 Separator used to separate the fields printed on the command line about the
1238 For example, to separate the fields with newlines and indentation:
1240 ffprobe -dump_separator "
1241 " -i ~/videos/matrixbench_mpeg2.mpg
1244 @item max_pixels @var{integer} (@emph{decoding/encoding,video})
1245 Maximum number of pixels per image. This value can be used to avoid out of
1246 memory failures due to large images.
1248 @item apply_cropping @var{bool} (@emph{decoding,video})
1249 Enable cropping if cropping parameters are multiples of the required
1250 alignment for the left and top parameters. If the alignment is not met the
1251 cropping will be partially applied to maintain alignment.
1252 Default is 1 (enabled).
1253 Note: The required alignment depends on if @code{AV_CODEC_FLAG_UNALIGNED} is set and the
1254 CPU. @code{AV_CODEC_FLAG_UNALIGNED} cannot be changed from the command line. Also hardware
1255 decoders will not apply left/top Cropping.
1260 @c man end CODEC OPTIONS
1262 @ifclear config-writeonly
1263 @include decoders.texi
1265 @ifclear config-readonly
1266 @include encoders.texi