annotate src/libsndfile-1.0.27/man/sndfile-interleave.1 @ 83:ae30d91d2ffe

Replace these with versions built using an older toolset (so as to avoid ABI compatibilities when linking on Ubuntu 14.04 for packaging purposes)
author Chris Cannam
date Fri, 07 Feb 2020 11:51:13 +0000
parents 1df64224f5ac
children
rev   line source
Chris@40 1 .Dd November 2, 2014
Chris@40 2 .Dt SNDFILE-INTERLEAVE 1
Chris@40 3 .Os
Chris@40 4 .Sh NAME
Chris@40 5 .Nm sndfile-interleave ,
Chris@40 6 .Nm sndfile-deinterleave
Chris@40 7 .Nd convert mono files into a multi-channel file and vice versa
Chris@40 8 .Sh SYNOPSIS
Chris@40 9 .Nm sndfile-interleave
Chris@40 10 .Ar input1
Chris@40 11 .Ar input2
Chris@40 12 .Ar ...
Chris@40 13 .Fl o Ar output
Chris@40 14 .Nm sndfile-deinterleave
Chris@40 15 .Ar file
Chris@40 16 .Sh DESCRIPTION
Chris@40 17 .Nm sndfile-interleave
Chris@40 18 creates a multi-channel file taking audio data
Chris@40 19 from two or more mono files as individual channels.
Chris@40 20 The format of the output file is determined by its filename suffix.
Chris@40 21 The audio parameters of the output file will be made so that
Chris@40 22 the format can accommodate each of the mono inputs;
Chris@40 23 for example, the samplerate will be the maximal samplerate
Chris@40 24 occuring in the inputs.
Chris@40 25 The output file will be overwritten if it already exists.
Chris@40 26 .Pp
Chris@40 27 .Nm sndfile-deinterleave
Chris@40 28 creates two or more mono files from a multi-channel audio file,
Chris@40 29 containing data from the individual channels. The names of the
Chris@40 30 resulting mono files are of the form
Chris@40 31 .Dq name_XY.suf
Chris@40 32 where
Chris@40 33 .Em name
Chris@40 34 and
Chris@40 35 .Em suf
Chris@40 36 are the basename and suffix of the original file.
Chris@40 37 If any file of such name already exists, it will be overwritten.
Chris@40 38 Apart from the number of channels,
Chris@40 39 the audio format of the resulting mono files
Chris@40 40 is the same as that of the original file.
Chris@40 41 .Sh EXIT STATUS
Chris@40 42 .Ex -std
Chris@40 43 .Sh EXAMPLES
Chris@40 44 Merge a mono OGG file and a mono FLAC file into a stereo WAV file:
Chris@40 45 .Bd -literal -offset indent
Chris@40 46 $ sndfile-interleave left.ogg right.flac -o stereo.wav
Chris@40 47 .Ed
Chris@40 48 .Pp
Chris@40 49 Split a multi-channel into individual mono files:
Chris@40 50 .Bd -literal -offset indent
Chris@40 51 $ sndfile-deinterleave multi.wav
Chris@40 52 Input file : multi
Chris@40 53 Output files :
Chris@40 54 multi_00.wav
Chris@40 55 multi_01.wav
Chris@40 56 multi_02.wav
Chris@40 57 multi_03.wav
Chris@40 58 .Ed
Chris@40 59 .Sh SEE ALSO
Chris@40 60 .Lk http://www.mega-nerd.com/libsndfile/
Chris@40 61 .Sh AUTHORS
Chris@40 62 .An Erik de Castro Lopo Aq Mt erikd@mega-nerd.com