SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from Fedora Other ffmpeg-4.1.4-2.fc30.x86_64.rpm

FFMPEG-CODECS

Section: (1)
Updated:
Index 

NAME

ffmpeg-codecs - FFmpeg codecs 

DESCRIPTION

This document describes the codecs (decoders and encoders) provided bythe libavcodec library. 

CODEC OPTIONS

libavcodec provides some generic global options, which can be set onall the encoders and decoders. In addition each codec may supportso-called private options, which are specific for a given codec.

Sometimes, a global option may only affect a specific kind of codec,and may be nonsensical or ignored by another, so you need to be awareof the meaning of the specified options. Also some options aremeant only for decoding or encoding.

Options may be set by specifying -option value in theFFmpeg tools, or by setting the value explicitly in the"AVCodecContext" options or using the libavutil/opt.h APIfor programmatic use.

The list of supported options follow:

b integer (encoding,audio,video)
Set bitrate in bits/s. Default value is 200K.
ab integer (encoding,audio)
Set audio bitrate (in bits/s). Default value is 128K.
bt integer (encoding,video)
Set video bitrate tolerance (in bits/s). In 1-pass mode, bitratetolerance specifies how far ratecontrol is willing to deviate from thetarget average bitrate value. This is not related to min/maxbitrate. Lowering tolerance too much has an adverse effect on quality.
flags flags (decoding/encoding,audio,video,subtitles)
Set generic flags.

Possible values:

mv4
Use four motion vector by macroblock (mpeg4).
qpel
Use 1/4 pel motion compensation.
loop
Use loop filter.
qscale
Use fixed qscale.
pass1
Use internal 2pass ratecontrol in first pass mode.
pass2
Use internal 2pass ratecontrol in second pass mode.
gray
Only decode/encode grayscale.
emu_edge
Do not draw edges.
psnr
Set error[?] variables during encoding.
truncated
ildct
Use interlaced DCT.
low_delay
Force low delay.
global_header
Place global headers in extradata instead of every keyframe.
bitexact
Only write platform-, build- and time-independent data. (except (I)DCT).This ensures that file and data checksums are reproducible and match betweenplatforms. Its primary use is for regression testing.
aic
Apply H263 advanced intra coding / mpeg4 ac prediction.
cbp
Deprecated, use mpegvideo private options instead.
qprd
Deprecated, use mpegvideo private options instead.
ilme
Apply interlaced motion estimation.
cgop
Use closed gop.
me_method integer (encoding,video)
Set motion estimation method.

Possible values:

zero
zero motion estimation (fastest)
full
full motion estimation (slowest)
epzs
EPZS motion estimation (default)
esa
esa motion estimation (alias for full)
tesa
tesa motion estimation
dia
dia motion estimation (alias for epzs)
log
log motion estimation
phods
phods motion estimation
x1
X1 motion estimation
hex
hex motion estimation
umh
umh motion estimation
iter
iter motion estimation
extradata_size integer
Set extradata size.
time_base rational number
Set codec time base.

It is the fundamental unit of time (in seconds) in terms of whichframe timestamps are represented. For fixed-fps content, timebaseshould be "1 / frame_rate" and timestamp increments should beidentically 1.

g integer (encoding,video)
Set the group of picture (GOP) size. Default value is 12.
ar integer (decoding/encoding,audio)
Set audio sampling rate (in Hz).
ac integer (decoding/encoding,audio)
Set number of audio channels.
cutoff integer (encoding,audio)
Set cutoff bandwidth. (Supported only by selected encoders, seetheir respective documentation sections.)
frame_size integer (encoding,audio)
Set audio frame size.

Each submitted frame except the last must contain exactly frame_sizesamples per channel. May be 0 when the codec hasCODEC_CAP_VARIABLE_FRAME_SIZE set, in that case the frame size is notrestricted. It is set by some decoders to indicate constant framesize.

frame_number integer
Set the frame number.
delay integer
qcomp float (encoding,video)
Set video quantizer scale compression (VBR). It is used as a constantin the ratecontrol equation. Recommended range for default rc_eq:0.0-1.0.
qblur float (encoding,video)
Set video quantizer scale blur (VBR).
qmin integer (encoding,video)
Set min video quantizer scale (VBR). Must be included between -1 and69, default value is 2.
qmax integer (encoding,video)
Set max video quantizer scale (VBR). Must be included between -1 and1024, default value is 31.
qdiff integer (encoding,video)
Set max difference between the quantizer scale (VBR).
bf integer (encoding,video)
Set max number of B frames between non-B-frames.

