Mercurial > hg > sv-dependency-builds

annotate src/libsndfile-1.0.25/doc/index.html @ 85:545efbb81310

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import initial set of sources
author Chris Cannam <cannam@all-day-breakfast.com>
date Mon, 18 Mar 2013 14:12:14 +0000
parents
children
rev   line source
cannam@85 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
cannam@85 2 <HTML>
cannam@85 3
cannam@85 4 <HEAD>
cannam@85 5 <TITLE>
cannam@85 6 libsndfile
cannam@85 7 </TITLE>
cannam@85 8 <META NAME="Author" CONTENT="Erik de Castro Lopo (erikd AT mega-nerd DOT com)">
cannam@85 9 <META NAME="Version" CONTENT="libsndfile-1.0.25">
cannam@85 10 <META NAME="Description" CONTENT="The libsndfile Home Page">
cannam@85 11 <META NAME="Keywords" CONTENT="WAV AIFF AU SVX PAF NIST W64 libsndfile sound audio dsp Linux">
cannam@85 12 <META NAME="ROBOTS" CONTENT="NOFOLLOW">
cannam@85 13 <LINK REL="stylesheet" HREF="libsndfile.css" TYPE="text/css" MEDIA="all">
cannam@85 14 <LINK REL="stylesheet" HREF="print.css" TYPE="text/css" MEDIA="print">
cannam@85 15 </HEAD>
cannam@85 16
cannam@85 17 <BODY>
cannam@85 18 <!-- pepper -->
cannam@85 19 <CENTER>
cannam@85 20 <IMG SRC="libsndfile.jpg" HEIGHT=98 WIDTH=367 ALT="libsndfile.jpg">
cannam@85 21 </CENTER>
cannam@85 22 <!-- pepper -->
cannam@85 23 <CENTER>
cannam@85 24 <A HREF="#History">History</A> -+-
cannam@85 25 <A HREF="#Features">Features</A> -+-
cannam@85 26 <A HREF="#Similar">Similar or Related Projects</A> -+-
cannam@85 27 <A HREF="NEWS">News</A>
cannam@85 28 <br>
cannam@85 29 <A HREF="development.html">Development</A> -+-
cannam@85 30 <A HREF="api.html">Programming Interface</A> -+-
cannam@85 31 <A HREF="bugs.html">Bug Reporting</A> -+-
cannam@85 32 <A HREF="#Download">Download</A>
cannam@85 33 <br>
cannam@85 34 <A HREF="FAQ.html">FAQ</A> -+-
cannam@85 35 <A HREF="lists.html">Mailing Lists</A> -+-
cannam@85 36 <A HREF="ChangeLog">Change Log</A> -+-
cannam@85 37 <A HREF="#Licensing">Licensing Information</A> -+-
cannam@85 38 <A HREF="#SeeAlso">See Also</A>
cannam@85 39 </CENTER>
cannam@85 40
cannam@85 41 <br><br>
cannam@85 42 <P>
cannam@85 43 Libsndfile is a C library for reading and writing files containing sampled sound
cannam@85 44 (such as MS Windows WAV and the Apple/SGI AIFF format) through one standard
cannam@85 45 library interface. It is released in source code format under the
cannam@85 46 <A HREF="http://www.gnu.org/copyleft/lesser.html">Gnu Lesser General Public License</A>.
cannam@85 47 </P>
cannam@85 48 <!-- pepper -->
cannam@85 49 <P>
cannam@85 50 The library was written to compile and run on a Linux system but should compile
cannam@85 51 and run on just about any Unix (including MacOS X).
cannam@85 52 There are also pre-compiled binaries available for 32 and 64 bit windows.
cannam@85 53 </P>
cannam@85 54 <P>
cannam@85 55 It was designed to handle both little-endian (such as WAV) and big-endian
cannam@85 56 (such as AIFF) data, and to compile and run correctly on little-endian (such as Intel
cannam@85 57 and DEC/Compaq Alpha) processor systems as well as big-endian processor systems such
cannam@85 58 as Motorola 68k, Power PC, MIPS and Sparc.
cannam@85 59 Hopefully the design of the library will also make it easy to extend for reading and
cannam@85 60 writing new sound file formats.
cannam@85 61 </P>
cannam@85 62 <!-- pepper -->
cannam@85 63 <P>
cannam@85 64 It has been compiled and tested (at one time or another) on the following systems:
cannam@85 65 </P>
cannam@85 66 <!-- pepper -->
cannam@85 67 <UL>
cannam@85 68 <LI>Every platform supported by Debian GNU/Linux including x86_64-linux-gnu,
cannam@85 69 i486-linux-gnu, powerpc-linux-gnu, sparc-linux-gnu, alpha-linux-gnu,
cannam@85 70 mips-linux-gnu and armel-linux-gnu.</LI>
cannam@85 71 <LI>arm-linux-androideab (Android phones OS)</LI>
cannam@85 72 <LI>powerpc-apple-darwin7.0 (Mac OS X 10.3)</LI>
cannam@85 73 <LI>sparc-sun-solaris2.8 (using gcc)</LI>
cannam@85 74 <LI>mips-sgi-irix5.3 (using gcc)</LI>
cannam@85 75 <LI>QNX 6.0</LI>
cannam@85 76 <LI>i386-unknown-openbsd2.9</LI>
cannam@85 77 </UL>
cannam@85 78 <!-- pepper -->
cannam@85 79 <P>
cannam@85 80 At the moment, each new release is being tested on i386 Linux, x86_64 Linux,
cannam@85 81 PowerPC Linux, Win32 and Win64.
cannam@85 82 </P>
cannam@85 83 <!-- pepper -->
cannam@85 84
cannam@85 85 <A NAME="Capabilities"></A>
cannam@85 86 <A NAME="Features"></A>
cannam@85 87 <H1><B>Features</B></H1>
cannam@85 88 <P>
cannam@85 89 libsndfile has the following main features :
cannam@85 90 </P>
cannam@85 91 <UL>
cannam@85 92 <lI> Ability to read and write a large number of file formats.
cannam@85 93 <LI> A simple, elegant and easy to use Applications Programming Interface.
cannam@85 94 <LI> Usable on Unix, Win32, MacOS and others.
cannam@85 95 <LI> On the fly format conversion, including endian-ness swapping, type conversion
cannam@85 96 and bitwidth scaling.
cannam@85 97 <LI> Optional normalisation when reading floating point data from files containing
cannam@85 98 integer data.
cannam@85 99 <LI> Ability to open files in read/write mode.
cannam@85 100 <LI> The ability to write the file header without closing the file (only on files
cannam@85 101 open for write or read/write).
cannam@85 102 <LI> Ability to query the library about all supported formats and retrieve text
cannam@85 103 strings describing each format.
cannam@85 104 </UL>
cannam@85 105 <P>
cannam@85 106 libsndfile has a comprehensive test suite so that each release is as bug free
cannam@85 107 as possible.
cannam@85 108 When new bugs are found, new tests are added to the test suite to ensure that
cannam@85 109 these bugs don't creep back into the code.
cannam@85 110 When new features are added, tests are added to the test suite to make sure that
cannam@85 111 these features continue to work correctly even when they are old features.
cannam@85 112 </P>
cannam@85 113 <P>
cannam@85 114 The following table lists the file formats and encodings that libsndfile can read
cannam@85 115 and write.
cannam@85 116 The file formats are arranged across the top and encodings along the left
cannam@85 117 edge.
cannam@85 118 </P>
cannam@85 119 <br>
cannam@85 120
cannam@85 121 <TABLE BORDER="1" cellpadding="2">
cannam@85 122 <TR><TD>&nbsp;</TD>
cannam@85 123 <TD ALIGN="center">Micro- soft<br>WAV</TD>
cannam@85 124 <TD ALIGN="center">SGI / Apple<br>AIFF / AIFC</TD>
cannam@85 125 <TD ALIGN="center">Sun / DEC /<br>NeXT<br>AU / SND</TD>
cannam@85 126 <TD ALIGN="center">Header- less<br>RAW</TD>
cannam@85 127 <TD ALIGN="center">Paris Audio<br>File<br>PAF</TD>
cannam@85 128 <TD ALIGN="center">Commo- dore<br>Amiga<br>IFF / SVX</TD>
cannam@85 129 <TD ALIGN="center">Sphere<br>Nist<br>WAV</TD>
cannam@85 130 <TD ALIGN="center">IRCAM<br>SF</TD>
cannam@85 131 <TD ALIGN="center">Creative<br>VOC</TD>
cannam@85 132 <TD ALIGN="center">Sound forge<br>W64</TD>
cannam@85 133 <TD ALIGN="center"><A HREF="octave.html">GNU Octave 2.0</A><br>MAT4</TD>
cannam@85 134 <TD ALIGN="center"><A HREF="octave.html">GNU Octave 2.1</A><br>MAT5</TD>
cannam@85 135 <TD ALIGN="center">Portable Voice Format<br>PVF</TD>
cannam@85 136 <TD ALIGN="center">Fasttracker 2<br>XI</TD>
cannam@85 137 <TD ALIGN="center">HMM Tool Kit<br>HTK</TD>
cannam@85 138 <TD ALIGN="center">Apple<br>CAF</TD>
cannam@85 139 <TD ALIGN="center">Sound<br>Designer II<br>SD2</TD>
cannam@85 140 <TD ALIGN="center">Free Lossless Audio Codec<br>FLAC</TD>
cannam@85 141 </TR>
cannam@85 142 <TR><TD>Unsigned 8 bit PCM</TD>
cannam@85 143 <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD>
cannam@85 144 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD>
cannam@85 145 <TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD>
cannam@85 146 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 147 </TR>
cannam@85 148
cannam@85 149 <TR><TD>Signed 8 bit PCM</TD>
cannam@85 150 <TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 151 <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD>
cannam@85 152 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD>
cannam@85 153 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 154 </TR>
cannam@85 155
cannam@85 156 <TR><TD>Signed 16 bit PCM</TD>
cannam@85 157 <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 158 <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 159 <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 160 <TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 161 <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 162 </TR>
cannam@85 163
cannam@85 164 <TR><TD>Signed 24 bit PCM</TD>
cannam@85 165 <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 166 <TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 167 <TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 168 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 169 </TR>
cannam@85 170
cannam@85 171 <TR><TD>Signed 32 bit PCM</TD>
cannam@85 172 <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 173 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD>
cannam@85 174 <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 175 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 176 </TR>
cannam@85 177
cannam@85 178 <TR><TD>32 bit float</TD>
cannam@85 179 <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 180 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD>
cannam@85 181 <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD>
cannam@85 182 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 183 </TR>
cannam@85 184
cannam@85 185 <TR><TD>64 bit double</TD>
cannam@85 186 <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 187 <TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 188 <TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 189 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 190 </TR>
cannam@85 191
cannam@85 192 <TR><TD>u-law encoding</TD>
cannam@85 193 <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 194 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 195 <TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 196 <TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 197 </TR>
cannam@85 198 <TR><TD>A-law encoding</TD>
cannam@85 199 <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 200 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>
cannam@85 201 <TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 202 <TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 203 </TR>
cannam@85 204
cannam@85 205 <TR><TD>IMA ADPCM</TD>
cannam@85 206 <TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 207 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD>
cannam@85 208 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 209 <TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 210 </TR>
cannam@85 211
cannam@85 212 <TR><TD>MS ADPCM</TD>
cannam@85 213 <TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 214 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 215 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 216 </TR>
cannam@85 217
cannam@85 218 <TR><TD>GSM 6.10</TD>
cannam@85 219 <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 220 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 221 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 222 </TR>
cannam@85 223
cannam@85 224 <TR><TD>G721 ADPCM 32kbps</TD>
cannam@85 225 <TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 226 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 227 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 228 </TR>
cannam@85 229
cannam@85 230 <TR><TD>G723 ADPCM 24kbps</TD>
cannam@85 231 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 232 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 233 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 234 </TR>
cannam@85 235
cannam@85 236 <TR><TD>G723 ADPCM 40kbps</TD>
cannam@85 237 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 238 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 239 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 240 </TR>
cannam@85 241
cannam@85 242 <TR><TD>12 bit DWVW</TD>
cannam@85 243 <TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 244 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 245 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 246 </TR>
cannam@85 247
cannam@85 248 <TR><TD>16 bit DWVW</TD>
cannam@85 249 <TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 250 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 251 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 252 </TR>
cannam@85 253
cannam@85 254 <TR><TD>24 bit DWVW</TD>
cannam@85 255 <TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 256 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 257 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 258 </TR>
cannam@85 259 <TR><TD>Ok Dialogic ADPCM</TD>
cannam@85 260 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 261 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 262 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 263 </TR>
cannam@85 264 <TR><TD>8 bit DPCM</TD>
cannam@85 265 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 266 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 267 <TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 268 </TR>
cannam@85 269 <TR><TD>16 bit DPCM</TD>
cannam@85 270 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 271 <TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 272 <TD>&nbsp;</TD><TD ALIGN="center">R/W</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD>
cannam@85 273 </TR>
cannam@85 274 </TABLE>
cannam@85 275
cannam@85 276 <p>
cannam@85 277 From version 1.0.18, libsndfile also reads and writes
cannam@85 278 <a href="http://flac.sourceforge.net/">FLAC</a>
cannam@85 279 and
cannam@85 280 <a href="http://www.vorbis.com/">Ogg/Vorbis</a>.
cannam@85 281 </p>
cannam@85 282
cannam@85 283 <!-- pepper -->
cannam@85 284
cannam@85 285 <P>
cannam@85 286 Some of the file formats I am also interested in adding are:
cannam@85 287 </P>
cannam@85 288 <UL>
cannam@85 289 <LI> Kurzweil K2000 sampler files.
cannam@85 290 <LI> Ogg Speex.
cannam@85 291 </UL>
cannam@85 292 <P>
cannam@85 293 I have decided that I will not be adding support for MPEG Layer 3 (commonly
cannam@85 294 known as MP3) due to the patent issues surrounding this file format.
cannam@85 295 See
cannam@85 296 <a href="http://www.mega-nerd.com/libsndfile/FAQ.html#Q020">
cannam@85 297 the FAQ</a>
cannam@85 298 for more.
cannam@85 299 </P>
cannam@85 300 <P>
cannam@85 301 Other file formats may also be added on request.
cannam@85 302 </P>
cannam@85 303
cannam@85 304 <!-- pepper -->
cannam@85 305
cannam@85 306 <A NAME="History"></A>
cannam@85 307 <H1><B>History</B></H1>
cannam@85 308 <P>
cannam@85 309 My first attempt at reading and writing WAV files was in 1990 or so under Windows
cannam@85 310 3.1.
cannam@85 311 I started using Linux in early 1995 and contributed some code to the
cannam@85 312 <A HREF="http://www.vaxxine.com/ve3wwg/gnuwave.html">wavplay</A>
cannam@85 313 program.
cannam@85 314 That contributed code would eventually mutate into this library.
cannam@85 315 As one of my interests is Digital Signal Processing (DSP) I decided that as well as
cannam@85 316 reading data from an audio file in the native format (typically 16 bit short integers)
cannam@85 317 it would also be useful to be able to have the library do the conversion to floating
cannam@85 318 point numbers for DSP applications.
cannam@85 319 It then dawned on me that whatever file format (anything from 8 bit unsigned chars,
cannam@85 320 to 32 bit floating point numbers) the library should be able to convert the data to
cannam@85 321 whatever format the library user wishes to use it in.
cannam@85 322 For example, in a sound playback program, the library caller typically wants the sound
cannam@85 323 data in 16 bit short integers to dump into a sound card even though the data in the
cannam@85 324 file may be 32 bit floating point numbers (ie Microsoft's WAVE_FORMAT_IEEE_FLOAT
cannam@85 325 format).
cannam@85 326 Another example would be someone doing speech recognition research who has recorded
cannam@85 327 some speech as a 16 bit WAV file but wants to process it as double precision floating
cannam@85 328 point numbers.
cannam@85 329 </P>
cannam@85 330 <P>
cannam@85 331 Here is the release history for libsndfile :
cannam@85 332 </P>
cannam@85 333 <UL>
cannam@85 334 <LI>Version 0.0.8 (Feb 15 1999) First official release.
cannam@85 335 <LI>Version 0.0.28 (Apr 26 2002) Final release of version 0 of libsndfile.
cannam@85 336 <LI>Version 1.0.0rc1 (Jun 24 2002) Release candidate 1 of version 1 of libsndfile.
cannam@85 337 <LI>Version 1.0.0rc6 (Aug 14 2002) MacOS 9 fixes.
cannam@85 338 <LI>Version 1.0.0 (Aug 16 2002) First 1.0.X release.
cannam@85 339 <LI>Version 1.0.1 (Sep 14 2002) Added MAT4 and MAT5 file formats.
cannam@85 340 <LI>Version 1.0.2 (Nov 24 2002) Added VOX ADPCM format.
cannam@85 341 <LI>Version 1.0.3 (Dec 09 2002) Fixes for Linux on ia64 CPUs.
cannam@85 342 <LI>Version 1.0.4 (Feb 02 2003) New file formats and functionality.
cannam@85 343 <LI>Version 1.0.5 (May 03 2003) One new file format and new functionality.
cannam@85 344 <LI>Version 1.0.6 (Feb 08 2004) Large file fix for Linux/Solaris, new functionality
cannam@85 345 and Win32 improvements.
cannam@85 346 <LI>Version 1.0.7 (Feb 24 2004) Fix build problems on MacOS X and fix ia64/MIPS etc
cannam@85 347 clip mode detction.
cannam@85 348 <LI>Version 1.0.8 (Mar 14 2004) Minor bug fixes.
cannam@85 349 <LI>Version 1.0.9 (Mar 30 2004) Add AVR format. Improve handling of some WAV files.
cannam@85 350 <LI>Version 1.0.10 (Jun 15 2004) Minor bug fixes. Fix support for Win32 MinGW compiler.
cannam@85 351 <LI>Version 1.0.11 (Nov 15 2004) Add SD2 file support, reading of loop data in WAV and AIFF.
cannam@85 352 Minor bug fixes.
cannam@85 353 <LI>Version 1.0.12 (Sep 30 2005) Add FLAC and CAF file support, virtual I/O interface.
cannam@85 354 Minor bug fixes and cleanups.
cannam@85 355 <LI>Version 1.0.13 (Jan 21 2006) Add read/write of instrument chunks. Minor bug fixes.
cannam@85 356 <LI>Version 1.0.14 (Feb 19 2006) Minor bug fixes. Start shipping windows binary/source ZIP.
cannam@85 357 <LI>Version 1.0.15 (Mar 16 2006) Minor bug fixes.
cannam@85 358 <LI>Version 1.0.16 (Apr 30 2006) Add support for RIFX. Other minor feature enhancements and
cannam@85 359 bug fixes.
cannam@85 360 <LI>Version 1.0.17 (Aug 31 2006) Add C++ wrapper sndfile.hh. Minor bug fixes and cleanups.
cannam@85 361 <LI>Version 1.0.18 (Feb 07 2009) Add Ogg/Vorbis suppport, remove captive libraries, many
cannam@85 362 new features and bug fixes. Generate Win32 and Win64 pre-compiled binaries.
cannam@85 363 <LI>Version 1.0.19 (Mar 02 2009) Fix for CVE-2009-0186. Huge number of minor fixes as a
cannam@85 364 result of static analysis.
cannam@85 365 <LI>Version 1.0.20 (May 14 2009) Fix for potential heap overflow.
cannam@85 366 <LI>Version 1.0.21 (December 13 2009) Bunch of minor bug fixes.
cannam@85 367 <LI>Version 1.0.22 (October 04 2010) Bunch of minor bug fixes.
cannam@85 368 <LI>Version 1.0.23 (October 10 2010) Minor bug fixes.
cannam@85 369 <LI>Version 1.0.24 (March 23 2011) Minor bug fixes.
cannam@85 370 <LI>Version 1.0.25 (July 13 2011) Fix for Secunia Advisory SA45125. Minor bug fixes and
cannam@85 371 improvements.
cannam@85 372 </UL>
cannam@85 373
cannam@85 374 <A NAME="Similar"></A>
cannam@85 375 <H1><B>Similar or Related Projects</B></H1>
cannam@85 376
cannam@85 377 <UL>
cannam@85 378 <LI><A HREF="http://sox.sourceforge.net/">SoX</A> is a program for
cannam@85 379 converting between sound file formats.
cannam@85 380 <LI><A HREF="http://www.hitsquad.com/smm/programs/WavPlay/">Wavplay</A> started out
cannam@85 381 as a minimal WAV file player under Linux and has mutated into Gnuwave, a client/server
cannam@85 382 application for more general multimedia and games sound playback.
cannam@85 383 <LI><A HREF="http://www.68k.org/~michael/audiofile/">Audiofile</A> (libaudiofile) is
cannam@85 384 a library similar to libsndfile but with a different programming interface. The
cannam@85 385 author Michael Pruett has set out to clone (and fix some bugs in) the libaudiofile
cannam@85 386 library which ships with SGI's IRIX OS.
cannam@85 387 <LI><A HREF="ftp://ccrma-ftp.stanford.edu/pub/Lisp/sndlib.tar.gz">sndlib.tar.gz</A> is
cannam@85 388 another library written by Bill Schottstaedt of CCRMA.
cannam@85 389 </UL>
cannam@85 390
cannam@85 391 <A NAME="Licensing"></A>
cannam@85 392 <H1><B>Licensing</B></H1>
cannam@85 393 <P>
cannam@85 394 libsndfile is released under the terms of the GNU Lesser General Public License,
cannam@85 395 of which there are two versions;
cannam@85 396 <a href="http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html">version 2.1</a>
cannam@85 397 and
cannam@85 398 <a href="http://www.gnu.org/copyleft/lesser.html">version 3</a>.
cannam@85 399 To maximise the compatibility of libsndfile, the user may choose to use libsndfile
cannam@85 400 under either of the above two licenses.
cannam@85 401 You can also read a simple explanation of the ideas behind the GPL and the LGPL
cannam@85 402 <A HREF="http://www.gnu.org/copyleft/copyleft.html">here</A>.
cannam@85 403 </P>
cannam@85 404 <P>
cannam@85 405 You can use libsndfile with
cannam@85 406 <A HREF="http://www.gnu.org/">Free Software</A>,
cannam@85 407 <A HREF="http://www.opensource.org/">Open Source</A>,
cannam@85 408 proprietary, shareware or other closed source applications as long as libsndfile
cannam@85 409 is used as a dynamically loaded library and you abide by a small number of other
cannam@85 410 conditions (read the LGPL for more info).
cannam@85 411 With applications released under the GNU GPL you can also use libsndfile statically
cannam@85 412 linked to your application.
cannam@85 413 </P>
cannam@85 414 <P>
cannam@85 415 I would like to see libsndfile used as widely as possible but I would prefer it
cannam@85 416 if you released software that uses libsndfile as
cannam@85 417 <A HREF="http://www.gnu.org/">Free Software</A>
cannam@85 418 or
cannam@85 419 <A HREF="http://www.opensource.org/">Open Source</A>.
cannam@85 420 However, if you put in a great deal of effort building a significant application
cannam@85 421 which simply uses libsndfile for file I/O, then I have no problem with you releasing
cannam@85 422 that as closed source and charging as much money as you want for it as long as you
cannam@85 423 abide by <A HREF="http://www.gnu.org/copyleft/lesser.html">the license</A>.
cannam@85 424 </P>
cannam@85 425
cannam@85 426 <A NAME="Download"></A>
cannam@85 427 <H1><B>Download</B></H1>
cannam@85 428 <P>
cannam@85 429 Here is the latest version. It is available in the following formats:
cannam@85 430 </P>
cannam@85 431 <UL>
cannam@85 432 <LI>Source code as a .tar.gz :
cannam@85 433 <A HREF="files/libsndfile-1.0.25.tar.gz">libsndfile-1.0.25.tar.gz</A>
cannam@85 434 and
cannam@85 435 <A HREF="files/libsndfile-1.0.25.tar.gz.asc">(GPG signature)</A>.
cannam@85 436 <LI>Win32 installer:
cannam@85 437 <A HREF="files/libsndfile-1.0.25-w32-setup.exe">
cannam@85 438 libsndfile-1.0.25-w32-setup.exe</A> (thoroughly tested under
cannam@85 439 <a href="http://www.winehq.com/">Wine</a> and Windows XP).
cannam@85 440 <LI>Win64 installer:
cannam@85 441 <A HREF="files/libsndfile-1.0.25-w64-setup.exe">
cannam@85 442 libsndfile-1.0.25-w64-setup.exe</A>
cannam@85 443 (thoroughly tested on 64 bit Windows 7).
cannam@85 444 </UL>
cannam@85 445
cannam@85 446 <P>
cannam@85 447 The Win32 installer was compiled for Windows XP but should also work on Windows
cannam@85 448 2000, Vista and Windows 7.
cannam@85 449 </p>
cannam@85 450
cannam@85 451 <P>
cannam@85 452 Pre-release versions of libsndfile are available
cannam@85 453 <A HREF="http://www.mega-nerd.com/tmp/">here</A>
cannam@85 454 and are announced on the
cannam@85 455 <A HREF="lists.html">libsndfile-devel</A>
cannam@85 456 mailing list.
cannam@85 457 </P>
cannam@85 458
cannam@85 459 <A NAME="SeeAlso"></A>
cannam@85 460 <H1><B>See Also</B></H1>
cannam@85 461 <UL>
cannam@85 462 <LI><a href="http://www.mega-nerd.com/libsndfile/tools/">
cannam@85 463 sndfile-tools</a>
cannam@85 464 : a small collection of programs which use libsndfile.
cannam@85 465 </UL>
cannam@85 466
cannam@85 467 <br><br>
cannam@85 468
cannam@85 469 <hr>
cannam@85 470
cannam@85 471 <P>
cannam@85 472 The latest version of this document can be found
cannam@85 473 <A HREF="http://www.mega-nerd.com/libsndfile/">here</A>.
cannam@85 474 </P>
cannam@85 475 <P>
cannam@85 476 Author :
cannam@85 477 <A HREF="m&#97;ilt&#111;:&#101;rikd&#64;&#109;eg&#97;-&#110;erd.&#99;om">
cannam@85 478 Erik de Castro Lopo</a>
cannam@85 479 </P>
cannam@85 480 <!-- pepper -->
cannam@85 481 <P>
cannam@85 482 This page has been accessed
cannam@85 483 <IMG SRC=
cannam@85 484 "/cgi-bin/Count.cgi?ft=6|frgb=55;55;55|tr=0|trgb=0;0;0|wxh=15;20|md=7|dd=B|st=1|sh=1|df=libsndfile.dat"
cannam@85 485 HEIGHT=30 WIDTH=100 ALT="counter.gif">
cannam@85 486 times.
cannam@85 487 </P>
cannam@85 488 <!-- pepper -->
cannam@85 489 <!-- pepper -->
cannam@85 490 <!-- pepper -->
cannam@85 491
cannam@85 492 <br><br>
cannam@85 493 </BODY>
cannam@85 494 </HTML>