mirror of
https://github.com/TorqueGameEngines/Torque3D.git
synced 2026-02-19 22:53:47 +00:00
a745fc3757
added libraries: opus flac libsndfile updated: libvorbis libogg openal - Everything works as expected for now. Bare in mind libsndfile needed the check for whether or not it could find the xiph libraries removed in order for this to work.
160 lines
3.2 KiB
Groff
160 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 .
|