Must be an integer between -1 and 16. 0 means that B-frames aredisabled. If a value of -1 is used, it will choose an automatic valuedepending on the encoder.

Default value is 0.

b_qfactor float (encoding,video)
Set qp factor between P and B frames.
rc_strategy integer (encoding,video)
Set ratecontrol method.
b_strategy integer (encoding,video)
Set strategy to choose between I/P/B-frames.
ps integer (encoding,video)
Set RTP payload size in bytes.
mv_bits integer
header_bits integer
i_tex_bits integer
p_tex_bits integer
i_count integer
p_count integer
skip_count integer
misc_bits integer
frame_bits integer
codec_tag integer
bug flags (decoding,video)
Workaround not auto detected encoder bugs.

Possible values:

autodetect
old_msmpeg4
some old lavc generated msmpeg4v3 files (no autodetection)
xvid_ilace
Xvid interlacing bug (autodetected if fourcc==XVIX)
ump4
(autodetected if fourcc==UMP4)
no_padding
padding bug (autodetected)
amv
ac_vlc
illegal vlc bug (autodetected per fourcc)
qpel_chroma
std_qpel
old standard qpel (autodetected per fourcc/version)
qpel_chroma2
direct_blocksize
direct-qpel-blocksize bug (autodetected per fourcc/version)
edge
edge padding bug (autodetected per fourcc/version)
hpel_chroma
dc_clip
ms
Workaround various bugs in microsoft broken decoders.
trunc
trancated frames
lelim integer (encoding,video)
Set single coefficient elimination threshold for luminance (negativevalues also consider DC coefficient).
celim integer (encoding,video)
Set single coefficient elimination threshold for chrominance (negativevalues also consider dc coefficient)
strict integer (decoding/encoding,audio,video)
Specify how strictly to follow the standards.

Possible values:

very
strictly conform to an older more strict version of the spec or reference software
strict
strictly conform to all the things in the spec no matter what consequences
normal
unofficial
allow unofficial extensions
experimental
allow non standardized experimental things, experimental(unfinished/work in progress/not well tested) decoders and encoders.Note: experimental decoders can pose a security risk, do not use this fordecoding untrusted input.
b_qoffset float (encoding,video)
Set QP offset between P and B frames.
err_detect flags (decoding,audio,video)
Set error detection flags.

Possible values:

crccheck
verify embedded CRCs
bitstream
detect bitstream specification deviations
buffer
detect improper bitstream length
explode
abort decoding on minor error detection
ignore_err
ignore decoding errors, and continue decoding.This is useful if you want to analyze the content of a video and thus wanteverything to be decoded no matter what. This option will not result in a videothat is pleasing to watch in case of errors.
careful
consider things that violate the spec and have not been seen in the wild as errors
compliant
consider all spec non compliancies as errors
aggressive
consider things that a sane encoder should not do as an error
has_b_frames integer
block_align integer
mpeg_quant integer (encoding,video)
Use MPEG quantizers instead of H.263.
qsquish float (encoding,video)
How to keep quantizer between qmin and qmax (0 = clip, 1 = usedifferentiable function).
rc_qmod_amp float (encoding,video)
Set experimental quantizer modulation.
rc_qmod_freq integer (encoding,video)
Set experimental quantizer modulation.
rc_override_count integer
rc_eq string (encoding,video)
Set rate control equation. When computing the expression, besides thestandard functions defined in the section 'Expression Evaluation', thefollowing functions are available: bits2qp(bits), qp2bits(qp). Alsothe following constants are available: iTex pTex tex mv fCode iCountmcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTexavgTex.
maxrate integer (encoding,audio,video)
Set max bitrate tolerance (in bits/s). Requires bufsize to be set.
minrate integer (encoding,audio,video)
Set min bitrate tolerance (in bits/s). Most useful in setting up a CBRencode. It is of little use elsewise.
bufsize integer (encoding,audio,video)
Set ratecontrol buffer size (in bits).
rc_buf_aggressivity float (encoding,video)
Currently useless.
i_qfactor float (encoding,video)
Set QP factor between P and I frames.
i_qoffset float (encoding,video)
Set QP offset between P and I frames.
rc_init_cplx float (encoding,video)
Set initial complexity for 1-pass encoding.
dct integer (encoding,video)
Set DCT algorithm.

