comparison src/libsndfile-1.0.27/man/sndfile-convert.1 @ 40:1df64224f5ac

Current libsndfile source

+.Dd November 2, 2014
+.Dt SNDFILE-CONVERT 1
+.Os
+.Sh NAME
+.Nm sndfile-convert
+.Nd convert sound files from one format to another
+.Sh SYNOPSIS
+.Nm sndfile-convert
+.Op Fl override-sample-rate Ns = Ns Ar rate
+.Op Fl endian Ns = Ns Cm little | big | cpu
+.Op Fl normalize
+.Op Ar encoding
+.Ar input
+.Ar output
+.Sh DESCRIPTION
+.Nm
+converts sound files from one audio format to another.
+The output file is overwritten it it already exists.
+.Ss Formats
+The format of the output file is determined by the filename extension.
+The following file formats are currently recognized:
+.Pp
+.Bl -tag -compact -width ircam
+.It wav
+WAV (Microsoft)
+.It aif
+AIFF (Apple/SGI)
+.It au
+AU (Sun/NeXT)
+.It snd
+AU (Sun/NeXT)
+.It raw
+RAW (header-less)
+.It gsm
+RAW (header-less)
+.It vox
+RAW (header-less)
+.It paf
+PAF (Ensoniq PARIS, big-endian)
+.It fap
+PAF (Ensoniq PARIS, little-endian)
+.It svx
+IFF (Amiga IFF/SVX8/SV16)
+.It nist
+SPHERE (NIST SPeech HEader Resources)
+.It sph
+SPHERE (NIST SPeech HEader Resources)
+.It voc
+VOC (Creative Labs)
+.It ircam
+SF (Berkeley/IRCAM/CARL)
+.It sf
+SF (Berkeley/IRCAM/CARL)
+.It w64
+W64 (SoundFoundry WAVE 64)
+.It mat
+MAT4 (GNU Octave 2.0 / Matlab 4.2)
+.It mat4
+MAT4 (GNU Octave 2.0 / Matlab 4.2)
+.It mat5
+MAT5 (GNU Octave 2.1 / Matlab 5.0)
+.It pvf
+PVF (Portable Voice Format)
+.It xi
+XI (FastTracker 2)
+.It htk
+HTK (HMM Tool Kit)
+.It sds
+SDS (Midi Sample Dump Standard)
+.It avr
+AVR (Audio Visual Research)
+.It wavex
+WAVEX (MS WAVE with WAVEFORMATEX)
+.It sd2
+SD2 (Sound Designer II)
+.It flac
+FLAC (FLAC Lossless Audio Codec)
+.It caf
+CAF (Apple Core Audio File)
+.It wve
+WVE (Psion Series 3)
+.It prc
+WVE (Psion Series 3)
+.It ogg
+OGG (OGG Container format)
+.It oga
+OGG (OGG Container format)
+.It mpc
+MPC (Akai MPC 2k)
+.It rf64
+RF64 (RIFF 64)
+.El
+.Ss Options
+The following options are recoginzed:
+.Pp
+.Bl -tag -compact -width "override-sample-rate=XXXXX"
+.It Fl override-sample-rate Ns = Ns Ar rate
+Make the input use sample rate of
+.Ar rate
+Hz.
+.It Fl endian Ns = Ns Cm little
+Make the output file use little endian data.
+.It Fl endian Ns = Ns Cm big
+Make the output file use big endian data.
+.It Fl endian Ns = Ns Cm cpu
+Make the output file use CPU endianness.
+.It Fl normalize
+Normalize the audio data in the output file.
+.El
+.Ss Encodings
+The optional
+.Ar encoding
+parameter allows setting of the data encoding for the output file.
+The following encodings are currently supported:
+.Pp
+.Bl -tag -compact -width ima-adpcmXX
+.It Fl pcms8
+signed 8 bit pcm
+.It Fl pcmu8
+unsigned 8 bit pcm
+.It Fl pcm16
+16 bit pcm
+.It Fl pcm24
+24 bit pcm
+.It Fl pcm32
+32 bit pcm
+.It Fl float32
+32 bit floating point
+.It Fl ulaw
+ULAW
+.It Fl alaw
+ALAW
+.It Fl ima-adpcm
+IMA ADPCM (WAV only)
+.It Fl ms-adpcm
+MS ADPCM (WAV only)
+.It Fl gsm610
+GSM6.10 (WAV only)
+.It Fl dwvw12
+12 bit DWVW (AIFF only)
+.It Fl dwvw16
+16 bit DWVW (AIFF only)
+.It Fl dwvw24
+24 bit DWVW (AIFF only)
+.It Fl vorbis
+Vorbis (OGG only)
+.El
+.Pp
+If no encoding is specified for the output file,
+.Nm
+will try to use the encoding of the input file.
+This will not always work as most container formats
+(e.g. WAV, AIFF etc) only support a small subset of encodings
+(e.g. 16 bit PCM, a-law, Vorbis etc).
+.Sh EXIT STATUS
+.Ex -std
+.Sh SEE ALSO
+.Lk http://www.mega-nerd.com/libsndfile/
+.Sh AUTHORS
+.An Erik de Castro Lopo Aq Mt [e-mail] .