comparison src/libsndfile-1.0.27/man/sndfile-interleave.1 @ 125:cd6cdf86811e

Current libsndfile source

+.Dd November 2, 2014
+.Dt SNDFILE-INTERLEAVE 1
+.Os
+.Sh NAME
+.Nm sndfile-interleave ,
+.Nm sndfile-deinterleave
+.Nd convert mono files into a multi-channel file and vice versa
+.Sh SYNOPSIS
+.Nm sndfile-interleave
+.Ar input1
+.Ar input2
+.Ar ...
+.Fl o Ar output
+.Nm sndfile-deinterleave
+.Ar file
+.Sh DESCRIPTION
+.Nm sndfile-interleave
+creates a multi-channel file taking audio data
+from two or more mono files as individual channels.
+The format of the output file is determined by its filename suffix.
+The audio parameters of the output file will be made so that
+the format can accommodate each of the mono inputs;
+for example, the samplerate will be the maximal samplerate
+occuring in the inputs.
+The output file will be overwritten if it already exists.
+.Pp
+.Nm sndfile-deinterleave
+creates two or more mono files from a multi-channel audio file,
+containing data from the individual channels. The names of the
+resulting mono files are of the form
+.Dq name_XY.suf
+where
+.Em name
+and
+.Em suf
+are the basename and suffix of the original file.
+If any file of such name already exists, it will be overwritten.
+Apart from the number of channels,
+the audio format of the resulting mono files
+is the same as that of the original file.
+.Sh EXIT STATUS
+.Ex -std
+.Sh EXAMPLES
+Merge a mono OGG file and a mono FLAC file into a stereo WAV file:
+.Bd -literal -offset indent
+$ sndfile-interleave left.ogg right.flac -o stereo.wav
+.Ed
+.Pp
+Split a multi-channel into individual mono files:
+.Bd -literal -offset indent
+$ sndfile-deinterleave multi.wav
+Input file : multi
+Output files :
+    multi_00.wav
+    multi_01.wav
+    multi_02.wav
+    multi_03.wav
+.Ed
+.Sh SEE ALSO
+.Lk http://www.mega-nerd.com/libsndfile/
+.Sh AUTHORS
+.An Erik de Castro Lopo Aq Mt [e-mail]