Possible values:

auto
autoselect a good one (default)
fastint
fast integer
int
accurate integer
mmx
altivec
faan
floating point AAN DCT
lumi_mask float (encoding,video)
Compress bright areas stronger than medium ones.
tcplx_mask float (encoding,video)
Set temporal complexity masking.
scplx_mask float (encoding,video)
Set spatial complexity masking.
p_mask float (encoding,video)
Set inter masking.
dark_mask float (encoding,video)
Compress dark areas stronger than medium ones.
idct integer (decoding/encoding,video)
Select IDCT implementation.

Possible values:

auto
int
simple
simplemmx
simpleauto
Automatically pick a IDCT compatible with the simple one
arm
altivec
sh4
simplearm
simplearmv5te
simplearmv6
simpleneon
simplealpha
ipp
xvidmmx
faani
floating point AAN IDCT
slice_count integer
ec flags (decoding,video)
Set error concealment strategy.

Possible values:

guess_mvs
iterative motion vector (MV) search (slow)
deblock
use strong deblock filter for damaged MBs
favor_inter
favor predicting from the previous frame instead of the current
bits_per_coded_sample integer
pred integer (encoding,video)
Set prediction method.

Possible values:

left
plane
median
aspect rational number (encoding,video)
Set sample aspect ratio.
sar rational number (encoding,video)
Set sample aspect ratio. Alias to aspect.
debug flags (decoding/encoding,audio,video,subtitles)
Print specific debug info.

Possible values:

pict
picture info
rc
rate control
bitstream
mb_type
macroblock (MB) type
qp
per-block quantization parameter (QP)
dct_coeff
green_metadata
display complexity metadata for the upcoming frame, GoP or for a given duration.
skip
startcode
er
error recognition
mmco
memory management control operations (H.264)
bugs
buffers
picture buffer allocations
thread_ops
threading operations
nomc
skip motion compensation
cmp integer (encoding,video)
Set full pel me compare function.

Possible values:

sad
sum of absolute differences, fast (default)
sse
sum of squared errors
satd
sum of absolute Hadamard transformed differences
dct
sum of absolute DCT transformed differences
psnr
sum of squared quantization errors (avoid, low quality)
bit
number of bits needed for the block
rd
rate distortion optimal, slow
zero
0
vsad
sum of absolute vertical differences
vsse
sum of squared vertical differences
nsse
noise preserving sum of squared differences
w53
5/3 wavelet, only used in snow
w97
9/7 wavelet, only used in snow
dctmax
chroma
subcmp integer (encoding,video)
Set sub pel me compare function.

Possible values:

sad
sum of absolute differences, fast (default)
sse
sum of squared errors
satd
sum of absolute Hadamard transformed differences
dct
sum of absolute DCT transformed differences
psnr
sum of squared quantization errors (avoid, low quality)
bit
number of bits needed for the block
rd
rate distortion optimal, slow
zero
0
vsad
sum of absolute vertical differences
vsse
sum of squared vertical differences
nsse
noise preserving sum of squared differences
w53
5/3 wavelet, only used in snow
w97
9/7 wavelet, only used in snow
dctmax
chroma
mbcmp integer (encoding,video)
Set macroblock compare function.

Possible values:

sad
sum of absolute differences, fast (default)
sse
sum of squared errors
satd
sum of absolute Hadamard transformed differences
dct
sum of absolute DCT transformed differences
psnr
sum of squared quantization errors (avoid, low quality)
bit
number of bits needed for the block
rd
rate distortion optimal, slow
zero
0
vsad
sum of absolute vertical differences
vsse
sum of squared vertical differences
nsse
noise preserving sum of squared differences
w53
5/3 wavelet, only used in snow
w97
9/7 wavelet, only used in snow
dctmax
chroma
ildctcmp integer (encoding,video)
Set interlaced dct compare function.

Possible values:

sad
sum of absolute differences, fast (default)
sse
sum of squared errors
satd
sum of absolute Hadamard transformed differences
dct
sum of absolute DCT transformed differences
psnr
sum of squared quantization errors (avoid, low quality)
bit
number of bits needed for the block
rd
rate distortion optimal, slow
zero
0
vsad
sum of absolute vertical differences
vsse
sum of squared vertical differences
nsse
noise preserving sum of squared differences
w53
5/3 wavelet, only used in snow
w97
9/7 wavelet, only used in snow
dctmax
chroma
dia_size integer (encoding,video)
Set diamond type & size for motion estimation.
last_pred integer (encoding,video)
Set amount of motion predictors from the previous frame.
preme integer (encoding,video)
Set pre motion estimation.
precmp integer (encoding,video)
Set pre motion estimation compare function.

