openharmony/third_party_libsnd
1
0
Fork 0
mirror of https://gitee.com/openharmony/third_party_libsnd synced 2024-11-23 09:59:54 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

man/sndfile-convert.1 : Reformatting.

Browse Source 
Patch-from: Jan Stary <hans@stare.cz>
This commit is contained in:
Erik de Castro Lopo 2014-06-21 19:01:37 +10:00
parent 02955198bb
commit c4c8258487
1 changed files with 126 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

137
man/sndfile-convert.1
View File

@ -6,24 +6,139 @@
.Nd convert sound files from one format to another
.Sh SYNOPSIS
.Nm sndfile-convert
.Op Ar options
.Op Ar encoding
.Ar input_file
.Ar output_file
.Ar input
.Ar output
.Sh DESCRIPTION
.Nm
converts sound files from one format to another using libsndfile
.Pq Lk http://www.mega-nerd.com/libsndfile/
to read and write the data.
converts sound files from one audio format to another.
.Ss Formats
The format of the output file is determined by the filename extension.
The following file formats are currently supported:
.Pp
The format of the output file is determined
by the filename extension of the output file.
.Bl -tag -compact -width ircam
.It aif
AIFF (Apple/SGI)
.It wav
WAV (Microsoft)
.It au
AU (Sun/NeXT)
.It caf
CAF (Apple Core Audio File)
.It flac
FLAC (FLAC Lossless Audio Codec)
.It snd
AU (Sun/NeXT)
.It svx
IFF (Amiga IFF/SVX8/SV16)
.It paf
PAF (Ensoniq PARIS)
.It fap
PAF (Ensoniq PARIS)
.It gsm
RAW (header-less)
.It nist
WAV (NIST Sphere)
.It htk
HTK (HMM Tool Kit)
.It ircam
SF (Berkeley/IRCAM/CARL)
.It sf
SF (Berkeley/IRCAM/CARL)
.It voc
VOC (Creative Labs)
.It w64
W64 (SoundFoundry WAVE 64)
.It raw
RAW (header-less)
.It mat4
MAT4 (GNU Octave 2.0 / Matlab 4.2)
.It mat5
MAT5 (GNU Octave 2.1 / Matlab 5.0)
.It mat
MAT4 (GNU Octave 2.0 / Matlab 4.2)
.It pvf
PVF (Portable Voice Format)
.It sds
SDS (Midi Sample Dump Standard)
.It sd2
SD2 (Sound Designer II)
.It vox
RAW (header-less)
.It xi
XI (FastTracker 2)
.It wve
WVE (Psion Series 3)
.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=XXXX"
.It Fl override-sample-rate Ns = Ns Ar X
Make the input use sample rate
.Ar X .
.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.
Run
.Dq sndfile-convert --help
for more information.
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
(eg 16 bit PCM, a-law, Vorbis etc).
.Sh SEE ALSO
.Lk http://www.mega-nerd.com/libsndfile/
.Sh AUTHORS
This manual page was written by
.An Erik de Castro Lopo Aq Mt erikd@mega-nerd.com .