Commit | Line | Data |
---|---|---|
2ba45a60 DM |
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 a 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 | @chapter See Also | |
48 | ||
49 | @ifhtml | |
50 | @url{ffmpeg.html,ffmpeg}, @url{ffplay.html,ffplay}, @url{ffprobe.html,ffprobe}, @url{ffserver.html,ffserver}, | |
51 | @url{ffmpeg-resampler.html,ffmpeg-resampler}, | |
52 | @url{libavutil.html,libavutil} | |
53 | @end ifhtml | |
54 | ||
55 | @ifnothtml | |
56 | ffmpeg(1), ffplay(1), ffprobe(1), ffserver(1), | |
57 | ffmpeg-resampler(1), | |
58 | libavutil(3) | |
59 | @end ifnothtml | |
60 | ||
61 | @include authors.texi | |
62 | ||
63 | @ignore | |
64 | ||
65 | @setfilename libswresample | |
66 | @settitle audio resampling library | |
67 | ||
68 | @end ignore | |
69 | ||
70 | @bye |