Possible values:

sad
sum of absolute differences, fast (default)
sse
sum of squared errors
satd
sum of absolute Hadamard transformed differences
dct
sum of absolute DCT transformed differences
psnr
sum of squared quantization errors (avoid, low quality)
bit
number of bits needed for the block
rd
rate distortion optimal, slow
zero
0
vsad
sum of absolute vertical differences
vsse
sum of squared vertical differences
nsse
noise preserving sum of squared differences
w53
5/3 wavelet, only used in snow
w97
9/7 wavelet, only used in snow
dctmax
chroma
pre_dia_size integer (encoding,video)
Set diamond type & size for motion estimation pre-pass.
subq integer (encoding,video)
Set sub pel motion estimation quality.
dtg_active_format integer
me_range integer (encoding,video)
Set limit motion vectors range (1023 for DivX player).
ibias integer (encoding,video)
Set intra quant bias.
pbias integer (encoding,video)
Set inter quant bias.
color_table_id integer
global_quality integer (encoding,audio,video)
coder integer (encoding,video)
Possible values:
vlc
variable length coder / huffman coder
ac
arithmetic coder
raw
raw (no encoding)
rle
run-length coder
deflate
deflate-based coder
context integer (encoding,video)
Set context model.
slice_flags integer
mbd integer (encoding,video)
Set macroblock decision algorithm (high quality mode).

Possible values:

simple
use mbcmp (default)
bits
use fewest bits
rd
use best rate distortion
stream_codec_tag integer
sc_threshold integer (encoding,video)
Set scene change threshold.
lmin integer (encoding,video)
Set min lagrange factor (VBR).
lmax integer (encoding,video)
Set max lagrange factor (VBR).
nr integer (encoding,video)
Set noise reduction.
rc_init_occupancy integer (encoding,video)
Set number of bits which should be loaded into the rc buffer beforedecoding starts.
flags2 flags (decoding/encoding,audio,video)
Possible values:
fast
Allow non spec compliant speedup tricks.
sgop
Deprecated, use mpegvideo private options instead.
noout
Skip bitstream encoding.
ignorecrop
Ignore cropping information from sps.
local_header
Place global headers at every keyframe instead of in extradata.
chunks
Frame data might be split into multiple chunks.
showall
Show all frames before the first keyframe.
skiprd
Deprecated, use mpegvideo private options instead.
export_mvs
Export motion vectors into frame side-data (see "AV_FRAME_DATA_MOTION_VECTORS")for codecs that support it. See also doc/examples/export_mvs.c.
error integer (encoding,video)
qns integer (encoding,video)
Deprecated, use mpegvideo private options instead.
threads integer (decoding/encoding,video)
Set the number of threads to be used, in case the selected codecimplementation supports multi-threading.

Possible values:

auto, 0
automatically select the number of threads to set

Default value is auto.

me_threshold integer (encoding,video)
Set motion estimation threshold.
mb_threshold integer (encoding,video)
Set macroblock threshold.
dc integer (encoding,video)
Set intra_dc_precision.
nssew integer (encoding,video)
Set nsse weight.
skip_top integer (decoding,video)
Set number of macroblock rows at the top which are skipped.
skip_bottom integer (decoding,video)
Set number of macroblock rows at the bottom which are skipped.
profile integer (encoding,audio,video)
Possible values:
unknown
aac_main
aac_low
aac_ssr
aac_ltp
aac_he
aac_he_v2
aac_ld
aac_eld
mpeg2_aac_low
mpeg2_aac_he
mpeg4_sp
mpeg4_core
mpeg4_main
mpeg4_asp
dts
dts_es
dts_96_24
dts_hd_hra
dts_hd_ma
level integer (encoding,audio,video)
Possible values:
unknown
lowres integer (decoding,audio,video)
Decode at 1= 1/2, 2=1/4, 3=1/8 resolutions.
skip_threshold integer (encoding,video)
Set frame skip threshold.
skip_factor integer (encoding,video)
Set frame skip factor.
skip_exp integer (encoding,video)
Set frame skip exponent.Negative values behave identical to the corresponding positive ones, exceptthat the score is normalized.Positive values exist primarily for compatibility reasons and are not so useful.
skipcmp integer (encoding,video)
Set frame skip compare function.

