doc: use a common authors.texi file blurb
[ffmpeg.git] / doc / libswresample.texi
1 \input texinfo @c -*- texinfo -*-
2
3 @settitle Libswresample Documentation
4 @titlepage
5 @center @titlefont{Libswresample Documentation}
6 @end titlepage
7
8 @top
9
10 @contents
11
12 @chapter Description
13 @c man begin DESCRIPTION
14
15 The libswresample library performs highly optimized audio resampling,
16 rematrixing and sample format conversion operations.
17
18 Specifically, this library performs the following conversions:
19
20 @itemize
21 @item
22 @emph{Resampling}: is the process of changing the audio rate, for
23 example from an high sample rate of 44100Hz to 8000Hz. Audio
24 conversion from high to low sample rate is a lossy process. Several
25 resampling options and algorithms are available.
26
27 @item
28 @emph{Format conversion}: is the process of converting the type of
29 samples, for example from 16-bit signed samples to unsigned 8-bit or
30 float samples. It also handles packing conversion, when passing from
31 packed layout (all samples belonging to distinct channels interleaved
32 in the same buffer), to planar layout (all samples belonging to the
33 same channel stored in a dedicated buffer or "plane").
34
35 @item
36 @emph{Rematrixing}: is the process of changing the channel layout, for
37 example from stereo to mono. When the input channels cannot be mapped
38 to the output streams, the process is lossy, since it involves
39 different gain factors and mixing.
40 @end itemize
41
42 Various other audio conversions (e.g. stretching and padding) are
43 enabled through dedicated options.
44
45 @c man end DESCRIPTION
46
47 @include authors.texi
48
49 @ignore
50
51 @setfilename libswresample
52 @settitle audio resampling library
53
54 @c man begin SEEALSO
55 ffmpeg(1), ffplay(1), ffprobe(1), ffserver(1), ffmpeg-resampler(1), libavutil(3)
56 @c man end
57
58 @end ignore
59
60 @bye