061991fe60
it appears a one-character typo in the cmake_minimum_required line prevents it from compiling under CMake 4.0. in order to fix that, I had to take this thing out of submodules... it is recommended to do this after you pull; git submodule deinit extern/libsndfile
161 lines
3.2 KiB
Groff
161 lines
3.2 KiB
Groff
.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://libsndfile.github.io/libsndfile/
|
|
.Sh AUTHORS
|
|
.An Erik de Castro Lopo Aq Mt erikd@mega-nerd.com .
|