Possible values:

sad
sum of absolute differences, fast (default)
sse
sum of squared errors
satd
sum of absolute Hadamard transformed differences
dct
sum of absolute DCT transformed differences
psnr
sum of squared quantization errors (avoid, low quality)
bit
number of bits needed for the block
rd
rate distortion optimal, slow
zero
0
vsad
sum of absolute vertical differences
vsse
sum of squared vertical differences
nsse
noise preserving sum of squared differences
w53
5/3 wavelet, only used in snow
w97
9/7 wavelet, only used in snow
dctmax
chroma
border_mask float (encoding,video)
Increase the quantizer for macroblocks close to borders.
mblmin integer (encoding,video)
Set min macroblock lagrange factor (VBR).
mblmax integer (encoding,video)
Set max macroblock lagrange factor (VBR).
mepc integer (encoding,video)
Set motion estimation bitrate penalty compensation (1.0 = 256).
skip_loop_filter integer (decoding,video)
skip_idct integer (decoding,video)
skip_frame integer (decoding,video)
Make decoder discard processing depending on the frame type selectedby the option value.

skip_loop_filter skips frame loop filtering, skip_idctskips frame IDCT/dequantization, skip_frame skips decoding.

Possible values:

none
Discard no frame.
default
Discard useless frames like 0-sized frames.
noref
Discard all non-reference frames.
bidir
Discard all bidirectional frames.
nokey
Discard all frames excepts keyframes.
all
Discard all frames.

Default value is default.

bidir_refine integer (encoding,video)
Refine the two motion vectors used in bidirectional macroblocks.
brd_scale integer (encoding,video)
Downscale frames for dynamic B-frame decision.
keyint_min integer (encoding,video)
Set minimum interval between IDR-frames.
refs integer (encoding,video)
Set reference frames to consider for motion compensation.
chromaoffset integer (encoding,video)
Set chroma qp offset from luma.
trellis integer (encoding,audio,video)
Set rate-distortion optimal quantization.
mv0_threshold integer (encoding,video)
b_sensitivity integer (encoding,video)
Adjust sensitivity of b_frame_strategy 1.
compression_level integer (encoding,audio,video)
min_prediction_order integer (encoding,audio)
max_prediction_order integer (encoding,audio)
timecode_frame_start integer (encoding,video)
Set GOP timecode frame start number, in non drop frame format.
request_channels integer (decoding,audio)
Set desired number of audio channels.
bits_per_raw_sample integer
channel_layout integer (decoding/encoding,audio)
Possible values:
request_channel_layout integer (decoding,audio)
Possible values:
rc_max_vbv_use float (encoding,video)
rc_min_vbv_use float (encoding,video)
ticks_per_frame integer (decoding/encoding,audio,video)
color_primaries integer (decoding/encoding,video)
Possible values:
bt709
BT.709
bt470m
BT.470 M
bt470bg
BT.470 BG
smpte170m
SMPTE 170 M
smpte240m
SMPTE 240 M
film
Film
bt2020
BT.2020
smpte428
smpte428_1
SMPTE ST 428-1
smpte431
SMPTE 431-2
smpte432
SMPTE 432-1
jedec-p22
JEDEC P22
color_trc integer (decoding/encoding,video)
Possible values:
bt709
BT.709
gamma22
BT.470 M
gamma28
BT.470 BG
smpte170m
SMPTE 170 M
smpte240m
SMPTE 240 M
linear
Linear
log
log100
Log
log_sqrt
log316
Log square root
iec61966_2_4
iec61966-2-4
IEC 61966-2-4
bt1361
bt1361e
BT.1361
iec61966_2_1
iec61966-2-1
IEC 61966-2-1
bt2020_10
bt2020_10bit
BT.2020 - 10 bit
bt2020_12
bt2020_12bit
BT.2020 - 12 bit
smpte2084
SMPTE ST 2084
smpte428
smpte428_1
SMPTE ST 428-1
arib-std-b67
ARIB STD-B67
colorspace integer (decoding/encoding,video)
Possible values:
rgb
RGB
bt709
BT.709
fcc
FCC
bt470bg
BT.470 BG
smpte170m
SMPTE 170 M
smpte240m
SMPTE 240 M
ycocg
YCOCG
bt2020nc
bt2020_ncl
BT.2020 NCL
bt2020c
bt2020_cl
BT.2020 CL
smpte2085
SMPTE 2085
color_range integer (decoding/encoding,video)
If used as input parameter, it serves as a hint to the decoder, whichcolor_range the input has.Possible values:
tv
mpeg
MPEG (219*2^(n-8))
pc
jpeg
JPEG (2^n-1)
chroma_sample_location integer (decoding/encoding,video)
Possible values:
left
center
topleft
top
bottomleft
bottom
log_level_offset integer
Set the log level offset.
slices integer (encoding,video)
Number of slices, used in parallelized encoding.
thread_type flags (decoding/encoding,video)
Select which multithreading methods to use.

