Mercurial > hg > sv-dependency-builds

annotate src/libsndfile-1.0.27/man/sndfile-convert.1 @ 84:08ae793730bd

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Add null config files
author Chris Cannam
date Mon, 02 Mar 2020 14:03:47 +0000
parents 1df64224f5ac
children
rev   line source
Chris@40 1 .Dd November 2, 2014
Chris@40 2 .Dt SNDFILE-CONVERT 1
Chris@40 3 .Os
Chris@40 4 .Sh NAME
Chris@40 5 .Nm sndfile-convert
Chris@40 6 .Nd convert sound files from one format to another
Chris@40 7 .Sh SYNOPSIS
Chris@40 8 .Nm sndfile-convert
Chris@40 9 .Op Fl override-sample-rate Ns = Ns Ar rate
Chris@40 10 .Op Fl endian Ns = Ns Cm little | big | cpu
Chris@40 11 .Op Fl normalize
Chris@40 12 .Op Ar encoding
Chris@40 13 .Ar input
Chris@40 14 .Ar output
Chris@40 15 .Sh DESCRIPTION
Chris@40 16 .Nm
Chris@40 17 converts sound files from one audio format to another.
Chris@40 18 The output file is overwritten it it already exists.
Chris@40 19 .Ss Formats
Chris@40 20 The format of the output file is determined by the filename extension.
Chris@40 21 The following file formats are currently recognized:
Chris@40 22 .Pp
Chris@40 23 .Bl -tag -compact -width ircam
Chris@40 24 .It wav
Chris@40 25 WAV (Microsoft)
Chris@40 26 .It aif
Chris@40 27 AIFF (Apple/SGI)
Chris@40 28 .It au
Chris@40 29 AU (Sun/NeXT)
Chris@40 30 .It snd
Chris@40 31 AU (Sun/NeXT)
Chris@40 32 .It raw
Chris@40 33 RAW (header-less)
Chris@40 34 .It gsm
Chris@40 35 RAW (header-less)
Chris@40 36 .It vox
Chris@40 37 RAW (header-less)
Chris@40 38 .It paf
Chris@40 39 PAF (Ensoniq PARIS, big-endian)
Chris@40 40 .It fap
Chris@40 41 PAF (Ensoniq PARIS, little-endian)
Chris@40 42 .It svx
Chris@40 43 IFF (Amiga IFF/SVX8/SV16)
Chris@40 44 .It nist
Chris@40 45 SPHERE (NIST SPeech HEader Resources)
Chris@40 46 .It sph
Chris@40 47 SPHERE (NIST SPeech HEader Resources)
Chris@40 48 .It voc
Chris@40 49 VOC (Creative Labs)
Chris@40 50 .It ircam
Chris@40 51 SF (Berkeley/IRCAM/CARL)
Chris@40 52 .It sf
Chris@40 53 SF (Berkeley/IRCAM/CARL)
Chris@40 54 .It w64
Chris@40 55 W64 (SoundFoundry WAVE 64)
Chris@40 56 .It mat
Chris@40 57 MAT4 (GNU Octave 2.0 / Matlab 4.2)
Chris@40 58 .It mat4
Chris@40 59 MAT4 (GNU Octave 2.0 / Matlab 4.2)
Chris@40 60 .It mat5
Chris@40 61 MAT5 (GNU Octave 2.1 / Matlab 5.0)
Chris@40 62 .It pvf
Chris@40 63 PVF (Portable Voice Format)
Chris@40 64 .It xi
Chris@40 65 XI (FastTracker 2)
Chris@40 66 .It htk
Chris@40 67 HTK (HMM Tool Kit)
Chris@40 68 .It sds
Chris@40 69 SDS (Midi Sample Dump Standard)
Chris@40 70 .It avr
Chris@40 71 AVR (Audio Visual Research)
Chris@40 72 .It wavex
Chris@40 73 WAVEX (MS WAVE with WAVEFORMATEX)
Chris@40 74 .It sd2
Chris@40 75 SD2 (Sound Designer II)
Chris@40 76 .It flac
Chris@40 77 FLAC (FLAC Lossless Audio Codec)
Chris@40 78 .It caf
Chris@40 79 CAF (Apple Core Audio File)
Chris@40 80 .It wve
Chris@40 81 WVE (Psion Series 3)
Chris@40 82 .It prc
Chris@40 83 WVE (Psion Series 3)
Chris@40 84 .It ogg
Chris@40 85 OGG (OGG Container format)
Chris@40 86 .It oga
Chris@40 87 OGG (OGG Container format)
Chris@40 88 .It mpc
Chris@40 89 MPC (Akai MPC 2k)
Chris@40 90 .It rf64
Chris@40 91 RF64 (RIFF 64)
Chris@40 92 .El
Chris@40 93 .Ss Options
Chris@40 94 The following options are recoginzed:
Chris@40 95 .Pp
Chris@40 96 .Bl -tag -compact -width "override-sample-rate=XXXXX"
Chris@40 97 .It Fl override-sample-rate Ns = Ns Ar rate
Chris@40 98 Make the input use sample rate of
Chris@40 99 .Ar rate
Chris@40 100 Hz.
Chris@40 101 .It Fl endian Ns = Ns Cm little
Chris@40 102 Make the output file use little endian data.
Chris@40 103 .It Fl endian Ns = Ns Cm big
Chris@40 104 Make the output file use big endian data.
Chris@40 105 .It Fl endian Ns = Ns Cm cpu
Chris@40 106 Make the output file use CPU endianness.
Chris@40 107 .It Fl normalize
Chris@40 108 Normalize the audio data in the output file.
Chris@40 109 .El
Chris@40 110 .Ss Encodings
Chris@40 111 The optional
Chris@40 112 .Ar encoding
Chris@40 113 parameter allows setting of the data encoding for the output file.
Chris@40 114 The following encodings are currently supported:
Chris@40 115 .Pp
Chris@40 116 .Bl -tag -compact -width ima-adpcmXX
Chris@40 117 .It Fl pcms8
Chris@40 118 signed 8 bit pcm
Chris@40 119 .It Fl pcmu8
Chris@40 120 unsigned 8 bit pcm
Chris@40 121 .It Fl pcm16
Chris@40 122 16 bit pcm
Chris@40 123 .It Fl pcm24
Chris@40 124 24 bit pcm
Chris@40 125 .It Fl pcm32
Chris@40 126 32 bit pcm
Chris@40 127 .It Fl float32
Chris@40 128 32 bit floating point
Chris@40 129 .It Fl ulaw
Chris@40 130 ULAW
Chris@40 131 .It Fl alaw
Chris@40 132 ALAW
Chris@40 133 .It Fl ima-adpcm
Chris@40 134 IMA ADPCM (WAV only)
Chris@40 135 .It Fl ms-adpcm
Chris@40 136 MS ADPCM (WAV only)
Chris@40 137 .It Fl gsm610
Chris@40 138 GSM6.10 (WAV only)
Chris@40 139 .It Fl dwvw12
Chris@40 140 12 bit DWVW (AIFF only)
Chris@40 141 .It Fl dwvw16
Chris@40 142 16 bit DWVW (AIFF only)
Chris@40 143 .It Fl dwvw24
Chris@40 144 24 bit DWVW (AIFF only)
Chris@40 145 .It Fl vorbis
Chris@40 146 Vorbis (OGG only)
Chris@40 147 .El
Chris@40 148 .Pp
Chris@40 149 If no encoding is specified for the output file,
Chris@40 150 .Nm
Chris@40 151 will try to use the encoding of the input file.
Chris@40 152 This will not always work as most container formats
Chris@40 153 (e.g. WAV, AIFF etc) only support a small subset of encodings
Chris@40 154 (e.g. 16 bit PCM, a-law, Vorbis etc).
Chris@40 155 .Sh EXIT STATUS
Chris@40 156 .Ex -std
Chris@40 157 .Sh SEE ALSO
Chris@40 158 .Lk http://www.mega-nerd.com/libsndfile/
Chris@40 159 .Sh AUTHORS
Chris@40 160 .An Erik de Castro Lopo Aq Mt erikd@mega-nerd.com .