doc: add decoders.texi
[ffmpeg.git] / doc / decoders.texi
1 @chapter Decoders
2 @c man begin DECODERS
3
4 Decoders are configured elements in Libav which allow the decoding of
5 multimedia streams.
6
7 When you configure your Libav build, all the supported native decoders
8 are enabled by default. Decoders requiring an external library must be enabled
9 manually via the corresponding @code{--enable-lib} option. You can list all
10 available decoders using the configure option @code{--list-decoders}.
11
12 You can disable all the decoders with the configure option
13 @code{--disable-decoders} and selectively enable / disable single decoders
14 with the options @code{--enable-decoder=@var{DECODER}} /
15 @code{--disable-decoder=@var{DECODER}}.
16
17 The option @code{-decoders} of the av* tools will display the list of
18 enabled decoders.
19
20 @c man end DECODERS
21
22 @chapter Audio Decoders
23 @c man begin AUDIO DECODERS
24
25 A description of some of the currently available audio decoders
26 follows.
27
28 @section ac3
29
30 AC-3 audio decoder.
31
32 This decoder implements part of ATSC A/52:2010 and ETSI TS 102 366, as well as
33 the undocumented RealAudio 3 (a.k.a. dnet).
34
35 @subsubsection AC-3 Decoder Options
36
37 @table @option
38
39 @item -drc_scale @var{value}
40 Dynamic Range Scale Factor. The factor to apply to dynamic range values
41 from the AC-3 stream. This factor is applied exponentially.
42 There are 3 notable scale factor ranges:
43 @table @option
44 @item drc_scale == 0
45 DRC disabled. Produces full range audio.
46 @item 0 < drc_scale <= 1
47 DRC enabled.  Applies a fraction of the stream DRC value.
48 Audio reproduction is between full range and full compression.
49 @item drc_scale > 1
50 DRC enabled. Applies drc_scale asymmetrically.
51 Loud sounds are fully compressed.  Soft sounds are enhanced.
52 @end table
53
54 @end table
55
56 @c man end AUDIO DECODERS