Use of frame will increase decoding delay by one frame perthread, so clients which cannot provide future frames should not useit.

Possible values:

slice
Decode more than one part of a single frame at once.

Multithreading using slices works only when the video was encoded withslices.

frame
Decode more than one frame at once.

Default value is slice+frame.

audio_service_type integer (encoding,audio)
Set audio service type.

Possible values:

ma
Main Audio Service
ef
Effects
vi
Visually Impaired
hi
Hearing Impaired
di
Dialogue
co
Commentary
em
Emergency
vo
Voice Over
ka
Karaoke
request_sample_fmt sample_fmt (decoding,audio)
Set sample format audio decoders should prefer. Default value is"none".
pkt_timebase rational number
sub_charenc encoding (decoding,subtitles)
Set the input subtitles character encoding.
field_order field_order (video)
Set/override the field order of the video.Possible values:
progressive
Progressive video
tt
Interlaced video, top field coded and displayed first
bb
Interlaced video, bottom field coded and displayed first
tb
Interlaced video, top coded first, bottom displayed first
bt
Interlaced video, bottom coded first, top displayed first
skip_alpha bool (decoding,video)
Set to 1 to disable processing alpha (transparency). This works like thegray flag in the flags option which skips chroma informationinstead of alpha. Default is 0.
codec_whitelist list (input)
``,'' separated list of allowed decoders. By default all are allowed.
dump_separator string (input)
Separator used to separate the fields printed on the command line about theStream parameters.For example to separate the fields with newlines and indention:

        ffprobe -dump_separator "                                  "  -i ~/videos/matrixbench_mpeg2.mpg
max_pixels integer (decoding/encoding,video)
Maximum number of pixels per image. This value can be used to avoid out ofmemory failures due to large images.
apply_cropping bool (decoding,video)
Enable cropping if cropping parameters are multiples of the requiredalignment for the left and top parameters. If the alignment is not met thecropping will be partially applied to maintain alignment.Default is 1 (enabled).Note: The required alignment depends on if "AV_CODEC_FLAG_UNALIGNED" is set and theCPU. "AV_CODEC_FLAG_UNALIGNED" cannot be changed from the command line. Also hardwaredecoders will not apply left/top Cropping.
 

DECODERS

Decoders are configured elements in FFmpeg which allow the decoding ofmultimedia streams.

When you configure your FFmpeg build, all the supported native decodersare enabled by default. Decoders requiring an external library must be enabledmanually via the corresponding "--enable-lib" option. You can list allavailable decoders using the configure option "--list-decoders".

You can disable all the decoders with the configure option"--disable-decoders" and selectively enable / disable single decoderswith the options "--enable-decoder=DECODER" /"--disable-decoder=DECODER".

The option "-decoders" of the ff* tools will display the list ofenabled decoders. 

VIDEO DECODERS

A description of some of the currently available video decodersfollows. 

rawvideo

Raw video decoder.

This decoder decodes rawvideo streams.

Options

top top_field_first
Specify the assumed field type of the input video.
-1
the video is assumed to be progressive (default)
0
bottom-field-first is assumed
1
top-field-first is assumed
 

libdavs2

AVS2-P2/IEEE1857.4 video decoder wrapper.

This decoder allows libavcodec to decode AVS2 streams with davs2 library. 

AUDIO DECODERS

A description of some of the currently available audio decodersfollows. 

ac3

AC-3 audio decoder.

This decoder implements part of ATSC A/52:2010 and ETSI TS 102 366, as well asthe undocumented RealAudio 3 (a.k.a. dnet).

AC-3 Decoder Options

