annotate ffmpeg/doc/libswresample.pod @ 13:844d341cf643 tip

Back up before ISMIR

=head1 NAME

libswresample - audio resampling library

=head1 DESCRIPTION


The libswresample library performs highly optimized audio resampling,
rematrixing and sample format conversion operations.

Specifically, this library performs the following conversions:


=over 4


=item *

I<Resampling>: is the process of changing the audio rate, for
example from an high sample rate of 44100Hz to 8000Hz. Audio
conversion from high to low sample rate is a lossy process. Several
resampling options and algorithms are available.


=item *

I<Format conversion>: is the process of converting the type of
samples, for example from 16-bit signed samples to unsigned 8-bit or
float samples. It also handles packing conversion, when passing from
packed layout (all samples belonging to distinct channels interleaved
in the same buffer), to planar layout (all samples belonging to the
same channel stored in a dedicated buffer or "plane").


=item *

I<Rematrixing>: is the process of changing the channel layout, for
example from stereo to mono. When the input channels cannot be mapped
to the output streams, the process is lossy, since it involves
different gain factors and mixing.

=back


Various other audio conversions (e.g. stretching and padding) are
enabled through dedicated options.



=head1 SEE ALSO



ffmpeg(1), ffplay(1), ffprobe(1), ffserver(1),
ffmpeg-resampler(1),
libavutil(3)


=head1 AUTHORS


The FFmpeg developers.

For details about the authorship, see the Git history of the project
(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command
B<git log> in the FFmpeg source directory, or browsing the
online repository at E<lt>B<http://source.ffmpeg.org>E<gt>.

Maintainers for the specific components are listed in the file
F<MAINTAINERS> in the source code tree.