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