-drc_scale value
Dynamic Range Scale Factor. The factor to apply to dynamic range valuesfrom the AC-3 stream. This factor is applied exponentially.There are 3 notable scale factor ranges:
drc_scale == 0
DRC disabled. Produces full range audio.
0 < drc_scale <= 1
DRC enabled. Applies a fraction of the stream DRC value.Audio reproduction is between full range and full compression.
drc_scale > 1
DRC enabled. Applies drc_scale asymmetrically.Loud sounds are fully compressed. Soft sounds are enhanced.
 

flac

FLAC audio decoder.

This decoder aims to implement the complete FLAC specification from Xiph.

FLAC Decoder options

-use_buggy_lpc
The lavc FLAC encoder used to produce buggy streams with high lpc values(like the default value). This option makes it possible to decode such streamscorrectly by using lavc's old buggy lpc logic for decoding.
 

ffwavesynth

Internal wave synthesizer.

This decoder generates wave patterns according to predefined sequences. Itsuse is purely internal and the format of the data it accepts is not publiclydocumented. 

libcelt

libcelt decoder wrapper.

libcelt allows libavcodec to decode the Xiph CELT ultra-low delay audio codec.Requires the presence of the libcelt headers and library during configuration.You need to explicitly configure the build with "--enable-libcelt". 

libgsm

libgsm decoder wrapper.

libgsm allows libavcodec to decode the GSM full rate audio codec. Requiresthe presence of the libgsm headers and library during configuration. You needto explicitly configure the build with "--enable-libgsm".

This decoder supports both the ordinary GSM and the Microsoft variant. 

libilbc

libilbc decoder wrapper.

libilbc allows libavcodec to decode the Internet Low Bitrate Codec (iLBC)audio codec. Requires the presence of the libilbc headers and library duringconfiguration. You need to explicitly configure the build with"--enable-libilbc".

Options

The following option is supported by the libilbc wrapper.

enhance
Enable the enhancement of the decoded audio when set to 1. The defaultvalue is 0 (disabled).
 

libopencore-amrnb

libopencore-amrnb decoder wrapper.

libopencore-amrnb allows libavcodec to decode the Adaptive Multi-RateNarrowband audio codec. Using it requires the presence of thelibopencore-amrnb headers and library during configuration. You need toexplicitly configure the build with "--enable-libopencore-amrnb".

An FFmpeg native decoder for AMR-NB exists, so users can decode AMR-NBwithout this library. 

libopencore-amrwb

libopencore-amrwb decoder wrapper.

libopencore-amrwb allows libavcodec to decode the Adaptive Multi-RateWideband audio codec. Using it requires the presence of thelibopencore-amrwb headers and library during configuration. You need toexplicitly configure the build with "--enable-libopencore-amrwb".

An FFmpeg native decoder for AMR-WB exists, so users can decode AMR-WBwithout this library. 

libopus

libopus decoder wrapper.

libopus allows libavcodec to decode the Opus Interactive Audio Codec.Requires the presence of the libopus headers and library duringconfiguration. You need to explicitly configure the build with"--enable-libopus".

An FFmpeg native decoder for Opus exists, so users can decode Opuswithout this library. 

SUBTITLES DECODERS

 

dvbsub

Options
compute_clut
-1
Compute clut if no matching CLUT is in the stream.
0
Never compute CLUT
1
Always compute CLUT and override the one provided in the stream.
dvb_substream
Selects the dvb substream, or all substreams if -1 which is default.
 

dvdsub

This codec decodes the bitmap subtitles used in DVDs; the same subtitles canalso be found in VobSub file pairs and in some Matroska files.

Options

palette
Specify the global palette used by the bitmaps. When stored in VobSub, thepalette is normally specified in the index file; in Matroska, the palette isstored in the codec extra-data in the same format as in VobSub. In DVDs, thepalette is stored in the IFO file, and therefore not available when readingfrom dumped VOB files.

The format for this option is a string containing 16 24-bits hexadecimalnumbers (without 0x prefix) separated by comas, for example "0d00ee,ee450d, 101010, eaeaea, 0ce60b, ec14ed, ebff0b, 0d617a, 7b7b7b, d1d1d1,7b2a0e, 0d950c, 0f007b, cf0dec, cfa80c, 7c127b".

ifo_palette
Specify the IFO file from which the global palette is obtained.(experimental)
forced_subs_only
Only decode subtitle entries marked as forced. Some titles have forcedand non-forced subtitles in the same track. Setting this flag to 1will only keep the forced subtitles. Default value is 0.
 

libzvbi-teletext

Libzvbi allows libavcodec to decode DVB teletext pages and DVB teletextsubtitles. Requires the presence of the libzvbi headers and library duringconfiguration. You need to explicitly configure the build with"--enable-libzvbi".

Options

txt_page
List of teletext page numbers to decode. Pages that do not match the specifiedlist are dropped. You may use the special "*" string to match all pages,or "subtitle" to match all subtitle pages.Default value is *.
txt_chop_top
Discards the top teletext line. Default value is 1.
txt_format
Specifies the format of the decoded subtitles.
bitmap
The default format, you should use this for teletext pages, because certaingraphics and colors cannot be expressed in simple text or even ASS.
text
Simple text based output without formatting.
ass
Formatted ASS output, subtitle pages and teletext pages are returned indifferent styles, subtitle pages are stripped down to text, but an effort ismade to keep the text alignment and the formatting.
txt_left
X offset of generated bitmaps, default is 0.
txt_top
Y offset of generated bitmaps, default is 0.
txt_chop_spaces
Chops leading and trailing spaces and removes empty lines from the generatedtext. This option is useful for teletext based subtitles where empty spaces maybe present at the start or at the end of the lines or empty lines may bepresent between the subtitle lines because of double-sized teletext characters.Default value is 1.
txt_duration
Sets the display duration of the decoded teletext pages or subtitles inmilliseconds. Default value is -1 which means infinity or until the nextsubtitle event comes.
txt_transparent
Force transparent background of the generated teletext bitmaps. Default valueis 0 which means an opaque background.
txt_opacity
Sets the opacity (0-255) of the teletext background. Iftxt_transparent is not set, it only affects characters between a startbox and an end box, typically subtitles. Default value is 0 iftxt_transparent is set, 255 otherwise.
 

ENCODERS

Encoders are configured elements in FFmpeg which allow the encoding ofmultimedia streams.

When you configure your FFmpeg build, all the supported native encodersare enabled by default. Encoders requiring an external library must be enabledmanually via the corresponding "--enable-lib" option. You can list allavailable encoders using the configure option "--list-encoders".

You can disable all the encoders with the configure option"--disable-encoders" and selectively enable / disable single encoderswith the options "--enable-encoder=ENCODER" /"--disable-encoder=ENCODER".

The option "-encoders" of the ff* tools will display the list ofenabled encoders. 

AUDIO ENCODERS

A description of some of the currently available audio encodersfollows. 

aac

Advanced Audio Coding (AAC) encoder.

This encoder is the default AAC encoder, natively implemented into FFmpeg. Itsquality is on par or better than libfdk_aac at the default bitrate of 128kbps.This encoder also implements more options, profiles and samplerates thanother encoders (with only the AAC-HE profile pending to be implemented) so thisencoder has become the default and is the recommended choice.

Options

b
Set bit rate in bits/s. Setting this automatically activates constant bit rate(CBR) mode. If this option is unspecified it is set to 128kbps.
q
Set quality for variable bit rate (VBR) mode. This option is valid only usingthe ffmpeg command-line tool. For library interface users, useglobal_quality.
cutoff
Set cutoff frequency. If unspecified will allow the encoder to dynamicallyadjust the cutoff to improve clarity on low bitrates.
aac_coder
Set AAC encoder coding method. Possible values:
twoloop
Two loop searching (TLS) method.

This method first sets quantizers depending on band thresholds and then triesto find an optimal combination by adding or subtracting a specific value fromall quantizers and adjusting some individual quantizer a little. Will tuneitself based on whether aac_is, aac_ms and aac_pnsare enabled.

anmr
Average noise to mask ratio (ANMR) trellis-based solution.

This is an experimental coder which currently produces a lower quality, is moreunstable and is slower than the default twoloop coder but has potential.Currently has no support for the aac_is or aac_pns options.Not currently recommended.

fast
Constant quantizer method.

Uses a cheaper version of twoloop algorithm that doesn't try to do as manyclever adjustments. Worse with low bitrates (less than 64kbps), but is betterand much faster at higher bitrates.This is the default choice for a coder

aac_ms
Sets mid/side coding mode. The default value of ``auto'' will automatically useM/S with bands which will benefit from such coding. Can be forced for all bandsusing the value ``enable'', which is mainly useful for debugging or disabled using``disable''.
aac_is
Sets intensity stereo c