--- /dev/null
+2011-07-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ogg_vorbis.c
+ Fix return value of SFC_SET_VBR_ENCODING_QUALITY command.
+
+ * doc/command.html
+ Document SFC_SET_VBR_ENCODING_QUALITY, SFC_GET/SET_LOOP_INFO and
+ SFC_GET_INSTRUMENT.
+
+ * NEWS README configure.ac doc/*.html
+ Updates for 1.0.25.
+
+2011-07-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sfconfig.h
+ Add handling for HAVE_SYS_WAIT_H.
+
+ * Makefile.am src/Makefile.am tests/Makefile.am
+ Add 'checkprograms' target.
+
+2011-07-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/sndfile.c
+ Purge SF_ASSERT macro. Use standard C assert instead.
+
+ * src/paf.c src/common.h src/sndfile.c
+ Fix for Secunia Advisory SA45125, heap overflow (heap gets overwritten with
+ byte value of 0) due to integer overflow if PAF file handler.
+
+ * src/ima_adpcm.c src/ms_adpcm.c src/paf.c
+ Use calloc instead of malloc followed by memset.
+
+ * tests/utils.tpl
+ Clean up use of memset.
+
+2011-07-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ogg.c
+ Fix log message.
+
+ * tests/format_check_test.c
+ Fix compiler warnings.
+
+2011-07-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fix error message for erro code SFE_ZERO_MINOR_FORMAT.
+
+ * tests/format_check_test.c
+ Add a test to for SF_FINFO format field validation.
+
+ * src/ogg.c src/ogg_vorbis.c src/ogg.h src/ogg_pcm.c src/ogg_speex.c
+ src/common.h src/Makefile.am
+ Move vorbis specific code to ogg_vorbis.c, add new files for handling PCM
+ and Speex codecs in an Ogg container. The later two are only enabled with
+ ENABLE_EXPERIMENTAL_CODE config variable.
+
+2011-06-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/strings.c
+ Clean up and refactor storage of SF_STR_SOFTWARE.
+
+2011-06-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in doc/api.html
+ Fix definition of SF_STR_LAST and update SF_STR_* related docs. Thanks to
+ Tim van der Molen for the patch.
+
+2011-06-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/sndfile-interleave.c
+ Fix handling of argc. Thanks to Marius Hennecke.
+
+ * src/wav_w64.c
+ Accept broken WAV files with blockalign == 0. Thanks to Olivier Tristan for
+ providing example files.
+
+ * src/wav.c
+ Jump over 'FLLR' chunks.
+
+2011-06-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in
+ Fix -Wundef warning due to ENABLE_SNDFILE_WINDOWS_PROTOTYPES.
+
+ * configure.ac
+ Add -Wundef to CFLAGS.
+
+ * src/ogg.c
+ Fix -Wunder warning.
+
+2011-05-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Use int64_t instead of off_t when they are the same size.
+
+ * src/Makefile.am tests/Makefile.am
+ Use check_PROGRAMS instead of noinst_PROGRAMS where appropriate.
+
+2011-05-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Don't allow unknown and/or un-editable chunks to prevent the file from being
+ opened in SFM_RDWR mode.
+
+2011-04-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/format_check_test.c
+ Fix segfault in test program.
+
+2011-04-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/format_check_test.c
+ New test program to check to make sure that sf_open() and sf_check_format()
+ agree as to what is a valid program.
+
+ * tests/Makefile.am tests/test_wrapper.sh.in
+ Hook into build and test runner.
+
+ * src/sndfile.c
+ Fix some sf_format_check() problems. Thanks to Charles Van Winkle for the
+ notification.
+
+2011-04-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/caf.c
+ Add validation to size of 'data' chunk and fix size of written 'data'
+ chunk. Thanks to Michael Pruett for reporting this.
+
+2011-03-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/* tests/* programs/*
+ Fix a bunch of compiler warnings with gcc-4.6.
+
+2011-03-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/util.tpl
+ Add NOT macro to util.h.
+
+ * src/strings.c
+ Fix handling of SF_STR_SOFTWARE that resulted in a segfault due to calling
+ strlen() on an unterminated string. Thanks to Francois Thibaud for reporting
+ this problem.
+
+ * tests/string_test.c
+ Add test for SF_STR_SOFTWARE segfault bug.
+
+ * configure.ac
+ Sanitize FLAC_CFLAGS value supplied by pkg-config which returns a value of
+ '-I${includedir}/FLAC'. However FLAC also provides an include file
+ <assert.h> which clashes with the Standard C header of the same name. The
+ solution is strip the 'FLAC' part off the end and include all FLAC headers
+ as <FLAC/header.h>.
+
+ * configure.ac src/Makefile.am
+ Use non-recursive make in src/ directory.
+
+2011-03-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * NEWS README docs/*.html
+ Updates for 1.0.24 release.
+
+2011-03-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Fix up usage of sed (should not assume GNU sed).
+
+ * M4/add_(c|cxx)flags.m4
+ Test flags in isolation.
+
+ * tests/cpp_test.cc
+ Fix a broken test (test segfaults). Report by Dave Flogeras.
+
+2011-03-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/common.[ch]
+ Add function program_name() which returns the program name minus the path
+ from argv [0].
+
+ * programs/*.c programs/Makefile.am
+ Use program_name() where appropriate. Fix build.
+
+2011-03-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ For u-law and A-law files, write an 18 byte 'fmt ' chunk instead of a 16
+ byte one. Win98 accepts files with a 16 but not 18 byte 'fmt' chunk. Later
+ version accept 18 byte but not 16 byte.
+
+2011-03-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/FAQ.html
+ Add examples for question 12.
+
+ * doc/libsndfile.css.in
+ Add tweaks for h4 element.
+
+ * doc/api.html
+ Add documentation for virtual I/O functionality. Thanks to Uli Franke.
+
+ * tests/util.tpl
+ Add static inline functions sf_info_clear() and sf_info_setup().
+
+ * tests/(alaw|dwvw|ulaw)_test.c
+ Use functions sf_info_clear() and sf_info_setup().
+
+2011-03-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Fail more gracefully if pkg-config is missing. Suggestion from Brian
+ Willoughby.
+
+2011-02-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.c
+ Use size_t instead of int for size params with varargs.
+
+2011-02-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/index.html
+ Update supported platforms with more Debian platforms and Android.
+
+2011-01-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.hh
+ Add an LPCWSTR version of the SndfileHandle constructor to the SndfileHandle
+ class definition. Thanks to Eric Eizenman for pointing out this was missing.
+
+ * tests/cpp_test.cc
+ Add test for LPCWSTR version of the SndfileHandle constructor.
+
+2011-01-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/sndfile-play.c
+ Remove cruft.
+
+2010-12-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.hh
+ Add methods rawHandle() and takeOwnership(). Thanks to Tim Blechmann for
+ the patch.
+
+ * tests/cpp_test.cc
+ Add tests for above two methods. Also supplied by Tim Blechmann.
+
+2010-11-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/api.html
+ Add mention of use of sf_strerror() when sf_open() fails.
+
+2010-11-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Make TYPEOF_SF_COUNT_T int64_t where possible. This may fix problems where
+ people are compiling on a 64 bit system with the GCC -m32 flag.
+
+ * src/sndfile.h.in
+ Fix comments on sf_count_t.
+
+2010-10-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Handle non-zero offset field in SSND chunk. Thanks to Michael Chinen.
+
+2010-10-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Sed fix for FreeBSD. Thanks Tony Theodore.
+
+2010-10-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * shave.in M4/shave.m4
+ Fix shave invocation of windres compiler. Thanks Damien Lespiau (upstream
+ shave author).
+
+ * configure.ac M4/shave.m4 shave-libtool.in shave.in
+ Switch from shave to automake-1.11's AM_SILENT_RULES.
+
+2010-10-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * shave-libtool.in shave.in
+ Sync to upstream version.
+
+ * src/rf64.c
+ More work to make the parser more robust and accepting of mal-formed files.
+
+2010-10-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Add functions psf_strlcpy() and psf_strlcat().
+
+ * src/broadcast.c src/sndfile.c src/strings.c src/test_main.c
+ src/test_main.h src/test_strncpy_crlf.c
+ Use functions psf_strlcpy() and psf_strlcat() as appropriate.
+
+ * tests/string_test.c
+ Add tests for SF_STR_GENRE and SF_STR_TRACKNUMBER.
+
+ * src/rf64.c
+ Fix size of 'ds64' chunk when writing RF64.
+
+2010-10-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/*.c
+ Add the libsndfile version to the usage message of all programs.
+
+2010-10-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac src/version-metadata.rc.in src/Makefile.am
+ Add version string resources to the windows DLL.
+
+ * doc/api.html
+ Update to add missing SF_FORMAT_* values. Closed Debian bug #545257.
+
+ * NEWS README configure.ac doc/*.html
+ Updates for 1.0.23 release.
+
+2010-10-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/pedantic-header-test.sh.in
+ Handle unusual values of CC environment variable.
+
+ * src/rf64.c
+ Minor tweaks and additional sanity checking.
+
+ * src/Makefile.am src/binheader_writef_check.py
+ Use python 2.6.
+
+2010-10-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.hh
+ Add a missing 'inline' before a constructor defintion.
+
+2010-10-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Add macro NOT.
+
+ * src/rf64.c
+ Minor tweaks.
+
+ * Makefile.am */Makefile.am
+ Add *~ to CLEANFILES.
+
+2010-10-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fix a typo in the error string for SFE_OPEN_PIPE_RDWR. Thanks to Charles
+ Van Winkle for the report.
+
+2010-10-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/flac.c src/ogg.c src/sndfile.h.in src/strings.c src/wav.c
+ Add ability to read/write tracknumber and genre to flac/ogg/wav files.
+ Thanks to Matti Nykyri for the patch.
+
+ * src/common.h src/broadcast.c src/strings.c
+ Add function psf_safe_strncpy() and use where appropriate.
+
+2010-10-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * NEWS README configure.ac doc/*.html
+ Updates for 1.0.22 release.
+
+2010-10-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/broadcast.c src/rf64.c src/sndfile.c src/wav.c
+ Rewrite of SF_BROADCAST_INFO handling.
+
+ * src/test_broadcast_var.c tests/command_test.c
+ Tweak SF_BROADCAST_INFO tests.
+
+ * src/test_broadcast_var.c
+ Fix OSX stack check error.
+
+2010-09-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sds.c
+ Set sustain_loop_end to 0 as suggested by Brian Lewis.
+
+2010-09-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sds.c
+ Make sure the correct frame count gets written into the header.
+
+ * tests/write_read_test.tpl
+ Don't allow SDS files to have a long frame count.
+
+2010-09-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sds.c
+ Apply a pair of patches from Brian Lewis to fix the packet number location
+ and the checksum.
+
+2010-09-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c src/file_io.c src/ogg.c src/rf64.c src/sndfile.c
+ src/strings.c src/test_audio_detect.c src/test_strncpy_crlf.c
+ src/wav.c tests/pcm_test.tpl
+ Fix a bunch of minor issues found using static analysis.
+
+2010-08-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/test_broadcast_var.c
+ New file containing tests for broadcast_set_var().
+
+ * src/Makefile.am src/test_main.[ch]
+ Hook test_broadcast_var.c into tests.
+
+2010-08-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/broadcast.c src/common.(c|h)
+ Move function strncpy_crlf() to src/common.c so the function can be tested
+ in isolation.
+
+ * src/test_strncpy_crlf.c
+ New file.
+
+ * src/Makefile.am src/test_main.[ch]
+ Hook test_strncpy_crlf.c into tests.
+
+2010-08-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Move code around to make comments make sense.
+
+ * src/broadcast.c
+ Add debugging code that is disabled by default.
+
+2010-08-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/flac.c
+ When the file meta data says the file has zero frames set psf->sf.frames
+ to SF_COUNT_MAX. Fixes Debian bug #590752.
+
+ * programs/sndfile-info.c
+ Print 'unknown' if frame count == SF_COUNT_MAX.
+
+2010-06-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Only support writing mono SVX files. Multichannel SVX files are not
+ interleaved and there is no support infrastructure to cache and write
+ multiple channels to create a non-interleaved file.
+
+ * src/file_io.c
+ Don't call close() on a file descriptor of -1. Thanks to Jeremy Friesner
+ for the bug report.
+
+2010-06-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Add macro SF_ASSERT.
+
+ * src/sndfile.c
+ Use SF_ASSERT to ensure sizeof (sf_count_t) == 8.
+
+ * src/svx.c
+ Add support for reading and writing stereo SVX files.
+
+2010-05-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ When compiling with x86_64-w64-mingw32-gcc link with -static-libgcc flags.
+
+ * programs/common.c programs/sndfile-metadata-set.c
+ Update metadata after the audio data is copied. Other minor fixes. Patch
+ from Marius Hennecke.
+
+2010-05-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/nist.c
+ Fix a regression reported by Hugh Secker-Walker.
+
+ * src/api.html
+ Add comment about sf_open_fd() not working on Windows if the application
+ and the libsndfile DLL are linked to different versions of the Microsoft
+ C runtime DLL.
+
+2010-04-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/pedantic-header-test.sh.in
+ Fix 'make distcheck'.
+
+2010-04-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/pedantic-header-test.sh.in
+ New file to test whether sndfile.h can be compiled with gcc's -pedantic
+ flag.
+
+ * configure.ac tests/test_wrapper.sh.in
+ Hook pedantic-header-test into test suite.
+
+ * src/sndfile.h.in
+ Fix -pedantic warning.
+
+2010-04-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/sndfile-salvage.c programs/Makefile.am
+ New program to salvage the audio data from WAV/WAVEX/AIFF files which are
+ greater than 4Gig in size.
+
+2010-04-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/sndfile-convert.c
+ Fix valgrind warning.
+
+2010-04-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/sndfile-cmp.c
+ When files differ in the PCM data, also print the difference offset.
+ Minor cleanup.
+
+2010-03-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Don't use the 'twos' marker for 24 and 32 bit PCM, use 'in24' and 'in32'
+ instead. Thanks to Paul Davis (Ardour) for this suggestion.
+
+2010-02-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Clean up configure report.
+
+ * tests/utils.tpl
+ Add functions test_read_raw_or_die and test_write_raw_or_die.
+
+ * tests/rdwr_test.(def|tpl) tests/Makefile.am
+ Add new test program and hook into build.
+
+ * src/sndfile.c
+ Fix minor issues with sf_read/write_raw(). Bug reported by Milan Křápek.
+
+ * tests/test_wrapper.sh.in
+ Add rdwr_test to the test wrapper script.
+
+2010-02-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Remove -fpascal-strings from OSX's OS_SPECIFIC_CFLAGS.
+
+ * programs/common.[ch] programs/sndfile-metadata-set.c
+ Apply a patch from Robin Gareus allowing the setting of the time reference
+ field of the BEXT chunk.
+
+2010-02-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ima_adpcm.c
+ Add a fix from Jonatan Liljedahl to handle predictor overflow when decoding
+ IMA4.
+
+2010-01-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.hh
+ Add a constructor which takes an existing file descriptor and then calls
+ sf_open_fd(). Patch from Sakari Bergen.
+
+2010-01-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/sndfile-deinterleave.c programs/sndfile-interleave.c
+ Improve usage messages.
+
+2010-01-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/id3.c src/Makefile.am
+ Add new file src/id3.c and hook into build.
+
+ * src/sndfile.c src/common.h
+ Detect and skip and ID3 header at the start of the file.
+
+2010-01-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/common.c
+ Fix update_strings() copyright, comment, album and license are correctly
+ written. Thanks to Todd Allen for reporting this.
+
+ * man/Makefile.am
+ Change GNU makeism to something more widely supported. Thanks to Christian
+ Weisgerber for reporting this.
+
+ * configure.ac programs/Makefile.am programs/sndfile-play.c
+ Apply patch from Christian Weisgerber and Jacob Meuserto add support for
+ OpenBSD's sndio.
+
+2010-01-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/api.html
+ Discourage the use of sf_read/write_raw().
+
+2009-12-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Test for Unix pipe() and waitpid() functions.
+
+ * src/sfconfig.h tests/pipe_test.tpl
+ Disable pipe_test if pipe() and waitpid() aren't available.
+
+2009-12-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac src/Makefile.am src/create_symbols_file.py
+ src/make-static-lib-hidden-privates.sh
+ Change name of generated file src/Symbols.linux to Symbols.gnu-binutils and
+ and use the same symbols file for other systems which use GNU binutils like
+ Debian's kfreebsd.
+
+ * M4/shave.m4 shave.in
+ Update shave files from upstream.
+
+2009-12-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * man/sndfile-metadata-get.1
+ Fix typo.
+
+ * man/sndfile-interleave.1 man/Makefile.am
+ New man page.
+
+2009-12-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ogg.c
+ When decoding to short or int, clip the decoded signal to [-1.0, 1.0] if
+ its too hot. Thanks to Dmitry Baikov for suggesting this.
+
+ * NEWS README doc/*.html
+ Updates for 1.0.21.
+
+2009-12-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/sndfile-jackplay.c man/sndfile-jackplay.1
+ Remove these which will now be in found in the sndfile-tools package.
+
+ * programs/Makefile.am man/Makefile.am
+ Remove build rules for sndfile-jackplay.
+
+ * configure.ac
+ Remove detection of JACK Audio Connect Kit.
+
+ * programs/sndfile-concat.c man/sndfile-concat.1
+ Add new program with man page.
+
+ * man/Makefile.am programs/Makefile.am
+ Hook sndfile-concat into build system.
+
+2009-12-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/error_test.c
+ Don't terminate when sf_close() returns zero in error_close_test().
+ It seems that Windows 7 behaves differently from earlier versions of
+ Windows.
+
+2009-12-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac M4/*.m4
+ Rename all custom macros from AC_* to MN_*.
+
+ * programs/sndfile-interleave.c
+ Make it actually work.
+
+2009-12-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/*.html configure.ac
+ Corrections and clarifications courtesy of Robin Forder.
+
+ * programs/sndfile-convert.c programs/common.[ch]
+ Move some code from convert to common for reuse.
+
+ * programs/sndfile-interleave.c programs/sndfile-interleave.c
+ Add new programs sndfile-interleave and sndfile-deinterleave.
+
+ * programs/Makefile.am
+ Hook new programs into build.
+
+2009-12-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/create_symbols_file.py tests/stdio_test.c tests/win32_test.c
+ Minor OS/2 tweaks as suggested by David Yeo.
+
+ * tests/multi_file_test.c
+ Fix file creation flags on windows. Thanks to Bruce Sharpe.
+
+ * src/sf_unistd.h
+ Set all group and other file create permssions to zero.
+
+ * tests/win32_test.c
+ Add a new test.
+
+2009-11-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/print.css doc/*.html
+ Add a print stylesheet and update all HTML documents to reference it.
+ Thanks to Aditya Bhargava for suggesting this.
+
+ * doc/index.html
+ Minor corrections.
+
+2009-11-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * sndfile.pc.in
+ Add a Libs.private entry to assist with static linking.
+
+2009-11-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/make-static-lib-hidden-privates.sh src/Makefile.am
+ Add a script to hide all non-public symbols in the libsndfile.a static
+ library.
+
+2009-11-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/locale_test.c
+ Correct usage of ENABLE_SNDFILE_WINDOWS_PROTOTYPES.
+
+2009-11-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/windows.c
+ Correct usage of ENABLE_SNDFILE_WINDOWS_PROTOTYPES.
+
+2009-11-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/sndfile-convert.c
+ Allow the program to read from stdin by specifying '-' on the command line
+ as the input file.
+
+ * src/sndfile.h.in
+ Hash define ENABLE_SNDFILE_WINDOWS_PROTOTYPES to 1 for greater safety.
+
+ * tests/virtual_io_test.c
+ Add a PAF/PCM_24 test and verify the file length is not negative
+ immediately after openning the file for write.
+
+2009-10-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ When writing loop lengths, adjust the end position by one to make up for
+ Microsoft's screwed up spec. Thanks to Olivier Tristan for the patch.
+
+2009-10-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/flac.c
+ Apply patch from Uli Franke allowing FLAC files to be encoded at any sample
+ rate.
+
+2009-10-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/nist.c
+ Fix parsing of odd ulaw encoded file provided by Jan Silovsky.
+
+ * configure.ac
+ Insist on libvorbis >= 1.2.3. Earlier verions have bugs that cause the
+ libsndfile test suite to fail on MIPS, PowerPC and others.
+ See: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=549899
+
+2009-10-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * man/sndfile-convert.1
+ Fix warning from Debian's lintian checks.
+
+ * man/sndfile-cmp.1 man/sndfile-jackplay.1 man/sndfile-metadata-get.1
+ man/Makefile.am
+ Add three new minimal manpages and hook into build.
+
+2009-10-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/test_wrapper.sh.in
+ Don't run cpp_test on x86_64-w64-mingw32.
+
+2009-09-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/utils.tpl
+ On windows, make sure the open() function doesn't get called with a third
+ parameter of 0 which fails for no good reason. Also make sure this third
+ parameter doesn't get called with S_IRGRP when compiling for windows because
+ Wine complains.
+
+ * src/sndfile.hh
+ Add a SndfileHandle constructor for windows that takes a 'const wchar_t *'
+ string.
+
+ * doc/FAQ.html
+ Add Q/A : I'm cross compiling libsndfile for another platform. How can I
+ run the test suite?
+
+ * src/create_symbols_file.py src/Makefile.am
+ Add Symbols.static target, a list of symbols, one per line.
+
+2009-09-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/test_wrapper.sh.in
+ Update to allow all tests to be gathered up into a testsuite tarball and
+ then be run using this script.
+
+ * build-test-tarball.mk.in
+ Add a Make script to build a tarball of all the test binaries and the test
+ wrapper script. This is useful for cross compiling; you can build the
+ binaries, build test test tarball and transfer the test tarball to the
+ target machine for testing.
+
+2009-09-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/*.c
+ Modify SF_FILE struct to allow it to carry either 8-bit or 16-bit strings
+ for the file path, directory and name. Fixes for this change throughout.
+
+ * src/windows.c src/Makefile.am
+ New file defining new windows only public function sf_wchar_open() which
+ takes a 'const wchar_t *' string (LPCWSTR) for the file name parameter.
+
+ * src/sndfile.h.in
+ Add SF_CHANNEL_MAP_ABISONIC_* entries.
+ Add windows only defintion for sf_wchar_open().
+
+ * src/create_symbols_file.py
+ Add sf_wchar_open() to the list of public symbols (windows only).
+
+ * tests/locale_test.c
+ Add a wchar_test() to test sf_wchar_open().
+
+2009-09-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/*.c
+ Split file stuff into PSF_FILE struct within the SF_PRIVATE struct.
+
+2009-09-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c src/voc.c
+ When a byte is needed, use unsigned char.
+
+ * src/ima_oki_adpcm.c src/broadcast.c src/test_ima_oki_adpcm.c
+ Include sfconfig.h to prevent compile errors with MinGW compilers.
+
+ * configure.ac
+ Remove AM_CONFIG_HEADER due to warnings from autoconf 2.64.
+
+ * tests/locale_test.c
+ Update to work with xx_XX.UTF-8 style locales. Refactoring.
+
+2009-09-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Set __USE_MINGW_ANSI_STDIO to 1 when compiling using MinGW compilers.
+ Remove unneeded AC_SUBST.
+ Report Host CPU/OS/vendor.
+
+2009-09-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fix error message string.
+
+ * src/flac.c
+ Add 88200 to the list of supported sample rates.
+
+ * src/ogg.c
+ Fix compiler warning when using gcc-4.5.0.
+
+ * programs/sndfile-info.c tests/utils.tpl
+ Remove WIN32 snprintf #define.
+
+ * src/ima_adpcm.c
+ Fix minor bug in aiff_ima_encode_block. Thanks to Denis Fileev for finding
+ this.
+
+2009-09-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/caf.c
+ Use the correct C99 format specifier for int64_t.
+
+ * M4/endian.m4
+ Fix detection of CPU endian-ness when cross compiling. Thanks to Pierre
+ Ossman for the bug report.
+
+ * src/caf.c src/sndfile.c
+ Fix reading and writing of PEAK chunks in CAF files.
+
+ * tests/peak_chunk_test.c tests/test_wrapper.sh.in
+ Run peak_chunk_test on CAF files.
+
+2009-09-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c src/wav.c
+ Use the correct C99 format specifier for int64_t.
+
+2009-08-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/rf64.c src/sndfile.c src/wav.c src/wav_w64.h
+ Apply a patch (massaged slightly) from Uli Franke adding handling of the
+ BEXT chunk in RF64 files.
+
+ * tests/command_test.c
+ Update channel_map_test() function so WAV test passes.
+
+ * src/rf64.c
+ Add channel mapping and ambisonic support.
+
+ * src/sndfile.h
+ Add comments showing correspondance between libsndfile channel map
+ defintiions and those used by Apple and MS.
+
+ Add handling of reading/writing channel map info.
+
+ * tests/command_test.c tests/test_wrapper.sh.in
+ Update channel map tests.
+
+2009-07-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Add function psf_isprint() a replacement for the standard C isprint()
+ function which ignores any locale settings and treats all input as ASCII.
+
+ * src/(aiff|common|rf64|sd2|strings|svx|wav).c
+ Use psf_isprint() instead of isprint().
+
+2009-07-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/command.c
+ Add string descriptions for SF_FORMAT_RF64 and SF_FORMAT_MPC2K.
+
+2009-06-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/sndfile-play.c
+ Allow use of Open Sound System audio output under FreeBSD.
+
+2009-06-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Add patch from Conrad Parker to add --disable-jack.
+
+2009-05-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/alaw.c src/float32.c src/htk.c src/pcm.c src/sds.c src/ulaw.c
+ Fix bugs where invalid files can cause a divide by zero error (SIGFPE).
+ Thanks to Sami Liedes for reporting this a Debian bug #530831.
+
+2009-05-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/chanmap.[ch]
+ New files for channel map decoding/encoding.
+
+2009-05-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac src/sndfile.h.in
+ Fix MSVC definition of sf_count_t.
+
+2009-05-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav_w64.[ch]
+ Add wavex_channelmask to WAV_PRIVATE struct and add a function to convert
+ an array of SF_CHANNEL_MASK_* values into a bit mask for use in WAV files.
+
+ * src/wav.c
+ Add ability to write the channel mask.
+
+2009-05-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/sndfile-info.c
+ Add -c command line option to dump the channel map information.
+
+ * src/wav_w64.c
+ Don't bail from parser if channel map bitmask is faulty.
+
+ * src/common.h src/sndfile.c
+ Remove error code SFE_W64_BAD_CHANNEL_MAP which is not needed any more.
+
+ * src/sndfile.c
+ On SFC_SET_CHANNEL_MAP_INFO pass the channel map command down to container's
+ command handler.
+
+2009-05-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in src/common.h src/sndfile.c src/wav_w64.c
+ Apply a patch from Lennart Poettering (PulseAudio) to allow reading of
+ channel data in WAV and W64 files.
+ Add a test for the above.
+
+2009-05-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/FAQ.html
+ Update the section about pre-compiled binaries for Win64.
+
+2009-05-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/test_conversions.c
+ Be more careful when including <stdint.h> so compiling on pre-C99 platforms
+ (hello Slowlaris) might actually work.
+
+ * NEWS README doc/*.html
+ Updates for 1.0.20.
+
+2009-04-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/voc.c
+ Fix a bug whereby opening a specially crafted VOC file could result in a
+ heap overflow. Thanks to Tobias Klein (http://www.trapkit.de) for reporting
+ this issue.
+
+ * src/aiff.c
+ Fix potential (heap) buffer overflow when parsing 'MARK' chunk.
+
+2009-04-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/stdin_test.c
+ Check psf->error after opening file.
+
+ * src/file_io.c
+ Fix obscure seeking bug reported by Hugh Secker-Walker.
+
+ * tests/utils.tpl
+ Add check of sf_error to test_open_file_or_die().
+
+ * src/sndfile.c
+ Clear error if opening resource fork fails.
+
+2009-04-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/alaw_test.c tests/locale_test.c tests/ulaw_test.c
+ Cleanup output.
+
+2009-03-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/float32.c
+ Fix f2s_clip_array.
+
+2009-03-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/float32.c
+ In host_read_f2s call convert instead of f2s_array.
+
+ * src/ima_adpcm.c
+ Remove dead code.
+
+ * src/test_ima_oki_adpcm.c examples/generate.c tests/dither_test.c
+ tests/dwvw_test.c tests/fix_this.c tests/generate.c
+ tests/multi_file_test.c
+ Minor fixes.
+
+2009-03-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * M4/shave.m4 shave.in
+ Pulled update from upstream.
+
+2009-03-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/api.html
+ Add pointers to example programs in source code tarball.
+
+2009-03-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Define SF_PLATFORM_S64 for non-gcc compilers with 'long long' type.
+
+ * configure.ac
+ Add documentation for --disable-external-libs and improve error handling
+ for that option.
+
+ * src/sndfile.c src/sndfile.h.in src/create_symbols_file.py
+ Add public function sf_version_string.
+
+ * tests/sfversion.c
+ Test function sf_version_string.
+
+ * M4/shave.m4 shave-libtool.in shave.in
+ Add new files from 'git clone git://git.lespiau.name/shave'.
+
+ * configure.ac
+ Enable shave.
+
+ * src/Makefile.am src/binheader_writef_check.py Octave/*
+ Shave related tweaks.
+
+2009-03-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/caf.c src/sndfile.c
+ Add SF_MAX_CHANNELS (set to 256) and use it.
+
+ * src/sndfile.h.in
+ Check for either _MSCVER or _MSC_VER being defined.
+
+2009-03-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/vorbis_test.c
+ Relax test slighly to allow test to pass on more CPUs etc.
+
+2009-03-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Detect vorbis_version_string() correctly.
+
+2009-03-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/index.html
+ Add a 'See Also' section with a link to sndfile-tools.
+
+ * NEWS README doc/*.html
+ Updates for 1.0.19 release.
+
+ * configure.ac
+ Fix --enable-external-libs logic.
+
+2009-03-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Fix resource leak and potential read beyond end of buffer.
+
+ * src/nist.c
+ Fix reading of header value sample_n_bytes.
+
+ * src/sd2.c src/wav.c
+ Fix potential read beyond end of buffer.
+
+ * src/sndfile.c src/svx.c
+ Check return values of file_io functions.
+
+ * tests/win32_test.c
+ Fix resource leak.
+
+ * configure.ac
+ Detect the presence/absence of vorbis_version_string() in libvorbis.
+
+ * src/ogg.c
+ Only call vorbis_version_string() from libvorbis if present.
+
+2009-02-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/win32_test.c
+ Don't use sprintf, even on windows.
+
+ * src/aiff.c src/rf64.c src/wav.c
+ Eliminate dead code, more validation of data read from file.
+
+2009-02-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ima_adpcm.c
+ Clamp values to a valid range before indexing ima_step_size array.
+
+ * src/GSM610/*.c tests/*c programs/*.c src/audio_detect.c
+ Don't include un-needed headers.
+
+ * programs/sndfile-info.c
+ Remove dead code.
+
+ * tests/test_wrapper.sh.in
+ Add 'set -e' so the script exits on error.
+
+ * src/test_ima_oki_adpcm.c
+ Fix read beyond end of array.
+
+ * tests/win32_test.c
+ Add missing close on file descriptor.
+
+ * src/nist.c programs/sndfile-metadata-set.c
+ Fix 'unused variable' warnings.
+
+ * src/aiff.c
+ Fix potential memory leak in handling of 'MARK' chunk.
+ Remove un-needed test (unsigned > 0).
+
+ * src/sd2.c
+ Improve handling of heap allocated buffer.
+
+ * src/sndfile.c
+ Remove un-needed test (always true).
+
+ * src/wav.c src/rf64.c
+ Ifdef out dead code that will be resurected some time in the future.
+
+ * src/wav.c src/w64.c src/xi.c
+ Handle error return values from psf_ftell.
+
+ * src/wav_w64.c
+ Fix handling and error checking of MSADPCM coefficient arrays.
+
+ * regtest/*.c
+ Bunch of fixes.
+
+ * src/test_file_io.c
+ Use snprintf instead of strncpy in test program.
+
+2009-02-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sd2.c
+ Validate data before using.
+
+ * src/caf.c
+ Validate channels per frame value before using, fixing a possible integer
+ overflow bug, leading to a possible heap overflow. Found by Alin Rad Pop of
+ Secunia Research (CVE-2009-0186).
+
+2009-02-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Octave/octave_test.sh
+ Unset TERM environment variable and export LD_LIBRARY_PATH.
+
+2009-02-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ In windows code, cast LPVOID to 'char*' in printf.
+
+2009-02-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * M4/octave.m4
+ Clear the TERM environment before evaluating anything in Octave. This works
+ around problems that might occur if a users TERM settings are incorrect.
+ Thanks to Rob Til Freedmen for helping to debug this.
+
+ * src/wav.c
+ Handle four zero bytes as a marker within a LIST or INFO chunk.
+ Thanks to Rogério Brito for supplying an example file.
+
+2009-02-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/*.c
+ Use C99 snprintf everywhere.
+
+2009-02-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/test_wrapper.sh.in
+ New file to act as the template for the test wrapper script.
+
+ * configure.ac
+ Generate tests/test_wrapper.sh from the template.
+
+ * tests/Makefile.am
+ Replace all tests with a single invocation of the test wrapper script.
+
+2009-02-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ogg.c
+ Record vorbis library version string.
+
+ * configure.ac
+ Require libvorbis >= 1.2.2.
+
+ * M4/endian.m4
+ Fix bracketing of function for autoconf 2.63. Thanks to Richard Ash.
+
+ * M4/octave.m4 M4/mkoctfile_version.m4
+ Clean up AC_WITH_ARG usage using AC_HELP_STRING.
+
+2009-02-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Octave/Makefile.am
+ Use $(top_buildir) instead of $(builddir) which may not be defined.
+
+ * M4/octave.m4
+ Improve logic and status reporting.
+
+2009-02-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac AUTHORS NEWS README doc/*.html
+ Final tweaks for 1.0.18 release.
+
+2009-02-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/sndfile-convert.c
+ Add 'htk' to the list of convert formats.
+
+ * programs/sndfile-info.c
+ Simplify get_signal_max using SFC_CALC_SIGNAL_MAX command.
+ Increase size of files for which signal max will be calculated.
+
+2009-01-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/index.html
+ Fix links for SoX and WavPlay. Thanks to Daniel Griscom.
+
+2009-01-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/sndfile-metadata-get.c
+ Make valgrind clean.
+ Clean up temp string array usage.
+ Error out if trying to update coding history in RDWR mode.
+
+2009-01-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/index.html
+ Fix links to versions of the LGPL.
+
+2008-12-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/string_test.c
+ Add test for RDWR mode where the file ends up shorter than when it was
+ opened.
+
+ * src/wav.c
+ Truncate the file on close for RDWR mode where the file ends up shorter
+ than when it was opened.
+
+2008-11-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * M4/add_cflags.m4
+ Fix problem with quoting of '#include'.
+
+ * M4/add_cxxflags.m4 configure.ac
+ Add new file M4/add_cxxflags.m4 and use it in configure.ac.
+
+2008-11-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/sndfile-info.c
+ Apply patch from Conrad Parker to calculate and display total duration when
+ more than one file is dumped.
+
+2008-11-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac src/Makefile.am
+ Tweaks to generation of Symbols files.
+
+ * tests/win32_ordinal_test.c
+ Update tests for above changes.
+
+2008-11-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/common.c
+ When merging broadcast info, make sure to clear the destination field
+ before copying in the new data.
+
+ * programs/test-sndfile-metadata-set.py
+ Add test for the above.
+
+ * src/broadcast.c
+ Fix checking of required coding_history_size.
+
+2008-10-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/command_test.c
+ Add test to detect if coding history is truncated.
+
+ * src/broadcast.c
+ Fix truncation of coding history.
+
+2008-10-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/command_test.c
+ Add broadcast_coding_history_size test.
+
+ * programs/*.[ch]
+ Use SF_BROADCAST_INFO_VAR to manipulate larger 'bext' chunks.
+
+ * src/rf64.c
+ Add code to prevent infinite loop on malformed file.
+
+ * src/common.h src/sndfile.c src/w64.c src/wav_w64.c
+ Rationalize and improve error handling when parsing 'fmt ' chunk.
+
+ * M4/octave.m4
+ Simplify and remove cruft.
+ Check for correct Octave version.
+
+ * Octave/*
+ Reduce 3 C++ files to one, fix build for octave 3.0, fix build.
+
+ * Octave/sndfile.cc Octave/PKG_ADD
+ Add Octave function sfversion which returns the libsndfile version that the
+ module is linked against.
+
+ * Octave/Makefile.am
+ Bunch of build and 'make distcheck' fixes.
+
+2008-10-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/common.c
+ Return 1 if SFC_SET_BROADCAST_INFO fails.
+
+ * programs/test-sndfile-metadata-set.py
+ Update for new programs directory, exit on any error.
+
+ * tests/error_test.c
+ Fix failure behaviour in error_number_test.
+
+ * src/common.h src/sndfile.c
+ Add error number SFE_BAD_BROADCAST_INFO_SIZE.
+
+ * src/*
+ Reimplement handling of broadcast extentioon chunk in WAV/WAVEX files.
+
+ * src/broadcast.c
+ Fix generation of added coding history.
+
+2008-10-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * programs/sndfile-metadata-get.c programs/sndfile-info.c
+ Exit with non-zero on errors.
+
+2008-10-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-to-text.c examples/Makefile.am
+ Add a new example program and hook it into the build.
+
+ * examples/ programs/
+ Add a new directory programs and move sndfile-info, sndfile-play and other
+ real programs to the new directory, leaving example programs where they
+ were.
+
+2008-10-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/Makefile.am
+ Automake 1.10 MinGW cross compiling fixes.
+
+2008-10-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-play.c
+ Remove call to deprecated function snd_pcm_sw_params_get_xfer_align.
+ Fix gcc-4.3 compiler warnings.
+
+ * tests/command_test.c
+ Fix a valgrind warning.
+
+ * tests/error_test.c tests/multi_file_test.c tests/peak_chunk_test.c
+ tests/pipe_test.tpl tests/stdio_test.c tests/win32_test.c
+ Fix gcc-4.3 compiler warnings.
+
+2008-10-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/broadcast.c
+ Fix termination of desitination string in strncpy_crlf.
+ When copying BROADCAST_INFO chunk, make sure destination gets correct line
+ endings.
+
+ * examples/common.c
+ Fix copying of BROADCAST_INFO coding_history field.
+
+2008-10-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/command_test.c
+ Add test function instrument_rw_test, but don't hook it into the testing
+ yet.
+
+ * src/common.h src/command.c src/sndfile.c src/flac.c
+ Error code rationalization.
+
+ * src/common.h src/sndfile.c
+ Set psf->error to SFE_CMD_HAS_DATA when adding metadata via sf_command()
+ fails due to psf->have_written being true.
+
+ * doc/command.html
+ Document the SFC_GET/SET_BROADCAST_INFO comamnds.
+
+2008-10-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/command_test.c
+ Improve error reporting when '\0' is found in coding history.
+ Fix false failure.
+
+2008-10-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/broadcast.c
+ Convert all coding history line endings to \r\n.
+
+ * tests/command_test.c
+ Add test to make sure all line endings are converted to \r\n.
+
+2008-10-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/broadcast.c
+ Changed the order of coding history fields.
+
+ * tests/command_test.c
+ Update bextch test to cope with previous change.
+
+ * examples/common.c
+ Add extra length check when copying broadcast info data.
+
+2008-10-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/utils.tpl tests/pcm_test.tpl
+ Update check_file_hash_or_die to use 64 bit hash.
+
+ * tests/checksum_test.c tests/Makefile.am
+ Add new checksum_test specifically for lossy compression of headerless
+ files.
+
+2008-10-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/gsm610.c
+ Seek to psf->dataoffset before decoding first block.
+
+ * src/sndfile.c
+ Fix detection of mpc2k files on big endian systems.
+
+2008-10-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/broadcast.c
+ Use '\r\n' newlines in Coding History as required by spec.
+
+2008-10-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/test_conversions.c
+ Use int64_t instead of 'long long'.
+
+2008-10-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-metadata-set.c
+ Remove --bext-coding-history-append command line option because it didn't
+ really make sense.
+
+ * examples/sndfile-metadata-(get|set).c
+ Add usage messages.
+
+ * examples/test-sndfile-metadata-set.py
+ Start work on test coding history.
+
+2008-09-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * README doc/win32.html
+ Bring these up to date.
+
+ * src/aiff.c
+ Fix parsing of REX files.
+
+2008-09-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Use intptr_t instead of long for return value of _get_osfhandle.
+
+ * src/test_conversions.c src/test_endswap.tpl
+ Fix printing of int64_t values.
+
+ * examples/sndfile-play.c
+ Fix win64 issues.
+
+ * tests/win32_ordinal_test.c
+ Fix calling of GetProcAddress with ordinal under win64.
+
+ * tests/utils.tpl
+ Fix win64 issues.
+
+2008-09-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/*
+ Rename copy_data.[ch] to common.[ch]. Fix build.
+ Move code from sndfile-metadata-set.c to common.c.
+
+ * examples/Makefile.am tests/Makefile.am regtest/Makefile.am
+ Clean paths.
+
+2008-09-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/tutorial.html doc/Makefile.am
+ Add file doc/tutorial.html and hook into build/dist system.
+
+2008-09-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-metadata-set.c
+ Clean up handling of bext command line params.
+
+2008-09-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/w64.c
+ Add handling/skipping of a couple of new chunk types.
+
+2008-09-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Add -funsigned-char to CFLAGS if the compiler supports it.
+
+ * examples/sndfile-metadata-(get|set).c
+ Add handling for more metadata types.
+
+2008-09-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Add macros SF_CONTAINER, SF_CODEC and SF_ENDIAN useful for splitting format
+ field of SF_INFO into component parts.
+
+ * src/*.c
+ Use new macros everywhere it is appropriate.
+
+2008-09-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-bwf-set.c
+ Massive reworking.
+
+2008-08-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-bwf-set.c
+ Add --info-auto-create-date command line option.
+
+ * examples/sndfile-metadata-set.c examples/sndfile-metadata-get.c
+ examples/Makefile.am examples/test-sndfile-bwf-set.py
+ Rename sndfile-bwf-(set|get).c to sndfile-metadata-(set|get).c.
+ Change command line args.
+
+2008-08-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Allow 'PAD ' chunk to be modified in RDWR mode.
+
+ * src/sndfile.h.in src/sndfile.c
+ Add handling (incomplete) for SFC_SET_ADD_HEADER_PAD_CHUNK.
+
+ * tests/Makefile.am tests/write_read_test.tpl tests/header_test.tpl
+ tests/misc_test.c
+ Add tests for RF64.
+
+ * src/rf64.c
+ Fixes to make sure all tests pass.
+
+ * tests/Makefile.am tests/string_test.c
+ Add string tests (not yet passing).
+
+2008-08-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/rf64.c
+ First pass at writing RF64 now working.
+
+2008-08-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-convert.c
+ Add SF_FORMAT_RF64 to format_map.
+
+ * src/common.h src/sndfile.c
+ More RF64 support code.
+
+ * examples/sndfile-bwf-set.c
+ Fix the month number in autogenerated date string and use hypen in date
+ instead of slash.
+
+ * examples/test-sndfile-bwf-set.py
+ Update tests.
+
+ * examples/sndfile-info.c
+ When called with -i or -b option, operate on all files on command line, not
+ just the first.
+
+2008-08-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/rf64.c
+ New file to handle RF64 (WAV like format supportting > 4Gig files).
+
+ * src/sndfile.h.in src/common.h src/sndfile.c src/Makefile.am
+ Hook the above into build so hacking can begin.
+
+ * src/pcm.c
+ Improve log message when pcm_init fails.
+
+ * src/sndfile-info.c
+ Only calculate and print 'Signal Max' if file is less than 10 megabytes in
+ length.
+
+2008-08-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/string_test.c
+ Polish string_multi_set_test.
+
+ * src/wav.c
+ In RDWR mode, pad the header if necessary (ie LIST chunk has moved or
+ length has changed).
+ Minor fixes in wav_write_strings.
+ Write PAD chunk with default endian-ness, not a specific endian-ness.
+
+ * examples/test-sndfile-bwf-set.py
+ Add Python script to test sndfile-bwf-set/get.
+
+ * examples/sndfile-bwf-set.c
+ Clean up and fixes.
+
+ * src/wav.c
+ Merge function wavex_write_header into wav_write_header, deleting about 70
+ lines of code.
+
+ * src/common.h
+ Double value of SF_MAX_STRINGS.
+
+ * tests/string_test.c
+ Add string tests for WAVEX and RIFX files.
+
+ * tests/command_test.c
+ Add broadcast test for WAVEX files.
+
+2008-08-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/string_test.c
+ Add a new string_rdwr_test (currently failing for WAV).
+ Add a new string_multi_set_test (currently failing).
+
+ * tests/command_test.c
+ Add new broadcast_rdwr_test (currently failing).
+
+ * src/wav.c
+ Fix to WAV parser to allow 'bext' chunk to be updated in place.
+ In wav_write_tailer, seek to psf->dataend if its greater than zero.
+
+ * src/sndfile.c
+ Make sure psf->have_written gets set correctly in mode SFM_RDWR.
+
+ * configure.ac
+ Test for <sys/time.h> and gettimeofday.
+
+ * src/common.c
+ Use gettimeofday() to initialize psf_rand_int32.
+
+ * src/common.h src/sndfile.c
+ Add unique_id field to SF_PRIVATE struct.
+
+ * src/common.h src/sndfile.c src/wav.c src/wav_w64.[ch]
+ Move wavex_ambisonic field from SF_PRIVATE struct to WAV_PRIVATE struct.
+
+ * src/common.h src/strings.c
+ Add function psf_location_string_count.
+
+2008-08-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Test for localtime and localtime_r.
+
+ * examples/sndfile-convert.c
+ In function copy_metadata(), copy broadcast info if present.
+
+ * examples/copy_data.[ch] examples/Makefile.am
+ Break some functionality out of sndfile-convert.c so it can be used in
+ examples/sndfile-bwf-set.c.
+
+ * tests/utils.tpl
+ Add new function create_short_sndfile().
+
+ * examples/sndfile-bwf-set.c examples/sndfile-bwf-get.c
+ examples/Makefile.am
+ Add new files and hook into build.
+
+2008-08-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in
+ Fix comments. Patch from Mark Glines.
+
+2008-07-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/misc_test.c
+ Use zero_data_test on Ogg/Vorbis files.
+
+ * src/ogg.c
+ Fix segfault when closing an Ogg/Vorbis file that has been opened for write
+ but had no actual data written to it. Bug reported by Chinoy Gupta.
+
+ * tests/Makefile.am
+ Make sure to run mist_test on Ogg/Vorbis files.
+
+2008-07-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * regtest/Makefile.am
+ Use SQLITE3_CFLAGS to locate sqlite headers.
+
+2008-07-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/index.html doc/FAQ.html
+ Add notes about which versions of windows libsndfile works on.
+
+2008-07-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/misc_test.c
+ Add a test for correct handling of Ambisonic files. Thanks to Fons
+ Adriaensen for the test.
+
+ * src/wav.c src/wav_w64.c
+ Fix handling of Ambisonic files. Thanks to Fons Adriaensen for the patch.
+
+2008-06-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Fix detection/enabling of external libs.
+
+ * M4/extra_pkg.m4 M4/Makefile.am
+ Add m4 macro PKG_CHECK_MOD_VERSION which is a hacked version
+ PKG_CHECK_MODULES. The new macro prints the version number of the package
+ it is searching for.
+
+2008-06-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Apply a fix from Axel Röbel where if the second loop in the instrument
+ chunk is none, the loop mode is written into the first loop.
+
+2008-05-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/test_float.c src/test_main.(c|h) src/Makefile.am
+ Add new file to test functions float32_(le|be)_(read|write) and
+ double64_(le|be)_(read|write). Hook into build and testsuite.
+
+ * src/double64.c src/float32.c
+ Fix bugs in functions found by test added above. Thanks to Nicolas Castagne
+ for reporting this bug.
+
+ * src/sndfile.h.in
+ Change time_reference_(low|high) entries of SF_BROADCAST_INFO struct to
+ unsigned.
+
+ * examples/sndfile-info.c
+ Print out the BEXT time reference in a sensible format.
+
+2008-05-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.c
+ Fuzz fixes.
+
+ * src/ogg.c
+ Add call to ogg_stream_clear to fix valgrind warning.
+
+ * src/aiff.c
+ Fix x86_64 compile issue.
+
+ * configure.ac src/Makefile.am src/flac.c src/ogg.c
+ Link to external versions of FLAC, Ogg and Vorbis.
+
+ * tests/lossy_comp_test.c tests/ogg_test.c tests/string_test.c
+ tests/vorbis_test.c tests/write_read_test.tpl
+ Fix tests when configured with --disable-external-libs.
+
+ * tests/external_libs_test.c tests/Makefile.am
+ Add new test and hook into build and test suite.
+
+ * src/command.c
+ Use HAVE_EXTERNAL_LIBS to ensure that the SFC_GET_FORMAT_* commands return
+ the right data when external libs are disabled.
+
+2008-05-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/write_read_test.tpl
+ Add a test for extending a file during write by seeking past the current
+ end of file.
+
+ * src/sndfile.c
+ Allow seeking past end of file during write.
+
+2008-05-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/api.html doc/command.html
+ Move all information about the sf_command function to command.html and add
+ a link from documentation of the sf_read/write_raw function to the
+ SFC_RAW_NEEDS_ENDSWAP command.
+
+ * doc/index.html doc/FAQ.html doc/libsndfile.css
+ Minor documentation tweaks.
+
+2008-05-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Add AM_PROG_CC_C_O.
+
+2008-04-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/error_test.c
+ Add a test to make sure if file opened with sf_open_fd, and then the file
+ descriptor is closed, then sf_close will return an error code. Thanks to
+ Dave Flogeras for the bug report.
+
+ * src/sndfile.c
+ Make sf_close return an error is the file descriptor is already closed.
+
+2008-04-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Set object format to aout for OS/2. Thanks to David Yeo.
+
+ * src/mpc2k.c src/sndfile.c src/sndfile.h.in src/common.h src/Makefile.am
+ Add ability to read MPC 2000 file.
+
+ * tests/write_read_test.tpl tests/misc_test.c tests/header_test.tpl
+ tests/Makefile.am
+ Add tests for MPC 2000 file format.
+
+ * examples/sndfile-convert.c
+ Allow conversion to MPC 2000 file format.
+
+2008-04-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/VORBIS/lib/codebook.c
+ Sync from upstream SVN.
+
+ * autogen.sh configure.ac
+ Minor tweaks.
+
+2008-04-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ogg.c
+ Add a patch that fixes finding the length in samples of an Ogg/Vorbis file.
+ The patch as supplied segfaulted and required many hours of debugging.
+
+ * src/OGG/bitwise.c
+ Sync from upstream SVN.
+
+2008-04-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Fix up handling of 'APPL' chunk. Thanks to Axel Röbel for bringing up
+ this issue.
+
+2008-04-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/*.c
+ Add calls to sf_close() where needed.
+
+ * tests/utils.tpl tests/multi_file_test.c
+ Always pass 0 as the third argument to open when OS_IS_WIN32.
+
+2008-04-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/test_*
+ Add files test_main.[ch].
+ Collapse all tests into a single executable.
+
+2008-03-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/FLAC
+ Sync to upstream CVS.
+
+2008-03-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Make SF_MIN and SF_MAX macros MinGW friendly.
+
+ * examples/sndfile-(info|play).c
+ Use Sleep function from <windows.h> instead of _sleep.
+
+ * tests/locale_test.c
+ Disable some tests when OS_IS_WIN32.
+
+ * src/FLAC/src/share/replaygain_anal/replaygain_analysis.c
+ src/FLAC/src/share/utf8/utf8.c
+ MinGW fixes.
+
+2008-03-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/FAQ.html
+ Tweaks to pcm16 <-> float conversion answer.
+
+2008-02-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/OGG
+ Sync to SVN upstream.
+
+ * Makefile.am
+ Add 'DISTCHECK_CONFIGURE_FLAGS = --enable-gcc-werror'.
+
+2008-02-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-jackplay.c
+ Minor tweaks to warning message printed when compiled without libjack.
+
+2008-01-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/peak_chunk_test.c
+ Improve read_write_peak_test to find more errors. Inspired by example
+ provided by Nicolas Castagne.
+
+ * src/aiff.c
+ Another SFM_RDWR fix shown up by above test.
+
+2008-01-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Fix reading of COMM encoding string.
+
+ * src/chunk.c src/common.h src/Makefile.am
+ New file for storing and retrieving info about header chunks. Hook into
+ build.
+
+ * src/aiff.c
+ Use new chunk logging to fix problem with AIFF in RDWR mode.
+
+2008-01-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/command.c
+ Add WVE to the list of major formats.
+
+ * tests/aiff_rw_test.c
+ Fix error reporting.
+
+2008-01-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.[ch]
+ Add internal functions str_of_major_format, str_of_minor_format,
+ str_of_open_mode and str_of_endianness.
+
+ * tests/write_read_test.tpl
+ Fix reporting of errors in new_rdwr_XXXX_test.
+
+2008-01-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-play.c
+ Apply patch from Yair K. to fix compiles with OSS v4.
+
+ * src/common.h src/float32.c src/double64.c
+ Rename psf->float_enswap to psf->data_endswap.
+
+ * src/sndfile.h.in src/sndfile.c src/pcm.c
+ Add command SFC_RAW_NEEDS_ENDSWAP.
+
+ * tests/command.c
+ Add test for SFC_RAW_NEEDS_ENDSWAP.
+
+ * doc/command.html
+ Document SFC_RAW_NEEDS_ENDSWAP.
+
+ * tests/peak_chunk_test.c
+ Add test function read_write_peak_test. Thanks to Nicolas Castagne for the
+ bug report.
+
+2008-01-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-cmp.c
+ Add new example program contributed by Conrad Parker.
+
+ * examples/Makefile.am
+ Hook into build.
+
+ * doc/development.html
+ Change use or reconfigure.mk to autogen.sh.
+
+2008-01-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/win32_test.c
+ Add another win32 test.
+
+ * tests/util.tpl
+ Add function file_length_fd which wraps fstat.
+
+ * tests/Makefile.am
+ Run the multi_file_test on AU files.
+
+ * tests/multi_file_test.c
+ Use function file_length_fd() instead of file_length() to overcome stupid
+ win32 bug. Fscking hell Microsoft sucks so much.
+
+2008-01-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sd2.c
+ Fix a rsrc parsing bug. Example file supplied by Uli Franke.
+
+2007-12-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/index.html
+ Allow use of either LGPL v2.1 or LGPL v3.
+
+ * tests/header_test.tpl
+ Add header_shrink_test from Axel Röbel.
+
+ * src/wav.c
+ Add fix from Axel Röbel for writing files with float data but no peak
+ chunk (ie peak chunk gets removed after the file is opened).
+
+ * src/aiff.c tests/header_test.tpl
+ Apply similar fix to above for AIFF files.
+
+ * src/wav.c tests/header_test.tpl
+ Apply similar fix to above for WAVEX files.
+
+ * src/command.c
+ Add Ogg/Vorbis to 'get format' commands.
+
+2007-12-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ogg.c
+ Fix seeking on multichannel Ogg Vorbis files. Reported by Bodo.
+ Set the default encoding quality to 0.4 instead of 4.0 (Bodo again).
+
+ * tests/ogg_test.c
+ Add stereo seek tests.
+
+2007-12-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/ogg_test.c
+ Add a test (currently failing) for stereo seeking on Ogg Vorbis files. Test
+ case supplied by Bodo.
+
+ * tests/utils.(def|tpl)
+ Add compare_XXX_or_die functions.
+
+2007-12-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Fix a bug where ignoring ssnd_fmt.offset and ssnd_fmt.blocksize caused
+ misaligned reading of 24 bit data. Thanks to Uli Franke for reporting this.
+
+2007-12-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/vox_adpcm.c src/ima_oki_adpcm.[ch] src/Makefile.am
+ Merge in code from the vox-patch branch. Thanks to Robs for the patch
+ which fixes a long standing bug in the VOX codec.
+
+2007-12-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-convert.c
+ Fix handling of -override-sample-rate=X option.
+
+2007-11-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ogg.c src/VORBIS
+ Merge in Ogg Vorbis support from John ffitch of the Csound project.
+
+2007-11-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Recognise files with 'vox6' extension as 6kHz OKI VOX ADPCM files. Also
+ recognise 'vox8' as and 'vox' as 8kHz files.
+
+ * configure.ac
+ Detect libjack (JACK Audio Connect Kit).
+
+ * examples/sndfile-jackplay.c examples/Makefile.am
+ Add new example program to play sound files using the JACK audio server.
+ Thanks to Jonatan Liljedahl for allowing this to be included.
+
+2007-11-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/index.html
+ Update support table with SD2 and FLAC.
+
+2007-11-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fix calculation of internal value psf->read_current when attempting to read
+ past end of audio data.
+ Remove redundant code.
+
+ * tests/lossy_comp_test.c
+ Add read_raw_test to check that raw reads do not go past the end of the
+ audio data section.
+ Clean up error output messages.
+
+ * src/sndfile.c
+ Add code to prevent sf_read_raw from reading past the end of the audio data.
+
+ * tests/Makefile.am
+ Add the wav_pcm lossy_comp_test.
+
+2007-11-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac src/Makefile.am src/create_symbols_file.py
+ More OS/2 fixes from David Yeo.
+
+2007-11-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c tests/utils.tpl tests/benchmark.tpl
+ Improve handling of requirements for O_BINARY as suggested by Ed Schouten.
+
+2007-11-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Fix symbol class when SF_MIN is nested inside SF_MAX or vice versa.
+
+ * src/create_symbols_file.py
+ Add support for OS/2 contributed by David Yeo.
+
+2007-11-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * M4/gcc_version.m4
+ Add macro AC_GCC_VERSION to detect GCC_MAJOR_VERSION and GCC_MINOR_VERSION.
+
+ * configure.ac
+ Use AC_GCC_VERSION to work around gcc-4.2 inline warning stupidity.
+ See http://gcc.gnu.org/bugzilla/show_bug.cgi?id=33995
+ Use -fgnu-inline to prevent stupid warnings.
+
+2007-11-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/util.tpl
+ Increase the printing width for print_test_name().
+
+ * tests/command_test.c tests/Makefile.am
+ Add tests for correct updating of broadcast WAV coding history.
+
+ * examples/sndfilehandle.cc examples/Makefile.am
+ Add example program using the C++ SndfileHandle class.
+
+2007-10-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/sndfile.c
+ Add error codes SFE_ZERO_MAJOR_FORMAT and SFE_ZERO_MINOR_FORMAT.
+
+2007-10-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sd2.c
+ Identify sample-rate/sample-size/channels by resource id.
+
+2007-10-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/broadcast.c src/common.h src/sndfile.c
+ Improvements to handling of broadcast info in WAV files. Thanks to Frederic
+ Cornu and other for their input.
+
+2007-10-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/FLAC/include/share/alloc.h
+ Mingw fix for SIZE_T_MAX from Uli Franke.
+
+2007-10-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/open_fail_test.c tests/error_test.c tests/Makefile.am
+ Move tests from open_fail_test.c to error_test.c and remove the former.
+
+2007-10-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/scale_clip_test.(def|tpl)
+ Add tests for SFC_SET_INT_FLOAT_WRITE command.
+
+ * doc/command.html
+ Add docs for SFC_SET_INT_FLOAT_WRITE command.
+
+ * examples/sndfile-play.c tests/dft_cmp.c
+ Fix gcc-4.2 warning messages.
+
+2007-10-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in src/sndfile.c
+ Add command SFC_GET_CURRENT_SF_INFO.
+
+ * src/sndfile.h.in src/sndfile.c src/create_symbols_file.py
+ Remove function sf_get_info (only ever in pre-release code).
+
+ * tests/command_test.c
+ Add test for SFC_GET_CURRENT_SF_INFO.
+
+2007-10-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Add parsing of 'exif' chunks. Originally coded by Trent Apted.
+
+ * configure.ac
+ Put config stuff in Cfg directory.
+ Remove check for inttypes.h.
+
+2007-10-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/w64.c
+ Fix writing of 'riff' chunk length and check for correct value in parser.
+
+2007-09-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/index.html
+ Link to MP3 FAQ entry.
+
+2007-09-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/flac.c
+ Move the blocksize check to an earlier stage of flac_buffer_copy.
+
+2007-09-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/FLAC
+ Huge merge from FLAC upstream.
+
+2007-09-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/*.c
+ Change license to all example programs to BSD.
+
+2007-09-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/FLAC/include/FLAC/metadata.h
+ Include <sys/types.h> to prevent compile error on OSX.
+
+ * Octave/octave_test.sh
+ Disable test on OSX. Can't get it to work.
+
+ * src/flac.c
+ Check the blocksize returned from the FLAC decoder to prevent buffer
+ overruns. Reported by Jeremy Friesner. Thanks.
+
+2007-09-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Makefile.am M4/octave.m4
+ Fix build when Octave headers are not present.
+
+2007-08-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/development.html
+ Add note about bzr repository directory looking empty.
+
+2007-08-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac Octave/* M4/octave_*
+ Bunch of changes to add ability to build GNU Octave modules to read/write
+ sound files using libsndfile from Octave.
+
+2007-08-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * acinclude.m4 configure.ac ...
+ Get rid of acinclude.m4 and replace it with an M4 directory.
+
+2007-08-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in
+ Remove crufty Metrowerks compiler support. Allow header file to be compiled
+ on windows with both GCC and microsoft compiler.
+
+2007-08-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/dft_cmp.[ch] tests/floating_point_test.tpl
+ Clean up floating point tests.
+
+2007-08-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Fix segfault when COMM chunk length is byte swapped.
+
+2007-08-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/mat4.c src/mat5.c src/sndfile.c
+ Add a generic SFE_CHANNEL_COUNT_ZERO error, remove format specific errors.
+
+ * src/au.c
+ Fix crash on AU files with zero channel count. Reported by Ben Alison.
+
+2007-08-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/voc.c
+ Fix bug in handling file supplied by Matt Olenik.
+
+2007-07-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/OGG
+ Merge from OGG upstream sources.
+
+2007-07-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/FLAC
+ Merge from FLAC upstream sources.
+
+2007-07-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/flac.c
+ Fix memory leak; set copy parameter to FALSE in call to
+ FLAC__metadata_object_vorbiscomment_append_comment.
+
+ * src/common.[ch]
+ Add function psf_rand_int32().
+
+2007-07-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/FLAC
+ Merge from FLAC upstream sources.
+
+ * src/strings.c tests/string_test.c tests/Makefile.am
+ Make sure string tests for SF_STR_LICENSE actually works.
+
+2007-07-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/string_test.c
+ Add ability to test strings stored in metadata secion of FLAC files.
+
+ * src/string.c
+ Fix logic for testing if audio data has been written and string is added.
+ Make sure SF_STR_ALBUM actually works.
+
+ * src/flac.c
+ Finalize reading/writing string metadata. Tests pass.
+
+ * src/sndfile.h.in tests/string_test.c src/flac.c
+ Add string type SF_STR_LICENSE, update test and use for FLAC files.
+
+ * src/sndfile.h.in
+ Add definition for SFC_SET_SCALE_FLOAT_INT_WRITE command.
+
+ * src/common.h src/double64.c src/float32.c src/sndfile.c
+ Add support for SFC_SET_SCALE_FLOAT_INT_WRITE (still needs testing).
+
+2007-07-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/flac.c
+ Apply patch from Ed Schouten to read artist and title metadata from FLAC
+ files.
+ Improve reporting of FLAC metadata.
+
+ * src/sndfile.h.in tests/string_test.c src/flac.c
+ Add string type SF_STR_ALBUM, update test and use for FLAC files.
+
+2007-06-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/FLAC/*
+ Merge from upstream CVS.
+
+2007-06-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/FLAC/*
+ Update from upstream CVS.
+
+2007-06-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/cpp_test.cc
+ Add extra tests for when the SndfileHandle constructor fails.
+
+ * src/sndfile.hh
+ Make sure failure to open the file in the constructor does not allow later
+ calls to other methods to fail.
+
+2007-06-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/util.tpl
+ Add function write_mono_file.
+
+ * tests/generate.[ch] tests/Makefile.am
+ Add files generate.[ch] and hook into build.
+
+ * tests/write_read_test.tpl
+ Add multi_seek_test.
+
+ * src/flac.c
+ Fix buffer overflow bug. Test provided by Jeremy Friesner and fix provided
+ by David Viens.
+
+2007-06-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/FAQ.html
+ Minor update.
+
+ * configure.ac src/FLAC/src/libFLAC/ia32/Makefile.am src/Makefile.am
+ Apply patch from Trent Apted make it compile on Intel MacOSX. Thanks Trent.
+
+2007-05-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Fix writing of MSGUID subtypes. Thanks to Bruce Sharpe.
+
+2007-05-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Fix array indexing bug raised by Bruce Sharpe.
+
+2007-05-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/FLAC/src/share/getopt/getopt.c
+ Fix Mac OSX / PowerPC compile warnings.
+
+ * configure.ac
+ Make sure WORDS_BIGENDIAN gets correctly defined for FLAC code.
+
+2007-05-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/FAQ.html
+ Add Q/A about MP3 support.
+
+2007-05-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/new_file_type.HOWTO
+ Minor updates.
+
+2007-05-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wve.c
+ Fix a couple bad parameters with psf_log_printf.
+
+ * src/pcm.c
+ Improve error reporting.
+
+ * src/common.h src/common.c
+ Constify psf_hexdump.
+
+2007-04-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/FLAC
+ Ditch and re-import required FLAC code.
+
+ * configure.ac
+ Force FLAC__HAS_OGG variable to 1.
+
+ * src/FLAC/src/libFLAC/stream_encoder.c
+ Fix compiler warnings.
+
+2007-04-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac tests/win32_ordinal_test.c
+ Detect if win32 DLL is beging generated and only run win32_ordinal_test if
+ true.
+
+ * src/G72x/Makefile.am src/Makefile.am
+ Use $(EXEEXT) where possible.
+
+2007-04-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wve.c src/common.h src/sndfile.c
+ Complete definition of SfE_WVE_NO_WVE error message.
+
+ * src/wve.c
+ Fix error in files generated on big endian systems. Robustify parsing.
+
+2007-04-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/double64.c
+ Fix clipping of double to short conversions on 64 bit systems.
+
+ * src/flac.c regtest/database.c tests/cpp_test.cc
+ Fix compile warnings for 64 bit systems.
+
+2007-04-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c src/wav_w64.c
+ Use audio detect function when 'fmt ' chunk data is suspicious.
+
+ * configure.ac
+ Add ugly hack to remove -Werror from some Makefiles.
+
+2007-04-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/GSM610/long_term.c src/macbinary3.c tests/cpp_test.cc
+ Add patch from André Pang to clean up compiles on OSX.
+
+ * src/wve.c src/common.h src/sndfile.c src/sndfile.h.in
+ examples/sndfile-convert.c
+ Merge changes from Reuben Thomas to improve WVE support.
+
+ * tests/lossy_comp_test.c tests/Makefile.am
+ Add tests for WVE files.
+
+2007-04-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.hh
+ Add a static SndfileHandle::formatCheck method as suggested by Jorge
+ Jiménez.
+
+2007-04-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fixed a bug in sf_error() where the function itself was being compared
+ against zero. Add a check for a NULL return from peak_info_calloc. Fix a
+ possible NULL dereference.
+
+2007-04-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/flac.c
+ Turn off seekable flag when writing, return SFE_BAD_RDWR_FORMAT when
+ opening file for RDWR.
+
+ * src/sndfile.c
+ Improve error message for SFE_BAD_RDWR_FORMAT.
+
+ * src/mat4.c
+ Fix array indexing issue. Thanks to Ben Allison (Nullsoft) for alerting me.
+
+2007-03-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/FAQ.html
+ Add Q/A 19 on project files.
+
+2007-03-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Guard agains MacOSX universal binary compiles.
+
+ * doc/FAQ.html
+ Add Q/A 18 and clean up Q3.
+
+2007-02-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Add support for 'in24' files.
+
+2007-02-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c src/wav_w64.c src/wav_w64.h
+ Start work towards detecting ausio codec type from the actual audio data.
+
+ * src/audio_detect.c src/test_audio_detect.c
+ Add new file and its unit test.
+
+2007-02-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/cooledit-fixer.c examples/Makefile.am
+ Remove old broken example program.
+
+2007-02-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c src/sndfile.h.in src/create_symbols_file.py
+ Add function sf_get_info.
+
+2007-01-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-play.c
+ For ALSA, use the 'default' device instead of 'plughw:0'.
+
+2007-01-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Allow writing of WAV/WAVEX 'BEXT' chunks in SFM_RDWR mode.
+
+2007-01-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/development.html doc/embedded_files.html man/sndfile-play.1
+ Minor documentation fixes. Thanks Reuben Thomas.
+
+2006-12-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-convert.c
+ Add -override-sample-rate command line option.
+
+2006-11-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/misc_test.c
+ Force errno to zero at start of some tests.
+
+ * src/sndfile.c
+ Minor clean up of error handling.
+
+ * configure.ac
+ Remove an assembler test which was failing on OSX.
+
+2006-11-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Fix the definition of SF_PLATFORM_S64 for MinGW.
+
+ * src/FLAC/Makefile.am src/FLAC/share/grabbag/Makefile.am
+ Fix path problems for MinGW.
+
+2006-11-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sfendian.h
+ Add include guard.
+
+ * src/Makefile.am src/flac.c
+ Clean up include paths.
+
+ * src/test_conversions.c
+ New file to test psf_binheader_readf/writef functions.
+
+ * src/Makefile.am src/test_file_io.c src/test_log_printf.c src/common.c
+ Clean up unit testing.
+
+ * src/common.c
+ Fix a bug reading/writing 64 bit header fields. Thanks to Jonathan Woithe
+ for reporting this.
+
+ * src/test_conversions.c
+ Complete unit test for above fix.
+
+2006-11-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ More refactoring to clean up psf_open_file() and vairous sf_open()
+ functions.
+
+2006-11-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Apply a patch from Jonathan Woithe to allow opening of (malformed) WAV
+ files of over 4 gigabytes.
+
+2006-11-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Refactor function psf_open_file() to provide a single return point.
+
+ * tests/misc_test.c
+ Fix permission_test to ensure that read only file can be created.
+
+2006-11-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Add SF_PLATFORM_S64 macro as a platform independant way of doing signed 64
+ bit integers.
+
+ * src/aiff.c src/svx.c src/wav.c
+ Add warning in log if files are larger than 4 gigabytes in size.
+
+2006-11-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/FLAC src/OGG confgure.ac src/Makefile.am
+ Pull in all required FLAC and OGG code so external libraries are not
+ needed. This makes compiling on stupid fscking Windoze easier.
+
+2006-10-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sd2.c
+ Add workaround for switched sample rate and sample size.
+
+ * src/wav.c
+ Add workaround for excessively long coding history in the 'bext' chunk.
+
+2006-10-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in src/sndfile.c src/wav.c doc/command.html
+ Use SF_AMBISONIC_* instead of SF_TRUE/SF_FALSE.
+
+2006-10-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in src/wav.c src/wav_w64.c src/common.h doc/command.html
+ Apply a patch from Fons Adriaensen to allow writing on WAVEX Ambisonic
+ files. Still needs a little tweaking before its ready for release.
+
+ * src/*.c
+ Use the UNUSED macro to prevent compiler warnings.
+
+2006-10-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Fix a bug in parsing AIFF files with a slightly unusual 'basc' chunk. Thanks
+ to David Viens for providing two example files.
+
+ * src/common.(c|h) src/aiff.c
+ Add a function psf_sanitize_string and use it in aiff.c.
+
+2006-10-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav_w64.c
+ Apply a patch from Fons Adriaensen which fixes a minor WAVEX GUID issue.
+
+2006-10-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/Makefile.am
+ Fix problem related to recent test coverage changes.
+
+2006-10-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac tests/Makefile.am
+ Add --enable-test-coverage configure option.
+
+2006-10-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.hh
+ Add an std::string SndfileHandle constructor.
+
+ * tests/scale_clip_test.tpl
+ Fix the 'make distcheck' target.
+
+2006-10-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/double64.c src/float32.c
+ Add optional clipping on float file data to int read data conversions.
+
+ * tests/tests/scale_clip_test.(def|tpl)
+ Add test for above new code.
+
+2006-09-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/aiff_rw_test.c
+ Add 'MARK' chunks to make sure they are parsed correctly.
+
+2006-09-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Fix parsing of MARK chunks. Many thanks to Sciss for generating files to
+ help debug the problem.
+
+2006-09-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Make the SF_MIN and SF_MAX macros at least partially type safe.
+
+ * tests/lossy_comp_test.c
+ Fix overflow problems when ensuring that signalis not zero.
+
+2006-08-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac docs/*.html
+ Changes for release 1.0.17.
+
+2006-08-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/flac.c
+ Remove inline from functions called by pointer. Thanks to Sampo Savolainen
+ for notifying me of this.
+
+2006-07-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.hh
+ Add writeSync method.
+ Add copy constructor and assignment operator (thanks Daniel Schmitt).
+ Add methods readRaw and writeRaw.
+ Make read/write/readf/writef simple overlaods instead of templates (thanks
+ to Trent Apted for suggesting this).
+
+ * tests/cpp_test.cc
+ Cleanup. Add tests.
+
+2006-07-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.hh
+ Templatize the read/write/readf/writef methods as suggested by Lars Luthman.
+ Prevent the potential leak of SNDFILE* pointers in the openRead/openWrite/
+ openReadWrite methods.
+ Add const to SF_INFO pointer in Sndfile constructor.
+ Make the destrictor call the close() method.
+
+ * tests/cpp_test.cc
+ Add more tests.
+
+2006-07-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/cpp_test.cc
+ Remove the generated file so "make distcheck" passes.
+
+ * src/Makefile.am
+ Add sndfile.hh to distributed header files.
+
+ * src/sndfile.hh
+ Change the license for the C++ wrapper to modified BSD.
+
+2006-07-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.hh
+ Complete it.
+
+ * tests/cpp_test.cc
+ Add more tests.
+
+2006-07-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/utils.tpl
+ Add extern C to generated header file.
+
+ * src/sndfile.hh
+ Work towards completing this.
+
+ * tests/cpp_test.cc tests/Makefile.am
+ Add a C++ test and hook into build.
+
+ * configure.ac
+ Add appropriate CXXFLAGS.
+
+2006-07-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Test if compiler supports -Wpointer-arith.
+
+ * src/common.c
+ Fix a warning resulting from -Wpointer-arith.
+
+2006-07-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-play.c
+ Explicitly set endian-ness as well as setting 16 bit output.
+
+ * examples/sndfile-info.c
+ Make sure to parse info if file fails to open.
+
+ * src/sndfile.c
+ Handle parse error a little better.
+
+ * src/wav_w64.[ch]
+ Minor clean up, add detection of IPP ITU G723.1.
+
+2006-06-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Make sure psf->dataoffset gets reset to zero when openning headersless
+ files based on the file name extension.
+
+2006-06-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/(command|lossy_comp|pcm|scale_clip)_test.c tests/fix_this.c
+ tests/write_read_test.(tpl|def)
+ Fix gcc-4.1 compiler warnings about "dereferencing type-punned pointer will
+ break strict-aliasing rules".
+
+ * examples/cooledit-fixer.c
+ More fixes like above.
+
+2006-06-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Fix a windows bug where the syserr string of SF_PRIVATE was not being set
+ correctly.
+
+ * src/sndfile.c
+ Fixed a logic bug in sf_seek(). Thanks to Paul Davis for finding this.
+
+2006-06-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Fixed detection of S_IRGRP.
+
+2006-05-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * sndfile-convert.c
+ Add conversion SF_INSTRUMENT data when present.
+
+2006-05-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/development.html
+ Removed references to tla on windows.
+
+ * src/common.h src/sndfile.c
+ Add separate void pointers for file containter and file codec data to
+ SF_PRIVATE struct. Still need to move all existing fdata pointers.
+
+ * tests/write_read_test.tpl
+ Change the order of some tests.
+
+ * src/aiff.c
+ When writing 'AIFC' files, make sure get an 'FVER' gets added.
+
+ * src/common.h src/(dwvw|flac|g72x|gsm610|ima_adpcm|ms_adpcm|paf|sds).c
+ src/(sndfile|voc|vox_adpcm|xi).c
+ Remove fdata field from SF_PRIVATE struct and replace it with codec_data.
+
+2006-05-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/testprog.c Win32/Makefile.am
+ Add a minimal win32 test program.
+
+ * Win32/README-precompiled-dll.txt Mingw-make-dist.sh
+ Update readme and Mingw build script.
+
+2006-05-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac acinclude.m4
+ Minor fixes for Solaris.
+
+2006-05-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/test_endswap.(def|tpl)
+ Fix printf formatting for int64_t on 64 bit machines.
+
+2006-05-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/binhead_check.py
+ New file to check for bad parameters passed to psf_binheader_writef().
+
+ * src/Makefile.am
+ Hook into test suite.
+
+ * src/voc.c src/caf.c src/wav.c src/mat5.c src/mat4.c
+ Fix bugs found by new test program.
+
+ * src/double64.c
+ Clean up double64_get_capability().
+
+2006-05-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav_w64.c
+ Fix a bug on x86_64 where an int was being passed via stdargs and being
+ read using size_t which is 64 bits. Thenks to John ffitch for giving me a
+ login on his box.
+
+2006-05-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/caf.c src/double64.c examples/sndfile-info.c tests/virtual_io_test.c
+ tests/utils.tpl
+ Fix a couple of signed/unsigned problems.
+
+2006-05-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/command_test.c
+ Add channel map tests.
+
+ * src/common.h src/sndfile.c
+ Add a pointer the the SF_PRIVATE struct and make sure it gets freed in
+ sf_close().
+
+2006-04-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac doc/(command|index|api).html NEWS README
+ Updates for 1.0.16 release.
+
+ * src/sndfile.h.in
+ Define enums for channel mapping.
+
+ * examples/sndfile-info.c
+ Clean up usage of SF_INFO struct.
+
+2006-04-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/util.tpl
+ Add function testing function exit_if_true().
+
+ * tests/floating_point_test.tpl
+ Fix a problem where the test program was not exiting when the test failed.
+
+2006-04-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in src/sndfile.c src/common.h src/command.c
+ Implement new commands SFC_GET_SIGNAL_MAX and SFC_GET_MAX_ALL_CHANNELS.
+
+ * doc/commands.html
+ Document new commands. Other minor updates.
+
+ * tests/peak_chunk_test.c
+ Update tests for new commands.
+
+2006-04-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/peak_chunk_test.c
+ Add test for RIFX and WAVEX files.
+ Try and confuse the PEAK chunk writing by enabling and disabling it.
+
+ * src/sndfile.c
+ Fix a bug where enabling and disabling PEAK chunk was screwing up.
+
+2006-03-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in
+ Add the block of 190 reserved bytes into this struct to allow for
+ future expansion.
+
+ * src/wav.c src/sndfile.c src/broadcast.c
+ Significant cleanup of broadcast wave stuff.
+
+ * examples/sndfile-info.c
+ Fix print message.
+
+ * tests/command_test.c tests/Makefile.am
+ Complete bext tests, hook test in test suite.
+
+2006-03-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in
+ Make coding_history field of SF_BROADCAST_INFO struct a char array instead
+ of a char pointer.
+
+ * src/sndfile.c src/common.h src/wav.c
+ Clean up knock on effects of above chnage.
+
+ * examples/sndfile-info.c
+ Add -b command line option to usage message.
+ Clean up output of broadcast wave info.
+
+ * src/wav.c
+ Ignore and skip the 'levl' chunk.
+
+2006-03-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Fix handling of --enable and --disable configure args. Thanks to Diego
+ 'Flameeyes' Pettenò who sent the patch.
+
+2006-03-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/win32.html
+ Make it really clear that although the MSVC++ cannot compile libsndfile,
+ the precompiled DLL can be used in C++ programs compiled with MSVC++.
+
+2006-03-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Fix bug in writing of INST chunk in AIFF files.
+ Fix potential bug in writing MARK chunks.
+
+ * src/sndfile.c
+ Make sure the instrument chunk can only be written at the start of the file.
+
+ * tests/command_test.c
+ Add check of log buffer.
+
+ * tests/utils.tpl
+ Add usage of space character to psf_binheader_writef.
+
+2006-03-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/Makefile.am tests/Makefile.am
+ Remove --source-time argument from autogen command lines.
+
+ * src/broadcast.c
+ New file for EBU Broadcast chunk in WAV files.
+
+ * src/sndfile.c src/sndfile.h.in src/wav.c src/common.h
+ Add patch from Paul Davis implementing read/write of the BEXT chunk.
+
+2006-03-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/README-precompiled-dll.txt
+ New file descibing how to use the precompiled DLL.
+
+ * Win32/Makefile.am
+ Add Win32/README-precompiled-dll.txt to EXTRA_DIST files.
+
+ * configure.ac
+ Bump version to 1.0.15.
+
+2006-03-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ On read, only add the endian flag if the file is big endian.
+
+ * src/ms_adpcm.c
+ Fixed writing of APDCM coeffs in RIFX files.
+
+ * tests/write_read_test.tpl tests/lossy_comp_test.c
+ Add tests for RIFX files.
+
+2006-03-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Mingw-make-dist.sh
+ Bunch of improvements.
+
+ * doc/win32.html
+ Update MinGW program versions.
+
+2006-03-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/create_symbols_file.py
+ Fix the library name in created win32 DEF file. Add correct DLL name for
+ Cygwin DLL.
+
+ * Win32/Makefile.am tests/Makefile.am
+ Remove redundant files, add win32_ordinal_test to test suite.
+
+ * tests/win32_ordinal_test.c
+ Update to do test in cygsndfile-1.dll as well.
+
+ * doc/win32.html
+ Fix typo, mention that -mno-cygwin with the Cygwin compiler does not work.
+
+ * src/wav.c src/wav_w64.c src/sndfile.c src/sndfile.h.in
+ Apply large patch from Jesse Chappell which adds support for RIFX files.
+
+2006-03-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Makefile.am
+ Add Mingw-make-dist.sh to the extra dist files.
+
+ * configure.ac
+ Fix setting SHLIB_VERSION_ARG for MinGW.
+
+ * tests/win32_ordinal_test.c
+ New test program to test that the win32 DLL ordinals agree with the DEF
+ file.
+
+2006-03-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Add a static inline function to convert an int to a size_t. This will be
+ a compile to nothing on 32 bit CPUs and a sign extension on 64 bit CPUs.
+
+ * src/aiff.c src/avr.c src/common.c src/xi.c src/gsm610.c
+ Fix an ia64 problem where a varargs function was being passed an int in
+ some places and a size_t in other places.
+
+ * src/sd2.c
+ Add a workaround for situations where OSX seems to add an extra 0x52 bytes
+ to the start of the resource fork.
+
+2006-02-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Mingw-make-dist.sh
+ Add a shell script to build the windows binary/source ZIP file.
+
+ * doc/index.html
+ Add download link for windows binary/source ZIP file. Add links for GPG
+ signatures.
+
+ * doc/win32.html
+ Remove info about building using microsoft compiler.
+
+ * configure.ac
+ Bump version to 1.0.14.
+
+2006-02-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sd2.c
+ Improve logging of errors in resource fork parser.
+
+2006-01-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/Makefile.msvc
+ Replace au_g72x.* with g72x.*. Thanks to ussell Borogove.
+
+2006-01-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.c
+ Make sure return values are initialised header buffer is full.
+
+ * src/wav.c
+ Add workarounds for messed up WAV files.
+
+2006-01-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/config.h
+ Undef HAVE_INTTYPES_H for win32.
+
+ * tests/command_test.c
+ Don't exit on error in instrument test for XI files.
+
+ * configure.ac
+ Bump version to 1.0.13.
+
+ * doc/*.html NEWS README
+ Update version numbers.
+
+2006-01-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/xi.c
+ Start work on add read/write of instrument chunks.
+
+ * src/command_test.c
+ Add tests for XI instrument chunk.
+
+ * tests/largefile_test.c tests/Makefile.am
+ Add new test and hook it into the build system. This test will not be run
+ automatically because it requires 3 Gig of disk space and takes 3 minutes
+ to run.
+
+2006-01-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-play.c
+ Fix calculation of samples remaining in win32 code. Thanks Axel Röbel.
+
+ * src/common.h
+ Make sure length of header buffer can hold header plus strings. Thanks Axel
+ Röbel.
+
+2006-01-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in src/aiff.c src/wav.c
+ Apply a patch from John ffitch (Csound project).
+ Add detune field to SF_INSTRUMENT struct.
+ Add reading/writing instrument chunks to WAV files.
+
+ * tests/command_test.c
+ Update SF_INSTRUMENT tests.
+
+ * tests/Makefile.am
+ Hook instrument tests into test suite.
+
+2006-01-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Check for <inttypes.h> because some broken systems (like Solaris) don't have
+ <stdint.h> which is the 1999 ISO C standard file containing int64_t.
+
+ * src/sfendian.h src/common.h
+ Use <inttypes.h> if <stdint.h> is not available.
+
+2005-12-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/peak_chunk_test.c
+ Extend and clean up tests.
+
+ * src/sndfile.c
+ Fix a bug that prevented the turning off of PEAK chunks.
+
+2005-12-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/error_test.c
+ Make the test distclean correct.
+
+ * src/file_io.c
+ Fix an SD2 MacOSX bug (reported by vince schwarzinger).
+
+2005-12-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c tests/command_test.c
+ Apply a big patch from John ffitch (Csound project) to add reading and
+ writing of instrument chunks to AIFF files. Also update the test.
+
+2005-12-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/aiff_rw_test.c tests/virtual_io_test.c tests/utils.tpl
+ Move test function dump_data_to_file() to utils.tpl.
+
+ * tests/error_test.c tests/Makefile.am
+ Updates, including a new test to test that sf_error() returns a valid error
+ number.
+
+2005-12-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/list_formats.c
+ Make sure the SF_INFO struct is memset to all zero before being used.
+ Thanks to Stephen F. Booth.
+
+ * src/sndfile.c
+ Make the return value of sf_error() match the API documentation.
+
+2005-11-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-convert.c
+ Allow conversion to raw gsm610.
+
+ * src/common.h src/sndfile.c src/au.c
+ Remove au_nh_open() and all references to it (wasn't working anyway).
+
+ * tests/headerless_test.c
+ Add new test for file extension based detection.
+
+ * src/sndfile.c
+ Rejig file extension based file type detection.
+
+2005-11-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Add "gsm" as a recognised file extension when no magic number can be found.
+
+ * tests/lossy_comp_test.c tests/Makefile.am
+ Test headerless GSM610.
+
+2005-11-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/api.html
+ Fix a minor typo and a minor error. Thanks Christoph Kobe and John Pavel.
+
+2005-10-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav_w64.c
+ Add more reporting of 'fmt ' chunk for G721 encoded files.
+
+ * src/wav.c
+ Gernerate a more correct 20 byte 'fmt ' chunk rather than a 16 byte one.
+
+2005-10-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/G72x/g72x.[ch]
+ Minor cleanup of interface.
+
+2005-10-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ogg.c
+ Removed the horribly broken and non-functional OGG implementation when
+ --enable-experimental was enabled. When OGG does finally work it will be
+ merged.
+
+ * src/caf.c
+ Fix a memory leak.
+
+2005-10-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/g72x.c src/G72x/*.(c|h) src/common.h src/sndfile.c src/wav.c src/au.c
+ Add support for G721 encoded WAV files.
+
+ * doc/index.html
+ Update support matrix.
+
+ * tests/lossy_comp_test.c
+ For file formats that support it, add string data after the audio data and
+ make sure it isn't treated as audio data on read.
+
+ * src/gsm610.c
+ Add code to ensure that the container close function (ie for WAV files) gets
+ called after the codec's close function. This allows GSM610 encoded WAV files
+ to have string data following the audio data.
+ Add an AIFF specific check on psf->datalength.
+
+ * src/wav.c
+ Simplify wav_close function.
+
+ * src/aiff.c
+ Make sure the tailer data gets written at an even file offset. Pad if
+ necessary.
+
+ * src/common.h
+ Replace the close function pointer in SF_PRIVATE with separate functions
+ codec_close and container_close. The former is always called first.
+
+ * src/*.c
+ Fix knock on effects of above.
+
+2005-10-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-info.c
+ Complete dumping SF_INSTRUMENT data.
+
+ * src/dwvw.c src/ima_adpcm.c src/gsm610.c src/ms_adpcm.c
+ Add extra checks in *_init function.
+
+ * tests/lossy_comp_test.c
+ Add a string comment to the end of the files to make sure that the decoder
+ doesn't decode beyond the end of the audio data section.
+
+2005-10-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-info.c
+ Minor code cleanup.
+ Start work on dumping SF_INSTRUMENT data.
+
+2005-10-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in src/common.h src/common.c
+ Update definition of SF_INSTRUMENT struct and create a function to allocate
+ and initialize the struct (input from David Viens).
+ Clean up definition of SF_INSTRUMENT struct.
+
+ * src/wav.c src/wav_w64.c
+ Add support for Ambisoncs B WAVEX files (David Viens).
+
+ * src/aiff.c src/wav.c src/wav_w64.c
+ Start work on reading/writing the SF_INSTRUMENT data.
+
+ * src/sndfile.c
+ Add code to get and set SF_INSTRUMENT data.
+
+ * tests/command_test.* tests/Makefile.am
+ Add test for set and getof SF_INSTRUMENT data.
+ The file command_test.c is no longer autogen generated.
+
+2005-10-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/gsm610.c
+ Minor cleanup.
+
+2005-10-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/lossy_comp_test.c
+ Minor cleanup.
+
+2005-10-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.c
+ Ensure sfconfig.h is included before any other header file.
+
+ * src/file_io.c
+ Add comments documenting the three sections of the file.
+
+ * src/gsm610.c
+ Make sure SF_FORMAT_WAVEX are handled correctly.
+
+2005-10-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Add options to allow disabling of FLAC and ALSA. Suggested by Ben Greear.
+
+2005-09-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/locale_test.c
+ Modify the way the unicode strings were encoded so that older compilers
+ do not complain. Thanks Axel Röbel.
+
+ * configure.ac
+ Bump the version to 1.0.12 for release.
+
+ * NEWS README Win32/config.h doc/(FAQ|index.html|command|api).html
+ Update version numbers.
+
+2005-09-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/flac.c
+ Fix valgrind error and minor cleanup.
+
+2005-09-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/(au|paf|aiff|w64|wav|svx).c
+ Make sure structs are initialised.
+
+2005-09-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Make -Wdeclaration-after-statement work with --enable-gcc-werror configure
+ option.
+ Add -std=gnu99 (C99 plus posix style stuff like gmtime_r) to CFLAGS if the
+ compiler supports it.
+
+2005-09-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac acinclude.m4
+ Add -Wdeclaration-after-statement to CFLAGS if the compilers supports it.
+
+2005-09-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/util.(tpl|def)
+ Make the test_write_*_or_die() functions const safe.
+
+2005-09-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/nist.c
+ Make sure the data offset is read from the file header. Thanks to
+ David A. van Leeuwen for a patch.
+
+2005-09-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac src/sfconfig.h
+ Check for <locale.h> and the function setlocale().
+ Set config variables to zero if not found.
+
+ * tests/locale_test.c tests/Makefile.am
+ Add new test program and hook into build/test system.
+
+2005-09-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/file_io.c
+ On windows, use windows specific types for file handles.
+ Add functions psf_init_files() and psf_use_rsrc().
+
+ * src/sd2.c
+ Make resource fork handling independant of file desciptor/handles.
+
+ * src/sndfile.c src/test_file_io.c
+ Fix knock on effects.
+
+2005-09-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/float_cast.h
+ The lrint and lrintf implementations in Cygwin are both buggy and slow.
+ Add replacements which were pulled from the Public Domain MinGW math.h
+ header file.
+
+2005-09-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/(lossy_comp_test|virtual_io_test).c
+ More Valgrind fixups.
+
+ * configure.ac
+ Simplify and correct configuring for Cygwin.
+
+ * Win32/config.h Win32/sndfile.h Win32/Makefile.msvc
+ Update build for MSVC.
+
+2005-09-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/lossy_comp_test.c
+ Make sure to close SNDFILE when exiting test when file format is not seekable.
+
+ * tests/(aiff_rw_test|virtual_io_test).c
+ Do a few valgrind fix ups.
+
+2005-09-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/float32.c src/double64.c
+ Replace floating point equality comparisons with greater/less comparisons.
+ Found by John Pavel using the Intel compiler.
+
+ * src/sfconfig.h
+ New file to clean up issues surrounding autoconf generated preprocessor
+ symbols.
+
+ * src/*.(c|h) tests/*.(c|tpl) examples/*.c
+ Fixed a bunch of other stuff found by John Pavel using the Intel compiler.
+
+ * src/file_io.c
+ Remove Mac OS9 Metrowerks compiler specific hacks.
+
+2005-08-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/w64.c
+ Cast integer literal to sf_count_t in call to psf_binheader_writef() to
+ prevent Valgrind error.
+
+2005-08-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/command.html
+ Improve documentation of SF_GET_FORMAT_SUBTYPE.
+
+2005-08-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-convert.c
+ Allow files to be converted to SD2 format.
+
+ * src/sd2.c
+ Fix a bug in reading and writing of SD2 files on little endian CPUs.
+ Thanks to Matthew Willis for finding this.
+
+2005-08-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/api.html
+ Update Note2 to point to SFC_SET_SCALE_FLOAT_INT_READ.
+
+2005-08-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Use $host_os instead of $target_os (thanks to Mo De Jong).
+
+2005-08-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/Makefile.am
+ Apply a patch from Mo DeJong to allow building outside of the source dir.
+
+ * src/file_io.c
+ Fix psf_fsync() for win32.
+
+ * src/wav.c src/wav_w64.(c|h)
+ Move some code from wav.c to wav_w64.c to improve the log output of files of
+ type WAVE_FORMAT_EXTENSIBLE.
+
+2005-08-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/create_symbols_file.py
+ Make sure sf_write_fsync is an exported symbol.
+
+ * examples/sndfile-convert.c
+ Add support for writing VOX adpcm files.
+
+2005-07-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/api.html
+ Document the new function sf_write_sync().
+
+ * doc/FAQ.html
+ Do you plan to support XYZ codec.
+
+2005-07-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in src/sndfile.c
+ Add function sf_write_sync() to the API.
+
+ * src/common.h src/file_io.c
+ Low level implementation (win32 not done yet).
+
+ * tests/write_read_test.tpl
+ Use the new function in the tests.
+
+2005-07-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/double64.c src/float32.c src/sndfile.c
+ Change the way PEAK chunk info is stored. Peaks now stored as an sf_count_t
+ for position and a double as the value.
+
+ * src/aiff.c src/caf.c src/wav.c
+ Fix knock on effects of above changes.
+
+ * src/caf.c
+ Implement 'peak' chunk for file wuth data in SF_FORMAT_FLOAT or
+ SF_FORMAT_DOUBLE format.
+
+2005-07-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/nist.c
+ Fix a bug where a variable was being used without being initialized.
+
+ * src/flac.c
+ Add extra debug in sf_flac_meta_callback.
+ Make a bunch of private functions static.
+
+ * src/aiff.c src/wav.c
+ Fix allocation for PEAK_CHUNK (bug found using valgrind).
+
+2005-07-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Move the peak_loc field of SF_PRIVATE to the PEAK_CHUNK struct.
+ Remove had_peak field of SF_PRIVATE, use pchunk != NULL instead.
+ Rename PEAK_CHUNK and PEAK_POS to PEAK_CHUNK_32 and PEAK_POS_32.
+
+ * src/aiff.c src/caf.c src/wav.c src/float32.c src/double64.c
+ Fix knock on effects from above.
+
+2005-07-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Prevent files with unknown chunks from being opened read/write.
+
+2005-07-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/flac.c
+ Do not use psf->end_of_file because it never gets set to anything.
+
+ * src/common.h
+ Remove unused SF_PRIVATE field end_of_file.
+
+2005-07-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.c
+ Change the 'S' format specifier of psf_binheader_writef() to write AIFF
+ style strings (no terminating character).
+
+ * src/aiff.c
+ Move to new (correct) AIFF string style. Thanks to Axel Röbel for being
+ so persistent on this issue.
+
+2005-07-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Allow SFE_UNSUPPORTED_FORMAT as an error from sf_open().
+
+ * doc/api.html doc/command.html
+ Documentation updates (thanks to Kyroz for promoting these updates).
+
+ * src/mat5.c
+ Modify the way the header is written.
+
+2005-07-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/caf.c
+ Add a 'free' chunk to the written file so that the audio data starts at
+ an offset of 0x1000.
+
+ * src/sndfile.c
+ Allow SFE_UNSUPPORTED_FORMAT as an error from sf_open().
+
+2005-07-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/caf.c src/sndfile.c
+ Add support for signed 8 bit integers.
+
+ * tests/write_read_test.tpl
+ Add test for signed 8 bit integers in CAF files.
+
+ * doc/index.html
+ Update matrix for signed 8 bit integers in CAF files.
+
+2005-07-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Update sf_check_format() to support CAF.
+
+ * examples/sndfile-convert.c
+ Add support for ".caf" file extension.
+
+ * doc/index.html
+ Add Apple CAF to the support matrix.
+
+ * src/caf.c
+ Add file write support.
+
+ * src/common.c
+ Fix printing of Frames.
+
+ * tests/Makefile.am tests/write_read_test.tpl tests/lossy_comp_test.c
+ tests/header_test.tpl misc_test.c
+ Add tests for CAF files.
+
+2005-07-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/FAQ.html
+ Fix Q/A about reading/writing memory buffers.
+
+ * src/caf.c
+ Bunch of work to support reading of CAF files.
+
+2005-07-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/(aiff|ima_adpcm|mat4|mat5|ms_adpcm).c examples/sndfile-play.c
+ Fix sign conversion errors reported by gcc-4.0.
+
+ * src/caf.c
+ New file for Apple's Core Audio File format.
+
+ * src/sndfile.c src/common.h src/sndfile.h.in src/Makefile.am
+ Hook new file into build system.
+
+2005-06-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src_wav_w64.c
+ Fix handling of stupidly large 'fmt ' chunks. Thanks to Vadim Berezniker
+ for supplying an example file.
+
+ * src/common.h src/sndfile.c
+ Remove redundant error code SFE_WAV_FMT_TOO_BIG.
+
+2005-06-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in src/common.h src/sndfile.c
+ Add public error value SF_ERR_MALFORMED_FILE.
+
+ * src/sndfile.c
+ When parsing a file header fails and we don't have a system error, then set
+ the error number to SF_ERR_MALFORMED_FILE (suggested by Kyroz).
+
+ * configure.ac
+ Allow sqlite support to be disabled in configure script.
+
+ * regtest/database.c regtest/sndfile-regtest.c
+ Fix compiling when sqlite is missing.
+
+2005-06-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Fix psf_is_pipe() and return value of psf_fread() when using virtual i/o.
+
+ * src/sndfile.c
+ Fix VALIDATE_AND_ASSIGN_PSF macro for virtual i/o.
+
+ * tests/virtual_io_test.c
+ Fill in skeleton test program.
+
+ * tests/Makefile.am
+ Move virtual i/o tests to end of tests with stdio/pipe tests.
+
+ * src/(sndfile.h.in|file_io.c|common.h|sndfile.c) tests/virtual_io_test.c
+ Rename some of the virtual i/o functions and data types.
+
+2005-06-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fix the return values of sf_commands : SFC_SET_NORM_DOUBLE,
+ SFC_SET_NORM_FLOAT, SFC_GET_LIB_VERSION and SFC_GET_LOG_INFO. Thanks to
+ Kyroz for pointing out these errors.
+
+ * doc/command.html
+ Correct documented return values for SFC_SET_NORM_DOUBLE and
+ SFC_SET_NORM_FLOAT. Thanks to Kyroz again.
+
+2005-05-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * regtest/*
+ Add new files for sndfile-regtest program.
+
+ * configure.ac Makefile.am
+ Hook regetest into build.
+
+ * src/wav.c src/common.c
+ Fix a regression where long ICMT chunks were causing the WAV parser
+ to exit.
+
+2005-05-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * libsndfile.spec.in
+ Add html docs to the files section as suggested by Karsten Jeppesen.
+
+ * src/aiff.c
+ Fix parsing of odd length ANNO chunks.
+
+2005-05-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Change the include guard to prevent clashes with other code.
+
+2005-05-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-play.c
+ Improve error handling in code for playback under Linux/ALSA.
+
+2005-05-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ircam.c
+ Fix writing of IRCAM files on big endian systems (thanks to Axel Röbel).
+
+ * src/wav.c
+ Add workaround for files created by the Peak audio editor on Mac which can
+ produce files with very short LIST chunks (thanks to Jonathan Segel who
+ supplied the file).
+
+2005-04-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Apply a patch From David Viens to make the parsing of basc chunks more
+ robust.
+
+ * src/wav.c
+ Another patch from David Viens to write correct wavex channel masks for
+ the most common channel configurations.
+
+2005-04-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/command.c
+ Only allow FLAC in the format arrays if FLAC is enabled. Thanks to
+ Leigh Smith.
+
+2005-03-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Add a directory field for storing the file directory to the SF_PRIVATE
+ struct.
+
+ * src/sndfile.c
+ Grab the directory name when copying the file path.
+
+ * src/file_io.c
+ Cleanup psf_open_rsrc() and also check for resource fork in
+ .AppleDouble/filename.
+
+2005-03-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/svx.c
+ Fix a bug in the printing of the channel count. Bug reported by Michael
+ Schwendt. Thanks.
+
+2005-01-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/paf.c
+ Fix a seek bug for 24 bit PAF files.
+
+ * tests/write_read_test.tpl
+ Update write_read_test to trigger the previously hidden PAF seek bug.
+
+2005-01-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c src/w64.c src/wav.c
+ Do not return a header parse error when the log buffer overflows.
+ Continuing parsing works even on files where the log buffer does overflow.
+ This avoids a bug on some weirdo WAV (and other) files.
+
+ * src/common.h src/sndfile.c
+ Remove SFE_LOG_OVERRIN error and its associated error message.
+
+ * src/file_io.c
+ Fix a rsrc fork problem on MacOSX.
+
+2004-12-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile-play.c
+ In the ALSA output code, added call to snd_pcm_drain() just before
+ snd_pcm_close() as suggested by Thomas Kaeding.
+ In the OSS output code, added two ioctls (SNDCTL_DSP_POST and
+ SNDCTL_DSP_SYNC) just before the close of the audio device.
+
+ * tests/virtual_io_test.c tests/Makefile.am
+ Add a new test program (currently empty) and add it to the build.
+
+2004-12-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in src/sndfile.h src/common.h src/file_io.c
+ src/create_symbols_file.py
+ Apply patch from Steve Baker which is the beginnings of a virtual
+ I/O interface.
+
+2004-12-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.c src/sndfile.h.in
+ Const-ify the write path throughout the library.
+
+2004-12-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/development.html
+ Minor improvements.
+
+2004-11-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/bugs.html
+ Minor improvements.
+
+2004-11-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Add workaround for Logic Platinum AIFF files with broken COMT chunks.
+
+2004-11-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/FAQ.html
+ Remove some ambiguities in the SD2 FAQ answer.
+
+2004-11-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/sndfile.h Win32/config.h MacOS9/sndfile.h MacOS9/config.h
+ Updates from autoconfig versions.
+
+2004-11-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Fix parsing of COMT chunks. Store SF_STR_COMMENT data in ANNO chunks
+ instead of COMT chunk.
+
+2004-11-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c src/common.h
+ Change the ptr argument to psf_write() from "void*" to a "const void*".
+ Thanks to Tobias Gehrig for suggesting this.
+
+2004-10-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c src/common.h
+ Add functions psf_close_rsrc() and read length of resourse fork into
+ rsrclength field of SF_PRIVATE.
+
+ * src/sd2.c
+ Make sure resource fork gets closed.
+
+ * tests/util.tpl
+ Add functions to check for file descriptor leakage.
+
+ * src/write_read_test.tpl
+ Use the file descriptor leak checks.
+
+ * src/sndfile.h.in
+ Add SFC_GET_LOOP_INFO and SF_LOOP_INFO struct.
+
+ * src/common.h
+ Add SF_LOOP_INFO pointer to SF_PRIVATE.
+
+ * src/wav.c src/aiff.c
+ Improve and add parsing of 'ACID' and 'basc' chunks, filling in
+ SF_LOOP_INFO data in SF_PRIVATE.
+
+2004-10-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sd2.c
+ Further cleanup: remove printfs, change snprintf to LSF_SNPRINTF.
+
+ * Win32/config.h Win32/sndfile.h
+ Updates.
+
+ * tests/util.tpl
+ Add win32 macro for snprintf.
+
+2004-10-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sfendian.h
+ Add macros : H2BE_SHORT, H2BE_INT, H2LE_SHORT and H2LE_INT.
+
+ * src/sd2.c
+ Use macros to make sure writing SD2 files on little endian machines works
+ correctly.
+
+ * tests/util.tpl
+ Add a delete_file() function which also deletes the resource fork of SD2
+ files.
+
+ * tests/write_read_test.tpl
+ Use delete_file() so that "make distcheck" works.
+
+2004-10-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c src/file_io.c
+ Move resource filename construction and testing to psf_open_rsrc().
+
+ * src/common.h src/sndfile.c
+ Add error SFE_SD2_FD_DISALLOWED.
+
+ * tests/util.tpl tests/*.(c|tpl)
+ Add and allow_fd parameter to test_open_file_or_die() so that use of
+ sf_open_fd() can be avoided when opening SD2 files.
+
+2004-10-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Update ACID chunk parsing.
+
+ * src/sd2.c
+ More fixes for files with large resource forks.
+
+2004-10-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/sndfile.c
+ Add error numbers and messages for sd2 files.
+
+ * src/sd2.c
+ Reading of sd2 (resource fork version) now seems to be working.
+
+2004-10-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.h
+ Update file_io.c to include win32 psf_rsrc_open().
+
+ * tests/floating_point_test.tpl
+ Remove use of __func__ in test programs (MSVC++ doesn't grok this).
+
+ * Win32/(config|sndfile).h MacOS9/(config|sndfile).h
+ Updates.
+
+2004-10-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sfendian.h
+ Fix endswap_int64_t_(array|copy).
+
+ * src/test_endswap.(tpl|def)
+ Add tests for above and inprove all tests.
+
+2004-10-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sfendian.h
+ Improve type safety, add endswap_double_array().
+
+ * src/double64.c
+ Use endswap_double_array() instead of endswap_long_array().
+
+ * src/test_endswap.(tpl|def) src/Makefile.am
+ Add preliminary endswap tests and hook into build system.
+
+2004-10-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/configure.ac src/makefile.am
+ Finally fix the bulding of DLLs on Win32/MinGW.
+
+ * tests/makefile.am
+ Fix running of tests on Win32/MinGW.
+
+2004-10-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in src/sndfile.c tests/floating_point_test.tpl
+ Rename SFC_SET_FLOAT_INT_MULTIPLIER to SFC_SET_SCALE_FLOAT_INT_READ.
+
+ * doc/command.html
+ Document SFC_SET_SCALE_FLOAT_INT_READ.
+
+2004-09-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/floating_point_test.(tpl|def)
+ Derived from floating_point_test.c.
+ Add (float|double)_(short|int)_test functions.
+
+ * tests/util.(tpl|def)
+ Make separate float and double versions of gen_windowed_sine().
+
+ * tests/write_read_test.tpl
+ Fix after changes to gen_windowed_sine().
+
+ * src/(float32|double64).c
+ Implement SFC_SET_FLOAT_INT_MULTIPPLIER.
+
+2004-09-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * acinclude.m4
+ Fix warnings from automake 1.8 and later.
+
+ * examples/sndfile-info.c
+ Add a "fflush (stdout)" after printing Win32 message.
+
+2004-09-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/Makefile.mingw.in
+ Add a "make install" target.
+
+2004-09-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in src/common.h src/sndfile.c src/command.c
+ Start work on adding command SFC_SET_FLOAT_INT_MULTIPLIER.
+
+2004-09-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-convert.c
+ Fix a bug converting stereo integer PCM files to float.
+
+2004-09-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-play.c
+ Appy patch from Conrad Parker to make Mac OSX error messages more
+ consistent and informative.
+
+ * doc/api.html
+ Fix a HTML HREF which was wrong.
+
+ * doc/win32.html
+ Add information about when nmake fails.
+
+2004-09-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-play.c
+ Another patch from Denis Cote to prevent race conditions.
+
+2004-09-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/ms_adpcm.c src/ima_adpcm.c
+ Fix alternative to ISO standard flexible struct array feature for broken
+ compilers.
+
+2004-08-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/string.c src/sndfile.c
+ Make sf_set_string() return an error if trying to set a string when in
+ read mode.
+
+2004-08-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Change the unnamed union into a named union so gcc-2.95 will compile it.
+
+ * src/*.c
+ Fixes to allow for the above change.
+
+2004-08-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-play.c
+ Fixes for Win32. Thanks to Denis Cote.
+
+ * Win32/Win32/Makefile.(msvc|mingw.in)
+ Fix build system after removal of sfendian.h.
+ Build sndfile-convert.
+
+ * src/Makefile.am
+ Remove sfendian.c from dependancies.
+
+2004-08-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in
+ Fix typo in comments (thanks Tommi Sakari Uimonen).
+
+2004-07-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/(a|u)law_test.c
+ Minor cleanup.
+
+2004-07-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/(pcm|float|double64|ulaw|alaw|xi).c
+ Optimise read/write loops by removing a redundant variable.
+
+2004-07-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Remove call to fsync() in psf_close().
+
+2004-07-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/pcm.c
+ Inline x2y_array() functions where possible.
+
+ * configure.ac
+ Detect presence of type int64_t.
+
+ * src/sfendian.c src/sfendian.h
+ Move functions in the first file to the sfendian.h as static inline
+ functions.
+ Improve endswap_long_*() where possible.
+
+2004-07-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/pcm.c
+ When converting from unsigned char to float or double, subtract 128 before
+ converting to float/double rather than after to save a floating point
+ operation as suggested by Stefan Briesenick.
+
+ * src/(pcm|sfendian|alaw|ulaw|double64|float32).c
+ Optimize inner loops by changing the loop counting slightly as suggested
+ by Stefan Briesenick.
+
+ * configure.ac
+ Detect presence of <byteswap.h>.
+
+ * src/sfendian.h
+ Use <byteswap.h> if present as suggested by Stefan Briesenick.
+
+ * src/pcm.c
+ Update bytewapping.
+
+2004-07-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/*.c
+ Change the psf->buffer field of SF_PRIVATE into a more type safe union with
+ double, float, int etc elements.
+
+2004-06-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-play.c
+ Merge slightly modifed patch from Stanko Juzbasic which allows playback of
+ mono files on MacOSX.
+
+2004-06-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-convert.c
+ Move copy_metadata() after the second sf_open().
+
+2004-06-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-convert.c
+ Fix a bug which caused the program to go into an infinite loop if the source
+ file has no meta-data. Thanks to Ron Parker for reporting this.
+
+ * src/sndfile.h.in
+ Add SF_STR_FIRST and SF_STR_LAST to allow enumeration of string types.
+
+ * Win32/sndfile.h MacOS9/sndfile.h
+ Update these as per the above file.
+
+2004-06-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac src/common.h src/ogg.c src/sndfile.c src/sndfile.h.in
+ src/Makefile.am
+ Apply large patch from Conrad Parker implementing Ogg Vorbis, Ogg Speex and
+ Annodex support via liboggz and libfishsound. Thanks Conrad.
+
+2004-06-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/avr.c src/ircam.c src/nist.c src/paf.c src/xi.c
+ Add cast to size_t for some parameters passed to psf_binheader_writef. This
+ is Debian bug number 253490. Thanks to Anand Kumria and Andreas Jochens.
+
+ * src/w64.c
+ Found and fixed a bug resulting from use of size_t when writing W64 'fmt '
+ chunk.
+
+2004-06-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Bump version to 1.0.10 ready for release.
+
+ * Makefile.am
+ Remove redundant files (check_libsndfile.py libsndfile_version_convert.py)
+ from distribution tarball.
+
+ * tests/header_test.tpl
+ Fix uninitialised variable.
+
+ * src/GSM610/short_term.c
+ Fix compiler warning on MSVC++.
+
+2004-05-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Improve record keeping of chunks seen and return an error if a file with
+ unusual chunks is opened in mode SFM_RDWR.
+
+ * src/mmreg.h
+ This file not needed so remove it.
+
+2004-05-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/header_test.tpl
+ Add extra_header_test().
+
+ * src/common.h src/sndfile.c
+ Add SFE_RDWR_BAD_HEADER error number and string.
+
+2004-05-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/utils.tpl tests/*.c tests/*.tpl
+ Add a line number argument to check_log_buffer_or_die() and update all
+ files that use that function.
+
+ * tests/header_test.tpl
+ Modify/update tests for files opened SFM_RDWR and SFC_UPDATE_HEADER_AUTO.
+
+ * src/aiff.c src/wav.c
+ Fix another bug in AIFF and WAV files opened in SFM_RDWR and using
+ SFC_UPDATE_HEADER_AUTO.
+
+ * src/test_file_io.c
+ Add a test for psf_ftruncate() function.
+
+2004-05-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fix another weird corner case bug found by Martin Rumori. Thanks.
+
+ * tests/header_test.(tpl|def)
+ Two new files to test for the absence of the above bug and include tests
+ moved from tests/misc_test.c.
+
+ * tests/Makefile.am
+ Hook new tests into build/test system.
+
+ * tests/misc_test.c
+ Remove update_header_test() which has been moved to the new files above.
+
+2004-05-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Fixed a bug reported by Martin Rumori on the LAD list. If a file created
+ with a format of SF_FORMAT_FLOAT and then closed before any data is written
+ to it, the header can get screwed up (PEAK chunk gets overwritten).
+
+ * tests/write_read_test.tpl
+ Add a test (empty_file_test) for the above bug.
+
+2004-05-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/Makefile.mingw.in
+ Added a Makefile for MinGW (needs to be processed by configure).
+
+ * src/mmsystem.h src/mmreg.h
+ Add files from the Wine project (under the LGPL) to allow build of
+ sndfile-play.exe under MinGW.
+
+2004-05-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/GSM610/gsm610_priv.h
+ Replace ugly macros with inline functions.
+
+ * src/GSM610/*.c
+ Remove temporary variables used by macros and other minor fixes required by
+ above change.
+
+2004-05-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/pipe_test.tpl tests/stdio_test.c Win32/Makefile.msvc
+ Make sure these programs compile (even though they do nothing) on Win32
+ and add them to the "make check" target.
+
+ * src/sfendian.h
+ Fix warning on Sparc CPU and code cleanup.
+
+2004-05-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Fix warning messages when compiling under MinGW.
+
+2004-05-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Set HAVE_FLEXIBLE_ARRAY in src/config.h depending on whether the compiler
+ accepts the flexible array struct member as per 1999 ISO C standard.
+
+ * src/common.h src/ima_adpcm.c src/paf.c src/ms_adpcm.c
+ Added ugly #if HAVE_FLEXIBLE_ARRAY and provided a non-standards compliant
+ hack for non 1999 ISO C compliant compilers.
+
+2004-04-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/strings.c
+ If adding an SF_STR_SOFTWARE string, only append libsndfile-X.Y.Z if the
+ string does not already have libsndfile in the string. Thanks to Conrad
+ Parker.
+
+ * tests/string_test.c
+ Add test to verify the above.
+
+ * examples/sndfile-convert.c
+ Add ability to transcode meta data as well (Conrad Parker).
+
+2004-04-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/command.html
+ Fix minor error. Thanks to Simon Burton.
+
+ * doc/win32.html
+ Started adding instructions for compiling libsndfile under MinGW.
+
+ * configure.ac
+ Add --enable-bow-docs to enable black text on a white background HTML docs.
+
+ * doc/libsndfile.css.in
+ This is now a template file for configure which sets the foreground and
+ background colours.
+
+2004-04-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Do some MinGW fixes.
+
+ * configure.ac doc/Makefile.am
+ Install HTML docs when doing make install.
+
+2004-04-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-info.c
+ Print out the dB level with the signal max.
+
+2004-04-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Define S_ISSOCK in src/file_io.c if required.
+
+2004-04-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Improve printout configuration summary (as suggested by Axel Röbel).
+
+ * doc/index.html
+ Add link to pre-release location.
+
+ * src/sndfile.h.in
+ Remove comma after last element of enum.
+
+ * src/float32.c src/double64.c
+ Fix read/write of float/double encoded raw files to/from pipes.
+
+ * tests/pipe_test.c tests/pipe_test.tpl tests/pipe_test.def
+ Turn pipe_test.c into an autogenerated file and add tests for reading/
+ writing floats and doubles.
+
+ * tests/Makefile.am
+ Hook tests/pipe_test.* into build system.
+
+2004-04-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac acinclude.m4
+ Rename AC_C_STRUCT_HACK macro to AC_C99_FLEXIBLE_ARRAY.
+
+2004-03-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/misc_test.c
+ Perform update_header_test in RDWR mode as well.
+
+ * src/aiff.c
+ Fix problems when updating header in RDWR mode.
+
+2004-03-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c src/w64.c src/wav_w64.c
+ Integrate code supplied by David Viens for supporting microsoft's
+ WAVEFORMATEXTENSIBLE stuff. Thanks David for supplying this.
+
+ * configure.ac doc/*.html
+ Bump version to 1.0.9.
+
+2004-03-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/command.c src/sndfile.c src/sndfile.h.in src/wav.c
+ Started work on supporting microsoft's WAVEFORMATEXTENSIBLE gunk.
+
+2004-03-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/avr.c
+ New file to handle Audio Visual Resaerch files.
+
+ * src/sndfile.h.in src/common.h src/sndfile.c src/command.c
+ Hook AVR into everything else.
+
+ * tests/Makefile.am tests/write_read_test.tpl tests/misc_test.c
+ Add testing for AVR files.
+
+2004-03-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Fix psf_set_file() for win32. Thanks to Vincent Trussart (Plogue Art et
+ Technologie) for coming up with the solution.
+
+2004-03-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/write_read_test.tpl
+ Fixed a bug that was causing valgrind to report a memory leak. The bug was
+ in the test code itself, not the library.
+
+2004-03-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/generate.cs
+ An example showing how to use libsndfile from C#. Thanks to James Robson
+ for providing this.
+
+2004-03-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.c
+ Fix problems with WAV files containing large chunks after the 'data'
+ chunk. Thanks to Koen Tanghe for providing a sample file.
+
+2004-03-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Detect presense of ALSA (Advanced Linux Sound Architecture).
+
+ * examples/sndfile-play.c
+ Add ALSA output support.
+
+ * examples/Makefile.am
+ Add ALSA_LIBS to link line of sndfile-play.c.
+
+2004-03-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * acinclude.m4
+ Add new macro (AC_C_STRUCT_HACK) to detect whether the C compiler allows
+ the use of the what is known as the struct hack introduced by the 1999 ISO
+ C Standard.
+
+ * configure.ac
+ The last release would not compile with gcc-2.95 due to the use of features
+ (ie struct hack) introduced by the 1999 ISO C Standard.
+ Add check to make sure compiler handles this and bomb out if it doesn't.
+
+2004-03-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/write_read_test.tpl
+ Fix compiler warning on Win32.
+
+ * src/file_io.c
+ Fix use of an un-initialised variable in Win32 stuff.
+
+ * Win32/config.h examples/sndfile-play.c
+ Win32 fixes.
+
+2004-03-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Fix bug which occurres when configuring for MinGW.
+ If compiler is gcc and cross compiling use -nostdinc.
+
+2004-03-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/aiff.c src/wav.c src/float32.c src/double64.c
+ src/sndfile.c
+ Fix a bug with PEAK chunk handling for files with more than 16 channels.
+ Thanks to Remy Bruno for finding this.
+
+2004-03-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.c
+ Fix a bug which was preventing WAV files being openned correctly if the
+ file had a very large header. Thanks to Eldad Zack for finding this.
+
+2004-03-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac src/file_io.c
+ Fix cross-compiling from Linux to Win32 using the MinGW tools.
+
+2004-03-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/create_symbols_file.sh
+ Christian Weisgerber pointed out that the shell script did not run on a
+ real Bourne shell although it did run under Bash in Bourne shell mode.
+
+ * src/create_symbols_file.py
+ Rewrite of above in Python. Also add support for writing Win32 .def files.
+ The Python script generates Symbols.linux, Symbols.darwin and
+ libsndfile.def (Win32 version). These files get shipped with the tarball
+ so there should not be necessary to run the Python script when building
+ the code from the tarball.
+
+ * configure.ac src/Makefile.am Win32/Makefile.am
+ Hook new Python script into the build system.
+
+2004-02-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/configure.ac
+ Add --enable-gcc-werror option and move GCC specific stuff down.
+
+2004-02-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * acinclude.m4 configure.ac
+ Fix clip mode detection (tested in one of HP's testdrive Itanium II boxes).
+
+ * src/file_io.c
+ Added check for sizeof (off_t) != sizeof (sf_count_t) to prevent recurrence
+ of missing large file support on Linux and Solaris.
+
+2004-02-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-play.c
+ Fix a MacOSX specific bug which was caused by a space being inserted in
+ the middle of a file name.
+
+ * configure.ac src/Makefile.am examples/Makefile.am
+ Fix a couple of MacOSX build issues.
+
+2004-02-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/command.html
+ Document SFC_SET_CLIPPING and SFC_GET_CLIPPING.
+
+2004-02-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/*.html
+ Applied patch from Frank Neumann (author of lakai) which fixes many minor
+ typos in documentation. Thanks Frank.
+
+2004-02-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * ChangeLog
+ Changed my email address throughout source and docs.
+
+2004-02-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Make sure config.h is included before stdio.h to make sure large file
+ support is enabled on Linux (and Solaris).
+
+ * tests/misc_test.c
+ Disable update_header test on Win32. This should work but doesn't and
+ I'm not sure why.
+
+ * Make.bat Win32/Makefile.msvc
+ Updates.
+
+2004-01-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Changed logindex, headindex and headend files of SF_PRIVATE from unsigned
+ int to int to prevent weird arithmetic bugs.
+
+ * src/common.c src/aiff.c src/wav.c src/w64.c
+ Fixed compiler warnings resulting from above change.
+
+2004-01-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.c
+ Fixed a bug in header reader for some files with data after the sample data.
+
+2003-12-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/lossy_comp_test.c tests/Makefile.am
+ Add tests for AIFF/IMA files.
+
+2003-12-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/macbinary3.c src/macos.c
+ Two new files required for handling SD2 files.
+
+ * src/common.h
+ Add prototypes for functions in above two files.
+
+ * src/Makefile.am
+ Hook new files into build system.
+
+2003-12-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Add checks for mmap() and getpagesize() which might be used at some time
+ for faster file reads.
+ Add detection of MacOSX.
+
+2003-12-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/FAQ.html
+ Minor mods to pkg-config section.
+
+2003-12-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/create_symbols_file.sh
+ Andre Pang (also known as Ozone) pointed out that on MacOSX, all non
+ static symbols are exported causing troubles when trying to link
+ libsndfile with another library which has any of the same symbols.
+ He fixed this by supplying the MacOSX linker with a file containing
+ all the public symbols so that only they would be exported and then
+ supplied a patch for libsndfile.
+ This wasn't quite ideal, because I would have to maintain two (3 if
+ you include Win32) separate files containing the exported symbols.
+ A better solution was to create this script which can generate a
+ Symbols file for Linux, MacoSX and any other OS that supports
+ minimising the number of exported symbols.
+
+ * configure.ac src/Makefile.am
+ Hook the new script into the build process.
+
+2003-12-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/index.html
+ Added comments about Steve Dekorte's SoundConverter scam.
+
+2003-12-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Axel Röbel pointed out that on Mac OSX a pipe is not considered a fifo
+ (S_ISFIFO (st.st_mode) is false) but a socket (S_ISSOCK (st.st_mode) is
+ true). The test has therefore been changed to is S_ISREG and anything
+ which which does not return true for S_ISREG is considered a pipe.
+
+2003-11-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/misc_test.c
+ Fix update_header_test to pass SDS.
+
+ * src/sds.c
+ More minor fixes.
+
+ * tests/floating_point_test.c
+ Add test for SDS files.
+
+ * src/command.c
+ Add SDS to major_formats array.
+
+2003-11-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/write_read_test.tpl tests/misc_test.c
+ Add tests for SDS files.
+
+ * src/sds.c
+ Fix a bug in header update code.
+
+2003-11-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sds.c
+ Get file write working.
+
+ * src/paf.c
+ Fix a potential bug in paf24_seek().
+
+2003-11-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/FAQ.html
+ Add Q/A about u-law encoded WAV files.
+
+ * Win32/*.h
+ Updated so it compiles on Win32.
+
+2003-11-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-convert.c
+ Add -alaw and -ulaw command line arguments.
+
+ * configure.ac
+ Add library versioning comments.
+ Add arguments to AC_INIT.
+
+2003-10-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Ross Bencina has contributed code to replace all of the (mostly broken)
+ Win32 POSIX emulation calls with calls the native Win32 file I/O API.
+ This code still needs testing but is likely to be a huge improvemnt
+ of support for Win32. Thanks Ross.
+
+2003-10-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/dwvw.c
+ Removed filedes field from the DWVW_PRIVATE struct.
+
+ * src/file_io.c
+ Change psf_fopen() so it returns psf->error instead of the file descriptor.
+ Add new functions psf_set_stdio() and psf_set_file().
+
+ * src/sndfile.c
+ Change these to work with changed psf_fopen() return value.
+ Remove all uses of psf->filedes from sndfile, making it easier to slot native
+ Win32 API file handling functions.
+
+ * src/test_file_io.c
+ Minor changes to make it compile with new file_io.c stuff.
+
+2003-10-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/gsm610.h
+ Rename a variable from true to true_flag. As Ross Bencina points out,
+ true is defined in the C99 header <stdbool.h>.
+
+ * src/file_io.c
+ If fstat() fails, return SF_TRUE instead of -1 (Ross Bencina).
+
+2003-10-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Increase the size of SF_BUFFER_LEN and SF_HEADER_LEN.
+
+ * src/sndfile.c
+ Fix sf_read/write_raw which were dividing by psf->bytwidth and
+ psf->blockwidth which can both be zero.
+
+ * examples/sndfile-info.c
+ Increase size of BUFFER_LEN.
+
+2003-09-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Add checks for <sys/wait.h> and ssize_t.
+ Other Win32/MinGW checks.
+
+ * src/aiff.c src/au_g72x.c src/file_io.c src/gsm610.c src/interleave.c
+ src/paf.c src/sds.c src/svx.c src/voc.c src/w64.c src/wav.c src/xi.c
+ Fix compiler warnings.
+
+2003-09-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/scale_clip_test.tpl
+ Add definition of M_PI if needed.
+
+2003-09-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Detect if S_IRGRP is declared in <unistd.h>.
+
+ * src/file_io.c tests/*.tpl tests/*.c
+ More fixes for Win32/MSVC++ and MinGW. MinGW does have <unistd.h> but that
+ file doesn't declare S_IRGRP.
+
+2003-10-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/config.h.in
+ Add comment stating that the sf_count_t typedef is determined when
+ libsndfile is being compiled.
+
+ * tests/utils.tpl
+ Modified so that utils.c gets one copy of the GPL and not two.
+
+
+2003-09-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/unistd.h src/sf_unistd.h
+ Move first file to the second. This will help for Win32/MSVC++ and MinGW.
+
+ * Win32/Makefile.am src/Makefile.am
+ Changed in line with above.
+
+ * Win32/Makefile.msvc
+ Removed "/I Win32" which is no longer required.
+
+ * src/file_io.c src/test_file_io.c tests/*.tpl tests/*.c
+ If HAVE_UNISTD_H include <unistd.h> else include <sf_unistd.h>. This should
+ work for Win32, MinGW and other fakes Unix-like OSes.
+
+ * src/*.c
+ Removed #include <unistd.h> from files which didn't need it.
+
+2003-09-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * libsndfile.spec.in
+ Apply fix from Andrew Schultz.
+
+2003-09-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/vox_adpcm.c
+ Only set psf->sf.samplerate if the existing value is invalid.
+
+2003-09-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-play.c
+ Started adding support for ALSA output.
+
+2003-09-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in
+ Removed <stdlib.h> from sndfile.h.
+
+ * src/*.c examples/*.c tests/*.c tests/*.tpl
+ Added <stdlib.h> where needed.
+
+2003-09-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Added ARRAY_LEN, SF_MAX and SF_MIN macros.
+
+2003-08-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/index.html
+ Remove statements about alternative licensing arrangements.
+
+2003-08-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * MacOS MacOS9 Makefile.am configure.ac
+ Change directory name from MacOS to MacOS9
+
+ * MacOS9/MacOS9-readme.txt
+ Change name to make it really obvious, add text to top of file to make it
+ still more obvious again.
+
+2003-08-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/test_log_printf.c
+ Add tests for %u conversions.
+
+ * src/common.c
+ Fix psf_log_printf() %u conversions.
+
+2003-08-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Fixed a bug where opening a file with a non-trival header in SFM_RDWR mode
+ would over-write part of the header. Thanks to Axel Röbel for pointing
+ this out. Axel also provided a patch to fix this but I came up with a
+ neater and more general solution.
+ Return error when openning an AIFF file with data after the SSND chunk
+ (Thanks Axel Röbel).
+
+ * tests/aiff_rw_test.c
+ Improvements to test program which will later allow it to be generalised to
+ test WAV, SVX and others as required.
+
+2003-08-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/pipe_test.c
+ Add useek_pipe_rw_test() submitted by Russell Francis.
+
+ * src/sndfile.c
+ In sf_open_fd(), check if input file descriptor is a pipe.
+
+ * src/sndfile.[ch]
+ Fix typo in variable name do_not_close_descriptor.
+
+2003-08-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/test_log_printf.c
+ Improve the tests for %d and %s conversions.
+
+ * src/common.c
+ Fixed a few problems in psf_log_printf() found using new tests.
+
+2003-08-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Add -Wwrite-strings warning to CFLAGS if the compiler is GCC. Thanks to
+ Peter Miller (Aegis author) for suggesting this and supplying a patch.
+
+ * src/*.c examples/*.c tests/*.c
+ Fix all compiler warnings arising from the above.
+
+2003-08-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/aiff_rw_test.c tests/Makefile.am
+ New test program to check for errors re-writing the headers of AIFC files
+ opened in mode SFM_RDWR.
+
+2003-07-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-play.c
+ Applied a patch from Tero Pelander to allow this program to run on systems
+ using devfs which used /dev/sound/dsp instead of /dev/dsp.
+
+2003-07-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/new_file_type.HOWTO
+ Updated document. Still incomplete.
+
+2003-06-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fix VALIDATE_SNDFILE_AND_ASSIGN_PSF which was returning an error rather
+ than saving it and returning zero.
+
+2003-06-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Two fixes for Mac OS9.
+ Fix all casts from sf_count_t to ssize_t (not size_t).
+
+2003-06-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Fix for reading files with RIFF length of 8 and data length of 0.
+
+2003-06-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.c tests/*.c tests/*.tpl
+ Added comments to mark code for removal when make Lite version of
+ libsndfile.
+
+2003-06-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-convert.c
+ Add extra error checking for unrecognised arguments.
+
+2003-06-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ima_adpcm.c
+ Started adding code to write IMA ADPCM encoded AIFF files.
+
+ * src/test_log_printf.c src/Makefile.am
+ New file to test psf_log_printf() function and add hooks into build system.
+
+ * src/common.c
+ Move psf_log_printf() function to top of the file and only compile the rest
+ of the file if if PSF_LOG_PRINTF_ONLY is not defined.
+
+2003-06-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/config.h Win32/sndfile.h
+ Updated with new config variables.
+
+ * Win32/unistd.h src/file_io.c
+ Added implementation of S_ISFIFO macro which Win32 seems to lack and is
+ used in src/file_io.c.
+
+ * tests/utils.tpl
+ Added #include <unitstd.h> to pull in Win32/unistd.h so it compiles for
+ Win32.
+
+ * src/Makefile.msvc
+ Added src\test_file_io.exe build target and run this as the very first
+ test.
+
+ * tests/win32_test.c
+ Add support for testing Cygwin32.
+
+ * configure.ac
+ Detect POSIX fsync() and fdatasync() functions.
+
+ * src/file_io.c
+ If compiling for Cygwin, call fsync() before calling fstat() to retrieve
+ file length.
+
+ * tests/pcm_test.tpl
+ Add a test for lrintf() function. This was required to detect a really
+ broken lrint() and lrintf() on Cygwin.
+
+ * tests/misc_test.c
+ Don't run permission test when compiling under Cygwin.
+
+ * src/float_cast.h
+ Fix fallback macro for lrint() and lrintf() to cast to long instead of int
+ to match official function prototypes.
+
+2003-06-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-convert.c
+ Modifications to improve accuracy of conversions; use double data for
+ floating point and int for everything else.
+
+ * src/ima_apdcm.c
+ Completed work on decoding IMA ADPCM encoded AIFF files. Still need to
+ get encoding working.
+
+2003-05-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c src/ima_adpcm.c
+ Start working on getting IMA ADPCM encoded AIFF files working.
+
+2003-05-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Fixed the touch command for when the autogen program is not found (Matt
+ Flax).
+
+ * src/ulaw.c src/alaw.c
+ Made these pipe-able.
+
+2003-05-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/paf.c src/ircam.c
+ Fixed writing to pipe.
+
+ * src/wav.c src/aiff.c src/nist.c src/mat*.c src/svx.c src/w64.c
+ Return SFE_NO_PIPE_WRITE if an attempt is made to write to a pipe.
+
+2003-05-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-info.c
+ Modified to detect unknown file lengths.
+
+ * src/mat4.c
+ Fix reading from a pipe.
+
+2003-05-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/pipe_test.c
+ Add more file types to tests.
+
+ * src/mat4.c
+ Removed explicit setting of psf->sf.seekable to SF_TRUE.
+
+ * tests/utils.tpl
+ Add macro for generating and check data in the stdio and pipe tests.
+
+ * tests/stdout_test.c tests/stdin_test.c
+ Use the above macro to generate known data on output and check data on
+ input.
+
+ * src/voc.c src/htk.c common.h sndfile.c
+ Disallow reading/writing VOC and HTK files from/to pipes be returning new
+ error values.
+
+ * src/w64.c
+ Fixes to allow reading from a pipe.
+
+2003-05-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac src/sndfile.h.in
+ When the configure script determines the sizeof (sf_count_t), also set the
+ value of SF_COUNT_MAX in sndfile.h.
+
+ * configure.ac
+ Remove -pedantic flag from default GCC compiler flags.
+
+ * tests/pipe_test.c
+ Add a pipe_read_test() before doing pipe_write_test().
+
+ * tests/scale_clip_test.c
+ Add test to make sure non-normalized values also clip in the right way.
+
+2003-05-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Add test to detect processor clipping capabilities.
+
+ * tests/stdin_test.c tests/stdout_test.c
+ Fix a pair of compiler warnings.
+
+ * src/common.h
+ Add new pipeoffset field to SF_PRIVATE. This will contain the current file
+ offset when operating on a pipe.
+
+ * src/common.c
+ Removed direct calls to psf_fread()/psf_fseek()/psf_fgets() etc from
+ psf_binheader_readf and redirect them to new buffered versions
+ header_read(), header_seek() and header_gets().
+ Add "G" format specifier to emulate fgets() functionality with buffering.
+ This will allow reading some file types from pipes.
+
+ * src/file_io.c
+ When the file descriptor is a pipe, manintain psf->pipeoffset.
+
+ * src/pvf.c
+ Change use of psf_fgets() to psf_binheader_readf() as required but changes to header re
+
+ * src/au.c
+ Fix reading from a pipe.
+
+2003-05-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/pcm.c
+ Add clipping versions of the f2XXX_array() functions to allow option of
+ clipping data that would otherwise overflow.
+
+ * tests/scale_clip_test.tpl tests/scale_clip_test.def
+ New files test that clipping option does actually work.
+
+2003-05-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/index.html
+ Fixed a typo ("OS(" instead of "OS9").
+
+2003-05-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/open_fail_test.c
+ Include <string.h> to prevent warning message of missing declaration of
+ memset().
+
+2003-05-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Add new "add_clipping" field to SF_PRIVATE.
+
+ * src/sndfile.h.in src/sndfile.c
+ Add command SFC_SET_CLIPPING which sets/resets add_clipping field.
+
+2003-05-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/api.html
+ Add docs for sf_set_string() and sf_get_string().
+
+ * src/common.h src/sndfile.c
+ Add new SFE_STR_BAD_STRING error.
+
+ * tests/stdin_test.c tests/stdout_test.c
+ Removed all non-error print statements.
+
+ * tests/stdio_test.c tests/pipe_test.c tests/Makefile.am
+ Add print statements removed from two files above.
+
+2003-05-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * libsndfile.spec.in
+ Fixed a coulpe of minor errors discovered by someone calling themselves
+ Agent Smith.
+
+ * src/common.c src/common.h src/file_io.h
+ Added is_pipe field to SF_PRIVATE and declaration of psf_is_pipe()
+ function. (Axel Röbel)
+
+ * src/sndfile.c
+ Fixed determination of whether the file is a pipe. (Axel Röbel)
+
+ * src/paf.c
+ Force paf24 to start with undefined mode. (Axel Röbel)
+
+ * tests/pipe_test.c
+ Mods to make this test work and actually do the test on RAW files. (Axel
+ Röbel).
+
+2003-05-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fixed a potential bug where psf->sf.seekable was being set to FALSE when
+ operating on stdin or stdout but then the default initialiser was reseting
+ it to TRUE. Thanks to Axel Röbel.
+
+ * src/aiff.c
+ Fixed a bug in the header parser where it was not handling an odd length
+ COMM chunk correctly. Thanks to Axel Röbel.
+
+ * src/test_file_io.c
+ Add more tests.
+
+ * tests/win32_test.c
+ New file for showing the bugs in the Win32 implementation of the POSIX API.
+ It also runs on Linux for sanity checking.
+
+ * tests/Makefile.am Win32/Makefile.msvc
+ Hook the new test program into the build system.
+
+2003-05-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/test_file_io.c
+ New test program to test operation of functions defined in file_io.c. This
+ should make supporting win32 significantly easier.
+
+ * src/Makefile.am
+ Hook new test program into the build system.
+
+ * src/file_io.c
+ Add compile/run time check that sizeof statbuf.st_size and sf_count_t are
+ the same.
+
+ * src/common.h src/sndfile.c
+ Added new error code and error message for new check.
+
+ * tests/benchmark.tpl
+ Fix to use frames instead of samples in SF_INFO.
+
+2003-05-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ More stuffing about working around PLAIN OLD-FASHIONED **BUGS** in Win32.
+
+ * examples/sndfile-info.c
+ Applied patch from Conrad Parker to add "--help" and "-h" options as
+ well as an improved usage message.
+
+2003-05-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/au.c
+ Added embedded file support.
+
+ * tests/multi_file_test.c
+ Added tests for embedded AU files.
+ Added verbose testing mode.
+
+ * src/common.h src/sndfile.c
+ Added an embedded AU specific error code and message.
+
+ * src/wav.c
+ Added patch from Conrad Parker which filled in a little more information
+ about ACIDized WAV files.
+
+2003-04-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Fixed Win32 version of psf_fseek() which was calling psf_get_filelen()
+ which was in turn calling psf_fseek() which in the end blew the stack.
+ Now of course this would have been easy to find on Linux, but this blow
+ up was happening in kernel32.dll and the fscking MSVC++ debugger couldn't
+ figure out what call caused this (it couldn't even tell me the stack had
+ overflowed) and was absolutley useless for this debugging exercise.
+ On top of that, the reason I got into this mess was that windoze doesn't
+ have a working fstat() function which can return file lengths > 2 Gig. It
+ HAS a fscking _fstati64() but the file length value is only updated AFTER
+ the bloody file is closed. That makes it completely useless.
+ How the hell do people stand working on this crap excuse of an OS?
+
+2003-04-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/unistd.h src/file_io.c
+ Moved definitions of S_IGRP etc from file_io.c to unistd.h so that these
+ can be used in the test programs.
+
+ * Win32/libsndfile.def
+ Added sf_open_fd.
+
+ * Win32/sndfile.h
+ Updated to match src/sndfile.h.in.
+
+ * Win32/Makefile.msvc
+ Added dither.c and htk.c to libsndfile.dll target.
+
+2003-04-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ First attempt at getting the Win32 versions of the these functions working.
+ They still need to be tested.
+
+2003-04-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/strings.c
+ Found and fixed a bug which was causing psf_store_string() to fail on
+ Motorola 68k processors. Many thanks fo Joshua Haberman (Debian maintainer
+ of libsndfile) for compiling and running debug code to help me debug the
+ problem.
+
+2003-04-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c src/file_io.c src/wav.c src/aiff.c
+ Much hacking to get reading and writing of embedded files working (ie sound
+ files at a non-zero files offset).
+
+ * doc/embedded_files.html
+ First pass atempt at documenting reading/writing embedded files.
+
+2003-04-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/FAQ.html
+ Updated answer to "Why doesn't libsndfile do interleaving/de-interleaving?"
+
+2003-04-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c src/aiff.c
+ Fix retrieving and storing of string data from files. Need to be careful
+ about using psf->buffer for strings.
+
+2003-04-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Fix psf_fseek() for seeks withing embedded files.
+
+2003-04-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in
+ Changed the definition of SNDFILE slightly to produce warnings when it isn't
+ used correctly. This should have zero affect in code which uses the SNDFILE
+ type correctly.
+
+ * src/sndfile.c
+ Fixed a few compiler warnings cause by the changes to the SNDFILE type.
+
+2003-04-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/FAQ.html
+ Added question and answer to the question "How about adding the ability
+ to write/read sound files to/from memory buffers?".
+
+2003-04-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/write_read_test.tpl
+ Removed un-needed enums declaring TRUE and FALSE and replaced usage of
+ these with SF_TRUE and SF_FALSE.
+
+ * tests/multi_file_test.c
+ New test program to test sf_open_fd() on files containing data other than
+ a single sound file.
+
+2003-04-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ When creating files, set the readable by others flag. This still allows
+ further restrictions to be enforced by use of the user's umask. Fix
+ suggested by Eric Lyon.
+
+2003-04-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in src/sndfile.c
+ Changed sf_open_fd(). Dropped offset parameter and added a close_desc
+ parameter. If close desc is TRUE, the file descritpor passed into the
+ library will be closed when sf_close() is called.
+
+ * tests/utils.tpl
+ Modified call to sf_open_fd() to set close_desc parameter to SF_TRUE.
+
+2003-04-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/write_read_test.tpl
+ Add a string (using sf_set_string() function) before and after data section
+ of all files. This will make sure that if string data can be added, it
+ doesn't overwrite real audio data.
+
+2003-04-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Started work on supporting a non-zero offset parameter for sf_open_fd ().
+
+ * src/<file header parsers>.c
+ Removed many uses of psf_fseek (SEEK_END) which to allow for future use of
+ sf_open_fd() with non-zero offset.
+ Associated refactoring.
+
+ * src/aiff.c
+ Implemented functionality required to get sf_get_string() and
+ sf_set_string() working for AIFF files.
+
+2003-04-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/utils.tpl
+ Modified test_open_file_or_die() to alternately use sf_open() and
+ sf_open_fd().
+
+ * src/svx.c
+ Fixed a bug which occurred when openning an existing file for read/write
+ using sf_open_fd(). In this case, the existing NAME chunk needs to be
+ read into psf->filename.
+ Fixed printing of sf_count_t types to logbuffer.
+
+2003-03-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in
+ Added prototype for new function sf_open_fd().
+
+ * src/sndfile.c
+ Moved most of the code in sf_open() to a new function psf_open_file().
+ Created new function sf_open_fd() which also uses psf_open_file() but
+ does not currently support the offset parameter.
+
+ * doc/api.html
+ Document sf_open_fd().
+
+2003-03-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fixed a memory leak reported by Evgeny Karpov. Memory leak only occurred
+ when an attempt was made to read and the open() call fails.
+
+2003-03-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/open_fail_test.c
+ New test program to check for memory leaks when sf_open fails on a valid
+ file. Currently this must be run manually under valgrid.
+
+ * tests/Makefile.am
+ Hook new test program into build.
+
+2003-03-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Octave/sndfile_save.m Octave/sndfile_play.m
+ Added a -mat-binary option to the octave save command to force the output
+ to binary mode even if the user has set ascii data as the default. Found
+ by Christopher Moore.
+
+2003-02-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/dither.html
+ New file which will document the interface which allows the addition of
+ audio dither when sample word sizes are being reduced.
+
+ * src/dither.c
+ More work.
+
+2003-02-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/misc_test.c
+ In update_header_test(), make HTK files a special case.
+
+ * doc/index.html
+ Added HTK to the feature matrix.
+
+2003-02-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/htk.c
+ New file for reading/writing HMM Tool Kit files.
+
+ * src/sndfile.h.in src/sndfile.c src/command.c src/Makefile.am
+ Hook in htk.c
+
+ * tests/write_read_test.tpl tests/misc_test.c tests/Makefile.am
+ Add tests for HTK files.
+
+2003-02-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Fixed a bug where the LIST chunk length was being written incorrectly.
+
+ * tests/string_test.c
+ Added call to check_log_buffer().
+ Minor cleanups.
+
+2003-02-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav_w64.h
+ Applied patch from Antoine Mathys to add extra WAV format definitions and
+ a G72x_ADPCM_WAV_FMT struct definition.
+
+ * src/wav_w64.c
+ Applied patch from Antoine Mathys which converts wav_w64_format_str() from
+ one huge inefficient switch statement to a binary search.
+
+ * tests/string_test.c
+ Dump log buffer if tests fail.
+
+2003-02-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/string_test.c
+ David Viens supplied some modifications to this file which showed up a bug
+ when using sf_set_string() and the sf_writef_float() functions.
+
+ * src/sndfile.c
+ Fixed the above bug.
+
+2003-02-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/FAQ.html
+ Added Q and A on how to detect libsndfile in configure.in (at the suggestion
+ of Davy Durham).
+
+2003-02-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in
+ Add enums and typedefs for dither.
+ Deprecate SFC_SET_ADD_DITHER_ON_WRITE and SFC_SET_ADD_DITHER_ON_READ, to be
+ replaced with SFC_SET_DITHER_ON_WRITE and SFC_SET_DITHER_ON_READ which will
+ allow different dither algorithms to be enabled.
+ Added SFC_GET_DITHER_INFO_COUNT and SFC_GET_DITHER_INFO.
+
+ * src/sndfile.h.in src/Version_script.in Win32/libsndfile.def.
+ Added public sf_dither_*() functions.
+
+ * src/sndfile.c
+ Implement commands above.
+
+ * src/dither.c
+ More work. Framework and external hooks into dither algorithms complete.
+
+2003-02-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/version-1.html libsndfile_version_convert.py
+ Remove redundant files.
+
+ * doc/index.html doc/api.html
+ Remove links to version-1.html.
+
+ * src/dither.c
+ New file to allow the addition of audio dither on input and output.
+
+ * src/common.h
+ Add prototype for dither_init() function.
+
+ * Makefile.am doc/Makefile.am
+ Changes for added and removed files.
+
+2003-02-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/Makefile.msvc
+ Changes to force example binaries to be placed in the top level directory
+ instead of the examples/ directory.
+ Add src/strings.c and src/xi.c to the build.
+ Add string_test to build and to tests on WAV files.
+
+ * doc/index.html
+ Added XI to support matrix.
+
+2003-01-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in
+ Added prototypes for sf_get_string() and sf_set_string() and SF_STR_*
+ enum values.
+
+ * src/sndfile.c
+ Added public interface to sf_get_string() and sf_set_string().
+
+ * src/wav.c
+ Added code for setting and getting strings in WAV files.
+
+ * tests/string_test.c
+ New test program for sf_get_string() and sf_set_string() functionality.
+
+ * tests/Makefile.am
+ Hook new test program into build and test framework.
+
+2003-01-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Added fields to SF_PRIVATE for string data needed to implement
+ sf_get_string() and sf_set_string().
+
+ * src/strings.c
+ New file for storing and retrieving strings to/from files.
+
+ * src/Makefile.am
+ Added strings.c to build.
+
+2003-01-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/xi.c
+ Read seems to be working so looking at write.
+
+ * src/sndfile.h.in
+ Added SF_FORMAT_XI, SF_FORMAT_DPCM_8 and SF_FORMAT_DPCM_16 enum values.
+
+ * tests/floating_point_test.c tests/lossy_comp_test.c tests/Makefile.am
+ Added test for 8 and 16 bit XI format files.
+
+2003-01-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/index.html
+ Added a non-lawyer readable summary of the licensing provisions as
+ suggested by Steve Dekorte.
+
+2003-01-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Fixed a compiler warning found by Alexander Lerch.
+
+2003-01-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Fixed the multiple linking of libm.
+
+2003-01-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/Makefile.mcvs
+ Added comments on the correct way to set up the MSVCDir environment
+ variable.
+
+ * doc/win32.html
+ Add on how to set up the MSVCDir environment variable.
+
+2003-01-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-play.c examples/sndfile-info.c
+ When run on Win32 without any command line parameters print a message and
+ then sleep for 5 seconds. This means the when somebody double clicks on
+ these programs in explorer the user will actually see the message.
+
+2003-01-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/misc_test.c
+ Bypass permission test if running as root because root is allowed to open
+ a readonly file for write.
+
+2003-01-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/Makefile.msvc
+ Added pvf.c and xi.c source files to project.
+
+ * src/sndfile.h
+ Updated for PVF files.
+
+2003-01-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Modified validate_sfinfo() to force samplerate, channels and sections
+ to be >= 1.
+ In format_from_extension() replaced calls to does_extension_match()
+ with strcmp().
+
+ * src/xi.c
+ More work.
+
+2003-01-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/Makefile.am
+ Added octave.html which had been left out. Found by Jan Weil.
+
+2003-01-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/pvf.c src/common.h src/sndfile.c
+ Fixed error handling for PVF files.
+
+ * src/xi.c
+ New file for handling Fasttracker 2 Extended Instrument files. Not working
+ yet and included when configured with --enable-experimental.
+
+ * src/sndfile.c src/common.h
+ Hooked in new file xi.c.
+
+2002-12-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/rx2.c
+ Added a patch from Marek Peteraj which sheds a little more light on the
+ slices within an RX2 file. Still need to find out data encoding.
+
+2002-12-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Started work on decoding 'acid' and 'strc' chunks.
+
+2002-12-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/peak_check_test.c
+ Minor cleanup.
+
+2002-12-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/write_read_test.tpl
+ Added check to make sure no error was generated when an attempt was made to
+ read past the end of the file.
+
+2002-12-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/lists.html
+ Added "mailto" links for all three lists.
+
+ * src/pvf.c
+ New file for Portable Voice Format files.
+
+ * src/sndfile.h.in src/sndfile.c src/common.h src/command.c src/Makefile.am
+ Added hooks for SF_FORMAT_PVF format files.
+
+ * tests/write_read_test.tpl tests/std*.c
+ Add tests for SF_FORMAT_PVF.
+
+ * doc/index.html
+ Add PVF to the compatibility matrix.
+
+ * src/pcm.c src/alaw.c src/ulaw.c src/float32.c src/double64.c
+ Previously, attempts to read beyond the end of a file would set psf->error
+ to SFE_SHORT_ERROR. This behaviour diverged from the behaviour of the POSIX
+ read() call but has now been fixed.
+ Attempts to read beyond the end of the file will return a short read count
+ but will not longer set any error.
+
+2002-12-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Add more sanity checking when opening a RAW file for read. When format is
+ not RAW, zero out all members of the SF_INFO struct.
+
+ * tests/raw_test.c
+ Add bad_raw_test() to check for above problem.
+
+ * tests/stdin_test.c examples/sndfile-info.c
+ Set the format field of the SF_INFO struct to zero before calling
+ sf_open().
+
+ * doc/api.html
+ Add information about the need to set the format field of the SF_INFO struct
+ to zero when opening non-RAW files for read.
+
+ * configure.ac
+ Removed use of conversion script on Solaris. Not all Solaris versions
+ support it.
+
+ * doc/lists.html
+ New file containg details of the mailing lists.
+
+ * doc/index.html
+ Add a link to the above new file.
+
+2002-12-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/dft_cmp.c
+ Fixed a SIGFPE on Alpha caused by a log10 (0.0). Thanks to Joshua Haberman
+ for providing the gdb traceback.
+
+2002-11-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Added more capabilities to 'smpl' chunk parser.
+
+ * src/sndfile.c
+ Fixed some (not all) possible problems found with Flawfinder.
+
+2002-11-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fixed a bug in sf_seek(). This bug could only occur when an attempt was
+ made to read beyond the end and then sf_seek() was called with a whence
+ parameter of SEEK_CUR.
+
+ * src/file_io.c
+ Win32's _fstati64() does not work, it returns BS. Re-implemented
+ psf_get_filelen() in terms of psf_fseek().
+
+ * tests/write_read_test.tpl
+ Add a test to detect above bug.
+
+ * src/float_cast.h
+ Modification to prevent compiler warnings on Mac OS X.
+
+ * src/file_io.c
+ Fixes for windows (what a f**ked OS).
+
+2002-11-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.ac
+ Disable use of native lrint()/lrintf() on Mac OSX. These functions exist on
+ Mac OSX 10.2 but not on 10.1. Forcing the use of the versions in
+ src/float_cast.h means that a library compiled on 10.2 will still work on
+ 10.1.
+
+2002-11-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in configure.ac
+ Renamed configure.in to configure.ac as expected by later versions of
+ autoconf.
+ Slight hacking of configure.ac to work with version 2.54 of autoconf.
+ Changed to using -dumpversion instead of --version for determining GCC
+ version numer as suggested by Anand Kumria.
+
+ * src/G72x/Makefile.am
+ Slight hacking required for operation with automake 1.6.3.
+
+2002-11-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.c
+ In psf_binheader_readf() changed type parameter type "b" type from size_t
+ to int to prevent errors on IA64 CPU where sizeof (size_t) != sizeof (int).
+ Thanks to Enrique Robledo Arnuncio for debugging this.
+
+2002-11-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * test/command_test.tpl
+ Changed test value so test would pass on Solaris.
+
+ * src/Version_script.in
+ Modified version numbering so that later versions of 1.0.X can replace
+ earlier versions without recompilation.
+
+ * src/vox_adpcm.c
+ Fixed bug causing short reads.
+
+2002-11-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * test/floating_point_test.c
+ Code cleanup using functions from util.c.
+ Add test for IEEE replacement floats and doubles.
+
+2002-11-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Fixed a possible divide by zero error when read the 'smpl' chunk. Thanks to
+ Serg Repalov for the example file.
+
+ * tests/pcm_test.tpl
+ Used sf_command (SFC_TEST_IEEE_FLOAT_REPLACE) to test IEEE replacement code.
+ Clean up pcm_double_test().
+
+ * src/float32.c src/double64.c
+ Force use of IEEE replacement code using psf->ieee_replace is TRUE,
+ Print message to log_buffer as well.
+ Rename all broken_read_* and broken_write* functions to replace_read_* and
+ replace_write_*.
+
+ * tests/util.tpl
+ Added string_in_log_buffer().
+
+ * tests/pcm_test.tpl
+ Use string_in_log_buffer() to ensure that IEEE replacement code has been
+ used.
+
+ * configure.in
+ Removed --enable-force-broken-float option. IEEE replacement code is now
+ always tested.
+
+2002-10-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/double64.c
+ Implement code for read/writing IEEE doubles on platforms where the native
+ double format is not IEEE.
+
+ * src/float32.c src/common.h
+ Remove float32_read() and float32_write(). Replace with float32_le_read(),
+ float32_be_read(), float32_le_write() and float32_be_write() to match stuff
+ in src/double64.c.
+
+ * src/common.c
+ Fix all usage of float32_write().
+
+ * src/sndfile.h.in
+ Added SFC_TEST_IEEE_FLOAT_REPLACE command (testing only).
+
+ * src/common.h
+ Added SF_PRIVATE field ieee_replace.
+
+ * src/sndfile.c
+ In sf_command() set/reset psf->ieee_replace.
+
+2002-10-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/pcm_test.tpl
+ Fixed a problem when testing with --enable-force-broken-float. The test was
+ generating a value of negative zero and the broken float code is not able
+ to write negative zero. Removing the negative zero fixed the test.
+
+2002-10-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Added fix for Cygwin (suggested by Maros Michalik).
+
+2002-10-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Improved error detection and handling.
+
+ * src/file_io.c src/common.h
+ Removed functions psf_ferror() and psf_clearerr() which were redundant
+ after above improvements.
+
+ * src/aiff.c src/svx.c src/w64.c src/wav.c
+ Removed all use of psf_ferror() and psf_clearerr().
+
+ * src/sndfile.c
+ Removed #include of <stdio.h>, <unistd.h>, <fcntl.h> and <math.h> which
+ are no longer needed.
+
+ * tests/misc_test.c
+ Added test to make sure the correct error message is returned with an
+ existing read-only file is openned for write.
+
+2002-10-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/index.html doc/api.html
+ Updated for OKI Dialogic ADPCM files.
+
+ * src/command.c
+ Added VOX ADPCM to sub_fomats.
+
+2002-10-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/vox_adpcm.c src/Makefile.am
+ New file for handling OKI Dialogic ADPCM files.
+
+ * src/sndfile.h
+ Add new subtype SF_FORMAT_VOX_ADPCM.
+
+ * src/sndfile.c
+ Renamed function is_au_snd_file () to format_from_extenstion () and expanded
+ its functionality to detect headerless VOX files.
+
+ * src/raw.c
+ Added hooks for SF_FORMAT_VOX_ADPCM.
+
+ * examples/sndfile-info.c
+ Print out file duration (suggested by Conrad Parker).
+
+ * libsndfile.spec.in
+ Force installation of sndfile.pc file (found by John Thompson).
+
+ * tests/Makefile.am tests/lossy_comp_test.c tests/floating_point_test.c
+ Add tests for SF_FORMAT_VOX_ADPCM.
+
+2002-10-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/misc_test.c
+ Add test which attempts to write to /dev/full (on Linux anyway) to check
+ for correct handling of writing to a full filesystem.
+
+ * src/sndfile.c
+ Return correct error message if the header cannot be written because the
+ filesystem is full.
+
+ * tests/util.tpl
+ Corrected printing of file mode in error reporting.
+
+ * src/mat5.c
+ Fixed a bug where a MAT5 file written by libsndfile could not be opened by
+ Octave 2.1.36.
+
+2002-10-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/file_io.c
+ All low level file I/O have been modified to be better able to report
+ system errors resulting from calling system level open/read/write etc.
+
+ * src/*.c
+ Updated for compatibility with above changes.
+
+ * examples/cooledit-fixer.c
+ New example program which fixes badly broken file created by Syntrillium's
+ Cooledit which are marked as containing PCM samples but actually contain
+ floating point data.
+
+ * examples/Makefile.am
+ Hooked cooledit-fixer into the build system.
+
+2002-10-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/command.html
+ Document SFC_GET_FORMAT_INFO.
+
+2002-10-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/wav32_aiff24.c examples/sndfile2oct.c examples/sfhexdump.c
+ examples/sfdump.c
+ Removed these files because they weren't interesting.
+
+ * examples/sfconvert.c examples/sndfile-convert.c
+ Renamed the first to the latter.
+
+ * examples/Makefile.am
+ Added sndfile-convert to the bin_PROGRAMS, so it is installed when the lib
+ is installed.
+ Removed old programs wav32_aiff24 and sndfile2oct.
+
+ * man/sndfile-convert.1
+ New man page.
+
+ * examples/sndfile-convert.c
+ Added some gloss now that sndfile-convert.c is an installed program.
+
+ * src/sndfile.h.in src/sndfile.c src/common.h src/command.h
+ Added command SFC_GET_FORMAT_INFO.
+
+ * tests/command_test.c
+ Added tests form SFC_GET_FORMAT_INFO.
+
+2002-10-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ In sf_format_check() return error if samplerate < 0.
+
+2002-10-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Fixed bug in handling of COMM chunks with a 4 byte encoding byte but no
+ encoding string.
+
+2002-10-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fixed repeated word in an error message.
+
+2002-10-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/index.html
+ Improved advertising in Features section.
+
+2002-10-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Added decoding of 'labl' chunks within 'LIST' chunks.
+
+ * src/common.h
+ Added (experimental only) SF_FORMAT_OGG and SF_FORMAT_VORBIS and definition
+ of ogg_open(). This is nowhere near working yet.
+
+ * src/sndfile.c
+ Added detection of 'OggS' file marker and added call to ogg_open() to
+ switch statement.
+
+ * src/ogg.c
+ New file. Very early start of Ogg Vorbis support.
+
+ * src/wav.c
+ Added handling of brain-damaged and broken Cooledit "32 bit 24.0 float
+ type 1" files. These files are marked as being 24 bit WAVE_FORMAT_PCM with
+ a block alignment of 4 times the numbers of channels but are in fact 32 bit
+ floating point.
+
+2002-10-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in
+ Modified option --enable-experimental to set ENABLE_EXPERIMENTAL_CODE in
+ config.h to either 0 or 1.
+
+ * src/sndfile.c
+ Modify sf_command (SFC_GET_LIB_VERSION) to append "-exp" to the version
+ string if experimental code has been enabled.
+
+2002-10-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/Makefile.am
+ Added -lm to libsndfile_la_LIBADD. This means that -lm is not longer needed
+ in the link line when linking something to libsndfile.
+
+ * tests/Makefile.am examples/Makefile.am
+ Removed -lm from all link lines.
+
+ * sndfile.pc.in
+ Removed -lm from Libs line.
+
+2002-09-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Removed all perror() calls.
+
+ * src/nist.c
+ Removed calls to exit() function.
+ Added check to detect NIST files dammaged from Unix CR -> Win32 CRLF
+ conversion process.
+
+2002-09-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in src/sndfile.c
+ New function sf_strerror() which will eventually replace functions
+ sf_perror() and sf_error_str().
+ Function sf_error_number() has also been changed, but this was documented
+ as being for testing only.
+
+ * doc/api.html
+ Documented above changes.
+
+ * tests/*.c examples/*.c
+ Changed to new error functions.
+
+2002-09-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in
+ Detect GCC version, and print a warning message about writeable strings
+ it GCC major version number is less than 3.
+
+2002-09-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in doc/api.html
+ Documentation fixes.
+
+2002-09-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/Version_script.in src/Makefile.am configure.in
+ Use the version script to prevent the exporting of all non public symbols.
+ This currently only works with Linux. Will test on Solaris as well.
+
+ * src/float_cast.h
+ Added #ifndef to prevent the #warning directives killing the SGI MIPSpro
+ compiler.
+
+ * src/au_g72x.c src/double64.c src/float32.c src/gsm610.c src/ima_adpcm.c
+ src/ms_adpcm.c
+ Fix benign compiler warnings arising from previously added compiler
+ flags.
+
+2002-09-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fixed a bug in sf_error_str() where errnum was used as the index instead
+ of k. Found by Tim Hockin.
+
+ * examples/sndfile-play.c
+ Fixed a compiler warning resulting from a variable shadowing a previously
+ defined local.
+
+2002-09-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in src/sndfile.c
+ Added command SFC_SET_RAW_START_OFFSET.
+
+ * doc/command.html
+ Document SFC_SET_RAW_START_OFFSET.
+
+ * tests/raw_test.c tests/Makefile.am
+ Add new file for for testing SF_FORMAT_RAW specific functionality.
+
+ * tests/dwvw_test.c
+ Updates.
+
+2002-09-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Modified reading of 'smpl' chunk to take account of the sampler data field.
+
+ * tests/utils.tpl tests/utils.h
+ Added function print_test_name().
+
+ * tests/misc_test.c tests/write_read_test.tpl tests/lossy_comp_test.c
+ tests/pcm_test.tpl tests/command_test.tpl tests/floating_point_test.c
+ Convert to use function print_test_name().
+
+2002-09-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/octave.html
+ Added a link to some other Octave scripts for reading and writing sound
+ files.
+
+ * src/paf.c
+ Change type of dummy data field to int. This should fix a benign compiler
+ warning on some CPUs.
+ Removed superfluous casts resulting from the above change.
+
+ * src/rx2.c
+ More hacking.
+
+2002-09-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/mat5.c src/common.c
+ Changed usage of snprintf() to LSF_SNPRINTF().
+
+ * Win32/Makefile.msvc
+ Updated to include new files and add new tests.
+
+ * Win32/config.h Win32/sndfile.h
+ Updated.
+
+ * doc/api.html
+ Added note about the possibility of "missing" features actually being
+ implemented as an sf_command().
+
+2002-09-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/misc_test.c
+ Added previously missing update_header_test and zero_data_tests for PAF,
+ MAT4 and MAT5 formats.
+
+ * src/paf.c src/mat4.c src/mat5.c
+ Fixed bugs uncovered by new tests above.
+
+ * src/mat5.c
+ Generalised parsing of name fields of MAT5 files.
+
+ * src/mat5.c src/sndfile.c
+ Added support for unsigned 8 bit PCM MAT5 files.
+
+ * tests/write_read_test.tpl
+ Added test for unsigned 8 bit PCM MAT5 files.
+
+ * doc/index.html
+ Added unsigned 8 bit PCM MAT5 to capabilities matrix.
+
+2002-09-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * test/update_header_test.c tests/misc_test.c
+ Renamed update_header_test.c to misc_test.c.
+ Added zero_data_test() to check for case where file is opened for write and
+ closed immediately. The resulting file can be left in a state where
+ libsndfile cannot open it. Problem reported by Werner Schweer, the author
+ of Muse.
+
+ * src/aiff.c
+ Removed superfluous cast.
+
+ * src/wav.c src/svx.c
+ Fixed case of file generated with no data.
+ Removed superfluous cast.
+
+ * src/sndfile.c
+ Fixed error on IA64 platform caused by incorrect termination of
+ SndfileErrors struct array. This problem was found in the Debian buildd
+ logs (http://buildd.debian.org/).
+
+ * configure.in
+ Added Octave directory.
+
+ * Octave/Makefile.ma
+ New Makfile.am for Octave directory.
+
+ * Octave/sndfile_load.m Octave/sndfile_save.m Octave/sndfile_play.m
+ New files for working with Octave.
+
+ * doc/octave.html
+ Document explaining the use of the above three Octave scripts.
+
+2002-09-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fixed bug in RDWR mode.
+
+2002-09-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.c
+ Fixed psf_get_date_str() for systems which don't have gmtime_r() or
+ gmtime().
+
+ * src/file_io.c
+ Added #include <io.h> for Win32. Reported by Koen Tanghe.
+
+2002-09-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.c
+ Added 'S' format specifier for psf_binheader_writef() which writes a C
+ string, including single null terminator to the header.
+ Added 'j' format specifier to allow jumping forwards or backwards in the
+ header.
+ Added function psf_get_date_str().
+
+ * src/mat5.c
+ Complete read and write support.
+
+ * doc/index.html
+ Added entries for MAT4 and MAT5 in capabilities matrix.
+
+2002-09-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/mat4.c
+ Completed read and write support.
+
+ * src/common.h src/sndfile.c
+ Added MAT4 and MAT5 specific error messages.
+
+ * tests/write_read_test.tpl tests/Makefile.am
+ Added tests for MAT4 and MAT5 files.
+
+ * tests/stdio_test.c tests/stdout_test.c tests/stdin_test.c
+ Added tests for MAT4 and MAT5 files.
+
+2002-09-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/command.c
+ Added elements for SF_FORMAT_MAT4 and SF_FORMAT_MAT5 to major_formats
+ array.
+
+ * examples/sfconvert.c
+ Added mat4 and mat5 output targets.
+
+2002-09-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Added check to prevent errors openning read only formats for read/write.
+
+ * src/interleave.c
+ New file for interleaving non-interleaved data. Non-interleaved data is
+ only supported on read.
+
+ * src/Makefile.am
+ Added src/interleave.c to build.
+
+2002-09-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/double64.c src/common.h
+ Added double64_be_read(), double64_le_read(), double64_be_write() and
+ double64_le_write() which replace double64_read() and double64_write().
+
+ * src/common.c
+ Cleanup of psf_binheader_readf() and add ability to read big and little
+ endian doubles (required by mat4.c and mat5.c).
+ Add ability for psf_binheader_writef() to write doubles to sound file
+ headers.
+
+2002-09-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/mat5.c
+ New file for reading Matlab (tm) version 5 data files. This is also the
+ native binary file format for version 2.1.X of GNU Octave which will be
+ used for testing.
+ Not complete yet.
+
+ * src/mat4.c
+ New file for reading Matlab (tm) version 4.2 data files. This is also the
+ native binary file format for version 2.0.X of GNU Octave which will be
+ used for testing.
+ Not complete yet.
+
+ * src/sndfile.h.in src/sndfile.c src/common.h src/command.c src/Makefile.am
+ Mods to add Matlab files.
+
+ * src/common.[ch]
+ Added readf_endian field to SF_PRIVATE struct allowing endianness to
+ remembered across calls to sf_binheader_readf().
+ Fixed bug in width_specifier behaviour for printing hex values.
+
+2002-08-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Check return value of close() call in psf_fclose().
+
+2002-08-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ms_adpcm.c
+ Commented out some code where 0x10000 was being subtracted from a short
+ and the result assigned to a short again. Andrew Zaja found this.
+
+2002-08-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/command.html
+ Fixed typo found by Tommi Ilmonen.
+
+ * src/ima_adpcm.c
+ Changed type of diff from short to int to prevent errors which can occur
+ during very rare circumstances. Thanks to FUWAFUWA.
+
+2002-08-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/floating_point_test.c
+ Disable testing on machines without lrintf().
+
+ * Win32/Makefile.msvc
+ Added dwd.c and wve.c to build.
+
+ * configure.in
+ Bumped version to 1.0.0.
+
+2002-08-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Add a #include for Mac OS 9. Thanks to Stephane Letz.
+
+ * src/wav.c
+ Changed an snprintf to LSF_SNPRINTF.
+
+ * doc/Makefile.am
+ Added version-1.html.
+
+2002-08-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in
+ Bumped version to 1.0.rc6.
+
+ * src/*.c
+ Modified scaling of normalised floats and doubles to integers. Until now
+ this has been done by multiplying by 0x8000 for short output, 0x80000000
+ for 32 bit ints and so on. Unfortunately this can cause an overflow and
+ wrap around in the target value. All thes values have therefore been
+ reduced to 0x7FFF, 0x7FFFFFFF and so on. The conversion from ints to
+ normalised floats and doubles remains unchanged. This does mean that for
+ repeated conversions normalised float -> pcm16 -> normalised float would
+ result in a decrease in amplitude of 0x7FFF/0x8000 on every round trip.
+ This is undesirable but less undesireable than the wrap around I am trying
+ to avoid.
+
+ * tests/floating_point_test.c
+ Removed file hash checking because new float scaling procedure introduced
+ above prevented the ability to crate a has on both x86 and PowerPC systems.
+
+2002-08-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/txw.c
+ Completed reading of TXW files. Seek doesn't work yet.
+
+ * src/file_io.c
+ Added a MacOS 9 replacement for ftruncate().
+
+ * MacOS/sndfile.h
+ Added MacOS 9 header file. This should be copied into src/ to compile
+ libsndfile for MacOS9.
+
+2002-08-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fixed commands SF_SET_NORM_DOUBLE and SFC_SET_NORM_FLOAT to return their
+ values after being set. Reported by Jussi Laako.
+
+ * configure.in
+ If autogen is not found, touch all .c and .h files in tests/.
+
+ * src/common.c
+ Added format width specifier to psf_log_printf() for %u, %d, %D and %X.
+
+ * src/dwd.c
+ Completed implementation of read only access to these files.
+
+ * src/common.h src/*.c src/pcm.c
+ Removed redundant field chars from SF_PRIVATE struct and modified
+ pcm_init() to do without it.
+
+2002-08-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wve.c
+ New file implementing read of Psion Alaw files. This will be a read only
+ format. Implementation complete.
+
+ * src/dwd/c
+ Started implementation of DiamondWare Digitized files. Also read only, not
+ complete.
+
+ * src/wav.c
+ Add parsing of 'smpl' chunk.
+
+ * src/paf.c
+ Fixed reading on un-normalized doubles and floats from 24 bit PAF files.
+ This brings it into line with the reading of 8 bit files into
+ un-normalized doubles which returns values in the range [-128, 127].
+
+ * src/common.c
+ Modified psf_log_printf() to accept the %% conversion specifier to allow
+ printing of a single '%'.
+
+ * src/sds.c
+ Read only of 16 bit samples is working. Need to build a test harness for
+ this and other read only formats.
+
+2002-08-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in
+ Added --enable-experimental configure option.
+ Removed pkg-config message at the end of the configure process.
+
+ * src/sds.c src/txw.c src/rx2.c src/sd2.c
+ Moved all the code in these files inside #if ENABLE_EXPERIMENTAL_CODE
+ blocks and added new *_open() function for the case where experimental is
+ not enabled. These new functions just return SFE_UNIMPLMENTED.
+
+ * Win32/sndfile.h src/sndfile.h.in src/common.h
+ Removed un-necessary #pragma pack commands.
+
+ * src/file_io.c
+ Implemented psf_ftruncate() and much other hacking for Win32.
+
+ * Win32/Makefile.msvc
+ Updated.
+
+ * doc/win32.html
+ Updated to include the copying of the sndfile.h file from the Win32/
+ directory to the src/ directory.
+
+ * Make.bat
+ Batch file to make compiling on Wi32 a little easier. Implements "make" and
+ "make check".
+
+2002-08-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ Add place holder for ftruncate() on Win32 which doesn't have ftruncate().
+ This will need to be fixed later.
+
+ * src/sndfile.h.in
+ New file (copy of sndfile.h) with sets up @TYPEOF_SF_COUNT_T@ which will be
+ replaced by the correct type during configure.
+
+ * configure.in
+ Modified to find a good type for TYPEOF_SF_COUNT_T.
+
+ * src/aiff.c
+ Fixed a bug when reading malformed headers.
+
+ * src/common.c
+ Set read values to zero before performing read.
+
+2002-08-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/command.html
+ Fixed some HTML tags which were not allowing jumps to links within the
+ page.
+
+ * src/sds.c
+ Massive hacking on this.
+
+ * src/wav.c
+ Added recognition of 'clm ' tag.
+
+2002-08-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/index.html
+ Added beginning of a capabilities list beyond simple file formats which
+ can be read/written.
+
+ * src/aiff.c
+ Added parsing of INST and MARK chunks of AIFF files. At the moment this
+ data is simply recorded in the log buffer. Later it will be possible to
+ read this data from an application using sf_command().
+
+ * src/wav.c
+ Added parsing of 'cue ' chunk which contains loop information in WAV files.
+
+ * exampes/sndfile-info.c
+ Changed reporting of Samples to Frames.
+
+ * src/wav.c src/w64.c src/aiff.c src/wav_w64.h
+ Moved from a samples to a frames nomenclature to avoid confusion.
+
+ * doc/FAQ.html
+ What's the best format for storing temporary files?
+
+ * src/sds.c
+ New file for reading/writing Midi Sample Dump Standard files.
+
+ * src/Makefile.am src/sndfile.c src/common.[ch]
+ Added hooks for sds.c.
+
+ * examples/sndfile-info.c
+ Changed from using sf_perror() to using sf_error_str().
+
+2002-08-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/api.html
+ Added explanation of mode parameter for sf_open().
+ Added explanation of usage of SFM_* values in sf_seek().
+
+ * src/sndfile.[ch] src/command.c src/file_io.c src/common.h
+ Implemented SFC_FILE_TRUNCATE to allow a file to be truncated. File
+ truncation was suggested by James McCartney.
+
+ * src/command.html
+ Documented SFC_FILE_TRUNCATE.
+
+ * tests/command_test.c
+ Add tests for SFC_FILE_TRUNCATE.
+
+ * src/sndfile.c
+ Added a thrid parameter to the VALIDATE_SNDFILE_AND_ASSIGN_PSF macro to
+ make resetting the error number optional. All uses of the macro other than
+ in error reporting functions were changed to reset the error number.
+
+ * src/pcm.c
+ Fixed a bug were sf_read_* was logging an SFE_SHORT_READ even when no error
+ occurred.
+
+ * tests/write_read_test.tpl
+ Added tests of internal error state.
+
+2002-08-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/GSM610/private.h src/GSM610/*.c src/GSM610/Makefile.am
+ Renamed private.h to gsm610_priv.h to prevent clash with other headers
+ named private.h in other directories. (Probably only a problem on MacOS 9).
+
+ * src/G72x/private.h src/G72x/*.c src/G72x/Makefile.am
+ Renamed private.h to g72x_priv.h to prevent clash with other headers
+ named private.h in other directories. (Probably only a problem on MacOS 9).
+
+ * MacOS/config.h
+ Changed values of HAVE_LRINT and HAVE_LRINTF to force use of code in
+ float_cash.h.
+
+ * src/sndfile.h
+ Changes the name of samples field of the SF_INFO to frames. The old name
+ had caused too much confusion and it simply had to be changed. There will
+ be at least one more pre-release.
+
+2002-08-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/index.html
+ Updated formats matrix to include RAW (header-less) GSM 6.10.
+ Fix specificaltion of table and spelling mistakes.
+
+ * src/sndfile.c src/command.c
+ Fixed bug in SFC_CALC_MAX_SIGNAL family and psf_calc_signal_max ().
+
+ * tests/command.c
+ Removed cruft.
+ Added test for SFC_CALC_MAX_SIGNAL and SFC_CALC_NORM_MAX_SIGNAL.
+
+ * configure.in
+ Update version to 1.0.0rc5.
+
+ * sfendian.h
+ Removed inclusion of un-necessary header.
+
+2002-08-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Minor fixes of info written to log buffer.
+
+ * src/float_cast.h
+ Add definition of HAVE_LRINT_REPLACEMENT.
+
+ * tests/floating_point_test.c
+ Fix file hash check on systems without lrint/lrintf.
+
+ * tests/dft_cmp.c
+ Limit SNR to less than -500.0dB.
+
+ * examples/sndfile2oct.c
+ Fixed compiler warnings.
+
+ * doc/api.html
+ Fixed error where last parameter of sf_error_str() was sf_count_t instead
+ of size_t.
+
+2002-08-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/FAQ.html
+ Why doesn't libsndfile do interleaving/de-interleaving.
+
+ * tests/pcm_test.tpl
+ On Win32 do not perform hash check on files containing doubles.
+
+2002-08-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Defined SF_COUNT_MAX_POSITIVE() macro, a portable way of setting variables
+ of type sf_count_t to their maximum positive value.
+
+ * src/dwvw.c src/w64.c
+ Used SF_COUNT_MAX_POSITIVE().
+
+2002-07-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/paf.c
+ Fixed bug in reading/writing of 24 bit PCM PAF files on big endian systems.
+
+ * tests/floating_point_tests.c
+ Fixed hash values for 24 bit PCM PAF files.
+ Disabled file has check if lrintf() function is not available and added
+ warning.
+ Decreased level of signal from a peak of 1.0 to a value of 0.95 to prevent
+ problems on platforms without lrintf() ie Solaris.
+
+2002-07-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Fixed a problem with two different kinds of mal-formed WAV file header. The
+ first had the 'fact' chunk before the 'fmt ' chunk, the other had an
+ incomplete 'INFO' chunk at the end of the file.
+
+ * src/w64.c
+ Added fix to allow differentiation between W64 files and ACID files.
+
+ * src/au_g72x.c src/common.h src/sndfile.c
+ Added error for G72x encoded files with more than one channel.
+
+ * tests/pcm_test.tpl tests/utils.tpl
+ Moved function check_file_hash_or_die() to utils.tpl. Function was then
+ modified to calculate the has of the whole file.
+
+ * src/wav.c
+ Fixed problem writing the 'fact' chunk on big endian systems.
+
+ * tests/sfconvert.c
+ Fixed bug where .paf files were being written as Sphere NIST.
+
+2002-07-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/voc.c
+ Fix for reading headers generated using SFC_UPDATE_HEADER_NOW.
+
+ * doc/command.html
+ Add docs for SFC_UPDATE_HEADER_NOW and SFC_SET_UPDATE_HEADER_AUTO.
+
+2002-07-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * man/sndfile-info.1 man/sndfile-play.1
+ Added manpages supplied by Joshua Haberman the Debian maintainer for
+ libsndfile. Additional tweaks by me.
+
+ * configure.in man/Makefile.am
+ Hooked manpages into autoconf/automake system.
+
+ * src/sndfile.c
+ Added hooks for SFC_SET_UPDATE_HEADER_AUTO.
+
+ * tests/update_header_test.c
+ Improved rigor of testing.
+
+ * src/*.c
+ Fixed problem with *_write_header() functions.
+
+2002-07-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/*.html
+ Updates to documentation to fix problems found by wdg-html-validator.
+
+ * src/common.h src/command.c
+ Added normalize parameter to calls to psf_calc_signal_max() and
+ psf_calc_max_all_channels().
+
+ * src/sndfile.c
+ Added handling for commands SFC_CALC_NORM_SIGNAL_MAX and
+ SFC_CALC_NORM_MAX_ALL_CHANNELS.
+
+ * doc/command.html
+ Added entry for SFC_CALC_NORM_SIGNAL_MAX and SFC_CALC_NORM_MAX_ALL_CHANNELS.
+
+2002-07-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-play.c Win32/Makefile.msvc
+ Get sndfile-play program working on Win32. The Win32 PCM sample I/O API
+ sucks. The sndfile-play program now works on Linux, MacOSX, Solaris and
+ Win32.
+
+2002-07-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/FAQ.html
+ New file for frequently asked questsions.
+
+2002-07-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/api.html
+ Documentation fixes.
+
+ * src/au.[ch] src/au_g72x.c src/G72x/g72x.h
+ Add support of 40kbps G723 ADPCM encoding.
+
+ * tests/lossy_comp_test.c tests/floating_point_test.c
+ Add tests for 40kbps G723 ADPCM encoding.
+
+ * doc/index.html
+ Update support matrix.
+
+2002-07-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/command.html
+ Documented SFC_GET_SIMPLE_FORMAT_COUNT, SFC_GET_SIMPLE_FORMAT,
+ SFC_GET_FORMAT_* and SFC_SET_ADD_PEAK_CHUNK.
+
+ * src/sndfile.c src/pcm.c
+ Add ability to turn on and off the addition of a PEAK chunk for floating
+ point WAV and AIFF files.
+
+ * src/sndfile.[ch] src/common.h src/command.c
+ Added sf_command SFC_CALC_MAX_ALL_CHANNELS. Implemented by Maurizio Umberto
+ Puxeddu.
+
+ * doc/command.html
+ Docs for SFC_CALC_MAX_ALL_CHANNELS (assisted by Maurizio Umberto Puxeddu).
+
+2002-07-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c src/gsm610.c
+ Finalised support for GSM 6.10 AIFF files and added support for GSM 6.10
+ encoded RAW (header-less) files.
+
+ * src/wav.c
+ Add support for IBM_FORMAT_MULAW and IBM_FORMAT_ALAW encodings.
+
+ * src/api.html
+ Fixed more documentation bugs.
+
+2002-07-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h src/common.h
+ Moved some yet-to-be-implelmented values for SF_FORMAT_* from the public
+ header file sndfile.h to the private header file common.h to avoid
+ confusion about the actual capabilities of libsndfile.
+
+2002-07-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c src/wav.c
+ Fixed file parsing for WAV and AIFF files containing non-audio data after
+ the data chunk.
+
+ * src/aiff.c src/sndfile.c
+ Add support for GSM 6.10 encoded AIFF files.
+
+ * tests/lossy_comp_test.c tests/Makefile.am
+ Add tests for GSM 6.10 encoded AIFF files.
+
+ * src/*.c
+ Fix compiler warnings.
+
+2002-07-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/command_test.c
+ For SFC_SET_NORM_* tests, change the file format from SF_FORMAT_WAV to
+ SF_FORMAT_RAW.
+
+ * src/sndfile.c
+ Added sf_command(SFC_TEST_ADD_TRAILING_DATA) to allow testing of reading
+ from AIFF and WAV files with non-audio data after the audio chunk.
+
+ * src/common.h
+ Add test commands SFC_TEST_WAV_ADD_INFO_CHUNK and
+ SFC_TEST_AIFF_ADD_INST_CHUNK. When these commands are working, they will be
+ moved to src/sndfile.h
+
+ * src/aiff.c src/wav.c
+ Begin implementation of XXXX_command() hook for sf_command().
+
+ * tests/write_read_test.tpl
+ Added sf_command (SFC_TEST_ADD_TRAILING_DATA) to ensure above new code was
+ working.
+
+2002-07-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/update_header_test.c
+ Allow read sample count == write sample count - 1 to fix problems with VOC
+ files.
+
+ * tests/write_read_test.tpl tests/pcm_test.tpl
+ Fixed some problems in the test suite discovered by using Valgrind.
+
+2002-07-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/utils.[ch] tests/*.c
+ Renamed check_log_buffer() to check_log_buffer_or_die().
+
+ * src/sndfile.c
+ SFC_UPDATE_HEADER_NOW and SFC_SETUPDATE_HEADER_AUTO almost finished. Works
+ for all file formats other than VOC.
+
+2002-07-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.[ch] src/common.h
+ Started adding functionality to allow the file header to be updated before
+ the file is closed on files open for SFM_WRITE. This was requested by
+ Maurizio Umberto Puxeddu who is using libsndfile for file I/O in iCSound.
+
+ * tests/update_header_test.c
+ New test program to test that the above functionality is working correctly.
+
+ * tests/peak_chunk_test.c tests/floating_point_test.c
+ Cleanups.
+
+2002-07-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sfendian.[ch]
+ Changed length count parameters for all endswap_XXX() functions from
+ sf_count_t (which can be 64 bit even on 32 bit architectures) to int. These
+ functions are only called frin inside the library, are always called with
+ integer parameters and doing the actual calculation on 64 bit values is
+ slow in comparision to doing it on ints.
+
+ * examples/sndfile-play.c
+ More playback hacking for Win32.
+
+2002-07-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.c
+ In psf_log_printf(), changed %D format conversion specifier to %M (marker) and
+ added %D specifier for printing the sf_count_t type.
+
+ * src/*.c
+ Changed all usage of psf_log_printf() with %D format conversion specifiers
+ to use %M conversion instead.
+
+ * tests/pcm_test.tpl tests/pcm_test.def
+ New files to autogen pcm_test.c.
+
+ * src/pcm.c
+ Fixed bug in scaling floats and doubles to 24 bit PCM and vice versa.
+
+2002-07-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in
+ Fix setup of $ac_cv_sys_largefile_CFLAGS so that sndfile.pc gets valid
+ values for CFLAGS.
+
+ * examples/sndfile-play.c
+ Start adding playback support for Win32.
+
+2002-07-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.c
+ Worked to removed compiler warnings.
+ Extensive refactoring.
+
+ * src/common.[ch]
+ Added function psf_memset() which works like the standard C function memset
+ but takes and sf_count_t as the length parameter.
+
+ * src/sndfile.c
+ Replaced calls to memset(0 with calls to psf_memset() as required.
+
+2002-07-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Added "libsndfile : " to the start of all error messages. This was suggested
+ by Conrad Parker author of Sweep ( http://sweep.sourceforge.net/ ).
+
+ * src/sfendian.[ch]
+ Added endswap_XXXX_copy() functions.
+
+ * src/pcm.c src/float32.c src/double64.c
+ Use endswap_XXXX_copy() functions and removed dead code.
+ Cleanups and optimisations.
+
+2002-07-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c src/sndfile.h
+ Gave values to all the SFC_* enum values to allow better control of the
+ interface as commands are added and removed.
+ Added new command SFC_SET_ADD_PEAK_CHUNK.
+
+ * src/wav.c src/aiff.c
+ Modified wav_write_header and aiff_write_header to make addition of a PEAK
+ chunk optional, even on floating point files.
+
+ * tests/benchmark.tpl
+ Added call to sf_command(SFC_SET_ADD_PEAK_CHUNK) to turn off addition of a
+ PEAK chunk for the benchmark where we are trying to miximize speed.
+
+ * src.pcm.c
+ Changed tribyte typedef to something more sensible.
+ Further conversion speed ups.
+
+2002-07-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/command.c
+ In major_formats rename "Sphere NIST" to "NIST Sphere".
+
+ * src/common.c src/sfendian.c
+ Moved all endswap_XXX_array() functions to sfendian.c. These functions will
+ be tweaked to provide maximum performance. Since maximum performance on one
+ platform does not guarantee maximum performance on another, a small set of
+ functions will be written and the optimal one chosen at compile time.
+
+ * src/common.h src/sfendian.h
+ Declarations of all endswap_XXX_array() functions moved to sfendian.h.
+
+ * src/Makefile.am
+ Add sfendian.c to build targets.
+
+2002-07-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/pcm.c src/sfendian.h
+ Re-coded PCM encoders and decoders to match or better the speed of
+ libsndfile version 0.0.28.
+
+2002-06-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Add checking for WAVPACK data in standard PCM WAV file. Return error if
+ found. This WAVPACK is *WAY* broken. It uses the same PCM WAV file header
+ and then stores non-PCM data.
+
+ * tests/benchmark.tpl
+ Added more tests.
+
+2002-06-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/benchmark.tpl
+ Added conditional definition of M_PI.
+ For Win32, set WRITE_PERMS to 0777.
+
+ * Win32/Makefile.msvc
+ Added target to make generate program on Win32.
+
+ * src/samplitude.c
+ Removed handler for Samplitude RAP file format. This file type seems rarer
+ than hens teeth and is completely undocumented.
+
+ * src/common.h src/sndfile.c src/Makefile.am Win32/Makefile.msvc
+ Removed references to sampltiude RAP format.
+
+ * tests/benchmark.tpl
+ Benchmark program now prints the libsndfile version number when run. This
+ program was also backported to version 0 to compare results. Version
+ 1.0.0rc2 is faster than version 0.0.28 on most conversions but slower on
+ some. The slow ones need to be fixed before final release.
+
+2002-06-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/benchmark.def tests/benchmark.tpl
+ New files which generate tests/benchmark.c using Autogen. Added int ->
+ SF_FORMAT_PCM_24 test.
+
+ * tests/benchmark.c
+ Now and Autogen output file.
+
+ * tests/Makefile.am
+ Updated for above changes.
+
+2002-06-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/benchmark.c
+ Basic benchmark program complete. Need to convert it to Autogen.
+
+ * Win32/Makefile.msvc
+ Added benchmark.exe target.
+
+2002-06-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/generate.c
+ New program to generate a number of different output file formats from a
+ single input file. This allows testing of the created files.
+
+ * tests/benchmark.c
+ New test program to benchmark libsndfile. Nowhere near complete yet.
+
+ * examples/Makefile.am tests/Makefile.am
+ New make rules for the two new programs.
+
+2002-06-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/libsndfile.def
+ Removed definition for sf_signal_max().
+
+ * src/sndfile.c
+ Removed cruft.
+
+ * doc/index.html
+ A number of documentation bugs were fixed. Thanks to Anand Kumria.
+
+ * doc/version-1.html
+ Minor doc updates.
+
+ * configure.in
+ Bumped version to 1.0.0rc2.
+
+ * src/sf_command.h src/Makefile.am
+ Removed the header file as it was no longer being used. Thanks to Anand
+ Kunria for spotting this.
+
+ * doc/index.html
+ A number of documentation bugs were fixed. Thanks to Anand Kumria.
+
+2002-06-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Test for Win32 before testing SIZEOF_OFF_T so that it works correctly
+ on Win32..
+
+ * src/file_io.c
+ Win32 fixes to ensure O_BINARY is used for file open.
+
+ * doc/win32.html
+ New file documenting the building libsndfile on Win32.
+
+ * doc/*.html
+ Updating of documentation.
+
+2002-06-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/pcm_test.c
+ Minor changes to allow easier determination of test file name.
+
+ * src/sndfile.[ch]
+ Removed function sf_signal_max().
+
+ * examples/sndfile-play.c
+ Changed call to sf_signal_max() to a call to sf_command().
+
+2002-06-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/format.c src/command.c
+ Renamed format.c to command.c which will now include code for sf_command()
+ calls to perform operations other than format commands.
+
+ * src/sndfile.c src/sndfile.h
+ Removed function sf_get_signal_max() which is replaced by commands passed
+ to sf_command().
+
+ * src/command.c
+ Implement commands SFC_CALC_SIGNAL_MAX.
+
+ * doc/command.html
+ Documented SFC_CALC_SIGNAL_MAX.
+
+2002-06-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-play.c
+ Mods to make sndfile-play work on Solaris. The program sndfile-play now
+ runs on Linux, MaxOSX and Solaris. Win32 to come.
+
+ * src/format.c
+ Added SF_FORMAT_DWVW_* to subtype_formats array.
+
+ * src/nist.c
+ Added support for 8 bit NIST Sphere files. Example file supplied by Anand
+ Kumria.
+
+2002-06-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sndfile-info.c
+ Tidy up of output format.
+
+ * examnples/sndfile-play.c
+ Mods to make sndfile-play work on MacOSX using Apple's CoreAudio API.
+
+ * configure.in
+ Add new variables OS_SPECIFIC_INCLUDES and OS_SPECIFIC_LINKS which were
+ required to supply extra include paths and link parameters to get
+ sndfile-play working on MacOSX.
+
+ * examples/Makefile.am
+ Use OS_SPOECIFIC_INCLUDES and OS_SPECIFIC_LINKS to build commands for
+ sndfile-play.
+
+2002-06-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/nist.c
+ Added ability to read/write new NIST Sphere file types (A-law, u-law).
+ Header parser was re-written from scratch. Example files supplied by Anand
+ Kumria.
+
+ * src/sndfile.c
+ Support for A-law and u-law NIST files.
+
+ * tests/Makefile.am tests/lossy_comp_test.c
+ Tests for A-law and u-law NIST files.
+
+2002-06-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/utils.c
+ Fixed an error in error string.
+
+2002-06-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * acinclude.m4
+ Removed exit command to allow cross-compiling.
+
+ * Win32/unistd.h src/file_io.c
+ Moved contents of first file into the second file (enclosed in #ifdef).
+ Win32/unistd.h is now an empty file but still must be there for libsndfile
+ to compile on Win32.
+
+ * src/sd2.c, src/sndfile.c:
+ Fixes for Sound Designer II files on big endian systems.
+
+2002-06-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in
+ Modified to work around problems with crappy MacOSX version of sed.
+ Added sanity check for proper values for CFLAGS.
+
+2002-06-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Code clean up in sf_open ().
+
+ * Win32/Makefile.msvc
+ Michael Fink's contributed MSVC++ makefile was hacked to bits and put back
+ together in a new improved form.
+
+ * src/file_io.c
+ Fixes for Win32; _lseeki64() returns an invalid argument for calls like
+ _lseeki64(fd, 0, SEEK_CUR) so need to use _telli64 (fd) instead.
+
+ * src/common.h src/sndfile.c src/wav.c src/aiff.c
+ Added SFE_LOG_OVERRUN error.
+ Added termination for potential infinite loop when parsing file headers.
+
+ * src/wav.c src/w64.c
+ Fixed bug casuing incorrect header generation when opening file read/write.
+
+2002-06-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/api.html
+ Improved the documentation to make it clearer that the file read method
+ and the underlying file format are completely disconnected. Suggested
+ by Josh Green.
+
+ * doc/command.html
+ Started correcting docs to take into account changes made to the
+ operations of the sf_command () function. Not complete yet.
+
+ * src/sndfile.c
+ Reverted some changes which had broken the partially working SDII header
+ parsing. Now have access to an iBook with OS X so reading and writing SDII
+ files on all platforms should be a reality in the near future. On Mac this
+ will involve reading the resource fork via the standard MacOS API. To move
+ a file from Mac to another OS, the resource and data forks will need to be
+ combined before transfer. The combined file will be read on both Mac and
+ other OSes like any other file.
+
+2002-06-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * ltmain.sh
+ Applied a patch from http://fink.sourceforge.net/doc/porting/libtool.php
+ which allows libsndfile to compile on MacOSX 10.1. This patch should not
+ interfere with compiling on other OSes.
+
+ * src/GSM610/private.h
+ Changes to fix compile problems on MacOSX (see src/GSM610/ChangeLog).
+
+ * src/float_cast.h
+ Added MacOSX replacements for lrint() and lrintf().
+
+2002-06-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Replaced the code to print the filename to the log buffer when a file is
+ opened. This code seems to have been left out during the merge of
+ sf_open_read() and sf_open_write() to make a single functions sf_open().
+
+2002-06-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Fixed a bug where the WAV header parser was going into an infinite loop
+ on a badly formed LIST chunk. File supplied by David Viens.
+
+2002-05-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in
+ Added a message at the end of the configuration process to warn about the
+ need for the use of pkg-config when linking programs against version 1 of
+ libsndfile.
+
+ * doc/pkg-config.html
+ New documentation file containing details of how to use pkg-config to
+ retrieve settings for CFLAGS and library locations for linking files
+ against version 1 of libsndfile.
+
+2002-05-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Fixed minor bug in handling of so-called ACIDized WAV files.
+
+2002-05-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/libsndfile.def Win32/Makefile.msvc
+ Two new files contributed by Michael Fink (from the winLAME project)
+ which allows libsndfile to be built on windows in a MSDOS box by doing
+ "nmake -f Makefile.msvc". Way cool!
+
+2002-05-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in
+ MacOSX is SSSOOOOOOO screwed up!!! I can't believe how hard it is to
+ generate a tarball which will configure and compile on that platform.
+ Joined the libtool mailing list to try and get some answers.
+
+2002-05-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in
+ Changed to autoconf version 2.50. MacOSX uses autoconf version 2.53 which
+ is incompatible with with version 2.13 which had been using until now.
+ The AC_SYS_LARGE_FILE macro distributed withe autoconf 2.50 is missing a
+ few features so AC_SYS_EXTRA_LARGE file was defined to replace it.
+
+ * configure.in
+ Changed to automake version 1.5 to try and make a tarball which will
+ work on MacOSX.
+
+2002-05-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav_gsm610.c
+ Changed name to gsm610.c. Added reading/writing of headerless files.
+
+ * src/sndfile.c src/raw.c
+ Added ability to read/write headerless (SF_FORMAT_RAW) GSM 6.10 files.
+
+2002-05-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/lossy_comp_test.c
+ Clean up in preparation for Autogen-ing this file.
+
+ * src/GSM610/*.[ch]
+ Code cleanup and prepartion forgetting file seek working. Details in
+ src/GSM610/ChangeLog.
+
+ * sndfile.pc.in
+ Testing complete. Is sndfile.m4 still needed?
+
+2002-05-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/write_read_test.tpl tests/rdwr_test.tpl
+ Merged tests from these two programs into write_read_test.tpl and deleted
+ rdwr_test.tpl.
+
+2002-05-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/w64.c src/svx.c src/paf.c
+ Fixed bugs in read/write mode.
+
+2002-05-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/Makefile.am
+ Renamed sfplay.c to sndfile-play.c and sndfile_info.c to sndfile-info.c for
+ consistency when these programs become part of the Debian package
+ sndfile-programs.
+
+ * sndfile.pc.in
+ New file to replace sndfile-config.in. Libsndfile now uses the pkg-config
+ model for providing installation parameters to dependant programs.
+
+ * src/sndfile.c
+ Cleanup of code in sf_open().
+
+2002-05-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/utils.tpl tests/write_read_test.tpl
+ More conversion to Autogen fixes and enchancements.
+
+ * src/*.c
+ Read/write mode is now working for 16, 24 and 32 bit PCM as well as 32
+ bit float and 64 bit double data. More tests still required.
+
+ * src/Makefile.am
+ Added DISTCLEANFILES target to remove config.status and config.last.
+
+ * Win32/Makefile.am MacOS/Makefile.am
+ Added DISTCLEANFILES target to remove Makefile.
+
+2002-05-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.[ch] tests/rdwr_test.c
+ More verifying workings of read/write mode. Fixing bugs found.
+
+ * tests/utils.[ch]
+ Made these files Autogen generated files.
+
+ * tests/util.tpl tests/util.def
+ New Autogen files to generate utils.[ch]. Moved some generic test functions
+ into this file. Autogen is such a great tool!
+
+2002-05-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/pcm.c src/float_cast.h Win32/config.h
+ Fixed a couple of Win32 specific bugs pointed out by Michael Fink
+ (maintainer of WinLAME) and David Viens.
+
+ * tests/check_log_buffer.[ch] tests/utils.[ch]
+ Moved check_log_buffer() to utils.[ch] and deleted old file.
+
+2002-05-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.[ch] src/sndfile.c
+ New function psf_default_seek() which will be the default seek function
+ for things like PCM and floating point data. This default is set for
+ both read and write in sf_open() but can be over-ridden by any codec
+ during it's initialisation.
+
+2002-05-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/au.c
+ AU files use a data size value of -1 to mean unknown. Fixed au_open_read()
+ to allow opening files like this.
+
+ * tests/rdwr_test .c
+ Added more tests.
+
+ * src/sndfile.c
+ Fixed bugs in read/write mode found due to improvements in the test
+ program.
+
+2002-04-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/rdwr_test .c
+ New file for testing read/write mode.
+
+2002-04-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * m4/*
+ Removed all m4 macros from this directory as they get concatenated to form
+ the file aclocal.m4 anyway.
+
+ * sndfile.m4
+ Moved this from the m4 directory to the root directory asn this is part of
+ the distribution and is installed during "make install".
+
+2002-04-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/float32.c
+ Removed logging of peaks for all file formats other than AIFF and WAV.
+
+ * tests/write_read_test.tpl tests/write_read_test.def
+ New files which autogen uses to generate write_read_test.c. Doing it this
+ way makes write_read_test.c far easier to maintain. Other test programs
+ will be converted to autogen in the near future.
+
+ * src/*.c
+ Fixed a few bugs found when testing on Sparc (bug endian) Solaris.
+
+2002-04-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * doc/*.html
+ Fixed documention versioning.
+
+ * configure.in
+ Fixed a bug in the routines which search for Large File Support on systems
+ which have large file support by defualt.
+
+2002-04-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.[ch]
+ Found and fixed an issue which can cause a bug in other software (I was
+ porting Conrad Parker's Sweep program from version 0 of the library to
+ version 1). When opening a file for write, the libsndfile code would
+ set the sfinfo.samples field to a maximum value.
+
+ * tests/write_read_test.c
+ Added tests to detect the above problem.
+
+2002-04-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.[ch]
+ Finished base implementation of read/write mode. Much more testing still
+ needed.
+
+ * m4/largefile.m4
+ Macro for detecting Large File Standard capabilities. This macro was ripped
+ out of the aclocal.m4 file of GNU tar-1.13.
+
+ * configure.in
+ Added detection of large file support. Files larger than 2 Gigabytes should
+ now be supported on 64 bit platforms and many 32 bit platforms including
+ Linux (2.4 kernel, glibc-2.2), *BSD, MacOS, Win32.
+
+ * libsndfile_convert_version.py
+ A Python script which attempts to autoconvert code written to use version 0
+ to version 1.
+
+2002-04-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.[ch]
+ Finished base implementation of read/write mode. Much more testing still
+ needed.
+
+ * tests/write_read_test.c
+ Preliminary tests for read/write mode added. More needed.
+
+2002-04-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.[ch]
+ Removed sf_open_read() and sf_open_write() functions,replacting them with
+ sf_open() which takes an extra mode parameter (SF_OPEN_READ, SF_OPEN_WRITE,
+ or SF_OPEN_RDWR). This new function sf_open can now be modified to allow
+ opening a file formodification (RDWR).
+
+2002-04-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.c
+ Completed merging of separate xxx_open_read() and xxx_open_write()
+ functions. All tests pass.
+
+2002-04-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/au.c
+ Massive refactoring required to merge au_open_read() with au_open_write()
+ to create au_open().
+
+2002-04-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.c
+ Started changes required to allow a sound file to be opened in read/write
+ mode, with separate file pointers for read and write. This involves merging
+ of encoder/decoder functions like pcm_read_init() and pcm_write_init()
+ int a new function pcm_init() as well as doing something similar for all
+ the file type specific functions ie aiff_open_read() and aiff_open_write()
+ were merged to make the function aiff_open().
+
+2002-04-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/file_io.c
+ New file containing psf_fopen(), psf_fread(), psf_fwrite(), psf_fseek() and
+ psf_ftell() functions. These function will replace use of fopen/fread/fwrite
+ etc and allow access to files larger than 2 gigabytes on a number of 32 bit
+ OSes (Linux on x86, 32 bit Solaris user space apps, Win32 and MacOS).
+
+ * src/*.c
+ Replaced all instances of fopen with psf_open, fread with psd_read, fwrite
+ with psf_write and so on.
+
+2002-03-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/dwvw.c
+ Finally fixed all known problems with 12, 16 and 24 bit DWVW encoding.
+
+ * tests/floating_point_test.c
+ Added tests for 12, 16 and 24 bit DWVW encoding.
+
+2002-03-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * m4/endian.m4
+ Defines a new m4 macro AC_C_FIND_ENDIAN, for determining the endian-ness of
+ the target CPU. It first checks for the definition of BYTE_ORDER in
+ <endian.h>, then in <sys/types.h> and <sys/param.h>. If none of these work
+ and the C compiler is not a cross compiler it compiles and runs a program
+ to test for endian-ness. If the compiler is a cross compiler it makes a
+ guess based on $target_cpu.
+
+ * configure.in
+ Modified to use AC_C_FIND_ENDIAN.
+
+ * src/sfendian.h
+ Simplified.
+
+2002-02-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/floating_point_test.c
+ Tests completely rewritten using the dft_cmp function. Now able to
+ calculate a quick guesstimate of the Signal to Noise Ratio of the encoder.
+
+2002-02-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/dft_cmp.[ch]
+ New files containing functions for comparing pre and post lossily
+ compressed data using a quickly hacked DFT.
+
+ * tests/utils.[ch]
+ New files containing functions for saving pre and post encoded data in a
+ file readable by the GNU Octave package.
+
+2002-02-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * m4/lrint.m4 m4/lrintf.m4
+ Fixed m4 macros to define HAVE_LRINT and HAVE_LRINTF even when the test
+ is cached.
+
+2002-02-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/floating_point_test.c
+ Fixed improper use of strncat ().
+
+2002-02-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/headerless_test.c
+ New test program to test the ability to open and read a known file type as a
+ RAW header-less file.
+
+2002-02-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/losy_comp_test.c
+ Added a test to ensure that the data read from a file is not all zeros.
+
+ * examples/sfconvert.c
+ Added "-gsm610" encoding types.
+
+2002-01-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sfconvert.c
+ Added "-dwvw12", "-dwvw16" and "-dwvw24" encoding types.
+
+ * tests/dwvw_test.c
+ New file for testing DWVW encoder/decoder.
+
+2002-01-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/dwvw.c
+ Implemented writing of DWVW. 12 bit seems to work, 16 and 24 bit still broken.
+
+ * src/aiff.c
+ Improved reporting of encoding types.
+
+ * src/voc.c
+ Clean up.
+
+2002-01-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/dwvw.c
+ New file implementing lossless Delta Word Variable Width (DWVW) encoding.
+ Reading 12 bit DWVW is now working.
+
+ * src/aiff.c common.h sndfile.c
+ Added hooks for DWVW encoded AIFF and RAW files.
+
+2002-01-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/w64.c
+ Robustify header parsing.
+
+ * src/wav_w64.h
+ Header file wav.h was renamed to wav_w64.h to signify sharing of
+ definitions across the two file types.
+
+ * src/wav.c src/w64.c src/wav_w64.c
+ Refactoring.
+ Modified and moved functions with a high degree of similarity between
+ wav.c and w64.c to wav_w64.c.
+
+2002-01-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/w64.c
+ Completed work on getting read and write working.
+
+ * examples/sfplay.c
+ Added code to scale floating point data so it plays at a reasonable volume.
+
+ * tests/Makefile.am tests/write_read_test.c
+ Added tests for W64 files.
+
+2002-01-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.c
+ Modded all code in file header writing routines to use
+ psf_new_binheader_writef().
+ Removed psf_binheader_writef() from src/common.c.
+ Globally replaced psf_new_binheader_writef with psf_binheader_writef.
+
+2002-01-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.c
+ Modded all code in file parsing routines to use psf_new_binheader_readf().
+ Removed psf_binheader_readf() from src/common.c.
+ Globally replaced psf_new_binheader_readf with psf_binheader_readf.
+
+ * src/common.[ch]
+ Added new function psf_new_binheader_writef () which will soon replace
+ psf_binheader_writef (). The new function has basically the same function
+ as the original but has a more flexible and capable interface. It also
+ allows the writing of 64 bit integer values for files contains 64 bit file
+ offsets.
+
+2002-01-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/formats.c src/sndfile.c src/sndfile.h
+ Added code allowing full enumeration of supported file formats via the
+ sf_command () interface.
+ This feature will allow applications to avoid needing recompilation when
+ support for new file formats are added to libsndfile.
+
+ * tests/command_test.c
+ Added test code for the above feature.
+
+ * examples/list_formats.c
+ New file. An example of the use of the supported file enumeration
+ interface. This program lists all the major formats and for each major
+ format the supported subformats.
+
+2002-01-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.[ch] tests/*.c
+ Changed command parameter of sf_command () function from a test string to
+ an int. The valid values for the command parameter begin with SFC_ and are
+ listed in src/sndfile.h.
+
+2001-12-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/formats.c src/sndfile.c
+ Added an way of enumerating a set of common file formats using the
+ sf_command () interface. This interface was suggested by Dominic Mazzoni,
+ one of the main authors of Audacity (http://audacity.sourceforge.net/).
+
+2001-12-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Added checking of filename parameter in sf_open_read (). Previousy, if a
+ NULL pointer was passed the library would segfault.
+
+2001-12-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.c src/common.h
+ Changed the len parameter of the endswap_*_array () functions from type
+ int to type long.
+
+ * src/pcm.c
+ Fixed a problem which
+
+2001-12-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Added conditional #include <sys/types.h> for EMX/gcc on OS/2. Thanks to
+ Paul Hartman for pointing this out.
+
+ * tests/lossy_comp_test.c tests/floating_point_test.c
+ Added definitions for M_PI for when it isn't defined in <math.h>.
+
+2001-11-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ircam.c
+ Re-implemented the header reader. Old version was making incorrect
+ assumptions about the endian-ness of the file from the magic number at the
+ start of the file. The new code looks at the integer which holds the
+ number of channels and determines the endian-ness from that.
+
+2001-11-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Added support for other AIFC types ('raw ', 'in32', '23ni').
+ Further work on IMA ADPCM encoding.
+
+2001-11-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ima_adpcm.c
+ Renamed from wav_ima_adpcm.c. This file will soon handle IMA ADPCM
+ encodings for both WAV and AIFF files.
+
+ * src/aiff.c
+ Started adding IMA ADPCM support.
+
+2001-11-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/double.c
+ New file for handling double precision floating point (SF_FORMAT_DOUBLE)
+ data.
+
+ * src/wav.c src/aiff.c src/au.c src/raw.c
+ Added support for SF_FORMAT_DOUBLE data.
+
+ * src/common.[ch]
+ Addition of endswap_long_array () for endian swapping 64 bit integers. This
+ function will work correctly on processors with 32 bit and 64 bit longs.
+ Optimised endswap_short_array () and endswap_int_array ().
+
+ * tests/pcm_test.c
+ Added and extra check. After the first file of each type is written to disk
+ a checksum is performed of the first 64 bytes and checked against a pre-
+ calculated value. This will work whatever the endian-ness of the host
+ machine.
+
+2001-11-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Added handling of u-law, A-law encoded AIFF files. Thanks to Tom Erbe for
+ supplying example files.
+
+ * tests/lossy_comp_test.c
+ Added tests for above.
+
+ * src/common.h src/*.c
+ Removed function typedefs from common.h and function pointer casting in all
+ the other files. This allows the compiler to perform proper type checking.
+ Hopefully this will prevernt problems like the sf_seek bug for OpenBSD,
+ BeOS etc.
+
+ * src/common.[ch]
+ Added new function psf_new_binheader_readf () which will eventually replace
+ psf_binheader_readf (). The new function has basically the same function as
+ the original but has a more flexible and capable interface. It also allows
+ the reading of 64 bit integer values for files contains 64 bit file
+ offsets.
+
+2001-11-26 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/voc.c
+ Completed implementation of VOC file handling. Can now handle 8 and 16 bit
+ PCM, u-law and A-law files with one or two channels.
+
+ * src/write_read_test.c tests/lossy_comp_test.c
+ Added tests for VOC files.
+
+2001-11-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/float_cast.h
+ Added inline asm version of lrint/lrintf for MacOS. Solution provided by
+ Stephane Letz.
+
+ * src/voc.c
+ More work on this braindamaged format. The VOC files produced by SoX also
+ have a number of inconsistencies.
+
+2001-11-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/paf.c
+ Added support for 8 bit PCM PAF files.
+
+ * tests/write_read_test.c
+ Added tests for 8 bit PAF files.
+
+2001-11-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/pcm_test.c
+ New test program to test for correct scaling of integer values between
+ different sized integer containers (ie short -> int).
+ The new specs for libsndfile state that when the source and destination
+ containers are of a different size, the most significant bit of the source
+ value becomes the most significant bit of the destination container.
+
+ * src/pcm.c src/paf.c
+ Modified to pass the above test program.
+
+ * tests/write_read_test.c tests/lossy_comp_test.c
+ Modified to work with the new scaling rules.
+
+2001-11-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/raw.c tests/write_read_test.c tests/write_read_test.c
+ Added ability to do raw reads/writes of float, u-law and A-law files.
+
+ * src/*.[ch] examples/*.[ch] tests/*.[ch]
+ Removed dependance on pcmbitwidth field of SF_INFO struct and moved to new
+ SF_FORMAT_* types and use of SF_ENDIAN_BIG/LITTLE/CPU.
+
+2001-11-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.[ch]
+ Started implmentation of major changes documented in doc/version1.html.
+
+ Removed all usage of off_t which is not part of the ISO C standard. All
+ places which were using it are now using type long which is the type of
+ the offset parameter for the fseek function.
+ This should fix problems on BeOS, MacOS and *BSD like systems which were
+ failing "make check" because sizeof (long) != sizeof (off_t).
+
+--------------------------------------------------------------------------------
+This is the boundary between version 1 of the library above and version 0 below.
+--------------------------------------------------------------------------------
+
+2001-11-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sfplay_beos.cpp
+ Added BeOS version of sfplay.c. This needs to be compiled using a C++
+ compiler so is therefore not built by default. Thanks to Marcus Overhagen
+ for providing this.
+
+2001-11-10 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sfplay.c
+ New example file showing how libsndfile can be used to read and play a
+ sound file.
+ At the moment on Linux is supported. Others will follow in the near future.
+
+2001-11-09 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/pcm.c
+ Fixed problem with normalisation code where a value of 1.0 could map to
+ a value greater than MAX_SHORT or MAX_INT. Thanks to Roger Dannenberg for
+ pointing this out.
+
+2001-11-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/pcm.c
+ Fixed scaling issue when reading/writing 8 bit files using
+ sf_read/sf_write_short ().
+ On read, values are scaled so that the most significant bit in the char
+ ends up in the most significant bit of the short. On write, values are
+ scaled so that most significant bit in the short ends up as the most
+ significant bit in the char.
+
+2001-11-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/au.c src/sndfile.c
+ Added support for 32 bit float data in big and little endian AU files.
+
+ * tests/write_read_test.c
+ Added tests for 32 bit float data in AU files.
+
+2001-11-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/lossy_comp_test.c
+ Finalised testing of stereo files where possible.
+
+2001-11-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav_ms_adpcm.c
+ Fixed bug in writing stereo MS ADPCM WAV files. Thanks to Xu Xin for
+ pointing out this problem.
+
+2001-10-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav_ms_adpcm.c
+ Modified function srate2blocksize () to handle 44k1Hz stereo files.
+
+2001-10-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/w64.c
+ Added support for Sonic Foundry 64 bit WAV format. As Linux (my main
+ development platform) does not yet support 64 bit file offsets by default,
+ current handling of this file format treats everything as 32 bit and fails
+ openning the file, if it finds anything that goes beyond 32 bit values.
+
+ * src/sndfile.[hc] src/common.h src/Makefile.am
+ Added hooks for W64 support.
+
+2001-10-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in
+ Added more warnings options to CFLAGS when the gcc compiler is detected.
+
+ * src/*.[ch] tests/*.c examples/*.c
+ Started fixing the warning messages due to the new CFLASG.
+
+ * src/voc.c
+ More work on VOC file read/writing.
+
+ * src/paf.c
+ Found that PAF files were not checking the normalisation flag when reading
+ or writing floats and doubles. Fixed it.
+
+ * tests/floating_point_test.c
+ Added specific test for the above problem.
+
+ * src/float_cast.h src/pcm.c
+ Added a section for Win32 to define lrint () and lrintf () in the header
+ and implement it in the pcm.c
+
+2001-10-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * sndfile-config.in m4/sndfile.m4
+ These files were donated by Conrad Parker who also provided instructions
+ on how to install them using autoconf/automake.
+
+ * src/float_cast.h
+ Fiddled around with this file some more. On Linux and other gcc supported
+ OSes use the C99 functions lrintf() and lrint() for casting from floating
+ point to int without incurring the huge perfromance penalty (particularly
+ on the i386 family) caused by the regular C cast from float to int.
+ These new C99 functions replace the FLOAT_TO_* and DOUBLE_TO_* macros which
+ I had been playing with.
+
+ * configure.in m4/lrint.m4 m4/lrintf.m4
+ Add detection of these functions.
+
+2001-10-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/voc.c
+ Completed code for reading VOC files containing a single audio data
+ segment.
+ Started implementing code to handle files with multiple VOC_SOUND_DATA
+ segments but couldn't be bothered finishing it. Multiple segment files can
+ have different sample rates for different sections and other nasties like
+ silence and repeat segments.
+
+2001-10-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/*.c
+ Removed SF_PRIVATE struct field fdata and replaced it with extra_data.
+
+ * src/voc.c
+ Further development of the read part of this woefult file format.
+
+2001-10-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/float_cast.h
+ Implemented gcc and i386 floating point to int cast macros. Standard cast
+ will be used when not on gcc for i385.
+
+ * src/pcm.c
+ Modified all uses of FLOAT/DOUBLE_TO_INT and FLOAT/DOUBLE_TO_SHORT casts to
+ comply with macros in float_cast.h.
+
+2001-10-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/voc.c
+ Changed the TYPE_xxx enum names to VOC_TYPE_xxx to prevent name clashes
+ on MacOS with CodeWarrior 6.0.
+
+ * MacOS/MacOS-readme.txt
+ Updated the compile instructions. Probably still need work as I don't have
+ access to a Mac.
+
+2001-10-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c src/aiff.c common.c
+ Changed all references to snprintf to LSF_SNPRINTF and all vsnprintf to
+ LSF_VSNPRINTF. LSF_VSNPRINTF and LSF_VSNPRINTF are defined in common.h.
+
+ * src/common.h
+ Added checking of HAVE_SNPRINTF and HAVE_VSNPRINTF and defining
+ LSF_VSNPRINTF and LSF_VSNPRINTF to appropriate values.
+
+ * src/missing.c
+ New file containing a minimal implementation of snprintf and vsnprintf
+ functions named missing_snprintf and missing_vsnprintf respectively. These
+ are only compliled into the binary if snprintf and/or vsnprintf are not
+ available.
+
+2001-09-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ircam.c
+ New file to handle Berkeley/IRCAM/CARL files.
+
+ * src/sndfile.c src/common.h
+ Modified for IRCAM handling.
+
+ * tests/*.c
+ Added tests for IRCAM files.
+
+2001-09-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Apparently microsoft windows (tm) doesn't like ulaw and Alaw WAV files with
+ 20 byte format chunks (contrary to ms's own documentation). Fixed the WAV
+ header writing code to generate smaller ms compliant ulaw and Alaw WAV
+ files.
+
+2001-09-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/stdio_test.sh tests/stdio_test.c
+ Shell script was rewritten as a C program due to incompatibilities of the
+ sh shell on Linux and Solaris.
+
+2001-09-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/stdio_test.sh tests/stdout_test.c tests/stdin_test.c
+ New test programs to verify the correct operation of reading from stdin and
+ writing to stdout.
+
+ * src/sndfile.c wav.c au.c nist.c paf.c
+ Fixed a bugs uncovered by the new test programs above.
+
+2001-09-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c wav.c
+ Fixed a bug preventing reading a file from stdin. Found by T. Narita.
+
+2001-09-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Fixed a problem on OpenBSD 2.9 which was causing sf_seek() to fail on IMA
+ WAV files. Root cause was the declaration of the func_seek typedef not
+ matching the functions it was actually being used to point to. In OpenBSD
+ sizeof (off_t) != sizeof (int). Thanks to Heikki Korpela for allowing me
+ to log into his OpenBSD machine to debug this problem.
+
+2001-09-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Implemented sf_command ("norm float").
+
+ * src/*.c
+ Implemented handling of sf_command ("set-norm-float"). Float normalization
+ can now be turned on and off.
+
+ * tests/double_test.c
+ Renamed to floating_point_test.c. Modified to include tests for all scaled
+ reads and writes of floats and doubles.
+
+ * src/au_g72x.c
+ Fixed bug in normalization code found with improved floating_point_test
+ program.
+
+ * src/wav.c
+ Added code for parsing 'INFO' and 'LIST' chunks. Will be used for extract
+ text annotations from WAV files.
+
+ * src/aiff.c
+ Added code for parsing '(c) ' and 'ANNO' chunks. Will be used for extract
+ text annotations from WAV files.
+
+2001-09-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sf_info.c example/Makefile.am
+ Renamed to sndfile_info.c. The program sndfile_info will now be installed
+ when the library is installed.
+
+ * src/float_cast.h
+ New file defining floating point to short and int casts. These casts will
+ eventually replace all flot and double casts to short and int. See comments
+ at the top of the file for the reasoning.
+
+ * src/*.c
+ Changed all default float and double casts to short or int with macros
+ defined in floatcast.h. At the moment these casts do nothing. They will be
+ replaced with faster float to int cast operations in the near future.
+
+2001-08-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/command_test.c
+ New file for testing sf_command () functionality.
+
+ * src/sndfile.c
+ Revisiting of error return values of some functions.
+ Started implementing sf_command () a new function will allow on-the-fly
+ modification of library behaviour, or instance, sample value scaling.
+
+ * src/common.h
+ Added hook for format specific sf_command () calls to SNDFILE struct.
+
+ * doc/api.html
+ Updated and errors corrected.
+
+ * doc/command.html
+ New documentation file explaining new sf_command () function.
+
+2001-08-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fixed error return values from sf_read*() and sf_write*(). There were
+ numerous instances of -1 being returned through size_t. These now all set
+ error int the SF_PRIVATE struct and return 0. Thanks to David Viens for
+ spotting this.
+
+2001-08-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.c
+ Fixed use of va_arg() calls that were causing warning messages with the
+ latest version of gcc (thanks Maurizio Umberto Puxeddu).
+
+2001-07-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.c src/sfendian.h
+ Moved definition of MAKE_MARKER macro to sfendian.h
+
+2001-07-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Modified sf_get_lib_version () so that version string will be visible using
+ the Unix strings command.
+
+ * examples/Makefile.am examples/sfinfo.c
+ Renamed sfinfo program and source code to sf_info. This prevents a name
+ clash with the program included with libaudiofile.
+
+2001-07-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/read_seek_test.c tests/lossy_comp_test.c
+ Added tests for sf_read_float () and sf_readf_float ().
+
+ * src/voc.c
+ New files for handling Creative Voice files (not complete).
+
+ * src/samplitude.c
+ New files for handling Samplitude files (not complete).
+
+2001-07-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c src/au.c src/paf.c src/svx.c src/wav.c
+ Converted these files to using psf_binheader_readf() function. Will soon be
+ ready to attempt to make reading writing from pipes work reliably.
+
+ * src/*.[ch]
+ Added code for sf_read_float () and sf_readf_float () methods of accessing
+ file data.
+
+2001-07-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/paf.c src/wav_gsm610.c
+ Removed two printf()s which had escaped notice for some time (thanks
+ Sigbjørn Skjæret).
+
+2001-07-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav_gsm610.c
+ Fixed a bug which prevented GSM 6.10 encoded WAV files generated by
+ libsndfile from being played in Windoze (thanks klay).
+
+2001-07-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.[ch]
+ Implemented psf_binheader_readf() which will do for file header reading what
+ psf_binheader_writef() did for writing headers. Will eventually allow
+ libsndfile to read and write from pipes, including named pipes.
+
+2001-07-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * MacOS/config.h Win32/config.h
+ Attempted to bring these two files uptodate with src/config.h. As I don't
+ have access to either of these systems support for them may be completely
+ broken.
+
+2001-06-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/float32.c
+ Fixed bug for big endian processors that can't read 32 bit IEEE floats. Now
+ tested on Intel x86 and UltraSparc processors.
+
+2001-06-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Modified to allow REX files (from Propellorhead's Recycle and Reason
+ programs) to be read.
+ REX files are basically an AIFF file with slightly unusual sequence of
+ chunks (AIFF files are supposed to allow any sequence) and some extra
+ application specific information.
+ Not yet able to write a REX file as the details of the application specific
+ data is unknown.
+
+2001-06-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Fixed endian bug when reading PEAK chunk on big endian machines.
+
+ * src/common.c
+ Fixed endian bug when reading PEAK chunk on big endian machines with
+ --enable-force-broken-float configure option.
+ Fix psf_binheader_writef for (FORCE_BROKEN_FLOAT ||______)
+
+2001-06-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in src/config.h.in
+ Removed old CAN_READ_WRITE_x86_IEEE configure variable now that float
+ capabilities are detected at run time.
+ Added FORCE_BROKEN_FLOAT to allow testing of broken float code on machines
+ where the processor can in fact handle floats correctly.
+
+ * src/float32.c
+ Rejigged code reading and writing of floats on broken processors.
+
+ * m4/
+ Removed this directory and all its files as they are no longer needed.
+
+2001-06-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/peak_chunk_test.c
+ New test to validate reading and writing of peak chunk.
+
+ * examples/sfconvert
+ Added -float32 option.
+
+ * src/*.c
+ Changed all error return values to negative values (ie the negative of what
+ they were).
+
+ * src/sndfile.c tests/error_test.c
+ Modified to take account of the previous change.
+
+2001-06-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/float32.c
+ File renamed from wav_float.c and renamed function to something more
+ general.
+ Added runtime detection of floating point capabilities.
+ Added recording of peaks during write for generation of PEAK chunk.
+
+ * src/wav.c src/aiff.c
+ Added handing for PEAK chunk for floating point files. PEAK is read when the
+ file headers are read and generated when the file is closed. Logic is in
+ place for adding PEAK chunk to end of file when writing to a pipe (reading
+ and writing from/to pipe to be implemented soon).
+
+ * src/sndfile.c
+ Modified sf_signal_max () to use PEAK values if present.
+
+2001-06-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.c
+ Added pcm_read_init () and pcm_write_init () to src/pcm.c and removed all
+ other calls to functions in this file from the filetype specific files.
+
+ * src/*.c
+ Added alaw_read_init (), alaw_write_int (), ulaw_read_init () and
+ ulaw_write_init () and removed all other calls to functions in alaw.c and
+ ulaw.c from the filetype specific files.
+
+ * tests/write_read_test.c
+ Added tests to validate sf_seek () on all file types.
+
+ * src/raw.c
+ Implemented raw_seek () function to fix a bug where
+ sf_seek (file, 0, SEEK_SET) on a RAW file failed.
+
+ * src/paf.c
+ Fixed a bug in paf24_seek () found due to added seeks tests in
+ tests/write_read_test.c
+
+2001-06-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/read_seek_test.c
+ Fixed a couple of broken binary files.
+
+ * src/aiff.c src/wav.c
+ Added handling of PEAK chunks on file read.
+
+2001-05-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * check_libsndfile.py
+ New file for the regression testing of libsndfile.
+ check_libsndfile.py is a Python script which reads in a file containing
+ filenames of audio files. Each file is checked by running the examples/sfinfo
+ program on them and checking for error or warning messages in the libsndfile
+ log buffer.
+
+ * check_libsndfile.list
+ This is an example list of audio files for use with check_libsndfile.py
+
+ * tests/lossy_comp_test.c
+ Changed the defined value of M_PI for math header files which don't have it.
+ This fixed validation test failures on MetroWerks compilers. Thanks to Lord
+ Praetor Satanus of Acheron for bringing this to my attention.
+
+2001-05-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.[ch]
+ Removed psf_header_setf () which was no longer required after refactoring
+ and simplification of header writing.
+ Added 'z' format specifier to psf_binheader_writef () for zero filling header
+ with N bytes. Used by paf.c and nist.c
+
+ * tests/check_log_buffer.c
+ New file implementing check_log_buffer () which reads the log buffer of a
+ SNDFILE* object and searches for error and warning messages. Calls exit ()
+ if any are found.
+
+ * tests/*.c
+ Added calls to check_log_buffer () after each call to sf_open_XXX ().
+
+2001-05-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c src/wav_ms_adpcm.c src/wav_gsm610.c
+ Major rehack of header writing using psf_binheader_writef ().
+
+2001-05-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c src/wav_ima_adpcm.c
+ Major rehack of header writing using psf_binheader_writef ().
+
+2001-05-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Changed return type of get_encoding_str () to prevent compiler warnings on
+ Mac OSX.
+
+ * src/aiff.c src/au.c
+ Major rehack of header writing using psf_binheader_writef ().
+
+2001-05-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h src/common.c
+ Added comments.
+ Name of log buffer changed from strbuffer to logbuffer.
+ Name of log buffer index variable changed from strindex to logindex.
+
+ * src/*.[ch]
+ Changed name of internal logging function from psf_sprintf () to
+ psf_log_printf ().
+ Changed name of internal header generation functions from
+ psf_[ab]h_printf () to psf_asciiheader_printf () and
+ psf_binheader_writef ().
+ Changed name of internal header manipulation function psf_hsetf () to
+ psf_header_setf ().
+
+2001-05-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/nist.c
+ Fixed reading and writing of sample_byte_format header. "01" means little
+ endian and "10" means big endian regardless of bit width.
+
+ * configure.in
+ Detect Mac OSX and disable -Wall and -pedantic gcc options. Mac OSX is
+ way screwed up and spews out buckets of warning messages from the system
+ headers.
+ Added --disable-gcc-opt configure option (sets gcc optimisation to -O0 ) for
+ easier debugging.
+ Made decision to harmonise source code version number and .so library
+ version number. Future releases will stick to this rule.
+
+ * doc/new_file_type.HOWTO
+ New file to document the addition of new file types to libsndfile.
+
+2001-05-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/nist.c
+ New file for reading/writing Sphere NIST audio file format.
+ Originally requested by Elis Pomales in 1999.
+ Retrieved from unstable (and untouched for 18 months) branch of libsndfile.
+ Some vital information gleaned from the source code to Bill Schottstaedt's
+ sndlib library : ftp://ccrma-ftp.stanford.edu/pub/Lisp/sndlib.tar.gz
+ Currently reading and writing 16, 24 and 32 bit, big-endian and little
+ endian, stereo and mono files.
+
+ * src/common.h src/common.c
+ Added psf_ah_printf () function to help construction of ASCII headers (ie NIST).
+
+ * configure.in
+ Added test for vsnprintf () required by psf_ah_printf ().
+
+ * tests/write_read_test.c
+ Added tests for supported NIST files.
+
+2001-05-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/write_read_test.c
+ Added tests for little endian AIFC files.
+
+ * src/aiff.c
+ Minor re-working of aiff_open_write ().
+ Added write support for little endian PCM encoded AIFC files.
+
+2001-05-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Minor re-working of aiff_open_read ().
+ Added read support for little endian PCM encoded AIFC files from the Mac
+ OSX CD ripper program. Guillaume Lessard provided a couple of sample files
+ and a working patch.
+ The patch was not used as is but gave a good guide as to what to do.
+
+2001-05-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h
+ Fixed comments about endian-ness of WAV and AIFF files. Guillaume Lessard
+ pointed out the error.
+
+2001-04-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/make_sine.c
+ Re-write of this example using sample rate and required frequency in Hz.
+
+2001-02-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fixed bug that prevented known file types from being read as RAW PCM data.
+
+2000-12-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Added handing of COMT chunk.
+
+2000-11-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sfconvert.c
+ Fixed bug in normalisatio code. Pointed out by Johnny Wu.
+
+2000-11-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/config.h
+ Fixed the incorrect setting of HAVE_ENDIAN_H parameter. Win32 only issue.
+
+2000-10-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/Makefile.am
+ Added -lm for write_read_test_LDADD.
+
+2000-10-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c src/au.c
+ Fixed bug which prevented writing of G723 24kbps AU files.
+
+ * tests/lossy_comp_test.c
+ Corrrection to options for G723 tests.
+
+ * configure.in
+ Added --disable-gcc-pipe option for DJGPP compiler (gcc on MS-DOS) which
+ doesn't allow gcc -pipe option.
+
+2000-09-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/ulaw.c src/alaw.c src/wav_imaadpcm.c src/msadpcm.c src/wav_gsm610.c
+ Fixed normailsation bugs shown up by new double_test program.
+
+2000-08-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/pcm.c
+ Fixed bug in normalisation code (spotted by Steve Lhomme).
+
+ * tests/double_test.c
+ New file to test scaled and unscaled sf_read_double() and sf_write_double()
+ functions.
+
+2000-08-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * COPYING
+ Changed to the LGPL COPYING file (spotted by H. S. Teoh).
+
+2000-08-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h
+ Removed prototype of unimplemented function sf_get_info(). Added prototype
+ for sf_error_number() Thanks to Sigbjørn Skjæret for spotting these.
+
+2000-08-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/newpcm.h
+ New file to contain a complete rewrite of the PCM data handling.
+
+2000-08-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fixed a leak of FILE* pointers in sf_open_write(). Thanks to Sigbjørn
+ Skjæret for spotting this one.
+
+2000-08-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/au_g72x.c src/G72x/g72x.c
+ Added G723 encoded AU file support.
+
+ * tests/lossy_comp_test.c
+ Added tests for G721 and G723 encoded AU files.
+
+2000-08-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * all files
+ Changed the license to LGPL. Albert Faber who had copyright on
+ Win32/unistd.h gave his permission to change the license on that file. All
+ other files were either copyright erikd AT mega-nerd DOT com or copyright
+ under a GPL/LGPL compatible license.
+
+2000-08-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/lossy_comp_test.c
+ Fixed incorrect error message.
+
+ * src/au_g72x.c src/G72x/*
+ G721 encoded AU files now working.
+
+ * Win32/README-Win32.txt
+ Replaced this file with a new one which gives a full explanation
+ of how to build libsndfile under Win32. Thanks to Mike Ricos.
+
+2000-08-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.[ch]
+ Removed double leading underscores from the start of all variable and
+ function names. Identifiers with a leading underscores are reserved
+ for use by the compiler.
+
+ * src/au_g72x.c src/G72x/*
+ Continued work on G721 encoded AU files.
+
+2000-07-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/G72x/*
+ New files for reading/writing G721 and G723 ADPCM audio. These files
+ are from a Sun Microsystems reference implementation released under a
+ free software licence.
+ Extensive changes to this code to make it fit in with libsndfile.
+ See the ChangeLog in this directory for details.
+
+ * src/au_g72x.c
+ New file for G721 encoded AU files.
+
+2000-07-08 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * libsndfile.spec.in
+ Added a spec file for making RPMs. Thanks to Josh Green for supplying this.
+
+2000-06-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c src/sndfile.h
+ Add checking for and handling of header-less u-law encoded AU/SND files.
+ Any file with a ".au" or ".snd" file extension and without the normal
+ AU file header is treated as an 8kHz, u-law encoded file.
+
+ * src/au.h
+ New function for opening a headerless u-law encoded file for read.
+
+2000-06-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/paf.c
+ Add checking for files shorter than minimal PAF file header length.
+
+2000-06-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/write_read_test.c
+ Added extra sf_perror() calls when sf_write_XXXX fails.
+
+2000-05-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.c
+ Modified usage of va_arg() macro to work correctly on PowerPC
+ Linux. Thanks to Kyle Wheeler for giving me ssh access to his
+ machine while I was trying to track this down.
+
+ * configure.in src/*.[ch]
+ Sorted out some endian-ness issues brought up by PowerPC Linux.
+
+ * tests/read_seek_test.c
+ Added extra debugging for when tests fail.
+
+2000-05-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Fixed bug in GSM 6.10 handling for big-endian machines. Thanks
+ to Sigbjørn Skjæret for reporting this.
+
+2000-04-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c src/wav.c src/wav_gsm610.c
+ Finallised writing of GSM 6.10 WAV files.
+
+ * tests/lossy_comp_test.c
+ Wrote new test code for GSM 6.10 files.
+
+ * examples/sfinfo.c
+ Fixed incorrect format in printf() statement.
+
+2000-04-06 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h.in
+ Fixed comments about sf_perror () and sf_error_str ().
+
+2000-03-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in
+ Fixed --enable-justsrc option.
+
+2000-03-07 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * wav.c
+ Fixed checking of bytespersec field of header. Still some weirdness
+ with some files.
+
+2000-03-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/lossy_comp_test.c
+ Added option to test PCM WAV files (sanity check).
+ Fixed bug in sf_seek() tests.
+
+2000-02-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c src/wav.c
+ Minor changes to allow writing of GSM 6.10 WAV files.
+
+2000-02-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in Makefile.am src/Makefile.am
+ Finally got around to figuring out how to build a single library from
+ multiple source directories.
+ Reading GSM 6.10 files now seems to work.
+
+2000-01-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Added more error reporting in read_fmt_chunk().
+
+1999-12-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sfinfo.c
+ Modified program to accept multiple filenames from the command line.
+
+1999-11-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav_ima_adpcm.c
+ Moved code around in preparation to adding ability to read/write IMA ADPCM
+ encoded AIFF files.
+
+1999-11-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.c
+ Fixed put_int() and put_short() macros used by _psf_hprintf() which were
+ causing seg. faults on Sparc Solaris.
+
+1999-11-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.c
+ Added string.h to includes. Thanks to Sigbjxrn Skjfret.
+
+ * src/svx.c
+ Fixed __svx_close() function to ensure FORM and BODY chunks are correctly
+ set.
+
+1999-10-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/au.c
+ Fixed handling of incorrect size field in AU header on read. Thanks to
+ Christoph Lauer for finding this problem.
+
+1999-09-28 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Fixed a bug with incorrect SSND chunk length being written. This also lead
+ to finding an minor error in AIFF header parsing. Thanks to Dan Timis for
+ pointing this out.
+
+1999-09-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/paf.c
+ Fixed a bug with reading and writing 24 bit stereo PAF files. This problem
+ came to light when implementing tests for the new functions which operate
+ in terms of frames rather than items.
+
+1999-09-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Modified file type detection to use first 12 bytes of file rather than
+ file name extension. Required this because NIST files use the same
+ filename extension as Microsoft WAV files.
+
+ * src/sndfile.c src/sndfile.h
+ Added short, int and double read/write functions which work in frames
+ rather than items. This was originally suggested by Maurizio Umberto
+ Puxeddu.
+
+1999-09-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/svx.c
+ Finished off implementation of write using __psf_hprintf().
+
+1999-09-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/common.h
+ Added a buffer to SF_PRIVATE for writing the header. This is required
+ to make generating headers for IFF/SVX files easier as well as making
+ it easier to do re-write the headers which will be required when
+ sf_rewrite_header() is implemented.
+
+ * src/common.c
+ Implemented __psf_hprintf() function. This is an internal function
+ which is documented briefly just above the code.
+
+1999-09-05 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fixed a bug in sf_write_raw() where it was returning incorrect values
+ (thanks to Richard Dobson for finding this one). Must put in a test
+ routine for sf_read_raw and sf_write_raw.
+
+ * src/aiff.c
+ Fixed default FORMsize in __aiff_open_write ().
+
+ * src/sndfile.c
+ Added copy of filename to internal data structure. IFF/SVX files
+ contain a NAME header chunk. Both sf_open_read() and sf_open_write()
+ copy the file name (less the leading path information) to the
+ filename field.
+
+ * src/svx.c
+ Started implementing writing of files.
+
+1999-08-04 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/svx.c
+ New file for reading/writing 8SVX and 16SVX files.
+
+ * src/sndfile.[ch] src/common.h
+ Changes for SVX files.
+
+ * src/aiff.c
+ Fixed header parsing when unknown chunk is found.
+
+1999-08-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/paf.c
+ New file for reading/writing Ensoniq PARIS audio file format.
+
+ * src/sndfile.[ch] src/common.h
+ Changes for PAF files.
+
+ * src/sndfile.[ch]
+ Added stuff for sf_get_lib_version() function.
+
+
+1999-07-31 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h MacOS/config.h
+ Fixed minor MacOS configuration issues.
+
+1999-07-30 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * MacOS/
+ Added a new directory for the MacOS config.h file and the
+ readme file.
+
+ * src/aiff.c
+ Fixed calculation of datalength when reading SSND chunk. Thanks to
+ Sigbjørn Skjæret for pointing out this error.
+
+1999-07-29 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c src/sndfile.h src/raw.c
+ Further fixing of #includes for MacOS.
+
+1999-07-25 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c src/aiff.c
+ Added call to ferror () in main header parsing loop of __XXX_open_read
+ functions. This should fix problems on platforms (MacOS, AmigaOS) where
+ fseek()ing or fread()ing beyond the end of the file puts the FILE*
+ stream in an error state until clearerr() is called.
+
+ * tests/write_read_test.c
+ Added tests for RAW header-less PCM files.
+
+ * src/common.h
+ Moved definition of struct tribyte to pcm.c which is the only place
+ which needs it.
+
+ * src/pcm.c
+ Modified all code which assumed sizeof (struct tribyte) == 3. This code
+ did not work on MacOS. Thanks to Ben "Jacobs" for pointing this out.
+
+ * src/au.c
+ Removed <sys/stat.h> from list of #includes (not being used).
+
+ * src/sndfile.c
+ Added MacOS specific #ifdef to replace <sys/stat.h>.
+
+ * src/sndfile.h
+ Added MacOS specific #ifdef to replace <sys/stat.h>.
+
+ * src/sndfile.h
+ Added MacOS specific typedef for off_t.
+
+ * MacOS-readme.txt
+ New file with instructions for building libsndfile under MacOS. Thanks
+ to Ben "Jacobs" for supplying these instructions.
+
+1999-07-24 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in
+ Removed sndfile.h from generated file list as there were no longer
+ any autoconf substitutions being made.
+
+ * src/raw.c
+ New file for handling raw header-less PCM files. In order to open these
+ for read, the user must specify format, pcmbitwidth and channels in the
+ SF_INFO struct when calling sf_open_read ().
+
+ * src/sndfile.c
+ Added support for raw header-less PCM files.
+
+1999-07-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * examples/sfinfo.c
+ Removed options so the sfinfo program always prints out all the information.
+
+1999-07-19 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/alaw.c
+ New file for A-law encoding (similar to u-law).
+
+ * tests/alaw_test.c
+ New test program to test the A-law encode/decode lookup tables.
+
+ * tests/lossy_comp_test.c
+ Added tests for a-law encoded WAV, AU and AULE files.
+
+1999-07-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c src/au.c
+ Removed second "#include <unistd.h>". Thanks to Ben "Jacobs" for pointing
+ this out.
+
+1999-07-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/ulaw_test.c
+ New test program to test the u-law encode/decode lookup tables.
+
+1999-07-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.h
+ Made corrections to comments on the return values from sf_seek ().
+
+ * src/sndfile.c
+ Fixed boundary condition checking bug and accounting bug in sf_read_raw ().
+
+1999-07-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/au.c src/ulaw.c
+ Finished implementation of u-law encoded AU files.
+
+ * src/wav.c
+ Implemented reading and writing of u-law encoded WAV files.
+
+ * tests/
+ Changed name of adpcm_test.c to lossy_comp_test.c. This test program
+ will now be used to test Ulaw and Alaw encoding as well as APDCM.
+ Added tests for Ulaw encoded WAV files.
+
+1999-07-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/adpcm_test.c
+ Initialised amp variable in gen_signal() to remove compiler warning.
+
+1999-07-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ In __aiff_open_read () prevented fseek()ing beyond end of file which
+ was causing trouble on MacOS with the MetroWerks compiler. Thanks to
+ Ben "Jacobs" for pointing this out.
+
+ *src/wav.c
+ Fixed as above in __wav_open_read ().
+
+1999-07-01 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav_ms_adpcm.c
+ Implemented MS ADPCM encoding. Code cleanup of decoder.
+
+ * tests/adpcm_test.c
+ Added tests for MS ADPCM WAV files.
+
+ * src/wav_ima_adpcm.c
+ Fixed incorrect parameter in call to srate2blocksize () from
+ __ima_writer_init ().
+
+1999-06-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/read_seek_test.c
+ Added test for 8 bit AIFF files.
+
+1999-06-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/write_read_test.c
+ Removed test for IMA ADPCM WAV files which is now done in adpcm_test.c
+
+ * configure.in
+ Added -Wconversion to CFLAGS.
+
+ * src/*.c tests/*.c examples/*.c
+ Fixed all warnings resulting from use of -Wconversion.
+
+1999-06-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Added fact chunk handling on read and write for all non WAVE_FORMAT_PCM
+ WAV files.
+
+ * src/wav_ima.c
+ Changed block alignment to be dependant on sample rate. This should make
+ WAV files created with libsndfile compatible with the MS Windows media
+ players.
+
+ * tests/adpcm_test.c
+ Reimplemented adpcm_test_short and implemented adpcm_test_int and
+ adpcm_test_double.
+ Now have full testing of IMA ADPCM WAV file read, write and seek.
+
+1999-06-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav_float.c
+ Fixed function prototype for x86f2d_array () which was causing ocassional
+ seg. faults on Sparc Solaris machines.
+
+1999-06-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c
+ Fixed bug in __aiff_close where the length fields in the header were
+ not being correctly calculated before writing.
+
+ * tests/write_read_test.c
+ Modified to detect the above bug in WAV, AIFF and AU files.
+
+1999-06-12 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * Win32/*
+ Added a contribution from Albert Faber to allow libsndfile to compile
+ under Win32 systems. libsndfile will now be used as part of LAME the
+ the MPEG 1 Layer 3 encoder (http://internet.roadrunner.com/~mt/mp3/).
+
+1999-06-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in
+ Changed to reflect previous changes.
+
+ * src/wav_ima_adpcm.c
+ Fixed incorrect calculation of bytespersec header field (IMA ADPCM only).
+
+ Fixed bug when writing from int or double data to IMA ADPCM file. Will need
+ to write test code for this.
+
+ Fixed bug in __ima_write () whereby the length of the current block was
+ calculated incorrectly. Thanks to Jongcheon Park for pointing this out.
+
+1999-03-27 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/*.c
+ Changed all read/write/lseek function calls to fread/fwrite/
+ fseek/ftell and added error checking of return values from
+ fread and fwrite in critical areas of the code.
+
+ * src/au.c
+ Fixed incorrect datasize element in AU header on write.
+
+ * tests/error_test.c
+ Add new test to check all error values have an associated error
+ string. This will avoid embarrassing real world core dumps.
+
+1999-03-23 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c src/aiff.c
+ Added handling for unknown chunk markers in the file.
+
+1999-03-22 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Filled in missing error strings in SndfileErrors array. Missing entries
+ can cause core dumps when calling sf_error-str (). Thanks to Sam
+ <mrsam at-sign geocities.com> for finding this problem.
+
+1999-03-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav_ima_adpcm.c
+ Work on wav_ms_adpcm.c uncovered a bug in __ima_read () when reading
+ stereo files. Caused by not adjusting offset into buffer of decoded
+ samples for 2 channels. A similar bug existed in __ima_write ().
+ Need a test for stereo ADPCM files.
+
+ * src/wav_ms_adpcm.c
+ Decoder working correctly.
+
+1999-03-18 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * configure.in Makefile.am
+ Added --enable-justsrc configuration variable sent by Sam
+ <mrsam at-sign geocities.com>.
+
+ * src/wav_ima_adpcm.c
+ Fixed bug when reading beyond end of data section due to not
+ checking pima->blockcount.
+ This uncovered __ima_seek () bug due to pima->blockcount being set
+ before calling __ima_init_block ().
+
+1999-03-17 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Started implementing MS ADPCM decoder.
+ If file is WAVE_FORMAT_ADPCM and length of data chunk is odd, this
+ encoder seems to add an extra byte. Why not just give an even data
+ length?
+
+1999-03-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Split code out of wav.c to create wav_float.c and wav_ima_adpcm.c.
+ This will make it easier to add and debug other kinds of WAV files
+ in future.
+
+1999-03-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/
+ Added adpcm_test.c which implements test functions for
+ IMA ADPCM reading/writing/seeking etc.
+
+ * src/wav.c
+ Fixed many bugs in IMA ADPCM encoder and decoder.
+
+1999-03-11 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Finished implementing IMA ADPCM encoder and decoder (what a bitch!).
+
+1999-03-03 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/wav.c
+ Started implementing IMA ADPCM decoder.
+
+1999-03-02 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/sndfile.c
+ Fixed bug where the sf_read_XXX functions were returning a
+ incorrect read count when reading past end of file.
+ Fixed bug in sf_seek () when seeking backwards from end of file.
+
+ * tests/read_seek_test.c
+ Added multiple read test to short_test(), int_test () and
+ double_test ().
+ Added extra chunk to all test WAV files to test that reading
+ stops at end of 'data' chunk.
+
+1999-02-21 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/write_read_test.c
+ Added tests for little DEC endian AU files.
+
+ * src/au.c
+ Add handling for DEC format little endian AU files.
+
+1999-02-20 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c src/au.c src/wav.c
+ Add __psf_sprintf calls during header parsing.
+
+ * src/sndfile.c src/common.c
+ Implement sf_header_info (sndfile.c) function and __psf_sprintf (common.c).
+
+ * tests/write_read_test.c
+ Added tests for 8 bit PCM files (WAV, AIFF and AU).
+
+ * src/au.c src/aiff.c
+ Add handling of 8 bit PCM data format.
+
+ * src/aiff.c
+ On write, set blocksize in SSND chunk to zero like everybody else.
+
+1999-02-16 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/pcm.c:
+ Fixed bug in let2s_array (cptr was not being initialised).
+
+ * src/sndfile.c:
+ Fixed bug in sf_read_raw and sf_write_raw. sf_seek should
+ now work when using these functions.
+
+1999-02-15 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * tests/write_read_test.c:
+ Force test_buffer array to be double aligned. Sparc Solaris
+ requires this.
+
+1999-02-14 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/pcm.c:
+ Fixed a bug which was causing errors in the reading
+ and writing of 24 bit PCM files.
+
+ * doc/api.html
+ Finished of preliminary documentaion.
+
+1999-02-13 Erik de Castro Lopo <erikd AT mega-nerd DOT com>
+
+ * src/aiff.c:
+ Changed reading of 'COMM' chunk to avoid reading an int
+ which overlaps an int (4 byte) boundary.
+
--- /dev/null
+Version 1.0.25 (2011-07-13)
+ * Fix for Secunia Advisory SA45125, heap overflow in PAF file handler.
+ * Accept broken WAV files with blockalign == 0.
+ * Minor bug fixes and improvements.
+
+Version 1.0.24 (2011-03-23)
+ * WAV files now have an 18 byte u-law and A-law fmt chunk.
+ * Document virtual I/O functionality.
+ * Two new methods rawHandle() and takeOwnership() in sndfile.hh.
+ * AIFF fix for non-zero offset value in SSND chunk.
+ * Minor bug fixes and improvements.
+
+Version 1.0.23 (2010-10-10)
+ * Add version metadata to Windows DLL.
+ * Add a missing 'inline' to sndfile.hh.
+ * Update docs.
+ * Minor bug fixes and improvements.
+
+Version 1.0.22 (2010-10-04)
+ * Couple of fixes for SDS file writer.
+ * Fixes arising from static analysis.
+ * Handle FLAC files with ID3 meta data at start of file.
+ * Handle FLAC files which report zero length.
+ * Other minor bug fixes and improvements.
+
+Version 1.0.21 (2009-12-13)
+ * Add a couple of new binary programs to programs/ dir.
+ * Remove sndfile-jackplay (now in sndfile-tools package).
+ * Add windows only function sf_wchar_open().
+ * Bunch of minor bug fixes.
+
+Version 1.0.20 (2009-05-14)
+ * Fix potential heap overflow in VOC file parser (Tobias Klein, http://www.trapkit.de/).
+
+Version 1.0.19 (2009-03-02)
+ * Fix for CVE-2009-0186 (Alin Rad Pop, Secunia Research).
+ * Huge number of minor bug fixes as a result of static analysis.
+
+Version 1.0.18 (2009-02-07)
+ * Add Ogg/Vorbis support (thanks to John ffitch).
+ * Remove captive FLAC library.
+ * Many new features and bug fixes.
+ * Generate Win32 and Win64 pre-compiled binaries.
+
+Version 1.0.17 (2006-08-31)
+ * Add sndfile.hh C++ wrapper.
+ * Update Win32 MinGW build instructions.
+ * Minor bug fixes and cleanups.
+
+Version 1.0.16 (2006-04-30)
+ * Add support for Broadcast (BEXT) chunks in WAV files.
+ * Implement new commands SFC_GET_SIGNAL_MAX and SFC_GET_MAX_ALL_CHANNELS.
+ * Add support for RIFX (big endian WAV variant).
+ * Fix configure script bugs.
+ * Fix bug in INST and MARK chunk writing for AIFF files.
+
+Version 1.0.15 (2006-03-16)
+ * Fix some ia64 issues.
+ * Fix precompiled DLL.
+ * Minor bug fixes.
+
+Version 1.0.14 (2006-02-19)
+ * Really fix MinGW compile problems.
+ * Minor bug fixes.
+
+Version 1.0.13 (2006-01-21)
+ * Fix for MinGW compiler problems.
+ * Allow readin/write of instrument chunks from WAV and AIFF files.
+ * Compile problem fix for Solaris compiler.
+ * Minor cleanups and bug fixes.
+
+Version 1.0.12 (2005-09-30)
+ * Add support for FLAC and Apple's Core Audio Format (CAF).
+ * Add virtual I/O interface (still needs docs).
+ * Cygwin and other Win32 fixes.
+ * Minor bug fixes and cleanups.
+
+Version 1.0.11 (2004-11-15)
+ * Add support for SD2 files.
+ * Add read support for loop info in WAV and AIFF files.
+ * Add more tests.
+ * Improve type safety.
+ * Minor optimisations and bug fixes.
+
+Version 1.0.10 (2004-06-15)
+ * Fix AIFF read/write mode bugs.
+ * Add support for compiling Win32 DLLS using MinGW.
+ * Fix problems resulting in failed compiles with gcc-2.95.
+ * Improve test suite.
+ * Minor bug fixes.
+
+Version 1.0.9 (2004-03-30)
+ * Add handling of AVR (Audio Visual Research) files.
+ * Improve handling of WAVEFORMATEXTENSIBLE WAV files.
+ * Fix for using pipes on Win32.
+
+Version 1.0.8 (2004-03-14)
+ * Correct peak chunk handing for files with > 16 tracks.
+ * Fix for WAV files with huge number of CUE chunks.
+
+Version 1.0.7 (2004-02-25)
+ * Fix clip mode detection on ia64, MIPS and other CPUs.
+ * Fix two MacOSX build problems.
+
+Version 1.0.6 (2004-02-08)
+ * Added support for native Win32 file access API (Ross Bencina).
+ * New mode to add clippling then a converting from float/double to integer
+ would otherwise wrap around.
+ * Fixed a bug in reading/writing files > 2Gig on Linux, Solaris and others.
+ * Many minor bug fixes.
+ * Other random fixes for Win32.
+
+Version 1.0.5 (2003-05-03)
+ * Added support for HTK files.
+ * Added new function sf_open_fd() to allow for secure opening of temporary
+ files as well as reading/writing sound files embedded within larger
+ container files.
+ * Added string support for AIFF files.
+ * Minor bug fixes and code cleanups.
+
+Version 1.0.4 (2003-02-02)
+ * Added suport of PVF and XI files.
+ * Added functionality for setting and retreiving strings from sound files.
+ * Minor code cleanups and bug fixes.
+
+Version 1.0.3 (2002-12-09)
+ * Minor bug fixes.
+
+Version 1.0.2 (2002-11-24)
+ * Added support for VOX ADPCM.
+ * Improved error reporting.
+ * Added version scripting on Linux and Solaris.
+ * Minor bug fixes.
+
+Version 1.0.1 (2002-09-14)
+ * Added MAT and MAT5 file formats.
+ * Minor bug fixes.
+
+Version 1.0.0 (2002-08-16)
+ * Final release for 1.0.0.
+
+Version 1.0.0rc6 (2002-08-14)
+ * Release candidate 6 for the 1.0.0 series.
+ * MacOS9 fixes.
+
+Version 1.0.0rc5 (2002-08-10)
+ * Release candidate 5 for the 1.0.0 series.
+ * Changed the definition of sf_count_t which was causing problems when
+ libsndfile was compiled with other libraries (ie WxWindows).
+ * Minor bug fixes.
+ * Documentation cleanup.
+
+Version 1.0.0rc4 (2002-08-03)
+ * Release candidate 4 for the 1.0.0 series.
+ * Minor bug fixes.
+ * Fix broken Win32 "make check".
+
+Version 1.0.0rc3 (2002-08-02)
+ * Release candidate 3 for the 1.0.0 series.
+ * Fix bug where libsndfile was reading beyond the end of the data chunk.
+ * Added on-the-fly header updates on write.
+ * Fix a couple of documentation issues.
+
+Version 1.0.0rc2 (2002-06-24)
+ * Release candidate 2 for the 1.0.0 series.
+ * Fix compile problem for Win32.
+
+Version 1.0.0rc1 (2002-06-24)
+ * Release candidate 1 for the 1.0.0 series.
+
+Version 0.0.28 (2002-04-27)
+ * Last offical release of 0.0.X series of the library.
+
+Version 0.0.8 (1999-02-16)
+ * First offical release.
--- /dev/null
+TARGETS = test.exe
+
+test.exe : test.c sndfile.h libsndfile-1.dll
+ gcc -I . $< libsndfile-1.dll -o $@
+
+# Need to patch the MinGW sndfile.h for Cygwin.
+sndfile.h : ../../include/sndfile.h
+ sed "s/typedef\s__int64\s/typedef int64_t /" $+ > $@
+
+# Need the DLL in the local directory.
+libsndfile-1.dll : ../../bin/libsndfile-1.dll
+ cp -f $+ $@
+
--- /dev/null
+/*
+** Copyright (C) 1999-2011Erik de Castro Lopo <erikd@mega-nerd.com>
+**
+** This program is free software; you can redistribute it and/or modify
+** it under the terms of the GNU Lesser General Public License as published by
+** the Free Software Foundation; either version 2.1 of the License, or
+** (at your option) any later version.
+**
+** This program is distributed in the hope that it will be useful,
+** but WITHOUT ANY WARRANTY; without even the implied warranty of
+** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+** GNU Lesser General Public License for more details.
+**
+** You should have received a copy of the GNU Lesser General Public License
+** along with this program; if not, write to the Free Software
+** Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+*/
+
+/*
+** sndfile.h -- system-wide definitions
+**
+** API documentation is in the doc/ directory of the source code tarball
+** and at http://www.mega-nerd.com/libsndfile/api.html.
+*/
+
+#ifndef SNDFILE_H
+#define SNDFILE_H
+
+/* This is the version 1.0.X header file. */
+#define SNDFILE_1
+
+#include <stdio.h>
+#include <sys/types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif /* __cplusplus */
+
+/* The following file types can be read and written.
+** A file type would consist of a major type (ie SF_FORMAT_WAV) bitwise
+** ORed with a minor type (ie SF_FORMAT_PCM). SF_FORMAT_TYPEMASK and
+** SF_FORMAT_SUBMASK can be used to separate the major and minor file
+** types.
+*/
+
+enum
+{ /* Major formats. */
+ SF_FORMAT_WAV = 0x010000, /* Microsoft WAV format (little endian default). */
+ SF_FORMAT_AIFF = 0x020000, /* Apple/SGI AIFF format (big endian). */
+ SF_FORMAT_AU = 0x030000, /* Sun/NeXT AU format (big endian). */
+ SF_FORMAT_RAW = 0x040000, /* RAW PCM data. */
+ SF_FORMAT_PAF = 0x050000, /* Ensoniq PARIS file format. */
+ SF_FORMAT_SVX = 0x060000, /* Amiga IFF / SVX8 / SV16 format. */
+ SF_FORMAT_NIST = 0x070000, /* Sphere NIST format. */
+ SF_FORMAT_VOC = 0x080000, /* VOC files. */
+ SF_FORMAT_IRCAM = 0x0A0000, /* Berkeley/IRCAM/CARL */
+ SF_FORMAT_W64 = 0x0B0000, /* Sonic Foundry's 64 bit RIFF/WAV */
+ SF_FORMAT_MAT4 = 0x0C0000, /* Matlab (tm) V4.2 / GNU Octave 2.0 */
+ SF_FORMAT_MAT5 = 0x0D0000, /* Matlab (tm) V5.0 / GNU Octave 2.1 */
+ SF_FORMAT_PVF = 0x0E0000, /* Portable Voice Format */
+ SF_FORMAT_XI = 0x0F0000, /* Fasttracker 2 Extended Instrument */
+ SF_FORMAT_HTK = 0x100000, /* HMM Tool Kit format */
+ SF_FORMAT_SDS = 0x110000, /* Midi Sample Dump Standard */
+ SF_FORMAT_AVR = 0x120000, /* Audio Visual Research */
+ SF_FORMAT_WAVEX = 0x130000, /* MS WAVE with WAVEFORMATEX */
+ SF_FORMAT_SD2 = 0x160000, /* Sound Designer 2 */
+ SF_FORMAT_FLAC = 0x170000, /* FLAC lossless file format */
+ SF_FORMAT_CAF = 0x180000, /* Core Audio File format */
+ SF_FORMAT_WVE = 0x190000, /* Psion WVE format */
+ SF_FORMAT_OGG = 0x200000, /* Xiph OGG container */
+ SF_FORMAT_MPC2K = 0x210000, /* Akai MPC 2000 sampler */
+ SF_FORMAT_RF64 = 0x220000, /* RF64 WAV file */
+
+ /* Subtypes from here on. */
+
+ SF_FORMAT_PCM_S8 = 0x0001, /* Signed 8 bit data */
+ SF_FORMAT_PCM_16 = 0x0002, /* Signed 16 bit data */
+ SF_FORMAT_PCM_24 = 0x0003, /* Signed 24 bit data */
+ SF_FORMAT_PCM_32 = 0x0004, /* Signed 32 bit data */
+
+ SF_FORMAT_PCM_U8 = 0x0005, /* Unsigned 8 bit data (WAV and RAW only) */
+
+ SF_FORMAT_FLOAT = 0x0006, /* 32 bit float data */
+ SF_FORMAT_DOUBLE = 0x0007, /* 64 bit float data */
+
+ SF_FORMAT_ULAW = 0x0010, /* U-Law encoded. */
+ SF_FORMAT_ALAW = 0x0011, /* A-Law encoded. */
+ SF_FORMAT_IMA_ADPCM = 0x0012, /* IMA ADPCM. */
+ SF_FORMAT_MS_ADPCM = 0x0013, /* Microsoft ADPCM. */
+
+ SF_FORMAT_GSM610 = 0x0020, /* GSM 6.10 encoding. */
+ SF_FORMAT_VOX_ADPCM = 0x0021, /* OKI / Dialogix ADPCM */
+
+ SF_FORMAT_G721_32 = 0x0030, /* 32kbs G721 ADPCM encoding. */
+ SF_FORMAT_G723_24 = 0x0031, /* 24kbs G723 ADPCM encoding. */
+ SF_FORMAT_G723_40 = 0x0032, /* 40kbs G723 ADPCM encoding. */
+
+ SF_FORMAT_DWVW_12 = 0x0040, /* 12 bit Delta Width Variable Word encoding. */
+ SF_FORMAT_DWVW_16 = 0x0041, /* 16 bit Delta Width Variable Word encoding. */
+ SF_FORMAT_DWVW_24 = 0x0042, /* 24 bit Delta Width Variable Word encoding. */
+ SF_FORMAT_DWVW_N = 0x0043, /* N bit Delta Width Variable Word encoding. */
+
+ SF_FORMAT_DPCM_8 = 0x0050, /* 8 bit differential PCM (XI only) */
+ SF_FORMAT_DPCM_16 = 0x0051, /* 16 bit differential PCM (XI only) */
+
+ SF_FORMAT_VORBIS = 0x0060, /* Xiph Vorbis encoding. */
+
+ /* Endian-ness options. */
+
+ SF_ENDIAN_FILE = 0x00000000, /* Default file endian-ness. */
+ SF_ENDIAN_LITTLE = 0x10000000, /* Force little endian-ness. */
+ SF_ENDIAN_BIG = 0x20000000, /* Force big endian-ness. */
+ SF_ENDIAN_CPU = 0x30000000, /* Force CPU endian-ness. */
+
+ SF_FORMAT_SUBMASK = 0x0000FFFF,
+ SF_FORMAT_TYPEMASK = 0x0FFF0000,
+ SF_FORMAT_ENDMASK = 0x30000000
+} ;
+
+/*
+** The following are the valid command numbers for the sf_command()
+** interface. The use of these commands is documented in the file
+** command.html in the doc directory of the source code distribution.
+*/
+
+enum
+{ SFC_GET_LIB_VERSION = 0x1000,
+ SFC_GET_LOG_INFO = 0x1001,
+ SFC_GET_CURRENT_SF_INFO = 0x1002,
+
+
+ SFC_GET_NORM_DOUBLE = 0x1010,
+ SFC_GET_NORM_FLOAT = 0x1011,
+ SFC_SET_NORM_DOUBLE = 0x1012,
+ SFC_SET_NORM_FLOAT = 0x1013,
+ SFC_SET_SCALE_FLOAT_INT_READ = 0x1014,
+ SFC_SET_SCALE_INT_FLOAT_WRITE = 0x1015,
+
+ SFC_GET_SIMPLE_FORMAT_COUNT = 0x1020,
+ SFC_GET_SIMPLE_FORMAT = 0x1021,
+
+ SFC_GET_FORMAT_INFO = 0x1028,
+
+ SFC_GET_FORMAT_MAJOR_COUNT = 0x1030,
+ SFC_GET_FORMAT_MAJOR = 0x1031,
+ SFC_GET_FORMAT_SUBTYPE_COUNT = 0x1032,
+ SFC_GET_FORMAT_SUBTYPE = 0x1033,
+
+ SFC_CALC_SIGNAL_MAX = 0x1040,
+ SFC_CALC_NORM_SIGNAL_MAX = 0x1041,
+ SFC_CALC_MAX_ALL_CHANNELS = 0x1042,
+ SFC_CALC_NORM_MAX_ALL_CHANNELS = 0x1043,
+ SFC_GET_SIGNAL_MAX = 0x1044,
+ SFC_GET_MAX_ALL_CHANNELS = 0x1045,
+
+ SFC_SET_ADD_PEAK_CHUNK = 0x1050,
+ SFC_SET_ADD_HEADER_PAD_CHUNK = 0x1051,
+
+ SFC_UPDATE_HEADER_NOW = 0x1060,
+ SFC_SET_UPDATE_HEADER_AUTO = 0x1061,
+
+ SFC_FILE_TRUNCATE = 0x1080,
+
+ SFC_SET_RAW_START_OFFSET = 0x1090,
+
+ SFC_SET_DITHER_ON_WRITE = 0x10A0,
+ SFC_SET_DITHER_ON_READ = 0x10A1,
+
+ SFC_GET_DITHER_INFO_COUNT = 0x10A2,
+ SFC_GET_DITHER_INFO = 0x10A3,
+
+ SFC_GET_EMBED_FILE_INFO = 0x10B0,
+
+ SFC_SET_CLIPPING = 0x10C0,
+ SFC_GET_CLIPPING = 0x10C1,
+
+ SFC_GET_INSTRUMENT = 0x10D0,
+ SFC_SET_INSTRUMENT = 0x10D1,
+
+ SFC_GET_LOOP_INFO = 0x10E0,
+
+ SFC_GET_BROADCAST_INFO = 0x10F0,
+ SFC_SET_BROADCAST_INFO = 0x10F1,
+
+ SFC_GET_CHANNEL_MAP_INFO = 0x1100,
+ SFC_SET_CHANNEL_MAP_INFO = 0x1101,
+
+ SFC_RAW_DATA_NEEDS_ENDSWAP = 0x1110,
+
+ /* Support for Wavex Ambisonics Format */
+ SFC_WAVEX_SET_AMBISONIC = 0x1200,
+ SFC_WAVEX_GET_AMBISONIC = 0x1201,
+
+ SFC_SET_VBR_ENCODING_QUALITY = 0x1300,
+
+ /* Following commands for testing only. */
+ SFC_TEST_IEEE_FLOAT_REPLACE = 0x6001,
+
+ /*
+ ** SFC_SET_ADD_* values are deprecated and will disappear at some
+ ** time in the future. They are guaranteed to be here up to and
+ ** including version 1.0.8 to avoid breakage of existng software.
+ ** They currently do nothing and will continue to do nothing.
+ */
+ SFC_SET_ADD_DITHER_ON_WRITE = 0x1070,
+ SFC_SET_ADD_DITHER_ON_READ = 0x1071
+} ;
+
+
+/*
+** String types that can be set and read from files. Not all file types
+** support this and even the file types which support one, may not support
+** all string types.
+*/
+
+enum
+{ SF_STR_TITLE = 0x01,
+ SF_STR_COPYRIGHT = 0x02,
+ SF_STR_SOFTWARE = 0x03,
+ SF_STR_ARTIST = 0x04,
+ SF_STR_COMMENT = 0x05,
+ SF_STR_DATE = 0x06,
+ SF_STR_ALBUM = 0x07,
+ SF_STR_LICENSE = 0x08,
+ SF_STR_TRACKNUMBER = 0x09,
+ SF_STR_GENRE = 0x10
+} ;
+
+/*
+** Use the following as the start and end index when doing metadata
+** transcoding.
+*/
+
+#define SF_STR_FIRST SF_STR_TITLE
+#define SF_STR_LAST SF_STR_GENRE
+
+enum
+{ /* True and false */
+ SF_FALSE = 0,
+ SF_TRUE = 1,
+
+ /* Modes for opening files. */
+ SFM_READ = 0x10,
+ SFM_WRITE = 0x20,
+ SFM_RDWR = 0x30,
+
+ SF_AMBISONIC_NONE = 0x40,
+ SF_AMBISONIC_B_FORMAT = 0x41
+} ;
+
+/* Public error values. These are guaranteed to remain unchanged for the duration
+** of the library major version number.
+** There are also a large number of private error numbers which are internal to
+** the library which can change at any time.
+*/
+
+enum
+{ SF_ERR_NO_ERROR = 0,
+ SF_ERR_UNRECOGNISED_FORMAT = 1,
+ SF_ERR_SYSTEM = 2,
+ SF_ERR_MALFORMED_FILE = 3,
+ SF_ERR_UNSUPPORTED_ENCODING = 4
+} ;
+
+
+/* Channel map values (used with SFC_SET/GET_CHANNEL_MAP).
+*/
+
+enum
+{ SF_CHANNEL_MAP_INVALID = 0,
+ SF_CHANNEL_MAP_MONO = 1,
+ SF_CHANNEL_MAP_LEFT, /* Apple calls this 'Left' */
+ SF_CHANNEL_MAP_RIGHT, /* Apple calls this 'Right' */
+ SF_CHANNEL_MAP_CENTER, /* Apple calls this 'Center' */
+ SF_CHANNEL_MAP_FRONT_LEFT,
+ SF_CHANNEL_MAP_FRONT_RIGHT,
+ SF_CHANNEL_MAP_FRONT_CENTER,
+ SF_CHANNEL_MAP_REAR_CENTER, /* Apple calls this 'Center Surround', Msft calls this 'Back Center' */
+ SF_CHANNEL_MAP_REAR_LEFT, /* Apple calls this 'Left Surround', Msft calls this 'Back Left' */
+ SF_CHANNEL_MAP_REAR_RIGHT, /* Apple calls this 'Right Surround', Msft calls this 'Back Right' */
+ SF_CHANNEL_MAP_LFE, /* Apple calls this 'LFEScreen', Msft calls this 'Low Frequency' */
+ SF_CHANNEL_MAP_FRONT_LEFT_OF_CENTER, /* Apple calls this 'Left Center' */
+ SF_CHANNEL_MAP_FRONT_RIGHT_OF_CENTER, /* Apple calls this 'Right Center */
+ SF_CHANNEL_MAP_SIDE_LEFT, /* Apple calls this 'Left Surround Direct' */
+ SF_CHANNEL_MAP_SIDE_RIGHT, /* Apple calls this 'Right Surround Direct' */
+ SF_CHANNEL_MAP_TOP_CENTER, /* Apple calls this 'Top Center Surround' */
+ SF_CHANNEL_MAP_TOP_FRONT_LEFT, /* Apple calls this 'Vertical Height Left' */
+ SF_CHANNEL_MAP_TOP_FRONT_RIGHT, /* Apple calls this 'Vertical Height Right' */
+ SF_CHANNEL_MAP_TOP_FRONT_CENTER, /* Apple calls this 'Vertical Height Center' */
+ SF_CHANNEL_MAP_TOP_REAR_LEFT, /* Apple and MS call this 'Top Back Left' */
+ SF_CHANNEL_MAP_TOP_REAR_RIGHT, /* Apple and MS call this 'Top Back Right' */
+ SF_CHANNEL_MAP_TOP_REAR_CENTER, /* Apple and MS call this 'Top Back Center' */
+
+ SF_CHANNEL_MAP_AMBISONIC_B_W,
+ SF_CHANNEL_MAP_AMBISONIC_B_X,
+ SF_CHANNEL_MAP_AMBISONIC_B_Y,
+ SF_CHANNEL_MAP_AMBISONIC_B_Z,
+
+ SF_CHANNEL_MAP_MAX
+} ;
+
+
+/* A SNDFILE* pointer can be passed around much like stdio.h's FILE* pointer. */
+
+typedef struct SNDFILE_tag SNDFILE ;
+
+/* The following typedef is system specific and is defined when libsndfile is
+** compiled. sf_count_t will be a 64 bit value when the underlying OS allows
+** 64 bit file offsets.
+** On windows, we need to allow the same header file to be compiler by both GCC
+** and the Microsoft compiler.
+*/
+
+#if (defined (_MSCVER) || defined (_MSC_VER))
+typedef __int64 sf_count_t ;
+#define SF_COUNT_MAX 0x7fffffffffffffffi64
+#else
+typedef __int64 sf_count_t ;
+#define SF_COUNT_MAX 0x7FFFFFFFFFFFFFFFLL
+#endif
+
+
+/* A pointer to a SF_INFO structure is passed to sf_open () and filled in.
+** On write, the SF_INFO structure is filled in by the user and passed into
+** sf_open ().
+*/
+
+struct SF_INFO
+{ sf_count_t frames ; /* Used to be called samples. Changed to avoid confusion. */
+ int samplerate ;
+ int channels ;
+ int format ;
+ int sections ;
+ int seekable ;
+} ;
+
+typedef struct SF_INFO SF_INFO ;
+
+/* The SF_FORMAT_INFO struct is used to retrieve information about the sound
+** file formats libsndfile supports using the sf_command () interface.
+**
+** Using this interface will allow applications to support new file formats
+** and encoding types when libsndfile is upgraded, without requiring
+** re-compilation of the application.
+**
+** Please consult the libsndfile documentation (particularly the information
+** on the sf_command () interface) for examples of its use.
+*/
+
+typedef struct
+{ int format ;
+ const char *name ;
+ const char *extension ;
+} SF_FORMAT_INFO ;
+
+/*
+** Enums and typedefs for adding dither on read and write.
+** See the html documentation for sf_command(), SFC_SET_DITHER_ON_WRITE
+** and SFC_SET_DITHER_ON_READ.
+*/
+
+enum
+{ SFD_DEFAULT_LEVEL = 0,
+ SFD_CUSTOM_LEVEL = 0x40000000,
+
+ SFD_NO_DITHER = 500,
+ SFD_WHITE = 501,
+ SFD_TRIANGULAR_PDF = 502
+} ;
+
+typedef struct
+{ int type ;
+ double level ;
+ const char *name ;
+} SF_DITHER_INFO ;
+
+/* Struct used to retrieve information about a file embedded within a
+** larger file. See SFC_GET_EMBED_FILE_INFO.
+*/
+
+typedef struct
+{ sf_count_t offset ;
+ sf_count_t length ;
+} SF_EMBED_FILE_INFO ;
+
+/*
+** Structs used to retrieve music sample information from a file.
+*/
+
+enum
+{ /*
+ ** The loop mode field in SF_INSTRUMENT will be one of the following.
+ */
+ SF_LOOP_NONE = 800,
+ SF_LOOP_FORWARD,
+ SF_LOOP_BACKWARD,
+ SF_LOOP_ALTERNATING
+} ;
+
+typedef struct
+{ int gain ;
+ char basenote, detune ;
+ char velocity_lo, velocity_hi ;
+ char key_lo, key_hi ;
+ int loop_count ;
+
+ struct
+ { int mode ;
+ unsigned int start ;
+ unsigned int end ;
+ unsigned int count ;
+ } loops [16] ; /* make variable in a sensible way */
+} SF_INSTRUMENT ;
+
+
+
+/* Struct used to retrieve loop information from a file.*/
+typedef struct
+{
+ short time_sig_num ; /* any positive integer > 0 */
+ short time_sig_den ; /* any positive power of 2 > 0 */
+ int loop_mode ; /* see SF_LOOP enum */
+
+ int num_beats ; /* this is NOT the amount of quarter notes !!!*/
+ /* a full bar of 4/4 is 4 beats */
+ /* a full bar of 7/8 is 7 beats */
+
+ float bpm ; /* suggestion, as it can be calculated using other fields:*/
+ /* file's lenght, file's sampleRate and our time_sig_den*/
+ /* -> bpms are always the amount of _quarter notes_ per minute */
+
+ int root_key ; /* MIDI note, or -1 for None */
+ int future [6] ;
+} SF_LOOP_INFO ;
+
+
+/* Struct used to retrieve broadcast (EBU) information from a file.
+** Strongly (!) based on EBU "bext" chunk format used in Broadcast WAVE.
+*/
+#define SF_BROADCAST_INFO_VAR(coding_hist_size) \
+ struct \
+ { char description [256] ; \
+ char originator [32] ; \
+ char originator_reference [32] ; \
+ char origination_date [10] ; \
+ char origination_time [8] ; \
+ unsigned int time_reference_low ; \
+ unsigned int time_reference_high ; \
+ short version ; \
+ char umid [64] ; \
+ char reserved [190] ; \
+ unsigned int coding_history_size ; \
+ char coding_history [coding_hist_size] ; \
+ }
+
+/* SF_BROADCAST_INFO is the above struct with coding_history field of 256 bytes. */
+typedef SF_BROADCAST_INFO_VAR (256) SF_BROADCAST_INFO ;
+
+
+/* Virtual I/O functionality. */
+
+typedef sf_count_t (*sf_vio_get_filelen) (void *user_data) ;
+typedef sf_count_t (*sf_vio_seek) (sf_count_t offset, int whence, void *user_data) ;
+typedef sf_count_t (*sf_vio_read) (void *ptr, sf_count_t count, void *user_data) ;
+typedef sf_count_t (*sf_vio_write) (const void *ptr, sf_count_t count, void *user_data) ;
+typedef sf_count_t (*sf_vio_tell) (void *user_data) ;
+
+struct SF_VIRTUAL_IO
+{ sf_vio_get_filelen get_filelen ;
+ sf_vio_seek seek ;
+ sf_vio_read read ;
+ sf_vio_write write ;
+ sf_vio_tell tell ;
+} ;
+
+typedef struct SF_VIRTUAL_IO SF_VIRTUAL_IO ;
+
+
+/* Open the specified file for read, write or both. On error, this will
+** return a NULL pointer. To find the error number, pass a NULL SNDFILE
+** to sf_strerror ().
+** All calls to sf_open() should be matched with a call to sf_close().
+*/
+
+SNDFILE* sf_open (const char *path, int mode, SF_INFO *sfinfo) ;
+
+
+/* Use the existing file descriptor to create a SNDFILE object. If close_desc
+** is TRUE, the file descriptor will be closed when sf_close() is called. If
+** it is FALSE, the descritor will not be closed.
+** When passed a descriptor like this, the library will assume that the start
+** of file header is at the current file offset. This allows sound files within
+** larger container files to be read and/or written.
+** On error, this will return a NULL pointer. To find the error number, pass a
+** NULL SNDFILE to sf_strerror ().
+** All calls to sf_open_fd() should be matched with a call to sf_close().
+
+*/
+
+SNDFILE* sf_open_fd (int fd, int mode, SF_INFO *sfinfo, int close_desc) ;
+
+SNDFILE* sf_open_virtual (SF_VIRTUAL_IO *sfvirtual, int mode, SF_INFO *sfinfo, void *user_data) ;
+
+
+/* sf_error () returns a error number which can be translated to a text
+** string using sf_error_number().
+*/
+
+int sf_error (SNDFILE *sndfile) ;
+
+
+/* sf_strerror () returns to the caller a pointer to the current error message for
+** the given SNDFILE.
+*/
+
+const char* sf_strerror (SNDFILE *sndfile) ;
+
+
+/* sf_error_number () allows the retrieval of the error string for each internal
+** error number.
+**
+*/
+
+const char* sf_error_number (int errnum) ;
+
+
+/* The following two error functions are deprecated but they will remain in the
+** library for the forseeable future. The function sf_strerror() should be used
+** in their place.
+*/
+
+int sf_perror (SNDFILE *sndfile) ;
+int sf_error_str (SNDFILE *sndfile, char* str, size_t len) ;
+
+
+/* Return TRUE if fields of the SF_INFO struct are a valid combination of values. */
+
+int sf_command (SNDFILE *sndfile, int command, void *data, int datasize) ;
+
+
+/* Return TRUE if fields of the SF_INFO struct are a valid combination of values. */
+
+int sf_format_check (const SF_INFO *info) ;
+
+
+/* Seek within the waveform data chunk of the SNDFILE. sf_seek () uses
+** the same values for whence (SEEK_SET, SEEK_CUR and SEEK_END) as
+** stdio.h function fseek ().
+** An offset of zero with whence set to SEEK_SET will position the
+** read / write pointer to the first data sample.
+** On success sf_seek returns the current position in (multi-channel)
+** samples from the start of the file.
+** Please see the libsndfile documentation for moving the read pointer
+** separately from the write pointer on files open in mode SFM_RDWR.
+** On error all of these functions return -1.
+*/
+
+sf_count_t sf_seek (SNDFILE *sndfile, sf_count_t frames, int whence) ;
+
+
+/* Functions for retrieving and setting string data within sound files.
+** Not all file types support this features; AIFF and WAV do. For both
+** functions, the str_type parameter must be one of the SF_STR_* values
+** defined above.
+** On error, sf_set_string() returns non-zero while sf_get_string()
+** returns NULL.
+*/
+
+int sf_set_string (SNDFILE *sndfile, int str_type, const char* str) ;
+
+const char* sf_get_string (SNDFILE *sndfile, int str_type) ;
+
+
+/* Return the library version string. */
+
+const char * sf_version_string (void) ;
+
+
+/* Functions for reading/writing the waveform data of a sound file.
+*/
+
+sf_count_t sf_read_raw (SNDFILE *sndfile, void *ptr, sf_count_t bytes) ;
+sf_count_t sf_write_raw (SNDFILE *sndfile, const void *ptr, sf_count_t bytes) ;
+
+
+/* Functions for reading and writing the data chunk in terms of frames.
+** The number of items actually read/written = frames * number of channels.
+** sf_xxxx_raw read/writes the raw data bytes from/to the file
+** sf_xxxx_short passes data in the native short format
+** sf_xxxx_int passes data in the native int format
+** sf_xxxx_float passes data in the native float format
+** sf_xxxx_double passes data in the native double format
+** All of these read/write function return number of frames read/written.
+*/
+
+sf_count_t sf_readf_short (SNDFILE *sndfile, short *ptr, sf_count_t frames) ;
+sf_count_t sf_writef_short (SNDFILE *sndfile, const short *ptr, sf_count_t frames) ;
+
+sf_count_t sf_readf_int (SNDFILE *sndfile, int *ptr, sf_count_t frames) ;
+sf_count_t sf_writef_int (SNDFILE *sndfile, const int *ptr, sf_count_t frames) ;
+
+sf_count_t sf_readf_float (SNDFILE *sndfile, float *ptr, sf_count_t frames) ;
+sf_count_t sf_writef_float (SNDFILE *sndfile, const float *ptr, sf_count_t frames) ;
+
+sf_count_t sf_readf_double (SNDFILE *sndfile, double *ptr, sf_count_t frames) ;
+sf_count_t sf_writef_double (SNDFILE *sndfile, const double *ptr, sf_count_t frames) ;
+
+
+/* Functions for reading and writing the data chunk in terms of items.
+** Otherwise similar to above.
+** All of these read/write function return number of items read/written.
+*/
+
+sf_count_t sf_read_short (SNDFILE *sndfile, short *ptr, sf_count_t items) ;
+sf_count_t sf_write_short (SNDFILE *sndfile, const short *ptr, sf_count_t items) ;
+
+sf_count_t sf_read_int (SNDFILE *sndfile, int *ptr, sf_count_t items) ;
+sf_count_t sf_write_int (SNDFILE *sndfile, const int *ptr, sf_count_t items) ;
+
+sf_count_t sf_read_float (SNDFILE *sndfile, float *ptr, sf_count_t items) ;
+sf_count_t sf_write_float (SNDFILE *sndfile, const float *ptr, sf_count_t items) ;
+
+sf_count_t sf_read_double (SNDFILE *sndfile, double *ptr, sf_count_t items) ;
+sf_count_t sf_write_double (SNDFILE *sndfile, const double *ptr, sf_count_t items) ;
+
+
+/* Close the SNDFILE and clean up all memory allocations associated with this
+** file.
+** Returns 0 on success, or an error number.
+*/
+
+int sf_close (SNDFILE *sndfile) ;
+
+
+/* If the file is opened SFM_WRITE or SFM_RDWR, call fsync() on the file
+** to force the writing of data to disk. If the file is opened SFM_READ
+** no action is taken.
+*/
+
+void sf_write_sync (SNDFILE *sndfile) ;
+
+
+
+/* The function sf_wchar_open() is Windows Only!
+** Open a file passing in a Windows Unicode filename. Otherwise, this is
+** the same as sf_open().
+**
+** In order for this to work, you need to do the following:
+**
+** #include <windows.h>
+** #define ENABLE_SNDFILE_WINDOWS_PROTOTYPES 1
+** #including <sndfile.h>
+*/
+
+#if (defined (ENABLE_SNDFILE_WINDOWS_PROTOTYPES) && ENABLE_SNDFILE_WINDOWS_PROTOTYPES)
+SNDFILE* sf_wchar_open (LPCWSTR wpath, int mode, SF_INFO *sfinfo) ;
+#endif
+
+
+
+#ifdef __cplusplus
+} /* extern "C" */
+#endif /* __cplusplus */
+
+#endif /* SNDFILE_H */
+
--- /dev/null
+#include <stdio.h>\r
+\r
+#include <sndfile.h>\r
+\r
+int\r
+main (void)\r
+{\r
+ char buf [1024] ;\r
+\r
+ sf_command (NULL, SFC_GET_LIB_VERSION, buf, sizeof (buf)) ;\r
+ puts (buf) ;\r
+\r
+ return 0 ;\r
+}\r
--- /dev/null
+Debug/main.o: \\r
+ C:/Users/wittend/Projects/libsndfile/Projects/w32-mingw/main.cpp \\r
+ C:/Users/wittend/Projects/libsndfile/Projects/w32-mingw/sndfile.h\r
+\r
+C:/Users/wittend/Projects/libsndfile/Projects/w32-mingw/sndfile.h:\r
--- /dev/null
+TARGETS = test.exe
+
+test.exe : test.c sndfile.h libsndfile-1.dll
+ gcc -I . $< libsndfile-1.dll -o $@
+
+# Need to the MinGW sndfile.h
+sndfile.h : ../../include/sndfile.h
+ cp -f $+ $@
+
+# Need the DLL in the local directory.
+libsndfile-1.dll : ../../bin/libsndfile-1.dll
+ cp -f $+ $@
+
--- /dev/null
+Release/main.o: \\r
+ C:/Users/wittend/Projects/libsndfile/Projects/w32-mingw/main.cpp \\r
+ C:/Users/wittend/Projects/libsndfile/Projects/w32-mingw/sndfile.h\r
+\r
+C:/Users/wittend/Projects/libsndfile/Projects/w32-mingw/sndfile.h:\r
--- /dev/null
+#include <stdio.h>
+#include "sndfile.h"\r
+
+int main(int argc, char **argv)
+{
+ char buf [1024] ;\r
+\r
+ sf_command (NULL, SFC_GET_LIB_VERSION, buf, sizeof (buf)) ;\r
+ puts (buf) ;\r
+ printf("\nhello world\n");
+\r
+ return 0 ;\r
+}
--- /dev/null
+/*
+** Copyright (C) 1999-2011Erik de Castro Lopo <erikd@mega-nerd.com>
+**
+** This program is free software; you can redistribute it and/or modify
+** it under the terms of the GNU Lesser General Public License as published by
+** the Free Software Foundation; either version 2.1 of the License, or
+** (at your option) any later version.
+**
+** This program is distributed in the hope that it will be useful,
+** but WITHOUT ANY WARRANTY; without even the implied warranty of
+** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+** GNU Lesser General Public License for more details.
+**
+** You should have received a copy of the GNU Lesser General Public License
+** along with this program; if not, write to the Free Software
+** Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+*/
+
+/*
+** sndfile.h -- system-wide definitions
+**
+** API documentation is in the doc/ directory of the source code tarball
+** and at http://www.mega-nerd.com/libsndfile/api.html.
+*/
+
+#ifndef SNDFILE_H
+#define SNDFILE_H
+
+/* This is the version 1.0.X header file. */
+#define SNDFILE_1
+
+#include <stdio.h>
+#include <sys/types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif /* __cplusplus */
+
+/* The following file types can be read and written.
+** A file type would consist of a major type (ie SF_FORMAT_WAV) bitwise
+** ORed with a minor type (ie SF_FORMAT_PCM). SF_FORMAT_TYPEMASK and
+** SF_FORMAT_SUBMASK can be used to separate the major and minor file
+** types.
+*/
+
+enum
+{ /* Major formats. */
+ SF_FORMAT_WAV = 0x010000, /* Microsoft WAV format (little endian default). */
+ SF_FORMAT_AIFF = 0x020000, /* Apple/SGI AIFF format (big endian). */
+ SF_FORMAT_AU = 0x030000, /* Sun/NeXT AU format (big endian). */
+ SF_FORMAT_RAW = 0x040000, /* RAW PCM data. */
+ SF_FORMAT_PAF = 0x050000, /* Ensoniq PARIS file format. */
+ SF_FORMAT_SVX = 0x060000, /* Amiga IFF / SVX8 / SV16 format. */
+ SF_FORMAT_NIST = 0x070000, /* Sphere NIST format. */
+ SF_FORMAT_VOC = 0x080000, /* VOC files. */
+ SF_FORMAT_IRCAM = 0x0A0000, /* Berkeley/IRCAM/CARL */
+ SF_FORMAT_W64 = 0x0B0000, /* Sonic Foundry's 64 bit RIFF/WAV */
+ SF_FORMAT_MAT4 = 0x0C0000, /* Matlab (tm) V4.2 / GNU Octave 2.0 */
+ SF_FORMAT_MAT5 = 0x0D0000, /* Matlab (tm) V5.0 / GNU Octave 2.1 */
+ SF_FORMAT_PVF = 0x0E0000, /* Portable Voice Format */
+ SF_FORMAT_XI = 0x0F0000, /* Fasttracker 2 Extended Instrument */
+ SF_FORMAT_HTK = 0x100000, /* HMM Tool Kit format */
+ SF_FORMAT_SDS = 0x110000, /* Midi Sample Dump Standard */
+ SF_FORMAT_AVR = 0x120000, /* Audio Visual Research */
+ SF_FORMAT_WAVEX = 0x130000, /* MS WAVE with WAVEFORMATEX */
+ SF_FORMAT_SD2 = 0x160000, /* Sound Designer 2 */
+ SF_FORMAT_FLAC = 0x170000, /* FLAC lossless file format */
+ SF_FORMAT_CAF = 0x180000, /* Core Audio File format */
+ SF_FORMAT_WVE = 0x190000, /* Psion WVE format */
+ SF_FORMAT_OGG = 0x200000, /* Xiph OGG container */
+ SF_FORMAT_MPC2K = 0x210000, /* Akai MPC 2000 sampler */
+ SF_FORMAT_RF64 = 0x220000, /* RF64 WAV file */
+
+ /* Subtypes from here on. */
+
+ SF_FORMAT_PCM_S8 = 0x0001, /* Signed 8 bit data */
+ SF_FORMAT_PCM_16 = 0x0002, /* Signed 16 bit data */
+ SF_FORMAT_PCM_24 = 0x0003, /* Signed 24 bit data */
+ SF_FORMAT_PCM_32 = 0x0004, /* Signed 32 bit data */
+
+ SF_FORMAT_PCM_U8 = 0x0005, /* Unsigned 8 bit data (WAV and RAW only) */
+
+ SF_FORMAT_FLOAT = 0x0006, /* 32 bit float data */
+ SF_FORMAT_DOUBLE = 0x0007, /* 64 bit float data */
+
+ SF_FORMAT_ULAW = 0x0010, /* U-Law encoded. */
+ SF_FORMAT_ALAW = 0x0011, /* A-Law encoded. */
+ SF_FORMAT_IMA_ADPCM = 0x0012, /* IMA ADPCM. */
+ SF_FORMAT_MS_ADPCM = 0x0013, /* Microsoft ADPCM. */
+
+ SF_FORMAT_GSM610 = 0x0020, /* GSM 6.10 encoding. */
+ SF_FORMAT_VOX_ADPCM = 0x0021, /* OKI / Dialogix ADPCM */
+
+ SF_FORMAT_G721_32 = 0x0030, /* 32kbs G721 ADPCM encoding. */
+ SF_FORMAT_G723_24 = 0x0031, /* 24kbs G723 ADPCM encoding. */
+ SF_FORMAT_G723_40 = 0x0032, /* 40kbs G723 ADPCM encoding. */
+
+ SF_FORMAT_DWVW_12 = 0x0040, /* 12 bit Delta Width Variable Word encoding. */
+ SF_FORMAT_DWVW_16 = 0x0041, /* 16 bit Delta Width Variable Word encoding. */
+ SF_FORMAT_DWVW_24 = 0x0042, /* 24 bit Delta Width Variable Word encoding. */
+ SF_FORMAT_DWVW_N = 0x0043, /* N bit Delta Width Variable Word encoding. */
+
+ SF_FORMAT_DPCM_8 = 0x0050, /* 8 bit differential PCM (XI only) */
+ SF_FORMAT_DPCM_16 = 0x0051, /* 16 bit differential PCM (XI only) */
+
+ SF_FORMAT_VORBIS = 0x0060, /* Xiph Vorbis encoding. */
+
+ /* Endian-ness options. */
+
+ SF_ENDIAN_FILE = 0x00000000, /* Default file endian-ness. */
+ SF_ENDIAN_LITTLE = 0x10000000, /* Force little endian-ness. */
+ SF_ENDIAN_BIG = 0x20000000, /* Force big endian-ness. */
+ SF_ENDIAN_CPU = 0x30000000, /* Force CPU endian-ness. */
+
+ SF_FORMAT_SUBMASK = 0x0000FFFF,
+ SF_FORMAT_TYPEMASK = 0x0FFF0000,
+ SF_FORMAT_ENDMASK = 0x30000000
+} ;
+
+/*
+** The following are the valid command numbers for the sf_command()
+** interface. The use of these commands is documented in the file
+** command.html in the doc directory of the source code distribution.
+*/
+
+enum
+{ SFC_GET_LIB_VERSION = 0x1000,
+ SFC_GET_LOG_INFO = 0x1001,
+ SFC_GET_CURRENT_SF_INFO = 0x1002,
+
+
+ SFC_GET_NORM_DOUBLE = 0x1010,
+ SFC_GET_NORM_FLOAT = 0x1011,
+ SFC_SET_NORM_DOUBLE = 0x1012,
+ SFC_SET_NORM_FLOAT = 0x1013,
+ SFC_SET_SCALE_FLOAT_INT_READ = 0x1014,
+ SFC_SET_SCALE_INT_FLOAT_WRITE = 0x1015,
+
+ SFC_GET_SIMPLE_FORMAT_COUNT = 0x1020,
+ SFC_GET_SIMPLE_FORMAT = 0x1021,
+
+ SFC_GET_FORMAT_INFO = 0x1028,
+
+ SFC_GET_FORMAT_MAJOR_COUNT = 0x1030,
+ SFC_GET_FORMAT_MAJOR = 0x1031,
+ SFC_GET_FORMAT_SUBTYPE_COUNT = 0x1032,
+ SFC_GET_FORMAT_SUBTYPE = 0x1033,
+
+ SFC_CALC_SIGNAL_MAX = 0x1040,
+ SFC_CALC_NORM_SIGNAL_MAX = 0x1041,
+ SFC_CALC_MAX_ALL_CHANNELS = 0x1042,
+ SFC_CALC_NORM_MAX_ALL_CHANNELS = 0x1043,
+ SFC_GET_SIGNAL_MAX = 0x1044,
+ SFC_GET_MAX_ALL_CHANNELS = 0x1045,
+
+ SFC_SET_ADD_PEAK_CHUNK = 0x1050,
+ SFC_SET_ADD_HEADER_PAD_CHUNK = 0x1051,
+
+ SFC_UPDATE_HEADER_NOW = 0x1060,
+ SFC_SET_UPDATE_HEADER_AUTO = 0x1061,
+
+ SFC_FILE_TRUNCATE = 0x1080,
+
+ SFC_SET_RAW_START_OFFSET = 0x1090,
+
+ SFC_SET_DITHER_ON_WRITE = 0x10A0,
+ SFC_SET_DITHER_ON_READ = 0x10A1,
+
+ SFC_GET_DITHER_INFO_COUNT = 0x10A2,
+ SFC_GET_DITHER_INFO = 0x10A3,
+
+ SFC_GET_EMBED_FILE_INFO = 0x10B0,
+
+ SFC_SET_CLIPPING = 0x10C0,
+ SFC_GET_CLIPPING = 0x10C1,
+
+ SFC_GET_INSTRUMENT = 0x10D0,
+ SFC_SET_INSTRUMENT = 0x10D1,
+
+ SFC_GET_LOOP_INFO = 0x10E0,
+
+ SFC_GET_BROADCAST_INFO = 0x10F0,
+ SFC_SET_BROADCAST_INFO = 0x10F1,
+
+ SFC_GET_CHANNEL_MAP_INFO = 0x1100,
+ SFC_SET_CHANNEL_MAP_INFO = 0x1101,
+
+ SFC_RAW_DATA_NEEDS_ENDSWAP = 0x1110,
+
+ /* Support for Wavex Ambisonics Format */
+ SFC_WAVEX_SET_AMBISONIC = 0x1200,
+ SFC_WAVEX_GET_AMBISONIC = 0x1201,
+
+ SFC_SET_VBR_ENCODING_QUALITY = 0x1300,
+
+ /* Following commands for testing only. */
+ SFC_TEST_IEEE_FLOAT_REPLACE = 0x6001,
+
+ /*
+ ** SFC_SET_ADD_* values are deprecated and will disappear at some
+ ** time in the future. They are guaranteed to be here up to and
+ ** including version 1.0.8 to avoid breakage of existng software.
+ ** They currently do nothing and will continue to do nothing.
+ */
+ SFC_SET_ADD_DITHER_ON_WRITE = 0x1070,
+ SFC_SET_ADD_DITHER_ON_READ = 0x1071
+} ;
+
+
+/*
+** String types that can be set and read from files. Not all file types
+** support this and even the file types which support one, may not support
+** all string types.
+*/
+
+enum
+{ SF_STR_TITLE = 0x01,
+ SF_STR_COPYRIGHT = 0x02,
+ SF_STR_SOFTWARE = 0x03,
+ SF_STR_ARTIST = 0x04,
+ SF_STR_COMMENT = 0x05,
+ SF_STR_DATE = 0x06,
+ SF_STR_ALBUM = 0x07,
+ SF_STR_LICENSE = 0x08,
+ SF_STR_TRACKNUMBER = 0x09,
+ SF_STR_GENRE = 0x10
+} ;
+
+/*
+** Use the following as the start and end index when doing metadata
+** transcoding.
+*/
+
+#define SF_STR_FIRST SF_STR_TITLE
+#define SF_STR_LAST SF_STR_GENRE
+
+enum
+{ /* True and false */
+ SF_FALSE = 0,
+ SF_TRUE = 1,
+
+ /* Modes for opening files. */
+ SFM_READ = 0x10,
+ SFM_WRITE = 0x20,
+ SFM_RDWR = 0x30,
+
+ SF_AMBISONIC_NONE = 0x40,
+ SF_AMBISONIC_B_FORMAT = 0x41
+} ;
+
+/* Public error values. These are guaranteed to remain unchanged for the duration
+** of the library major version number.
+** There are also a large number of private error numbers which are internal to
+** the library which can change at any time.
+*/
+
+enum
+{ SF_ERR_NO_ERROR = 0,
+ SF_ERR_UNRECOGNISED_FORMAT = 1,
+ SF_ERR_SYSTEM = 2,
+ SF_ERR_MALFORMED_FILE = 3,
+ SF_ERR_UNSUPPORTED_ENCODING = 4
+} ;
+
+
+/* Channel map values (used with SFC_SET/GET_CHANNEL_MAP).
+*/
+
+enum
+{ SF_CHANNEL_MAP_INVALID = 0,
+ SF_CHANNEL_MAP_MONO = 1,
+ SF_CHANNEL_MAP_LEFT, /* Apple calls this 'Left' */
+ SF_CHANNEL_MAP_RIGHT, /* Apple calls this 'Right' */
+ SF_CHANNEL_MAP_CENTER, /* Apple calls this 'Center' */
+ SF_CHANNEL_MAP_FRONT_LEFT,
+ SF_CHANNEL_MAP_FRONT_RIGHT,
+ SF_CHANNEL_MAP_FRONT_CENTER,
+ SF_CHANNEL_MAP_REAR_CENTER, /* Apple calls this 'Center Surround', Msft calls this 'Back Center' */
+ SF_CHANNEL_MAP_REAR_LEFT, /* Apple calls this 'Left Surround', Msft calls this 'Back Left' */
+ SF_CHANNEL_MAP_REAR_RIGHT, /* Apple calls this 'Right Surround', Msft calls this 'Back Right' */
+ SF_CHANNEL_MAP_LFE, /* Apple calls this 'LFEScreen', Msft calls this 'Low Frequency' */
+ SF_CHANNEL_MAP_FRONT_LEFT_OF_CENTER, /* Apple calls this 'Left Center' */
+ SF_CHANNEL_MAP_FRONT_RIGHT_OF_CENTER, /* Apple calls this 'Right Center */
+ SF_CHANNEL_MAP_SIDE_LEFT, /* Apple calls this 'Left Surround Direct' */
+ SF_CHANNEL_MAP_SIDE_RIGHT, /* Apple calls this 'Right Surround Direct' */
+ SF_CHANNEL_MAP_TOP_CENTER, /* Apple calls this 'Top Center Surround' */
+ SF_CHANNEL_MAP_TOP_FRONT_LEFT, /* Apple calls this 'Vertical Height Left' */
+ SF_CHANNEL_MAP_TOP_FRONT_RIGHT, /* Apple calls this 'Vertical Height Right' */
+ SF_CHANNEL_MAP_TOP_FRONT_CENTER, /* Apple calls this 'Vertical Height Center' */
+ SF_CHANNEL_MAP_TOP_REAR_LEFT, /* Apple and MS call this 'Top Back Left' */
+ SF_CHANNEL_MAP_TOP_REAR_RIGHT, /* Apple and MS call this 'Top Back Right' */
+ SF_CHANNEL_MAP_TOP_REAR_CENTER, /* Apple and MS call this 'Top Back Center' */
+
+ SF_CHANNEL_MAP_AMBISONIC_B_W,
+ SF_CHANNEL_MAP_AMBISONIC_B_X,
+ SF_CHANNEL_MAP_AMBISONIC_B_Y,
+ SF_CHANNEL_MAP_AMBISONIC_B_Z,
+
+ SF_CHANNEL_MAP_MAX
+} ;
+
+
+/* A SNDFILE* pointer can be passed around much like stdio.h's FILE* pointer. */
+
+typedef struct SNDFILE_tag SNDFILE ;
+
+/* The following typedef is system specific and is defined when libsndfile is
+** compiled. sf_count_t will be a 64 bit value when the underlying OS allows
+** 64 bit file offsets.
+** On windows, we need to allow the same header file to be compiler by both GCC
+** and the Microsoft compiler.
+*/
+
+#if (defined (_MSCVER) || defined (_MSC_VER))
+typedef __int64 sf_count_t ;
+#define SF_COUNT_MAX 0x7fffffffffffffffi64
+#else
+typedef __int64 sf_count_t ;
+#define SF_COUNT_MAX 0x7FFFFFFFFFFFFFFFLL
+#endif
+
+
+/* A pointer to a SF_INFO structure is passed to sf_open () and filled in.
+** On write, the SF_INFO structure is filled in by the user and passed into
+** sf_open ().
+*/
+
+struct SF_INFO
+{ sf_count_t frames ; /* Used to be called samples. Changed to avoid confusion. */
+ int samplerate ;
+ int channels ;
+ int format ;
+ int sections ;
+ int seekable ;
+} ;
+
+typedef struct SF_INFO SF_INFO ;
+
+/* The SF_FORMAT_INFO struct is used to retrieve information about the sound
+** file formats libsndfile supports using the sf_command () interface.
+**
+** Using this interface will allow applications to support new file formats
+** and encoding types when libsndfile is upgraded, without requiring
+** re-compilation of the application.
+**
+** Please consult the libsndfile documentation (particularly the information
+** on the sf_command () interface) for examples of its use.
+*/
+
+typedef struct
+{ int format ;
+ const char *name ;
+ const char *extension ;
+} SF_FORMAT_INFO ;
+
+/*
+** Enums and typedefs for adding dither on read and write.
+** See the html documentation for sf_command(), SFC_SET_DITHER_ON_WRITE
+** and SFC_SET_DITHER_ON_READ.
+*/
+
+enum
+{ SFD_DEFAULT_LEVEL = 0,
+ SFD_CUSTOM_LEVEL = 0x40000000,
+
+ SFD_NO_DITHER = 500,
+ SFD_WHITE = 501,
+ SFD_TRIANGULAR_PDF = 502
+} ;
+
+typedef struct
+{ int type ;
+ double level ;
+ const char *name ;
+} SF_DITHER_INFO ;
+
+/* Struct used to retrieve information about a file embedded within a
+** larger file. See SFC_GET_EMBED_FILE_INFO.
+*/
+
+typedef struct
+{ sf_count_t offset ;
+ sf_count_t length ;
+} SF_EMBED_FILE_INFO ;
+
+/*
+** Structs used to retrieve music sample information from a file.
+*/
+
+enum
+{ /*
+ ** The loop mode field in SF_INSTRUMENT will be one of the following.
+ */
+ SF_LOOP_NONE = 800,
+ SF_LOOP_FORWARD,
+ SF_LOOP_BACKWARD,
+ SF_LOOP_ALTERNATING
+} ;
+
+typedef struct
+{ int gain ;
+ char basenote, detune ;
+ char velocity_lo, velocity_hi ;
+ char key_lo, key_hi ;
+ int loop_count ;
+
+ struct
+ { int mode ;
+ unsigned int start ;
+ unsigned int end ;
+ unsigned int count ;
+ } loops [16] ; /* make variable in a sensible way */
+} SF_INSTRUMENT ;
+
+
+
+/* Struct used to retrieve loop information from a file.*/
+typedef struct
+{
+ short time_sig_num ; /* any positive integer > 0 */
+ short time_sig_den ; /* any positive power of 2 > 0 */
+ int loop_mode ; /* see SF_LOOP enum */
+
+ int num_beats ; /* this is NOT the amount of quarter notes !!!*/
+ /* a full bar of 4/4 is 4 beats */
+ /* a full bar of 7/8 is 7 beats */
+
+ float bpm ; /* suggestion, as it can be calculated using other fields:*/
+ /* file's lenght, file's sampleRate and our time_sig_den*/
+ /* -> bpms are always the amount of _quarter notes_ per minute */
+
+ int root_key ; /* MIDI note, or -1 for None */
+ int future [6] ;
+} SF_LOOP_INFO ;
+
+
+/* Struct used to retrieve broadcast (EBU) information from a file.
+** Strongly (!) based on EBU "bext" chunk format used in Broadcast WAVE.
+*/
+#define SF_BROADCAST_INFO_VAR(coding_hist_size) \
+ struct \
+ { char description [256] ; \
+ char originator [32] ; \
+ char originator_reference [32] ; \
+ char origination_date [10] ; \
+ char origination_time [8] ; \
+ unsigned int time_reference_low ; \
+ unsigned int time_reference_high ; \
+ short version ; \
+ char umid [64] ; \
+ char reserved [190] ; \
+ unsigned int coding_history_size ; \
+ char coding_history [coding_hist_size] ; \
+ }
+
+/* SF_BROADCAST_INFO is the above struct with coding_history field of 256 bytes. */
+typedef SF_BROADCAST_INFO_VAR (256) SF_BROADCAST_INFO ;
+
+
+/* Virtual I/O functionality. */
+
+typedef sf_count_t (*sf_vio_get_filelen) (void *user_data) ;
+typedef sf_count_t (*sf_vio_seek) (sf_count_t offset, int whence, void *user_data) ;
+typedef sf_count_t (*sf_vio_read) (void *ptr, sf_count_t count, void *user_data) ;
+typedef sf_count_t (*sf_vio_write) (const void *ptr, sf_count_t count, void *user_data) ;
+typedef sf_count_t (*sf_vio_tell) (void *user_data) ;
+
+struct SF_VIRTUAL_IO
+{ sf_vio_get_filelen get_filelen ;
+ sf_vio_seek seek ;
+ sf_vio_read read ;
+ sf_vio_write write ;
+ sf_vio_tell tell ;
+} ;
+
+typedef struct SF_VIRTUAL_IO SF_VIRTUAL_IO ;
+
+
+/* Open the specified file for read, write or both. On error, this will
+** return a NULL pointer. To find the error number, pass a NULL SNDFILE
+** to sf_strerror ().
+** All calls to sf_open() should be matched with a call to sf_close().
+*/
+
+SNDFILE* sf_open (const char *path, int mode, SF_INFO *sfinfo) ;
+
+
+/* Use the existing file descriptor to create a SNDFILE object. If close_desc
+** is TRUE, the file descriptor will be closed when sf_close() is called. If
+** it is FALSE, the descritor will not be closed.
+** When passed a descriptor like this, the library will assume that the start
+** of file header is at the current file offset. This allows sound files within
+** larger container files to be read and/or written.
+** On error, this will return a NULL pointer. To find the error number, pass a
+** NULL SNDFILE to sf_strerror ().
+** All calls to sf_open_fd() should be matched with a call to sf_close().
+
+*/
+
+SNDFILE* sf_open_fd (int fd, int mode, SF_INFO *sfinfo, int close_desc) ;
+
+SNDFILE* sf_open_virtual (SF_VIRTUAL_IO *sfvirtual, int mode, SF_INFO *sfinfo, void *user_data) ;
+
+
+/* sf_error () returns a error number which can be translated to a text
+** string using sf_error_number().
+*/
+
+int sf_error (SNDFILE *sndfile) ;
+
+
+/* sf_strerror () returns to the caller a pointer to the current error message for
+** the given SNDFILE.
+*/
+
+const char* sf_strerror (SNDFILE *sndfile) ;
+
+
+/* sf_error_number () allows the retrieval of the error string for each internal
+** error number.
+**
+*/
+
+const char* sf_error_number (int errnum) ;
+
+
+/* The following two error functions are deprecated but they will remain in the
+** library for the forseeable future. The function sf_strerror() should be used
+** in their place.
+*/
+
+int sf_perror (SNDFILE *sndfile) ;
+int sf_error_str (SNDFILE *sndfile, char* str, size_t len) ;
+
+
+/* Return TRUE if fields of the SF_INFO struct are a valid combination of values. */
+
+int sf_command (SNDFILE *sndfile, int command, void *data, int datasize) ;
+
+
+/* Return TRUE if fields of the SF_INFO struct are a valid combination of values. */
+
+int sf_format_check (const SF_INFO *info) ;
+
+
+/* Seek within the waveform data chunk of the SNDFILE. sf_seek () uses
+** the same values for whence (SEEK_SET, SEEK_CUR and SEEK_END) as
+** stdio.h function fseek ().
+** An offset of zero with whence set to SEEK_SET will position the
+** read / write pointer to the first data sample.
+** On success sf_seek returns the current position in (multi-channel)
+** samples from the start of the file.
+** Please see the libsndfile documentation for moving the read pointer
+** separately from the write pointer on files open in mode SFM_RDWR.
+** On error all of these functions return -1.
+*/
+
+sf_count_t sf_seek (SNDFILE *sndfile, sf_count_t frames, int whence) ;
+
+
+/* Functions for retrieving and setting string data within sound files.
+** Not all file types support this features; AIFF and WAV do. For both
+** functions, the str_type parameter must be one of the SF_STR_* values
+** defined above.
+** On error, sf_set_string() returns non-zero while sf_get_string()
+** returns NULL.
+*/
+
+int sf_set_string (SNDFILE *sndfile, int str_type, const char* str) ;
+
+const char* sf_get_string (SNDFILE *sndfile, int str_type) ;
+
+
+/* Return the library version string. */
+
+const char * sf_version_string (void) ;
+
+
+/* Functions for reading/writing the waveform data of a sound file.
+*/
+
+sf_count_t sf_read_raw (SNDFILE *sndfile, void *ptr, sf_count_t bytes) ;
+sf_count_t sf_write_raw (SNDFILE *sndfile, const void *ptr, sf_count_t bytes) ;
+
+
+/* Functions for reading and writing the data chunk in terms of frames.
+** The number of items actually read/written = frames * number of channels.
+** sf_xxxx_raw read/writes the raw data bytes from/to the file
+** sf_xxxx_short passes data in the native short format
+** sf_xxxx_int passes data in the native int format
+** sf_xxxx_float passes data in the native float format
+** sf_xxxx_double passes data in the native double format
+** All of these read/write function return number of frames read/written.
+*/
+
+sf_count_t sf_readf_short (SNDFILE *sndfile, short *ptr, sf_count_t frames) ;
+sf_count_t sf_writef_short (SNDFILE *sndfile, const short *ptr, sf_count_t frames) ;
+
+sf_count_t sf_readf_int (SNDFILE *sndfile, int *ptr, sf_count_t frames) ;
+sf_count_t sf_writef_int (SNDFILE *sndfile, const int *ptr, sf_count_t frames) ;
+
+sf_count_t sf_readf_float (SNDFILE *sndfile, float *ptr, sf_count_t frames) ;
+sf_count_t sf_writef_float (SNDFILE *sndfile, const float *ptr, sf_count_t frames) ;
+
+sf_count_t sf_readf_double (SNDFILE *sndfile, double *ptr, sf_count_t frames) ;
+sf_count_t sf_writef_double (SNDFILE *sndfile, const double *ptr, sf_count_t frames) ;
+
+
+/* Functions for reading and writing the data chunk in terms of items.
+** Otherwise similar to above.
+** All of these read/write function return number of items read/written.
+*/
+
+sf_count_t sf_read_short (SNDFILE *sndfile, short *ptr, sf_count_t items) ;
+sf_count_t sf_write_short (SNDFILE *sndfile, const short *ptr, sf_count_t items) ;
+
+sf_count_t sf_read_int (SNDFILE *sndfile, int *ptr, sf_count_t items) ;
+sf_count_t sf_write_int (SNDFILE *sndfile, const int *ptr, sf_count_t items) ;
+
+sf_count_t sf_read_float (SNDFILE *sndfile, float *ptr, sf_count_t items) ;
+sf_count_t sf_write_float (SNDFILE *sndfile, const float *ptr, sf_count_t items) ;
+
+sf_count_t sf_read_double (SNDFILE *sndfile, double *ptr, sf_count_t items) ;
+sf_count_t sf_write_double (SNDFILE *sndfile, const double *ptr, sf_count_t items) ;
+
+
+/* Close the SNDFILE and clean up all memory allocations associated with this
+** file.
+** Returns 0 on success, or an error number.
+*/
+
+int sf_close (SNDFILE *sndfile) ;
+
+
+/* If the file is opened SFM_WRITE or SFM_RDWR, call fsync() on the file
+** to force the writing of data to disk. If the file is opened SFM_READ
+** no action is taken.
+*/
+
+void sf_write_sync (SNDFILE *sndfile) ;
+
+
+
+/* The function sf_wchar_open() is Windows Only!
+** Open a file passing in a Windows Unicode filename. Otherwise, this is
+** the same as sf_open().
+**
+** In order for this to work, you need to do the following:
+**
+** #include <windows.h>
+** #define ENABLE_SNDFILE_WINDOWS_PROTOTYPES 1
+** #including <sndfile.h>
+*/
+
+#if (defined (ENABLE_SNDFILE_WINDOWS_PROTOTYPES) && ENABLE_SNDFILE_WINDOWS_PROTOTYPES)
+SNDFILE* sf_wchar_open (LPCWSTR wpath, int mode, SF_INFO *sfinfo) ;
+#endif
+
+
+
+#ifdef __cplusplus
+} /* extern "C" */
+#endif /* __cplusplus */
+
+#endif /* SNDFILE_H */
+
--- /dev/null
+#include <stdio.h>\r
+\r
+#include <sndfile.h>\r
+\r
+int\r
+main (void)\r
+{\r
+ char buf [1024] ;\r
+\r
+ sf_command (NULL, SFC_GET_LIB_VERSION, buf, sizeof (buf)) ;\r
+ puts (buf) ;\r
+\r
+ return 0 ;\r
+}\r
--- /dev/null
+##\r
+## Auto Generated makefile by CodeLite IDE\r
+## any manual changes will be erased \r
+##\r
+## Release\r
+ProjectName :=test_sndfile\r
+ConfigurationName :=Release\r
+IntermediateDirectory :=./Release\r
+OutDir := $(IntermediateDirectory)\r
+WorkspacePath := "C:\Users\wittend\Projects\dvui"\r
+ProjectPath := "C:\Users\wittend\Projects\libsndfile\Projects\w32-mingw"\r
+CurrentFileName :=\r
+CurrentFilePath :=\r
+CurrentFileFullPath :=\r
+User :=wittend\r
+Date :=5/6/2012\r
+CodeLitePath :="C:\Program Files\CodeLite"\r
+LinkerName :=g++\r
+ArchiveTool :=ar rcus\r
+SharedObjectLinkerName :=g++ -shared -fPIC\r
+ObjectSuffix :=.o\r
+DependSuffix :=.o.d\r
+PreprocessSuffix :=.o.i\r
+DebugSwitch :=-gstab\r
+IncludeSwitch :=-I\r
+LibrarySwitch :=-l\r
+OutputSwitch :=-o \r
+LibraryPathSwitch :=-L\r
+PreprocessorSwitch :=-D\r
+SourceSwitch :=-c \r
+CompilerName :=g++\r
+C_CompilerName :=gcc\r
+OutputFile :=$(IntermediateDirectory)/$(ProjectName)\r
+Preprocessors :=\r
+ObjectSwitch :=-o \r
+ArchiveOutputSwitch := \r
+PreprocessOnlySwitch :=-E \r
+ObjectsFileList :="C:\Users\wittend\Projects\libsndfile\Projects\w32-mingw\test_sndfile.txt"\r
+PCHCompileFlags :=\r
+MakeDirCommand :=makedir\r
+CmpOptions := -O2 -Wall $(Preprocessors)\r
+C_CmpOptions := -O2 -Wall $(Preprocessors)\r
+LinkOptions := \r
+IncludePath := $(IncludeSwitch). $(IncludeSwitch). \r
+IncludePCH := \r
+RcIncludePath := \r
+Libs := $(LibrarySwitch)sndfile-1 \r
+LibPath := $(LibraryPathSwitch). \r
+\r
+\r
+##\r
+## User defined environment variables\r
+##\r
+CodeLiteDir:=C:\Program Files\CodeLite\r
+WXWIN:=C:\bin\wxWidgets-2.9.2\r
+PATH:=$(WXWIN)\lib\gcc_dll;$(PATH)\r
+WXCFG:=gcc_dll\mswu\r
+UNIT_TEST_PP_SRC_DIR:=C:\bin\UnitTest++-1.3\r
+Objects=$(IntermediateDirectory)/main$(ObjectSuffix) \r
+\r
+##\r
+## Main Build Targets \r
+##\r
+.PHONY: all clean PreBuild PrePreBuild PostBuild\r
+all: $(OutputFile)\r
+\r
+$(OutputFile): $(IntermediateDirectory)/.d $(Objects) \r
+ @$(MakeDirCommand) $(@D)\r
+ @echo "" > $(IntermediateDirectory)/.d\r
+ @echo $(Objects) > $(ObjectsFileList)\r
+ $(LinkerName) $(OutputSwitch)$(OutputFile) @$(ObjectsFileList) $(LibPath) $(Libs) $(LinkOptions)\r
+\r
+$(IntermediateDirectory)/.d:\r
+ @$(MakeDirCommand) "./Release"\r
+\r
+PreBuild:\r
+\r
+\r
+##\r
+## Objects\r
+##\r
+$(IntermediateDirectory)/main$(ObjectSuffix): main.cpp $(IntermediateDirectory)/main$(DependSuffix)\r
+ $(CompilerName) $(IncludePCH) $(SourceSwitch) "C:/Users/wittend/Projects/libsndfile/Projects/w32-mingw/main.cpp" $(CmpOptions) $(ObjectSwitch)$(IntermediateDirectory)/main$(ObjectSuffix) $(IncludePath)\r
+$(IntermediateDirectory)/main$(DependSuffix): main.cpp\r
+ @$(CompilerName) $(CmpOptions) $(IncludePCH) $(IncludePath) -MG -MP -MT$(IntermediateDirectory)/main$(ObjectSuffix) -MF$(IntermediateDirectory)/main$(DependSuffix) -MM "C:/Users/wittend/Projects/libsndfile/Projects/w32-mingw/main.cpp"\r
+\r
+$(IntermediateDirectory)/main$(PreprocessSuffix): main.cpp\r
+ @$(CompilerName) $(CmpOptions) $(IncludePCH) $(IncludePath) $(PreprocessOnlySwitch) $(OutputSwitch) $(IntermediateDirectory)/main$(PreprocessSuffix) "C:/Users/wittend/Projects/libsndfile/Projects/w32-mingw/main.cpp"\r
+\r
+\r
+-include $(IntermediateDirectory)/*$(DependSuffix)\r
+##\r
+## Clean\r
+##\r
+clean:\r
+ $(RM) $(IntermediateDirectory)/main$(ObjectSuffix)\r
+ $(RM) $(IntermediateDirectory)/main$(DependSuffix)\r
+ $(RM) $(IntermediateDirectory)/main$(PreprocessSuffix)\r
+ $(RM) $(OutputFile)\r
+ $(RM) $(OutputFile).exe\r
+ $(RM) "C:\Users\wittend\Projects\dvui\.build-release\test_sndfile"\r
+\r
+\r
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<CodeLite_Project Name="test_sndfile" InternalType="Console">
+ <Plugins>
+ <Plugin Name="qmake">
+ <![CDATA[00020001N0005Debug0000000000000001N0007Release000000000000]]>
+ </Plugin>
+ </Plugins>
+ <Description/>
+ <Dependencies/>
+ <VirtualDirectory Name="src">
+ <File Name="main.cpp"/>
+ </VirtualDirectory>
+ <Settings Type="Executable">
+ <GlobalSettings>
+ <Compiler Options="" C_Options="">
+ <IncludePath Value="."/>
+ </Compiler>
+ <Linker Options="">
+ <LibraryPath Value="."/>
+ </Linker>
+ <ResourceCompiler Options=""/>
+ </GlobalSettings>
+ <Configuration Name="Debug" CompilerType="gnu g++" DebuggerType="GNU gdb debugger" Type="Executable" BuildCmpWithGlobalSettings="append" BuildLnkWithGlobalSettings="append" BuildResWithGlobalSettings="append">
+ <Compiler Options="-g;-O0;-Wall" C_Options="-g;-O0;-Wall" Required="yes" PreCompiledHeader="" PCHInCommandLine="no" UseDifferentPCHFlags="no" PCHFlags="">
+ <IncludePath Value="."/>
+ </Compiler>
+ <Linker Options="" Required="yes">
+ <Library Value="libsndfile-1.dll"/>
+ </Linker>
+ <ResourceCompiler Options="" Required="no"/>
+ <General OutputFile="$(IntermediateDirectory)/$(ProjectName)" IntermediateDirectory="./Debug" Command="./$(ProjectName)" CommandArguments="" UseSeparateDebugArgs="no" DebugArguments="" WorkingDirectory="$(IntermediateDirectory)" PauseExecWhenProcTerminates="yes"/>
+ <Environment EnvVarSetName="<Use Defaults>" DbgSetName="<Use Defaults>">
+ <![CDATA[]]>
+ </Environment>
+ <Debugger IsRemote="no" RemoteHostName="" RemoteHostPort="" DebuggerPath="">
+ <PostConnectCommands/>
+ <StartupCommands/>
+ </Debugger>
+ <PreBuild/>
+ <PostBuild/>
+ <CustomBuild Enabled="no">
+ <RebuildCommand/>
+ <CleanCommand/>
+ <BuildCommand/>
+ <PreprocessFileCommand/>
+ <SingleFileCommand/>
+ <MakefileGenerationCommand/>
+ <ThirdPartyToolName>None</ThirdPartyToolName>
+ <WorkingDirectory/>
+ </CustomBuild>
+ <AdditionalRules>
+ <CustomPostBuild/>
+ <CustomPreBuild/>
+ </AdditionalRules>
+ <Completion>
+ <ClangCmpFlags/>
+ <ClangPP/>
+ <SearchPaths/>
+ </Completion>
+ </Configuration>
+ <Configuration Name="Release" CompilerType="gnu g++" DebuggerType="GNU gdb debugger" Type="Executable" BuildCmpWithGlobalSettings="append" BuildLnkWithGlobalSettings="append" BuildResWithGlobalSettings="append">
+ <Compiler Options="-O2;-Wall" C_Options="-O2;-Wall" Required="yes" PreCompiledHeader="" PCHInCommandLine="no" UseDifferentPCHFlags="no" PCHFlags="">
+ <IncludePath Value="."/>
+ </Compiler>
+ <Linker Options="" Required="yes">
+ <Library Value="libsndfile-1.dll"/>
+ </Linker>
+ <ResourceCompiler Options="" Required="no"/>
+ <General OutputFile="$(IntermediateDirectory)/$(ProjectName)" IntermediateDirectory="./Release" Command="./$(ProjectName)" CommandArguments="" UseSeparateDebugArgs="no" DebugArguments="" WorkingDirectory="$(IntermediateDirectory)" PauseExecWhenProcTerminates="yes"/>
+ <Environment EnvVarSetName="<Use Defaults>" DbgSetName="<Use Defaults>">
+ <![CDATA[]]>
+ </Environment>
+ <Debugger IsRemote="no" RemoteHostName="" RemoteHostPort="" DebuggerPath="">
+ <PostConnectCommands/>
+ <StartupCommands/>
+ </Debugger>
+ <PreBuild/>
+ <PostBuild/>
+ <CustomBuild Enabled="no">
+ <RebuildCommand/>
+ <CleanCommand/>
+ <BuildCommand/>
+ <PreprocessFileCommand/>
+ <SingleFileCommand/>
+ <MakefileGenerationCommand/>
+ <ThirdPartyToolName>None</ThirdPartyToolName>
+ <WorkingDirectory/>
+ </CustomBuild>
+ <AdditionalRules>
+ <CustomPostBuild/>
+ <CustomPreBuild/>
+ </AdditionalRules>
+ <Completion>
+ <ClangCmpFlags/>
+ <ClangPP/>
+ <SearchPaths/>
+ </Completion>
+ </Configuration>
+ </Settings>
+</CodeLite_Project>
--- /dev/null
+./Release/main.o \r
--- /dev/null
+#include <cstdio>\r
+\r
+#include <sndfile.h>\r
+\r
+int\r
+main (void)\r
+{\r
+ char buf [1024] ;\r
+\r
+ sf_command (NULL, SFC_GET_LIB_VERSION, buf, sizeof (buf)) ;\r
+ puts (buf) ;\r
+\r
+ return 0 ;\r
+}
\ No newline at end of file
--- /dev/null
+Microsoft Visual Studio Solution File, Format Version 7.00\r
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "test", "test.vcproj", "{A3CC29EE-FB2A-4B83-A364-595F5314A6DC}"\r
+EndProject\r
+Global\r
+ GlobalSection(SolutionConfiguration) = preSolution\r
+ ConfigName.0 = Debug\r
+ ConfigName.1 = Release\r
+ EndGlobalSection\r
+ GlobalSection(ProjectDependencies) = postSolution\r
+ EndGlobalSection\r
+ GlobalSection(ProjectConfiguration) = postSolution\r
+ {A3CC29EE-FB2A-4B83-A364-595F5314A6DC}.Debug.ActiveCfg = Debug|Win32\r
+ {A3CC29EE-FB2A-4B83-A364-595F5314A6DC}.Debug.Build.0 = Debug|Win32\r
+ {A3CC29EE-FB2A-4B83-A364-595F5314A6DC}.Release.ActiveCfg = Release|Win32\r
+ {A3CC29EE-FB2A-4B83-A364-595F5314A6DC}.Release.Build.0 = Release|Win32\r
+ EndGlobalSection\r
+ GlobalSection(ExtensibilityGlobals) = postSolution\r
+ EndGlobalSection\r
+ GlobalSection(ExtensibilityAddIns) = postSolution\r
+ EndGlobalSection\r
+EndGlobal\r
--- /dev/null
+<?xml version="1.0" encoding = "Windows-1252"?>\r
+<VisualStudioProject\r
+ ProjectType="Visual C++"\r
+ Version="7.00"\r
+ Name="test"\r
+ ProjectGUID="{A3CC29EE-FB2A-4B83-A364-595F5314A6DC}"\r
+ Keyword="Win32Proj">\r
+ <Platforms>\r
+ <Platform\r
+ Name="Win32"/>\r
+ </Platforms>\r
+ <Configurations>\r
+ <Configuration\r
+ Name="Debug|Win32"\r
+ OutputDirectory="Debug"\r
+ IntermediateDirectory="Debug"\r
+ ConfigurationType="1"\r
+ CharacterSet="2">\r
+ <Tool\r
+ Name="VCCLCompilerTool"\r
+ Optimization="0"\r
+ AdditionalIncludeDirectories=""..\..\include""\r
+ PreprocessorDefinitions="WIN32;_DEBUG;_CONSOLE"\r
+ MinimalRebuild="TRUE"\r
+ BasicRuntimeChecks="3"\r
+ RuntimeLibrary="5"\r
+ UsePrecompiledHeader="0"\r
+ WarningLevel="3"\r
+ Detect64BitPortabilityProblems="TRUE"\r
+ DebugInformationFormat="4"/>\r
+ <Tool\r
+ Name="VCCustomBuildTool"/>\r
+ <Tool\r
+ Name="VCLinkerTool"\r
+ AdditionalDependencies="libsndfile-1.lib"\r
+ OutputFile="$(OutDir)/test.exe"\r
+ LinkIncremental="2"\r
+ AdditionalLibraryDirectories=""..\..""\r
+ GenerateDebugInformation="TRUE"\r
+ ProgramDatabaseFile="$(OutDir)/test.pdb"\r
+ SubSystem="1"\r
+ TargetMachine="1"/>\r
+ <Tool\r
+ Name="VCMIDLTool"/>\r
+ <Tool\r
+ Name="VCPostBuildEventTool"/>\r
+ <Tool\r
+ Name="VCPreBuildEventTool"/>\r
+ <Tool\r
+ Name="VCPreLinkEventTool"/>\r
+ <Tool\r
+ Name="VCResourceCompilerTool"/>\r
+ <Tool\r
+ Name="VCWebServiceProxyGeneratorTool"/>\r
+ <Tool\r
+ Name="VCWebDeploymentTool"/>\r
+ </Configuration>\r
+ <Configuration\r
+ Name="Release|Win32"\r
+ OutputDirectory="Release"\r
+ IntermediateDirectory="Release"\r
+ ConfigurationType="1"\r
+ CharacterSet="2">\r
+ <Tool\r
+ Name="VCCLCompilerTool"\r
+ Optimization="2"\r
+ InlineFunctionExpansion="1"\r
+ OmitFramePointers="TRUE"\r
+ PreprocessorDefinitions="WIN32;NDEBUG;_CONSOLE"\r
+ StringPooling="TRUE"\r
+ RuntimeLibrary="4"\r
+ EnableFunctionLevelLinking="TRUE"\r
+ UsePrecompiledHeader="0"\r
+ WarningLevel="3"\r
+ Detect64BitPortabilityProblems="TRUE"\r
+ DebugInformationFormat="3"/>\r
+ <Tool\r
+ Name="VCCustomBuildTool"/>\r
+ <Tool\r
+ Name="VCLinkerTool"\r
+ OutputFile="$(OutDir)/test.exe"\r
+ LinkIncremental="1"\r
+ GenerateDebugInformation="TRUE"\r
+ SubSystem="1"\r
+ OptimizeReferences="2"\r
+ EnableCOMDATFolding="2"\r
+ TargetMachine="1"/>\r
+ <Tool\r
+ Name="VCMIDLTool"/>\r
+ <Tool\r
+ Name="VCPostBuildEventTool"/>\r
+ <Tool\r
+ Name="VCPreBuildEventTool"/>\r
+ <Tool\r
+ Name="VCPreLinkEventTool"/>\r
+ <Tool\r
+ Name="VCResourceCompilerTool"/>\r
+ <Tool\r
+ Name="VCWebServiceProxyGeneratorTool"/>\r
+ <Tool\r
+ Name="VCWebDeploymentTool"/>\r
+ </Configuration>\r
+ </Configurations>\r
+ <Files>\r
+ <Filter\r
+ Name="Source Files"\r
+ Filter="cpp;c;cxx;def;odl;idl;hpj;bat;asm">\r
+ <File\r
+ RelativePath="test.cc">\r
+ </File>\r
+ </Filter>\r
+ <Filter\r
+ Name="Header Files"\r
+ Filter="h;hpp;hxx;hm;inl;inc">\r
+ </Filter>\r
+ <Filter\r
+ Name="Resource Files"\r
+ Filter="rc;ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe">\r
+ </Filter>\r
+ </Files>\r
+ <Globals>\r
+ </Globals>\r
+</VisualStudioProject>\r
--- /dev/null
+#include <cstdio>\r
+\r
+#include <sndfile.h>\r
+\r
+int\r
+main (void)\r
+{\r
+ char buf [1024] ;\r
+\r
+ sf_command (NULL, SFC_GET_LIB_VERSION, buf, sizeof (buf)) ;\r
+ puts (buf) ;\r
+\r
+ return 0 ;\r
+}
\ No newline at end of file
--- /dev/null
+Microsoft Visual Studio Solution File, Format Version 10.00\r
+# Visual C++ Express 2008\r
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "test", "test.vcproj", "{A3CC29EE-FB2A-4B83-A364-595F5314A6DC}"\r
+EndProject\r
+Global\r
+ GlobalSection(SolutionConfigurationPlatforms) = preSolution\r
+ Debug|Win32 = Debug|Win32\r
+ Release|Win32 = Release|Win32\r
+ EndGlobalSection\r
+ GlobalSection(ProjectConfigurationPlatforms) = postSolution\r
+ {A3CC29EE-FB2A-4B83-A364-595F5314A6DC}.Debug|Win32.ActiveCfg = Debug|Win32\r
+ {A3CC29EE-FB2A-4B83-A364-595F5314A6DC}.Debug|Win32.Build.0 = Debug|Win32\r
+ {A3CC29EE-FB2A-4B83-A364-595F5314A6DC}.Release|Win32.ActiveCfg = Release|Win32\r
+ {A3CC29EE-FB2A-4B83-A364-595F5314A6DC}.Release|Win32.Build.0 = Release|Win32\r
+ EndGlobalSection\r
+ GlobalSection(SolutionProperties) = preSolution\r
+ HideSolutionNode = FALSE\r
+ EndGlobalSection\r
+EndGlobal\r
--- /dev/null
+<?xml version="1.0" encoding="Windows-1252"?>\r
+<VisualStudioProject\r
+ ProjectType="Visual C++"\r
+ Version="9.00"\r
+ Name="test"\r
+ ProjectGUID="{A3CC29EE-FB2A-4B83-A364-595F5314A6DC}"\r
+ Keyword="Win32Proj"\r
+ TargetFrameworkVersion="131072"\r
+ >\r
+ <Platforms>\r
+ <Platform\r
+ Name="Win32"\r
+ />\r
+ </Platforms>\r
+ <ToolFiles>\r
+ </ToolFiles>\r
+ <Configurations>\r
+ <Configuration\r
+ Name="Debug|Win32"\r
+ OutputDirectory="Debug"\r
+ IntermediateDirectory="Debug"\r
+ ConfigurationType="1"\r
+ InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC70.vsprops"\r
+ CharacterSet="2"\r
+ >\r
+ <Tool\r
+ Name="VCPreBuildEventTool"\r
+ />\r
+ <Tool\r
+ Name="VCCustomBuildTool"\r
+ />\r
+ <Tool\r
+ Name="VCXMLDataGeneratorTool"\r
+ />\r
+ <Tool\r
+ Name="VCWebServiceProxyGeneratorTool"\r
+ />\r
+ <Tool\r
+ Name="VCMIDLTool"\r
+ />\r
+ <Tool\r
+ Name="VCCLCompilerTool"\r
+ Optimization="0"\r
+ AdditionalIncludeDirectories=""..\..\include""\r
+ PreprocessorDefinitions="WIN32;_DEBUG;_CONSOLE"\r
+ MinimalRebuild="true"\r
+ BasicRuntimeChecks="3"\r
+ RuntimeLibrary="1"\r
+ UsePrecompiledHeader="0"\r
+ WarningLevel="3"\r
+ Detect64BitPortabilityProblems="false"\r
+ DebugInformationFormat="4"\r
+ />\r
+ <Tool\r
+ Name="VCManagedResourceCompilerTool"\r
+ />\r
+ <Tool\r
+ Name="VCResourceCompilerTool"\r
+ />\r
+ <Tool\r
+ Name="VCPreLinkEventTool"\r
+ />\r
+ <Tool\r
+ Name="VCLinkerTool"\r
+ AdditionalDependencies="libsndfile-1.lib"\r
+ OutputFile="$(OutDir)/test.exe"\r
+ LinkIncremental="2"\r
+ AdditionalLibraryDirectories=""..\..""\r
+ GenerateDebugInformation="true"\r
+ ProgramDatabaseFile="$(OutDir)/test.pdb"\r
+ SubSystem="1"\r
+ RandomizedBaseAddress="1"\r
+ DataExecutionPrevention="0"\r
+ TargetMachine="1"\r
+ />\r
+ <Tool\r
+ Name="VCALinkTool"\r
+ />\r
+ <Tool\r
+ Name="VCManifestTool"\r
+ />\r
+ <Tool\r
+ Name="VCXDCMakeTool"\r
+ />\r
+ <Tool\r
+ Name="VCBscMakeTool"\r
+ />\r
+ <Tool\r
+ Name="VCFxCopTool"\r
+ />\r
+ <Tool\r
+ Name="VCAppVerifierTool"\r
+ />\r
+ <Tool\r
+ Name="VCPostBuildEventTool"\r
+ />\r
+ </Configuration>\r
+ <Configuration\r
+ Name="Release|Win32"\r
+ OutputDirectory="Release"\r
+ IntermediateDirectory="Release"\r
+ ConfigurationType="1"\r
+ InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC70.vsprops"\r
+ CharacterSet="2"\r
+ >\r
+ <Tool\r
+ Name="VCPreBuildEventTool"\r
+ />\r
+ <Tool\r
+ Name="VCCustomBuildTool"\r
+ />\r
+ <Tool\r
+ Name="VCXMLDataGeneratorTool"\r
+ />\r
+ <Tool\r
+ Name="VCWebServiceProxyGeneratorTool"\r
+ />\r
+ <Tool\r
+ Name="VCMIDLTool"\r
+ />\r
+ <Tool\r
+ Name="VCCLCompilerTool"\r
+ Optimization="2"\r
+ InlineFunctionExpansion="1"\r
+ OmitFramePointers="true"\r
+ PreprocessorDefinitions="WIN32;NDEBUG;_CONSOLE"\r
+ StringPooling="true"\r
+ RuntimeLibrary="0"\r
+ EnableFunctionLevelLinking="true"\r
+ UsePrecompiledHeader="0"\r
+ WarningLevel="3"\r
+ Detect64BitPortabilityProblems="true"\r
+ DebugInformationFormat="3"\r
+ />\r
+ <Tool\r
+ Name="VCManagedResourceCompilerTool"\r
+ />\r
+ <Tool\r
+ Name="VCResourceCompilerTool"\r
+ />\r
+ <Tool\r
+ Name="VCPreLinkEventTool"\r
+ />\r
+ <Tool\r
+ Name="VCLinkerTool"\r
+ OutputFile="$(OutDir)/test.exe"\r
+ LinkIncremental="1"\r
+ GenerateDebugInformation="true"\r
+ SubSystem="1"\r
+ OptimizeReferences="2"\r
+ EnableCOMDATFolding="2"\r
+ RandomizedBaseAddress="1"\r
+ DataExecutionPrevention="0"\r
+ TargetMachine="1"\r
+ />\r
+ <Tool\r
+ Name="VCALinkTool"\r
+ />\r
+ <Tool\r
+ Name="VCManifestTool"\r
+ />\r
+ <Tool\r
+ Name="VCXDCMakeTool"\r
+ />\r
+ <Tool\r
+ Name="VCBscMakeTool"\r
+ />\r
+ <Tool\r
+ Name="VCFxCopTool"\r
+ />\r
+ <Tool\r
+ Name="VCAppVerifierTool"\r
+ />\r
+ <Tool\r
+ Name="VCPostBuildEventTool"\r
+ />\r
+ </Configuration>\r
+ </Configurations>\r
+ <References>\r
+ </References>\r
+ <Files>\r
+ <Filter\r
+ Name="Source Files"\r
+ Filter="cpp;c;cxx;def;odl;idl;hpj;bat;asm"\r
+ >\r
+ <File\r
+ RelativePath="test.cc"\r
+ >\r
+ </File>\r
+ </Filter>\r
+ <Filter\r
+ Name="Header Files"\r
+ Filter="h;hpp;hxx;hm;inl;inc"\r
+ >\r
+ </Filter>\r
+ <Filter\r
+ Name="Resource Files"\r
+ Filter="rc;ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe"\r
+ >\r
+ </Filter>\r
+ </Files>\r
+ <Globals>\r
+ </Globals>\r
+</VisualStudioProject>\r
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">\r
+<HTML>\r
+\r
+<HEAD>\r
+ <TITLE>\r
+ libsndfile : Frequently Asked Questions.\r
+ </TITLE>\r
+ <META NAME="Author" CONTENT="Erik de Castro Lopo (erikd AT mega-nerd DOT com)">\r
+ <META NAME="Description" CONTENT="The libsndfile FAQ.">\r
+ <META NAME="Keywords" CONTENT="WAV AIFF AU libsndfile sound audio dsp Linux">\r
+ <LINK REL="stylesheet" HREF="libsndfile.css" TYPE="text/css" MEDIA="all">\r
+ <LINK REL="stylesheet" HREF="print.css" TYPE="text/css" MEDIA="print">\r
+</HEAD>\r
+\r
+<BODY>\r
+\r
+<H1><B>libsndfile : Frequently Asked Questions.</B></H1>\r
+<P>\r
+<A HREF="#Q001">Q1 : Do you plan to support XYZ codec in libsndfile?</A><BR/>\r
+<A HREF="#Q002">Q2 : In version 0 the SF_INFO struct had a pcmbitwidth field\r
+ but version 1 does not. Why?</A><BR/>\r
+<A HREF="#Q003">Q3 : Compiling is really slow on MacOS X. Why?</A><BR/>\r
+<A HREF="#Q004">Q4 : When trying to compile libsndfile on Solaris I get a "bad\r
+ substitution" error during linking. What can I do to fix this?</A><BR/>\r
+<A HREF="#Q005">Q5 : Why doesn't libsndfile do interleaving/de-interleaving?</A><BR/>\r
+<A HREF="#Q006">Q6 : What's the best format for storing temporary files?</A><BR/>\r
+<A HREF="#Q007">Q7 : On Linux/Unix/MacOS X, what's the best way of detecting the\r
+ presence of libsndfile?</A><BR/>\r
+<A HREF="#Q008">Q8 : But I just want a simple Makefile! What do I do?</A><BR/>\r
+<A HREF="#Q009">Q9 : How about adding the ability to write/read sound files to/from\r
+ memory buffers?</A><BR/>\r
+<A HREF="#Q010">Q10 : Reading a 16 bit PCM file as normalised floats and then\r
+ writing them back changes some sample values. Why?</A><BR/>\r
+<A HREF="#Q011">Q11 : I'm having problems with u-law encoded WAV files generated by\r
+ libsndfile in Winamp. Why?</A><BR/>\r
+<A HREF="#Q012">Q12 : I'm looking at sf_read*. What are items? What are frames?</A><BR/>\r
+<A HREF="#Q013">Q13 : Why can't libsndfile open this Sound Designer II (SD2)\r
+ file?</A><BR/>\r
+<A HREF="#Q014">Q14 : I'd like to statically link libsndfile to my closed source\r
+ application. Can I buy a license so that this is possible?</A><BR/>\r
+<A HREF="#Q015">Q15 : My program is crashing during a call to a function in libsndfile.\r
+ Is this a bug in libsndfile?</A><BR/>\r
+<A HREF="#Q016">Q16 : Will you accept a fix for compiling libsndfile with compiler X?\r
+ </A><BR/>\r
+<A HREF="#Q017">Q17 : Can libsndfile read/write files from/to UNIX pipes?\r
+ </A><BR/>\r
+<A HREF="#Q018">Q18 : Is it possible to build a Universal Binary on Mac OS X?\r
+ </A><BR/>\r
+<A HREF="#Q019">Q19 : I have project files for Visual Studio / XCode / Whatever. Why\r
+ don't you distribute them with libsndfile?\r
+ </A><BR/>\r
+<A HREF="#Q020">Q20 : Why doesn't libsndfile support MP3? Lots of other Open Source\r
+ projects support it!\r
+ </A><BR/>\r
+<A HREF="#Q021">Q21 : How do I use libsndfile in a closed source or commercial program\r
+ and comply with the license?\r
+ </A><BR/>\r
+<A HREF="#Q022">Q22 : What versions of windows does libsndfile work on?\r
+ </A><BR/>\r
+<A HREF="#Q023">Q23 : I'm cross compiling libsndfile for another platform. How can I\r
+ run the test suite?\r
+ </A><BR/>\r
+<HR>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="Q001"></A>\r
+<H2><BR/><B>Q1 : Do you plan to support XYZ codec in libsndfile?</B></H2>\r
+<P>\r
+If source code for XYZ codec is available under a suitable license (LGPL, BSD,\r
+MIT etc) then yes, I'd like to add it.\r
+</P>\r
+<P>\r
+If suitable documentation is available on how to decode and encode the format\r
+then maybe, depending on how much work is involved.\r
+</P>\r
+<P>\r
+If XYZ is some proprietary codec where no source code or documentation is\r
+available then no.\r
+</P>\r
+<P>\r
+So if you want support for XYZ codec, first find existing source code or\r
+documentation.\r
+If you can't find either then the answer is no.\r
+</P>\r
+<!-- ========================================================================= -->\r
+<A NAME="Q002"></A>\r
+<H2><BR/><B>Q2 : In version 0 the SF_INFO struct had a pcmbitwidth field\r
+ but version 1 does not. Why?</B></H2>\r
+<P>\r
+ This was dropped for a number of reasons:\r
+</P>\r
+<UL>\r
+ <LI> pcmbitwidth makes little sense on compressed or floating point formats\r
+ <LI> with the new API you really don't need to know it\r
+</UL>\r
+<P>\r
+As documented\r
+ <A HREF="http://www.mega-nerd.com/libsndfile/api.html#note1">here</A>\r
+there is now a well defined behaviour which ensures that no matter what the\r
+bit width of the source file, the scaling always does something sensible.\r
+This makes it safe to read 8, 16, 24 and 32 bit PCM files using sf_read_short()\r
+and always have the optimal behaviour.\r
+</P>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="Q003"></A>\r
+<H2><BR/><B>Q3 : Compiling is really slow on MacOS X. Why?</B></H2>\r
+<P>\r
+When you configure and compile libsndfile, it uses the /bin/sh shell for a number\r
+of tasks (ie configure script and libtool).\r
+Older versions of OS X (10.2?) shipped a really crappy Bourne shell as /bin/sh\r
+which resulted in <b>really</b> slow compiles.\r
+Newer version of OS X ship GNU Bash as /bin/sh and this answer doesn't apply in that\r
+case.\r
+</P>\r
+<P>\r
+To fix this I suggest that you install the GNU Bash shell, rename /bin/sh to\r
+/bin/sh.old and make a symlink from /bin/sh to the bash shell.\r
+Bash is designed to behave as a Bourne shell when is is called as /bin/sh.\r
+</P>\r
+<P>\r
+When I did this on my iBook running MacOS X, compile times dropped from 13 minutes\r
+to 3 minutes.\r
+</P>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="Q004"></A>\r
+<H2><BR/><B>Q4 : When trying to compile libsndfile on Solaris I get a "bad\r
+ substitution" error on linking. Why?</B></H2>\r
+<P>\r
+It seems that the Solaris Bourne shell disagrees with GNU libtool.\r
+</P>\r
+<P>\r
+To fix this I suggest that you install the GNU Bash shell, rename /bin/sh to\r
+/bin/sh.old and make a symlink from /bin/sh to the bash shell.\r
+Bash is designed to behave as a Bourne shell when is is called as /bin/sh.\r
+</P>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="Q005"></A>\r
+<H2><BR/><B>Q5 : Why doesn't libsndfile do interleaving/de-interleaving?</B></H2>\r
+<P>\r
+This problem is bigger than it may seem at first.\r
+</P>\r
+<P>\r
+For a stereo file, it is a pretty safe bet that a simple interleaving/de-interleaving\r
+could satisfy most users.\r
+However, for files with more than 2 channels this is unlikely to be the case.\r
+If the user has a 4 channel file and want to play that file on a stereo output\r
+sound card they either want the first 2 channels or they want some mixed combination\r
+of the 4 channels.\r
+</P>\r
+<P>\r
+When you add more channels, the combinations grow exponentially and it becomes\r
+increasingly difficult to cover even a sensible subset of the possible combinations.\r
+On top of that, coding any one style of interleaver/de-interleaver is trivial, while\r
+coding one that can cover all combinations is far from trivial.\r
+This means that this feature will not be added any time soon.\r
+</P>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="Q006"></A>\r
+<H2><BR/><B>Q6 : What's the best format for storing temporary files?</B></H2>\r
+\r
+<P>\r
+When you want to store temporary data there are a number of requirements;\r
+</P>\r
+<UL>\r
+ <LI> A simple, easy to parse header.\r
+ <LI> The format must provide the fastest possible read and write rates (ie\r
+ avoid conversions and encoding/decoding).\r
+ <LI> The file format must be reasonably common and playable by most players.\r
+ <LI> Able to store data in either endian-ness.\r
+</UL>\r
+<P>\r
+The format which best meets these requirements is AU, which allows data to be\r
+stored in any one of short, int, float and double (among others) formats.\r
+</P>\r
+<P>\r
+For instance, if an application uses float data internally, its temporary files\r
+should use a format of (SF_ENDIAN_CPU | SF_FORMAT_AU | SF_FORMAT_FLOAT) which\r
+will store big endian float data in big endian CPUs and little endian float data\r
+on little endian CPUs.\r
+Reading and writing this format will not require any conversions or byte swapping\r
+regardless of the host CPU.\r
+</P>\r
+\r
+<!-- ========================================================================= -->\r
+\r
+<A NAME="Q007"></A>\r
+<H2><BR/><B>Q7 : On Linux/Unix/MaxOS X, what's the best way of detecting the presence\r
+ of libsndfile using autoconf?</B></H2>\r
+\r
+<P>\r
+libsndfile uses the pkg-config (man pkg-config) method of registering itself with the\r
+host system.\r
+The best way of detecting its presence is using something like this in configure.ac\r
+(or configure.in):\r
+</P>\r
+<PRE>\r
+ PKG_CHECK_MODULES(SNDFILE, sndfile >= 1.0.2, ac_cv_sndfile=1, ac_cv_sndfile=0)\r
+\r
+ AC_DEFINE_UNQUOTED([HAVE_SNDFILE],${ac_cv_sndfile},\r
+ [Set to 1 if you have libsndfile.])\r
+\r
+ AC_SUBST(SNDFILE_CFLAGS)\r
+ AC_SUBST(SNDFILE_LIBS)\r
+</PRE>\r
+<P>\r
+This will automatically set the <B>SNDFILE_CFLAGS</B> and <B>SNDFILE_LIBS</B>\r
+variables which can be used in Makefile.am like this:\r
+</P>\r
+<PRE>\r
+ SNDFILE_CFLAGS = @SNDFILE_CFLAGS@\r
+ SNDFILE_LIBS = @SNDFILE_LIBS@\r
+</PRE>\r
+<P>\r
+If you install libsndfile from source, you will probably need to set the\r
+<B>PKG_CONFIG_PATH</B> environment variable as suggested at the end of the\r
+libsndfile configure process. For instance on my system I get this:\r
+</P>\r
+<PRE>\r
+ -=-=-=-=-=-=-=-=-=-= Configuration Complete =-=-=-=-=-=-=-=-=-=-\r
+\r
+ Configuration summary :\r
+\r
+ Version : ..................... 1.0.5\r
+ Experimental code : ........... no\r
+\r
+ Tools :\r
+\r
+ Compiler is GCC : ............. yes\r
+ GCC major version : ........... 3\r
+\r
+ Installation directories :\r
+\r
+ Library directory : ........... /usr/local/lib\r
+ Program directory : ........... /usr/local/bin\r
+ Pkgconfig directory : ......... /usr/local/lib/pkgconfig\r
+\r
+ Compiling some other packages against libsndfile may require\r
+ the addition of "/usr/local/lib/pkgconfig" to the\r
+ PKG_CONFIG_PATH environment variable.\r
+</PRE>\r
+\r
+<!-- ========================================================================= -->\r
+\r
+<A NAME="Q008"></A>\r
+<H2><BR/><B>Q8 : But I just want a simple Makefile! What do I do?</B></H2>\r
+\r
+<P>\r
+The <B>pkg-config</B> program makes finding the correct compiler flag values and\r
+library location far easier.\r
+During the installation of libsndfile, a file named <B>sndfile.pc</B> is installed\r
+in the directory <B>${libdir}/pkgconfig</B> (ie if libsndfile is installed in\r
+<B>/usr/local/lib</B>, <B>sndfile.pc</B> will be installed in\r
+<B>/usr/local/lib/pkgconfig/</B>).\r
+</P>\r
+<P>\r
+In order for pkg-config to find sndfile.pc it may be necessary to point the\r
+environment variable <B>PKG_CONFIG_PATH</B> in the right direction.\r
+</P>\r
+<PRE>\r
+ export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig\r
+</PRE>\r
+\r
+<P>\r
+Then, to compile a C file into an object file, the command would be:\r
+</P>\r
+<PRE>\r
+ gcc `pkg-config --cflags sndfile` -c somefile.c\r
+</PRE>\r
+<P>\r
+and to link a number of objects into an executable that links against libsndfile,\r
+the command would be:\r
+</P>\r
+<PRE>\r
+ gcc `pkg-config --libs sndfile` obj1.o obj2.o -o program\r
+</PRE>\r
+\r
+<!-- ========================================================================= -->\r
+\r
+<A NAME="Q009"></A>\r
+<H2><BR/><B>Q9 : How about adding the ability to write/read sound files to/from\r
+ memory buffers?</B></H2>\r
+\r
+<P>\r
+This has been added for version 1.0.13.\r
+</P>\r
+\r
+<!-- ========================================================================= -->\r
+\r
+<A NAME="Q010"></A>\r
+<H2><BR/><B>Q10 : Reading a 16 bit PCM file as normalised floats and then\r
+ writing them back changes some sample values. Why?</B></H2>\r
+\r
+<P>\r
+This is caused by the fact that the conversion from 16 bit short to float is\r
+done by dividing by 32768 (0x8000 in hexadecimal) while the conversion from\r
+float to 16 bit short is done by multiplying by 32767 (0x7FFF in hex).\r
+So for instance, a value in a 16 bit PCM file of 20000 gets read as a floating\r
+point number of 0.6103515625 (20000.0 / 0x8000).\r
+Converting that back to a 16 bit short results in a value of 19999.3896484375\r
+(0.6103515625 * 0x7FFF) which then gets rounded down to 19999.\r
+</P>\r
+<P>\r
+You will notice that for this particular case, the error is 1 in 20000 or\r
+0.005%.\r
+Interestingly, for values of less than 16369, dividing by 0x8000 followed\r
+by multiplying by 0x7FFF and then rounding the result, gives back the\r
+original value.\r
+It turns out that as long as the host operating system supplies the 1999 ISO\r
+C Standard functions <B>lrintf</B> and <B>lrint</B> (or a replacement has\r
+been supplied) then the maximum possible error is 1 in 16369 or about 0.006%.\r
+</P>\r
+<P>\r
+Regardless of the size of the error, the reason why this is done is rather\r
+subtle.\r
+</P>\r
+<P>\r
+In a file containing 16 bit PCM samples, the values are restricted to the range\r
+[-32768, 32767] while we want floating point values in the range [-1.0, 1.0].\r
+The only way to do this conversion is to do a floating point division by a value\r
+of 0x8000.\r
+Converting the other way, the only way to ensure that floating point values in\r
+the range [-1.0, 1.0] are within the valid range allowed by a 16 bit short is\r
+to multiply by 0x7FFF.\r
+</P>\r
+<P>\r
+Some people would say that this is a severe short-coming of libsndfile.\r
+I would counter that anybody who is constantly converting back and forth\r
+between 16 bit shorts and normalised floats is going to suffer other losses\r
+in audio quality that they should also be concerned about.\r
+</P>\r
+<P>\r
+Since this problem only occurs when converting between integer data on disk and\r
+normalized floats in the application, it can be avoided by using something\r
+other than normalized floats in the application.\r
+Alternatives to normalized floats are the <b>short</b> and <b>int</b> data\r
+types (ie using sf_read_short or sf_read_int) or using un-normalized floats\r
+(see\r
+ <a href="http://www.mega-nerd.com/libsndfile/command.html#SFC_SET_NORM_FLOAT">\r
+ SFC_SET_NORM_FLOAT</a>).\r
+</P>\r
+<P>\r
+Another way to deal with this problem is to consider 16 bit short data as a\r
+final destination format only, not as an intermediate storage format.\r
+All intermediate data (ie which is going to be processed further) should be\r
+stored in floating point format which is supported by all of the most common\r
+file formats.\r
+If floating point files are considered too large (2 times the size of a 16 bit\r
+PCM file), it would also be possible to use 24 bit PCM as an intermediate\r
+storage format (and which is also supported by most common file types).\r
+</P>\r
+\r
+<!-- ========================================================================= -->\r
+\r
+<A NAME="Q011"></A>\r
+<H2><BR/><B>Q11 : I'm having problems with u-law encoded WAV files generated by\r
+ libsndfile in Winamp. Why?\r
+</B></H2>\r
+\r
+<P>\r
+This is actually a Winamp problem.\r
+The official Microsoft spec suggests that the 'fmt ' chunk should be 18 bytes.\r
+Unfortunately at least one of Microsoft's own applications (Sound Recorder on\r
+Win98 I believe) did not accept 18 bytes 'fmt ' chunks.\r
+</P>\r
+<P>\r
+Michael Lee did some experimenting and found that:\r
+</P>\r
+<PRE>\r
+ I have checked that Windows Media Player 9, QuickTime Player 6.4,\r
+ RealOne Player 2.0 and GoldWave 5.06 can all play u-law files with\r
+ 16-byte or 18-byte 'fmt ' chunk. Only Winamp (2.91) and foobar2000\r
+ are unable to play u-law files with 16-byte 'fmt ' chunk.\r
+</PRE>\r
+\r
+<P>\r
+Even this is a very small sampling of all the players out there.\r
+For that reason it is probably not a good idea to change this now because there\r
+is the risk of breaking something that currently works.\r
+</P>\r
+\r
+<!-- ========================================================================= -->\r
+\r
+<A NAME="Q012"></A>\r
+<H2><BR/><B>Q12 : I'm looking at sf_read*. What are items? What are frames?\r
+</B></H2>\r
+\r
+<P>\r
+An <tt>item</tt>tt> is a single sample of the data type you are reading; ie a\r
+single <tt>short</tt> value for <tt>sf_read_short</tt> or a single <tt>float</tt>\r
+for <tt>sf_read_float</tt>.\r
+</P>\r
+\r
+For a sound file with only one channel, a frame is the same as a item (ie a\r
+single sample) while for multi channel sound files, a single frame contains a\r
+single item for each channel.\r
+</P>\r
+\r
+<P>\r
+Here are two simple, correct examples, both of which are assumed to be working\r
+on a stereo file, first using items:\r
+</P>\r
+\r
+<PRE>\r
+ #define CHANNELS 2\r
+ short data [CHANNELS * 100] ;\r
+ sf_count items_read = sf_read_short (file, data, 200) ;\r
+ assert (items_read == 200) ;\r
+</PRE>\r
+\r
+<P>\r
+and now readng the exact same amount of data using frames:\r
+</P>\r
+\r
+<PRE>\r
+ #define CHANNELS 2\r
+ short data [CHANNELS * 100] ;\r
+ sf_count frames_read = sf_readf_short (file, data, 100) ;\r
+ assert (frames_read == 100) ;\r
+</PRE>\r
+\r
+<!-- ========================================================================= -->\r
+\r
+<A NAME="Q013"></A>\r
+<H2><BR/><B>Q13 : Why can't libsndfile open this Sound Designer II (SD2) file?\r
+</B></H2>\r
+\r
+<P>\r
+This is somewhat complicated.\r
+First some background.\r
+</P>\r
+\r
+<P>\r
+SD2 files are native to the Apple Macintosh platform and use features of\r
+the Mac filesystem (file resource forks) to store the file's sample rate,\r
+number of channels, sample width and more.\r
+When you look at a file and its resource fork on Mac OS X it looks like\r
+this:\r
+</P>\r
+\r
+<PRE>\r
+ -rw-r--r-- 1 erikd erikd 46512 Oct 18 22:57 file.sd2\r
+ -rw-r--r-- 1 erikd erikd 538 Oct 18 22:57 file.sd2/rsrc\r
+</PRE>\r
+\r
+<P>\r
+Notice how the file itself looks like a directory containing a single file\r
+named <B>rsrc</B>.\r
+When libsndfile is compiled for MacOS X, it should open (for write and read)\r
+SD2 file with resource forks like this without any problems.\r
+It will also handle files with the resource fork in a separate file as\r
+described below.\r
+</P>\r
+\r
+<P>\r
+When SD2 files are moved to other platforms, the resource fork of the file\r
+can sometimes be dropped altogether.\r
+All that remains is the raw audio data and no information about the number\r
+of channels, sample rate or bit width which makes it a little difficult for\r
+libsndfile to open the file.\r
+</P>\r
+\r
+<P>\r
+However, it is possible to safely move an SD2 file to a Linux or Windows\r
+machine.\r
+For instance, when an SD2 file is copied from inside MacOS X to a windows\r
+shared directory or a Samba share (ie Linux), MacOS X is clever enough to\r
+store the resource fork of the file in a separate hidden file in the\r
+same directory like this:\r
+</P>\r
+<PRE>\r
+ -rw-r--r-- 1 erikd erikd 538 Oct 18 22:57 ._file.sd2\r
+ -rw-r--r-- 1 erikd erikd 46512 Oct 18 22:57 file.sd2\r
+</PRE>\r
+\r
+<P>\r
+Regardless of what platform it is running on, when libsndfile is asked to\r
+open a file named <B>"foo"</B> and it can't recognize the file type from\r
+the data in the file, it will attempt to open the resource fork and if\r
+that fails, it then tries to open a file named <B>"._foo"</B> to see if\r
+the file has a valid resource fork.\r
+This is the same regardless of whether the file is being opened for read\r
+or write.\r
+</P>\r
+\r
+<P>\r
+In short, libsndfile should open SD2 files with a valid resource fork on\r
+all of the platforms that libsndfile supports.\r
+If a file has lost its resource fork, the only option is the open the file\r
+using the SF_FORMAT_RAW option and guessing its sample rate, channel count\r
+and bit width.\r
+</P>\r
+\r
+<P>\r
+Occasionally, when SD2 files are moved to other systems, the file is\r
+ <A HREF="http://www.macdisk.com/binhexen.php3">BinHexed</A>\r
+which wraps the resource fork and the data fork together.\r
+For these files, it would be possible to write a BinHex parser but\r
+there is not a lot to gain considering how rare these BinHexed SD2\r
+files are.\r
+</P>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="Q014"></A>\r
+<H2><BR/><B>Q14 : I'd like to statically link libsndfile to my closed source\r
+ application. Can I buy a license so that this is possible?\r
+</B></H2>\r
+\r
+<P>\r
+Unfortunately no.\r
+libsndfile contains code written by other people who have agreed that their\r
+code be used under the GNU LGPL but no more.\r
+Even if they were to agree, there would be significant difficulties in\r
+dividing up the payments fairly.\r
+</P>\r
+\r
+<P>\r
+The <B>only</B> way you can legally use libsndfile as a statically linked\r
+library is if your application is released under the GNU GPL or LGPL.\r
+</P>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="Q015"></A>\r
+<H2><BR/><B>Q15 : My program is crashing during a call to a function in libsndfile.\r
+ Is this a bug in libsndfile?\r
+</B></H2>\r
+\r
+<P>\r
+libsndfile is being used by large numbers of people all over the world\r
+without any problems like this. That means that it is much more likely\r
+that your code has a bug than libsndfile. However, it is still possible\r
+that there is a bug in libsndfile.\r
+</P>\r
+<P>\r
+To figure out whether it is your code or libsndfile you should do the\r
+following:\r
+</P>\r
+ <UL>\r
+ <LI>Make sure you are compiling your code with warnings switched on and\r
+ that you fix as many warnings as possible.\r
+ With the GNU compiler (gcc) I would recommend at least\r
+ <B>-W -Wall -Werror</B> which will force you to fix all warnings\r
+ before you can run the code.\r
+ <LI>Try using a memory debugger.\r
+ <A HREF="http://valgrind.kde.org/">Valgrind</A> on x86 Linux is excellent.\r
+ <A HREF="http://www.ibm.com/software/awdtools/purify/">Purify</A> also\r
+ has a good reputation.\r
+ <LI>If the code is clean after the above two steps and you still get\r
+ a crash in libsndfile, then send me a small snippet of code (no\r
+ more than 30-40 lines) which includes the call to sf_open() and\r
+ also shows how all variables passed to/returned from sf_open()\r
+ are defined.\r
+ </UL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="Q016"></A>\r
+<H2><BR/><B>Q16 : Will you accept a fix for compiling libsndfile with compiler X?\r
+</B></H2>\r
+\r
+<P>\r
+If compiler X is a C++ compiler then no.\r
+C and C++ are different enough to make writing code that compiles as valid C\r
+and valid C++ too difficult.\r
+I would rather spend my time fixing bugs and adding features.\r
+</P>\r
+\r
+<P>\r
+If compiler X is a C compiler then I will do what I can as long as that does\r
+not hamper the correctness, portability and maintainability of the existing\r
+code.\r
+It should be noted however that libsndfile uses features specified by the 1999\r
+ISO C Standard.\r
+This can make compiling libsndfile with some older compilers difficult.\r
+</P>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="Q017"></A>\r
+<H2><BR/><B>Q17 : Can libsndfile read/write files from/to UNIX pipes?\r
+</B></H2>\r
+\r
+<P>\r
+Yes, libsndfile can read files from pipes.\r
+Unfortunately, the write case is much more complicated.\r
+</P>\r
+\r
+<P>\r
+File formats like AIFF and WAV have information at the start of the file (the\r
+file header) which states the length of the file, the number of sample frames\r
+etc.\r
+This information must be filled in correctly when the file header is written,\r
+but this information is not reliably known until the file is closed.\r
+This means that libsndfile cannot write AIFF, WAV and many other file types\r
+to a pipe.\r
+</P>\r
+\r
+<P>\r
+However, there is at least one file format (AU) which is specifically designed\r
+to be written to a pipe.\r
+Like AIFF and WAV, AU has a header with a sample frames field, but it is\r
+specifically allowable to set that frames field to 0x7FFFFFFF if the file\r
+length is not known when the header is written.\r
+The AU file format can also hold data in many of the standard formats (ie\r
+SF_FORMAT_PCM_16, SF_FORMAT_PCM_24, SF_FORMAT_FLOAT etc) as well as allowing\r
+data in both big and little endian format.\r
+</P>\r
+\r
+<P>\r
+See also <A HREF="#Q006">FAQ Q6</A>.\r
+</P>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="Q018"></A>\r
+<H2><BR/><B>Q18 : Is it possible to build a Universal Binary on Mac OS X?\r
+</B></H2>\r
+\r
+<P>\r
+Yes, but you must do two separate configure/build/test runs; one on PowerPC\r
+and one on Intel.\r
+It is then possible to merge the binaries into a single universal binary using\r
+one of the programs in the Apple tool chain.\r
+</P>\r
+\r
+<P>\r
+It is <b>not</b> possible to build a working universal binary via a single\r
+compile/build run on a single CPU.\r
+</P>\r
+\r
+<P>\r
+The problem is that the libsndfile build process detects features of the CPU its\r
+being built for during the configure process and when building a universal binary,\r
+configure is only run once and that data is then used for both CPUs.\r
+That configure data will be wrong for one of those CPUs.\r
+You will still be able to compile libsndfile, and the test suite will pass on\r
+the machine you compiled it on.\r
+However, if you take the universal binary test suite programs compiled on one\r
+CPU and run them on the other, the test suite will fail.\r
+</P>\r
+\r
+<P>\r
+Part of the problem is the the CPU endian-ness is detected at configure time.\r
+Yes, I know the Apple compiler defines one of the macros __LITTLE_ENDIAN__\r
+and __BIG_ENDIAN__, but those macros are not part of the 1999 ISO C Standard\r
+and they are not portable.\r
+</P>\r
+\r
+<P>\r
+Endian issues are not the only reason why the cross compiled binary will fail.\r
+The configure script also detects other CPU specific idiosyncrasies to provide\r
+more optimized code.\r
+</P>\r
+\r
+<P>\r
+Finally, the real show stopper problem with universal binaries is the problem\r
+with the test suite.\r
+libsndfile contains a huge, comprehensive test suite.\r
+When you compile a universal binary and run the test suite, you only test the\r
+native compile.\r
+The cross compiled binary (the one with the much higher chance of having\r
+problems) cannot be tested.\r
+</P>\r
+\r
+<P>\r
+Now, if you have read this far you're probably thinking there must be a way\r
+to fix this and there probably is.\r
+The problem is that its a hell of a lot of work and would require significant\r
+changes to the configure process, the internal code and the test suite.\r
+In addition, these changes must not break compilation on any of the platforms\r
+libsndfile is currently working on.\r
+</p>\r
+\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="Q019"></A>\r
+<H2><BR/><B>Q19 : I have project files for Visual Studio / XCode / Whatever. Why\r
+ don't you distribute them with libsndfile?\r
+</B></H2>\r
+\r
+<P>\r
+There's a very good reason for this.\r
+I will only distribute things that I actually have an ability to test and\r
+maintain.\r
+Project files for a bunch of different compilers and Integrated Development\r
+Environments are simply too difficult to maintain.\r
+</P>\r
+\r
+<P>\r
+The problem is that every time I add a new file to libsndfile or rename an\r
+existing file I would have to modify all the project files and then test that\r
+libsndfile still built with all the different compilers.\r
+</P>\r
+\r
+<P>\r
+Maintaining these project files is also rather difficult if I don't have access\r
+to the required compiler/IDE.\r
+If I just edit the project files without testing them I will almost certainly\r
+get it wrong.\r
+If I release a version of libsndfile with broken project files, I'll get a bunch\r
+of emails from people complaining about it not building and have no way of\r
+fixing or even testing it.\r
+</P>\r
+\r
+<P>\r
+I currently release sources that I personally test on Win32, Linux and\r
+MacOS X (PowerPC) using the compiler I trust (GNU GCC).\r
+Supporting one compiler on three (actually much more because GCC is available\r
+almost everywhere) platforms is doable without too much pain.\r
+I also release binaries for Win32 with instructions on how to use those\r
+binaries with Visual Studio.\r
+As a guy who is mainly interested in Linux, I'm not to keen to jump through\r
+a bunch of hoops to support compilers and operating systems I don't use.\r
+</P>\r
+\r
+<P>\r
+So, I hear you want to volunteer to maintain the project files for Some Crappy\r
+Compiler 2007?\r
+Well sorry, that won't work either.\r
+I have had numerous people over the years offer to maintaining the project\r
+files for Microsoft's Visual Studio.\r
+Every single time that happened, they maintained it for a release or two and\r
+then disappeared off the face of the earth.\r
+Hence, I'm not willing to enter into an arrangement like that again.\r
+</P>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="Q020"></A>\r
+<H2><BR/><B>Q20 : Why doesn't libsndfile support MP3? Lots of other Open Source\r
+ projects support it!\r
+</B></H2>\r
+\r
+<P>\r
+MP3 is not supported for one very good reason; doing so requires the payment\r
+of licensing fees.\r
+As can be seen from\r
+ <a href="http://www.mp3licensing.com/royalty/software.html">\r
+ mp3licensing.com</a>\r
+the required royalty payments are not cheap.\r
+</P>\r
+\r
+<p>\r
+Yes, I know other libraries ignore the licensing requirements, but their legal\r
+status is extremely dubious.\r
+At any time, the body selling the licenses could go after the authors of those\r
+libraries.\r
+Some of those authors may be students and hence wouldn't be worth pursuing.\r
+</P>\r
+\r
+<p>\r
+However, libsndfile is released under the name of a company, Mega Nerd Pty Ltd;\r
+a company which has income from from libsamplerate licensing, libsndfile based\r
+consulting income and other unrelated consulting income.\r
+Adding MP3 support to libsndfile could place that income would be under legal\r
+threat.\r
+</p>\r
+\r
+<p>\r
+Fortunately, Ogg Vorbis exists as an alternative to MP3.\r
+Support for Ogg Vorbis was added to libsndfile (mostly due to the efforts of\r
+John ffitch of the Csound project) in version 1.0.18.\r
+</p>\r
+\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="Q021"></A>\r
+<H2><BR/><B>Q21 : How do I use libsndfile in a closed source or commercial program\r
+ and comply with the license?\r
+</B></H2>\r
+\r
+<p>\r
+Here is a checklist of things you need to do to make sure your use of libsndfile\r
+in a closed source or commercial project complies with the license libsndfile is\r
+released under, the GNU Lesser General Public License (LGPL):\r
+</p>\r
+\r
+<ul>\r
+<li>Make sure you are linking to libsndfile as a shared library (Linux and Unix\r
+ systems), Dynamic Link Library (Microsoft Windows) or dynlib (Mac OS X).\r
+ If you are using some other operating system that doesn't allow dynamically\r
+ linked libraries, you will not be able to use libsndfile unless you release\r
+ the source code to your program.\r
+<li>In the licensing documentation for your program, add a statement that your\r
+ software depends on libsndfile and that libsndfile is released under the GNU\r
+ Lesser General Public License, either\r
+ <a href="http://www.gnu.org/licenses/lgpl-2.1.txt">version 2.1</a>\r
+ or optionally\r
+ <a href="http://www.gnu.org/licenses/lgpl.txt">version 3</a>.\r
+<li>Include the text for both versions of the license, possibly as separate\r
+ files named libsndfile_lgpl_v2_1.txt and libsndfile_lgpl_v3.txt.\r
+</ul>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="Q022"></A>\r
+<H2><BR/><B>Q22 : What versions of Windows does libsndfile work on?\r
+</B></H2>\r
+\r
+<p>\r
+Currently the precompiled windows binaries are thoroughly tested on Windows XP.\r
+As such, they should also work on Win2k and Windows Vista.\r
+They may also work on earlier versions of Windows.\r
+</p>\r
+\r
+<p>\r
+Since version 0.1.18 I have also been releasing precompiled binaries for Win64,\r
+the 64 bit version of Windows.\r
+These binaries have received much less testing than the 32 bit versions, but\r
+should work as expected.\r
+I'd be very interested in receiving feedback on these binaries.\r
+</p>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="Q023"></A>\r
+<H2><BR/><B>Q23 : I'm cross compiling libsndfile for another platform. How can I\r
+ run the test suite?\r
+</B></H2>\r
+\r
+<p>\r
+</p>\r
+\r
+<p>\r
+Since version 1.0.21 the top level Makefile has an extra make target,\r
+'test-tarball'.\r
+Building this target creates a tarball called called:\r
+</p>\r
+\r
+<center><tt>\r
+libsndfile-testsuite-${host_triplet}-${version}.tar.gz\r
+</tt></center>\r
+\r
+<p>\r
+in the top level directory.\r
+This tarball can then be copied to the target platform.\r
+Once untarred and test script <tt>test_wrapper.sh</tt> can be run from\r
+the top level of the extracted tarball.\r
+</p>\r
+\r
+<!-- ========================================================================= -->\r
+<HR>\r
+<P>\r
+ The libsndfile home page is here :\r
+ <A HREF="http://www.mega-nerd.com/libsndfile/">\r
+ http://www.mega-nerd.com/libsndfile/</A>.\r
+<BR/>\r
+Version : 1.0.25\r
+</P>\r
+\r
+</BODY>\r
+</HTML>\r
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">\r
+<HTML>\r
+\r
+<HEAD>\r
+ <TITLE>\r
+ The libsndfile API\r
+ </TITLE>\r
+ <META NAME="Author" CONTENT="Erik de Castro Lopo (erikd AT mega-nerd DOT com)">\r
+ <META NAME="Description" CONTENT="The libsndfile API.">\r
+ <META NAME="Keywords" CONTENT="WAV AIFF AU libsndfile sound audio dsp Linux">\r
+ <LINK REL="stylesheet" HREF="libsndfile.css" TYPE="text/css" MEDIA="all">\r
+ <LINK REL="stylesheet" HREF="print.css" TYPE="text/css" MEDIA="print">\r
+</HEAD>\r
+\r
+<BODY>\r
+\r
+<BR>\r
+<H1><B>libsndfile</B></H1>\r
+<P>\r
+ Libsndfile is a library designed to allow the reading and writing of many\r
+ different sampled sound file formats (such as MS Windows WAV and the Apple/SGI\r
+ AIFF format) through one standard library interface.\r
+</P>\r
+<!-- pepper -->\r
+<P>\r
+ During read and write operations, formats are seamlessly converted between the\r
+ format the application program has requested or supplied and the file's data\r
+ format. The application programmer can remain blissfully unaware of issues\r
+ such as file endian-ness and data format. See <A HREF="#note1">Note 1</A> and\r
+ <A HREF="#note2">Note 2</A>.\r
+</P>\r
+<!-- pepper -->\r
+<P>\r
+ Every effort is made to keep these documents up-to-date, error free and\r
+ unambiguous.\r
+ However, since maintaining the documentation is the least fun part of working\r
+ on libsndfile, these docs can and do fall behind the behaviour of library.\r
+ If any errors, omissions or ambiguities are found, please notify me (erikd)\r
+ at mega-nerd dot com.\r
+</P>\r
+<!-- pepper -->\r
+<P>\r
+ To supplement this reference documentation, there are simple example programs\r
+ included in the source code tarball.\r
+ The test suite which is also part of the source code tarball is also a good\r
+ place to look for the correct usage of the library functions.\r
+</P>\r
+<!-- pepper -->\r
+<P>\r
+ <B> Finally, if you think there is some feature missing from libsndfile, check that\r
+ it isn't already implemented (and documented)\r
+ <A HREF="command.html">here</A>.\r
+ </B>\r
+</P>\r
+\r
+<H2><B>Synopsis</B></H2>\r
+<P>\r
+The functions of libsndfile are defined as follows:\r
+</P>\r
+<!-- pepper -->\r
+<PRE>\r
+ #include <stdio.h>\r
+ #include <sndfile.h>\r
+\r
+ SNDFILE* <A HREF="#open">sf_open</A> (const char *path, int mode, SF_INFO *sfinfo) ;\r
+ SNDFILE* <A HREF="#open_fd">sf_open_fd</A> (int fd, int mode, SF_INFO *sfinfo, int close_desc) ;\r
+ SNDFILE* <A HREF="#open_virtual">sf_open_virtual</A> (SF_VIRTUAL_IO *sfvirtual, int mode, SF_INFO *sfinfo, void *user_data) ;\r
+ int <A HREF="#check">sf_format_check</A> (const SF_INFO *info) ;\r
+\r
+ sf_count_t <A HREF="#seek">sf_seek</A> (SNDFILE *sndfile, sf_count_t frames, int whence) ;\r
+\r
+ int <A HREF="command.html">sf_command</A> (SNDFILE *sndfile, int cmd, void *data, int datasize) ;\r
+\r
+ int <A HREF="#error">sf_error</A> (SNDFILE *sndfile) ;\r
+ const char* <A HREF="#error">sf_strerror</A> (SNDFILE *sndfile) ;\r
+ const char* <A HREF="#error">sf_error_number</A> (int errnum) ;\r
+\r
+ int <A HREF="#error">sf_perror</A> (SNDFILE *sndfile) ;\r
+ int <A HREF="#error">sf_error_str</A> (SNDFILE *sndfile, char* str, size_t len) ;\r
+\r
+ int <A HREF="#close">sf_close</A> (SNDFILE *sndfile) ;\r
+ void <A HREF="#write_sync">sf_write_sync</A> (SNDFILE *sndfile) ;\r
+\r
+ sf_count_t <A HREF="#read">sf_read_short</A> (SNDFILE *sndfile, short *ptr, sf_count_t items) ;\r
+ sf_count_t <A HREF="#read">sf_read_int</A> (SNDFILE *sndfile, int *ptr, sf_count_t items) ;\r
+ sf_count_t <A HREF="#read">sf_read_float</A> (SNDFILE *sndfile, float *ptr, sf_count_t items) ;\r
+ sf_count_t <A HREF="#read">sf_read_double</A> (SNDFILE *sndfile, double *ptr, sf_count_t items) ;\r
+\r
+ sf_count_t <A HREF="#readf">sf_readf_short</A> (SNDFILE *sndfile, short *ptr, sf_count_t frames) ;\r
+ sf_count_t <A HREF="#readf">sf_readf_int</A> (SNDFILE *sndfile, int *ptr, sf_count_t frames) ;\r
+ sf_count_t <A HREF="#readf">sf_readf_float</A> (SNDFILE *sndfile, float *ptr, sf_count_t frames) ;\r
+ sf_count_t <A HREF="#readf">sf_readf_double</A> (SNDFILE *sndfile, double *ptr, sf_count_t frames) ;\r
+\r
+ sf_count_t <A HREF="#write">sf_write_short</A> (SNDFILE *sndfile, short *ptr, sf_count_t items) ;\r
+ sf_count_t <A HREF="#write">sf_write_int</A> (SNDFILE *sndfile, int *ptr, sf_count_t items) ;\r
+ sf_count_t <A HREF="#write">sf_write_float</A> (SNDFILE *sndfile, float *ptr, sf_count_t items) ;\r
+ sf_count_t <A HREF="#write">sf_write_double</A> (SNDFILE *sndfile, double *ptr, sf_count_t items) ;\r
+\r
+ sf_count_t <A HREF="#writef">sf_writef_short</A> (SNDFILE *sndfile, short *ptr, sf_count_t frames) ;\r
+ sf_count_t <A HREF="#writef">sf_writef_int</A> (SNDFILE *sndfile, int *ptr, sf_count_t frames) ;\r
+ sf_count_t <A HREF="#writef">sf_writef_float</A> (SNDFILE *sndfile, float *ptr, sf_count_t frames) ;\r
+ sf_count_t <A HREF="#writef">sf_writef_double</A> (SNDFILE *sndfile, double *ptr, sf_count_t frames) ;\r
+\r
+ sf_count_t <A HREF="#raw">sf_read_raw</A> (SNDFILE *sndfile, void *ptr, sf_count_t bytes) ;\r
+ sf_count_t <A HREF="#raw">sf_write_raw</A> (SNDFILE *sndfile, void *ptr, sf_count_t bytes) ;\r
+\r
+ const char* <A HREF="#string">sf_get_string</A> (SNDFILE *sndfile, int str_type) ;\r
+ int <A HREF="#string">sf_set_string</A> (SNDFILE *sndfile, int str_type, const char* str) ;\r
+\r
+</PRE>\r
+<!-- pepper -->\r
+<P>\r
+SNDFILE* is an anonymous pointer to data which is private to the library.\r
+</P>\r
+\r
+\r
+<A NAME="open"></A>\r
+<H2><B>File Open Function</B></H2>\r
+\r
+<PRE>\r
+ SNDFILE* sf_open (const char *path, int mode, SF_INFO *sfinfo) ;\r
+</PRE>\r
+\r
+<P>\r
+The SF_INFO structure is for passing data between the calling function and the library\r
+when opening a file for reading or writing. It is defined in sndfile.h as follows:\r
+</P>\r
+<!-- pepper -->\r
+<PRE>\r
+ typedef struct\r
+ { sf_count_t frames ; /* Used to be called samples. */\r
+ int samplerate ;\r
+ int channels ;\r
+ int format ;\r
+ int sections ;\r
+ int seekable ;\r
+ } SF_INFO ;\r
+</PRE>\r
+\r
+<P>\r
+The mode parameter for this function can be any one of the following three values:\r
+</P>\r
+<!-- pepper -->\r
+<PRE>\r
+ SFM_READ - read only mode\r
+ SFM_WRITE - write only mode\r
+ SFM_RDWR - read/write mode\r
+</PRE>\r
+\r
+<P>\r
+When opening a file for read, the <b>format</B> field should be set to zero before\r
+calling sf_open().\r
+The only exception to this is the case of RAW files where the caller has to set\r
+the samplerate, channels and format fields to valid values.\r
+All other fields of the structure are filled in by the library.\r
+</P>\r
+<!-- pepper -->\r
+<P>\r
+When opening a file for write, the caller must fill in structure members samplerate,\r
+channels, and format.\r
+</P>\r
+<!-- pepper -->\r
+<P>\r
+The format field in the above SF_INFO structure is made up of the bit-wise OR of a\r
+major format type (values between 0x10000 and 0x08000000), a minor format type\r
+(with values less than 0x10000) and an optional endian-ness value.\r
+The currently understood formats are listed in sndfile.h as follows and also include\r
+bitmasks for separating major and minor file types.\r
+Not all combinations of endian-ness and major and minor file types are valid.\r
+</P>\r
+<!-- pepper -->\r
+<PRE>\r
+ enum\r
+ { /* Major formats. */\r
+ SF_FORMAT_WAV = 0x010000, /* Microsoft WAV format (little endian). */\r
+ SF_FORMAT_AIFF = 0x020000, /* Apple/SGI AIFF format (big endian). */\r
+ SF_FORMAT_AU = 0x030000, /* Sun/NeXT AU format (big endian). */\r
+ SF_FORMAT_RAW = 0x040000, /* RAW PCM data. */\r
+ SF_FORMAT_PAF = 0x050000, /* Ensoniq PARIS file format. */\r
+ SF_FORMAT_SVX = 0x060000, /* Amiga IFF / SVX8 / SV16 format. */\r
+ SF_FORMAT_NIST = 0x070000, /* Sphere NIST format. */\r
+ SF_FORMAT_VOC = 0x080000, /* VOC files. */\r
+ SF_FORMAT_IRCAM = 0x0A0000, /* Berkeley/IRCAM/CARL */\r
+ SF_FORMAT_W64 = 0x0B0000, /* Sonic Foundry's 64 bit RIFF/WAV */\r
+ SF_FORMAT_MAT4 = 0x0C0000, /* Matlab (tm) V4.2 / GNU Octave 2.0 */\r
+ SF_FORMAT_MAT5 = 0x0D0000, /* Matlab (tm) V5.0 / GNU Octave 2.1 */\r
+ SF_FORMAT_PVF = 0x0E0000, /* Portable Voice Format */\r
+ SF_FORMAT_XI = 0x0F0000, /* Fasttracker 2 Extended Instrument */\r
+ SF_FORMAT_HTK = 0x100000, /* HMM Tool Kit format */\r
+ SF_FORMAT_SDS = 0x110000, /* Midi Sample Dump Standard */\r
+ SF_FORMAT_AVR = 0x120000, /* Audio Visual Research */\r
+ SF_FORMAT_WAVEX = 0x130000, /* MS WAVE with WAVEFORMATEX */\r
+ SF_FORMAT_SD2 = 0x160000, /* Sound Designer 2 */\r
+ SF_FORMAT_FLAC = 0x170000, /* FLAC lossless file format */\r
+ SF_FORMAT_CAF = 0x180000, /* Core Audio File format */\r
+ SF_FORMAT_WVE = 0x190000, /* Psion WVE format */\r
+ SF_FORMAT_OGG = 0x200000, /* Xiph OGG container */\r
+ SF_FORMAT_MPC2K = 0x210000, /* Akai MPC 2000 sampler */\r
+ SF_FORMAT_RF64 = 0x220000, /* RF64 WAV file */\r
+\r
+ /* Subtypes from here on. */\r
+\r
+ SF_FORMAT_PCM_S8 = 0x0001, /* Signed 8 bit data */\r
+ SF_FORMAT_PCM_16 = 0x0002, /* Signed 16 bit data */\r
+ SF_FORMAT_PCM_24 = 0x0003, /* Signed 24 bit data */\r
+ SF_FORMAT_PCM_32 = 0x0004, /* Signed 32 bit data */\r
+\r
+ SF_FORMAT_PCM_U8 = 0x0005, /* Unsigned 8 bit data (WAV and RAW only) */\r
+\r
+ SF_FORMAT_FLOAT = 0x0006, /* 32 bit float data */\r
+ SF_FORMAT_DOUBLE = 0x0007, /* 64 bit float data */\r
+\r
+ SF_FORMAT_ULAW = 0x0010, /* U-Law encoded. */\r
+ SF_FORMAT_ALAW = 0x0011, /* A-Law encoded. */\r
+ SF_FORMAT_IMA_ADPCM = 0x0012, /* IMA ADPCM. */\r
+ SF_FORMAT_MS_ADPCM = 0x0013, /* Microsoft ADPCM. */\r
+\r
+ SF_FORMAT_GSM610 = 0x0020, /* GSM 6.10 encoding. */\r
+ SF_FORMAT_VOX_ADPCM = 0x0021, /* Oki Dialogic ADPCM encoding. */\r
+\r
+ SF_FORMAT_G721_32 = 0x0030, /* 32kbs G721 ADPCM encoding. */\r
+ SF_FORMAT_G723_24 = 0x0031, /* 24kbs G723 ADPCM encoding. */\r
+ SF_FORMAT_G723_40 = 0x0032, /* 40kbs G723 ADPCM encoding. */\r
+\r
+ SF_FORMAT_DWVW_12 = 0x0040, /* 12 bit Delta Width Variable Word encoding. */\r
+ SF_FORMAT_DWVW_16 = 0x0041, /* 16 bit Delta Width Variable Word encoding. */\r
+ SF_FORMAT_DWVW_24 = 0x0042, /* 24 bit Delta Width Variable Word encoding. */\r
+ SF_FORMAT_DWVW_N = 0x0043, /* N bit Delta Width Variable Word encoding. */\r
+\r
+ SF_FORMAT_DPCM_8 = 0x0050, /* 8 bit differential PCM (XI only) */\r
+ SF_FORMAT_DPCM_16 = 0x0051, /* 16 bit differential PCM (XI only) */\r
+\r
+ SF_FORMAT_VORBIS = 0x0060, /* Xiph Vorbis encoding. */\r
+\r
+ /* Endian-ness options. */\r
+\r
+ SF_ENDIAN_FILE = 0x00000000, /* Default file endian-ness. */\r
+ SF_ENDIAN_LITTLE = 0x10000000, /* Force little endian-ness. */\r
+ SF_ENDIAN_BIG = 0x20000000, /* Force big endian-ness. */\r
+ SF_ENDIAN_CPU = 0x30000000, /* Force CPU endian-ness. */\r
+\r
+ SF_FORMAT_SUBMASK = 0x0000FFFF,\r
+ SF_FORMAT_TYPEMASK = 0x0FFF0000,\r
+ SF_FORMAT_ENDMASK = 0x30000000\r
+ } ;\r
+</PRE>\r
+<!-- pepper -->\r
+<P>\r
+Every call to sf_open() should be matched with a call to sf_close() to free up\r
+memory allocated during the call to sf_open().\r
+</P>\r
+<!-- pepper -->\r
+<P>\r
+On success, the sf_open function returns a non-NULL pointer which should be\r
+passed as the first parameter to all subsequent libsndfile calls dealing with\r
+that audio file.\r
+On fail, the sf_open function returns a NULL pointer.\r
+An explanation of the error can obtained by passing NULL to\r
+ <A HREF="#error">sf_strerror</A>.\r
+</P>\r
+\r
+<A NAME="open_fd"></A>\r
+<H3><B>File Descriptor Open</B></H3>\r
+\r
+<PRE>\r
+ SNDFILE* sf_open_fd (int fd, int mode, SF_INFO *sfinfo, int close_desc) ;\r
+</PRE>\r
+\r
+<P>\r
+<b>Note:</b> On Microsoft Windows, this function does not work if the\r
+application and the libsndfile DLL are linked to different versions of the\r
+Microsoft C runtime DLL.\r
+</P>\r
+<P>\r
+The second open function takes a file descriptor of a file that has already been\r
+opened.\r
+Care should be taken to ensure that the mode of the file represented by the\r
+descriptor matches the mode argument.\r
+This function is useful in the following circumstances:\r
+</P>\r
+\r
+<UL>\r
+ <LI>Opening temporary files securely (ie use the tmpfile() to return a\r
+ FILE* pointer and then using fileno() to retrieve the file descriptor\r
+ which is then passed to libsndfile).\r
+ <LI>Opening files with file names using OS specific character encodings\r
+ and then passing the file descriptor to sf_open_fd().\r
+ <LI>Opening sound files embedded within larger files.\r
+ <A HREF="embedded_files.html">More info</A>.\r
+</UL>\r
+\r
+<P>\r
+Every call to sf_open_fd() should be matched with a call to sf_close() to free up\r
+memory allocated during the call to sf_open().\r
+</P>\r
+\r
+<P>\r
+When sf_close() is called, the file descriptor is only closed if the <B>close_desc</B>\r
+parameter was TRUE when the sf_open_fd() function was called.\r
+</P>\r
+\r
+<P>\r
+On success, the sf_open_fd function returns a non-NULL pointer which should be\r
+passed as the first parameter to all subsequent libsndfile calls dealing with\r
+that audio file.\r
+On fail, the sf_open_fd function returns a NULL pointer.\r
+</P>\r
+\r
+<A NAME="open_virtual"></A>\r
+<h3><b>Virtual File Open Function</b></h3>\r
+<pre>\r
+ SNDFILE* sf_open_virtual (SF_VIRTUAL_IO *sfvirtual, int mode, SF_INFO *sfinfo, void *user_data) ;\r
+</pre>\r
+<p>\r
+ Opens a soundfile from a virtual file I/O context which is provided\r
+ by the caller. This is usually used to interface libsndfile to a stream or buffer\r
+ based system. Apart from the sfvirtual and the user_data parameters this function behaves\r
+ like <a href="#open">sf_open</a>.\r
+</p>\r
+\r
+<pre>\r
+ typedef struct\r
+ { sf_vio_get_filelen get_filelen ;\r
+ sf_vio_seek seek ;\r
+ sf_vio_read read ;\r
+ sf_vio_write write ;\r
+ sf_vio_tell tell ;\r
+ } SF_VIRTUAL_IO ;\r
+</pre>\r
+<p>\r
+Libsndfile calls the callbacks provided by the SF_VIRTUAL_IO structure when opening, reading\r
+and writing to the virtual file context. The user_data pointer is a user defined context which\r
+will be available in the callbacks.\r
+</p>\r
+<pre>\r
+ typedef sf_count_t (*sf_vio_get_filelen) (void *user_data) ;\r
+ typedef sf_count_t (*sf_vio_seek) (sf_count_t offset, int whence, void *user_data) ;\r
+ typedef sf_count_t (*sf_vio_read) (void *ptr, sf_count_t count, void *user_data) ;\r
+ typedef sf_count_t (*sf_vio_write) (const void *ptr, sf_count_t count, void *user_data) ;\r
+ typedef sf_count_t (*sf_vio_tell) (void *user_data) ;\r
+</pre>\r
+<h4>sf_vio_get_filelen</h4>\r
+<pre>\r
+ typedef sf_count_t (*sf_vio_get_filelen) (void *user_data) ;\r
+</pre>\r
+<p>\r
+The virtual file contex must return the length of the virtual file in bytes.<br>\r
+</p>\r
+<h4>sf_vio_seek</h4>\r
+<pre>\r
+ typedef sf_count_t (*sf_vio_seek) (sf_count_t offset, int whence, void *user_data) ;\r
+</pre>\r
+<p>\r
+The virtual file context must seek to offset using the seek mode provided by whence which is one of<br>\r
+</p>\r
+<pre>\r
+ SEEK_CUR\r
+ SEEK_SET\r
+ SEEK_END\r
+</pre>\r
+<p>\r
+The return value must contain the new offset in the file.\r
+</p>\r
+<h4>sf_vio_read</h4>\r
+<pre>\r
+ typedef sf_count_t (*sf_vio_read) (void *ptr, sf_count_t count, void *user_data) ;\r
+</pre>\r
+<p>\r
+The virtual file context must copy ("read") "count" bytes into the\r
+buffer provided by ptr and return the count of actually copied bytes.\r
+</p>\r
+<h4>sf_vio_write</h4>\r
+<pre>\r
+ typedef sf_count_t (*sf_vio_write) (const void *ptr, sf_count_t count, void *user_data) ;\r
+</pre>\r
+<p>\r
+The virtual file context must process "count" bytes stored in the\r
+buffer passed with ptr and return the count of actually processed bytes.<br>\r
+</p>\r
+<h4>sf_vio_tell</h4>\r
+<pre>\r
+ typedef sf_count_t (*sf_vio_tell) (void *user_data) ;\r
+</pre>\r
+<p>\r
+Return the current position of the virtual file context.<br>\r
+</p>\r
+\r
+\r
+<A NAME="check"></A>\r
+<BR><H2><B>Format Check Function</B></H2>\r
+\r
+<PRE>\r
+ int sf_format_check (const SF_INFO *info) ;\r
+</PRE>\r
+<!-- pepper -->\r
+<P>\r
+This function allows the caller to check if a set of parameters in the SF_INFO struct\r
+is valid before calling sf_open (SFM_WRITE).\r
+</P>\r
+<P>\r
+sf_format_check returns TRUE if the parameters are valid and FALSE otherwise.\r
+</P>\r
+\r
+<A NAME="seek"></A>\r
+<BR><H2><B>File Seek Functions</B></H2>\r
+\r
+<PRE>\r
+ sf_count_t sf_seek (SNDFILE *sndfile, sf_count_t frames, int whence) ;\r
+</PRE>\r
+\r
+<P>\r
+The file seek functions work much like lseek in unistd.h with the exception that\r
+the non-audio data is ignored and the seek only moves within the audio data section of\r
+the file.\r
+In addition, seeks are defined in number of (multichannel) frames.\r
+Therefore, a seek in a stereo file from the current position forward with an offset\r
+of 1 would skip forward by one sample of both channels.\r
+</P>\r
+\r
+<P>\r
+like lseek(), the whence parameter can be any one of the following three values:\r
+</P>\r
+\r
+<PRE>\r
+ SEEK_SET - The offset is set to the start of the audio data plus offset (multichannel) frames.\r
+ SEEK_CUR - The offset is set to its current location plus offset (multichannel) frames.\r
+ SEEK_END - The offset is set to the end of the data plus offset (multichannel) frames.\r
+</PRE>\r
+<!-- pepper -->\r
+<P>\r
+Internally, libsndfile keeps track of the read and write locations using separate\r
+read and write pointers.\r
+If a file has been opened with a mode of SFM_RDWR, bitwise OR-ing the standard whence\r
+values above with either SFM_READ or SFM_WRITE allows the read and write pointers to\r
+be modified separately.\r
+If the SEEK_* values are used on their own, the read and write pointers are\r
+both modified.\r
+</P>\r
+\r
+<P>\r
+Note that the frames offset can be negative and in fact should be when SEEK_END is used for the\r
+whence parameter.\r
+</P>\r
+<P>\r
+sf_seek will return the offset in (multichannel) frames from the start of the audio data\r
+or -1 if an error occured (ie an attempt is made to seek beyond the start or end of the file).\r
+</P>\r
+\r
+<A NAME="error"></A>\r
+<H2><BR><B>Error Reporting Functions</B></H2>\r
+\r
+\r
+<PRE>\r
+ int sf_error (SNDFILE *sndfile) ;\r
+</PRE>\r
+<P>\r
+This function returns the current error number for the given SNDFILE.\r
+The error number may be one of the following:\r
+</P>\r
+<PRE>\r
+ enum\r
+ { SF_ERR_NO_ERROR = 0,\r
+ SF_ERR_UNRECOGNISED_FORMAT = 1,\r
+ SF_ERR_SYSTEM = 2,\r
+ SF_ERR_MALFORMED_FILE = 3,\r
+ SF_ERR_UNSUPPORTED_ENCODING = 4\r
+ } ;\r
+</PRE>\r
+<!-- pepper -->\r
+<P>\r
+or any one of many other internal error values.\r
+Applications should only test the return value against error values defined in\r
+<sndfile.h> as the internal error values are subject to change at any\r
+time.\r
+For errors not in the above list, the function sf_error_number() can be used to\r
+convert it to an error string.\r
+</P>\r
+\r
+<PRE>\r
+ const char* sf_strerror (SNDFILE *sndfile) ;\r
+ const char* sf_error_number (int errnum) ;\r
+</PRE>\r
+\r
+<P>\r
+The error functions sf_strerror() and sf_error_number() convert the library's internal\r
+error enumerations into text strings.\r
+</P>\r
+<PRE>\r
+ int sf_perror (SNDFILE *sndfile) ;\r
+ int sf_error_str (SNDFILE *sndfile, char* str, size_t len) ;\r
+</PRE>\r
+\r
+<P>\r
+The functions sf_perror() and sf_error_str() are deprecated and will be dropped\r
+from the library at some later date.\r
+</P>\r
+\r
+<A NAME="close"></A>\r
+<H2><BR><B>File Close Function</B></H2>\r
+\r
+<PRE>\r
+ int sf_close (SNDFILE *sndfile) ;\r
+</PRE>\r
+<!-- pepper -->\r
+<P>\r
+The close function closes the file, deallocates its internal buffers and returns\r
+0 on success or an error value otherwise.\r
+</P>\r
+<BR>\r
+\r
+<A NAME="write_sync"></A>\r
+<H2><BR><B>Write Sync Function</B></H2>\r
+\r
+<PRE>\r
+ void sf_write_sync (SNDFILE *sndfile) ;\r
+</PRE>\r
+<!-- pepper -->\r
+<P>\r
+If the file is opened SFM_WRITE or SFM_RDWR, call the operating system's function\r
+to force the writing of all file cache buffers to disk. If the file is opened\r
+SFM_READ no action is taken.\r
+</P>\r
+<BR>\r
+\r
+\r
+<A NAME="read"></A>\r
+<H2><BR><B>File Read Functions (Items)</B></H2>\r
+\r
+<PRE>\r
+ sf_count_t sf_read_short (SNDFILE *sndfile, short *ptr, sf_count_t items) ;\r
+ sf_count_t sf_read_int (SNDFILE *sndfile, int *ptr, sf_count_t items) ;\r
+ sf_count_t sf_read_float (SNDFILE *sndfile, float *ptr, sf_count_t items) ;\r
+ sf_count_t sf_read_double (SNDFILE *sndfile, double *ptr, sf_count_t items) ;\r
+</PRE>\r
+\r
+<P>\r
+The file read items functions fill the array pointed to by ptr with the requested\r
+number of items. The items parameter must be an integer product of the number\r
+of channels or an error will occur.\r
+</P>\r
+<!-- pepper -->\r
+<P>\r
+It is important to note that the data type used by the calling program and the data\r
+format of the file do not need to be the same. For instance, it is possible to open\r
+a 16 bit PCM encoded WAV file and read the data using sf_read_float(). The library\r
+seamlessly converts between the two formats on-the-fly. See\r
+<A HREF="#note1">Note 1</A>.\r
+</P>\r
+<!-- pepper -->\r
+<P>\r
+The sf_read_XXXX functions return the number of items read.\r
+Unless the end of the file was reached during the read, the return value should\r
+equal the number of items requested.\r
+Attempts to read beyond the end of the file will not result in an error but will\r
+cause the sf_read_XXXX functions to return less than the number of items requested\r
+or 0 if already at the end of the file.\r
+</P>\r
+\r
+<A NAME="readf"></A>\r
+<H2><BR><B>File Read Functions (Frames)</B></H2>\r
+\r
+<PRE>\r
+ sf_count_t sf_readf_short (SNDFILE *sndfile, short *ptr, sf_count_t frames) ;\r
+ sf_count_t sf_readf_int (SNDFILE *sndfile, int *ptr, sf_count_t frames) ;\r
+ sf_count_t sf_readf_float (SNDFILE *sndfile, float *ptr, sf_count_t frames) ;\r
+ sf_count_t sf_readf_double (SNDFILE *sndfile, double *ptr, sf_count_t frames) ;\r
+</PRE>\r
+<!-- pepper -->\r
+<P>\r
+The file read frames functions fill the array pointed to by ptr with the requested\r
+number of frames of data. The array must be large enough to hold the product of\r
+frames and the number of channels.\r
+</P>\r
+\r
+<P><B>\r
+Care must be taken to ensure that there is enough space in the array pointed to by\r
+ptr, to take (frames * channels) number of items (shorts, ints, floats or doubles).\r
+</B></P>\r
+\r
+<P>\r
+The sf_readf_XXXX functions return the number of frames read.\r
+Unless the end of the file was reached during the read, the return value should equal\r
+the number of frames requested.\r
+Attempts to read beyond the end of the file will not result in an error but will cause\r
+the sf_readf_XXXX functions to return less than the number of frames requested or 0 if\r
+already at the end of the file.\r
+</P>\r
+\r
+<A NAME="write"></A>\r
+<H2><BR><B>File Write Functions (Items)</B></H2>\r
+\r
+<PRE>\r
+ sf_count_t sf_write_short (SNDFILE *sndfile, short *ptr, sf_count_t items) ;\r
+ sf_count_t sf_write_int (SNDFILE *sndfile, int *ptr, sf_count_t items) ;\r
+ sf_count_t sf_write_float (SNDFILE *sndfile, float *ptr, sf_count_t items) ;\r
+ sf_count_t sf_write_double (SNDFILE *sndfile, double *ptr, sf_count_t items) ;\r
+</PRE>\r
+\r
+<P>\r
+The file write items functions write the data in the array pointed to by ptr to the file.\r
+The items parameter must be an integer product of the number of channels or an error\r
+will occur.\r
+</P>\r
+<!-- pepper -->\r
+<P>\r
+It is important to note that the data type used by the calling program and the data\r
+format of the file do not need to be the same. For instance, it is possible to open\r
+a 16 bit PCM encoded WAV file and write the data using sf_write_float(). The library\r
+seamlessly converts between the two formats on-the-fly. See\r
+<A HREF="#note1">Note 1</A>.\r
+</P>\r
+<P>\r
+The sf_write_XXXX functions return the number of items written (which should be the\r
+same as the items parameter).\r
+</P>\r
+\r
+<A NAME="writef"></A>\r
+<H2><BR><B>File Write Functions (Frames)</B></H2>\r
+\r
+<PRE>\r
+ sf_count_t sf_writef_short (SNDFILE *sndfile, short *ptr, sf_count_t frames) ;\r
+ sf_count_t sf_writef_int (SNDFILE *sndfile, int *ptr, sf_count_t frames) ;\r
+ sf_count_t sf_writef_float (SNDFILE *sndfile, float *ptr, sf_count_t frames) ;\r
+ sf_count_t sf_writef_double (SNDFILE *sndfile, double *ptr, sf_count_t frames) ;\r
+</PRE>\r
+\r
+<P>\r
+The file write frames functions write the data in the array pointed to by ptr to the file.\r
+The array must be large enough to hold the product of frames and the number of channels.\r
+</P>\r
+<P>\r
+The sf_writef_XXXX functions return the number of frames written (which should be the\r
+same as the frames parameter).\r
+</P>\r
+\r
+<A NAME="raw"></A>\r
+<H2><BR><B>Raw File Read and Write Functions</B></H2>\r
+<!-- pepper -->\r
+<PRE>\r
+ sf_count_t sf_read_raw (SNDFILE *sndfile, void *ptr, sf_count_t bytes) ;\r
+ sf_count_t sf_write_raw (SNDFILE *sndfile, void *ptr, sf_count_t bytes) ;\r
+</PRE>\r
+\r
+<P>\r
+<b>Note:</b> Unless you are writing an external decoder/encode that uses\r
+libsndfile to handle the file headers, you should not be using these\r
+functions.\r
+</P>\r
+\r
+<P>\r
+The raw read and write functions read raw audio data from the audio file (not to be\r
+confused with reading RAW header-less PCM files). The number of bytes read or written\r
+must always be an integer multiple of the number of channels multiplied by the number\r
+of bytes required to represent one sample from one channel.\r
+</P>\r
+<!-- pepper -->\r
+<P>\r
+The raw read and write functions return the number of bytes read or written (which\r
+should be the same as the bytes parameter).\r
+</P>\r
+\r
+<P>\r
+<B>\r
+Note : The result of using of both regular reads/writes and raw reads/writes on\r
+compressed file formats other than SF_FORMAT_ALAW and SF_FORMAT_ULAW is undefined.\r
+</B>\r
+</P>\r
+\r
+<p>\r
+See also : <a href="command.html#SFC_RAW_NEEDS_ENDSWAP">SFC_RAW_NEEDS_ENDSWAP</a>\r
+</p>\r
+\r
+<A NAME="string"></A>\r
+<H2><BR><B>Functions for Reading and Writing String Data</B></H2>\r
+\r
+\r
+<PRE>\r
+ const char* sf_get_string (SNDFILE *sndfile, int str_type) ;\r
+ int sf_set_string (SNDFILE *sndfile, int str_type, const char* str) ;\r
+</PRE>\r
+\r
+<P>\r
+These functions allow strings to be set on files opened for write and to be\r
+retrieved from files opened for read where supported by the given file type.\r
+The <B>str_type</B> parameter can be any one of the following string types:\r
+</P>\r
+\r
+<PRE>\r
+ enum\r
+ { SF_STR_TITLE,\r
+ SF_STR_COPYRIGHT,\r
+ SF_STR_SOFTWARE,\r
+ SF_STR_ARTIST,\r
+ SF_STR_COMMENT,\r
+ SF_STR_DATE,\r
+ SF_STR_ALBUM,\r
+ SF_STR_LICENSE,\r
+ SF_STR_TRACKNUMBER,\r
+ SF_STR_GENRE\r
+ } ;\r
+</PRE>\r
+\r
+<P>\r
+The sf_get_string() function returns the specified string if it exists and a\r
+NULL pointer otherwise.\r
+In addition to the string ids above, SF_STR_FIRST (== SF_STR_TITLE) and\r
+SF_STR_LAST (always the same as the highest numbers string id) are also\r
+available to allow iteration over all the available string ids.\r
+</P>\r
+\r
+<P>\r
+The sf_set_string() function sets the string data.\r
+It returns zero on success and non-zero on error.\r
+The error code can be converted to a string using sf_error_number().\r
+</P>\r
+\r
+\r
+<P>\r
+\r
+</P>\r
+\r
+<HR>\r
+\r
+<A NAME="note1"></A>\r
+<H2><BR><B>Note 1</B></H2>\r
+<!-- pepper -->\r
+<P>\r
+When converting between integer PCM formats of differing size (ie using sf_read_int()\r
+to read a 16 bit PCM encoded WAV file) libsndfile obeys one simple rule:\r
+</P>\r
+\r
+<P CLASS=indent_block>\r
+Whenever integer data is moved from one sized container to another sized container,\r
+the most significant bit in the source container will become the most significant bit\r
+in the destination container.\r
+</P>\r
+\r
+<P>\r
+When converting between integer data and floating point data, different rules apply.\r
+The default behaviour when reading floating point data (sf_read_float() or\r
+sf_read_double ()) from a file with integer data is normalisation. Regardless of\r
+whether data in the file is 8, 16, 24 or 32 bit wide, the data will be read as\r
+floating point data in the range [-1.0, 1.0]. Similarly, data in the range [-1.0, 1.0]\r
+will be written to an integer PCM file so that a data value of 1.0 will be the largest\r
+allowable integer for the given bit width. This normalisation can be turned on or off\r
+using the <A HREF="command.html">sf_command</A> interface.\r
+</P>\r
+\r
+<A NAME="note2"></A>\r
+<H2><BR><B>Note 2</B></H2>\r
+\r
+<P>\r
+Reading a file containg floating point data (allowable with WAV, AIFF, AU and other\r
+file formats) using integer read methods (sf_read_short() or sf_read_int()) can\r
+produce unexpected results.\r
+For instance the data in the file may have a maximum absolute value < 1.0 which\r
+would mean that all sample values read from the file will be zero.\r
+In order to read these files correctly using integer read methods, it is recommended\r
+that you use the\r
+ <A HREF="command.html">sf_command</A>\r
+interface, a command of\r
+ <A HREF="command.html#SFC_SET_SCALE_FLOAT_INT_READ">SFC_SET_SCALE_FLOAT_INT_READ</A>\r
+and a parameter of SF_TRUE to force correct scaling.\r
+</P>\r
+<!-- pepper -->\r
+<HR>\r
+<!-- pepper -->\r
+<P>\r
+ The libsndfile home page is\r
+ <A HREF="http://www.mega-nerd.com/libsndfile/">here</A>.\r
+</P>\r
+<P>\r
+Version : 1.0.25\r
+</P>\r
+<!-- pepper -->\r
+<!-- pepper -->\r
+<!-- pepper -->\r
+<!-- pepper -->\r
+\r
+</BODY>\r
+</HTML>\r
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">\r
+<HTML>\r
+\r
+<HEAD>\r
+ <TITLE>\r
+ Bug Reporting\r
+ </TITLE>\r
+ <META NAME="Author" CONTENT="Erik de Castro Lopo (erikd AT mega-nerd DOT com)">\r
+ <LINK REL="stylesheet" HREF="libsndfile.css" TYPE="text/css" MEDIA="all">\r
+ <LINK REL="stylesheet" HREF="print.css" TYPE="text/css" MEDIA="print">\r
+</HEAD>\r
+\r
+<BODY>\r
+\r
+<CENTER>\r
+ <H1><B>Reporting Bugs in libsndfile</B></H1>\r
+</CENTER>\r
+<P>\r
+ Before even attempting to report a bug in libsndfile please make sure you have\r
+ read the\r
+ <A HREF="FAQ.html">Frequently Asked Questions</A>.\r
+ If you are having a problem writing code using libsndfile make sure you read\r
+ the\r
+ <A HREF="api.html">Application Programming Interface</A>\r
+ documentation.\r
+</P>\r
+<P>\r
+ That said, I am interested in finding and fixing all genuine bugs in libsndfile.\r
+ Bugs I want to fix include any of the following problems (and probably others) :\r
+</P>\r
+ <UL>\r
+ <LI> Compilation problems on new platforms.\r
+ <LI> Errors being detected during the `make check' process.\r
+ <LI> Segmentation faults occuring inside libsndfile.\r
+ <LI> libsndfile hanging when opening a file.\r
+ <LI> Supported sound file types being incorrectly read or written.\r
+ <LI> Omissions, errors or spelling mistakes in the documentation.\r
+ </UL>\r
+\r
+<P>\r
+ When submitting a bug report you must include :\r
+</P>\r
+ <UL>\r
+ <LI> Your system (CPU and memory size should be enough).\r
+ <LI> The operating system you are using.\r
+ <LI> Whether you are using a package provided by your distribution or you\r
+ compiled it youself.\r
+ <LI> If you compiled it yourself, the compiler you are using. (Also make\r
+ sure to run 'make check'.)\r
+ <LI> A description of the problem.\r
+ <LI> Information generated by the sndfile-info program (see next paragraph).\r
+ <LI> If you are having problems with sndfile-play and ALSA on Linux, I will\r
+ need information about your kernel, ALSA version, compiler version,\r
+ whether you compiled the kernel/ALSA your self or installed from a\r
+ package etc.\r
+ </UL>\r
+\r
+<P>\r
+ If libsndfile compiles and installs correctly but has difficulty reading a particular\r
+ file or type of file you should run the <B>sndfile-info</B> program (from the examples\r
+ directory of the libsndfile distribution) on the file. See\r
+ <A HREF="sndfile_info.html">here</A>\r
+ for an example of the use of the <B>sndfile-info</B> program.\r
+</P>\r
+<P>\r
+ Please do not send me a sound file which fails to open under libsndfile unless I\r
+ specifically ask you to. The above information should usually suffice for most\r
+ problems.\r
+</P>\r
+<P>\r
+ Once you have the above information you should email it to one of the\r
+ <A HREF="lists.html">mailing lists</a>\r
+ (posting to these lists is limited to the list subscribers).\r
+\r
+</P>\r
+</BODY>\r
+</HTML>\r
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">\r
+<HTML>\r
+\r
+<HEAD>\r
+ <TITLE>\r
+ libsndfile : the sf_command function.\r
+ </TITLE>\r
+ <META NAME="Author" CONTENT="Erik de Castro Lopo (erikd AT mega-nerd DOT com)">\r
+ <!-- Another version at the bottom of the page. -->\r
+ <META NAME="Description" CONTENT="The libsndfile API.">\r
+ <META NAME="Keywords" CONTENT="WAV AIFF AU libsndfile sound audio dsp Linux">\r
+ <LINK REL="stylesheet" HREF="libsndfile.css" TYPE="text/css" MEDIA="all">\r
+ <LINK REL="stylesheet" HREF="print.css" TYPE="text/css" MEDIA="print">\r
+</HEAD>\r
+\r
+<BODY>\r
+\r
+<H1><B>sf_command</B></H1>\r
+<PRE>\r
+\r
+ int sf_command (SNDFILE *sndfile, int cmd, void *data, int datasize) ;\r
+</PRE>\r
+<P>\r
+ This function allows the caller to retrieve information from or change aspects of the\r
+ library behaviour.\r
+ Examples include retrieving a string containing the library version or changing the\r
+ scaling applied to floating point sample data during read and write.\r
+ Most of these operations are performed on a per-file basis.\r
+</P>\r
+<P>\r
+ The cmd parameter is an integer identifier which is defined in <sndfile.h>.\r
+ All of the valid command identifiers have names beginning with "SFC_".\r
+ Data is passed to and returned from the library by use of a void pointer.\r
+ The library will not read or write more than datasize bytes from the void pointer.\r
+ For some calls no data is required in which case data should be NULL and datasize\r
+ may be used for some other purpose.\r
+</P>\r
+<P>\r
+ The available commands are as follows:\r
+</P>\r
+\r
+<CENTER>\r
+<TABLE BORDER="0" WIDTH="90%" CELLPADDING="4">\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_LIB_VERSION">SFC_GET_LIB_VERSION</A></TD>\r
+ <TD>Retrieve the version of the library.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_LOG_INFO">SFC_GET_LOG_INFO</A></TD>\r
+ <TD>Retrieve the internal per-file operation log.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_CALC_SIGNAL_MAX">SFC_CALC_SIGNAL_MAX</A></TD>\r
+ <TD>Calculate the measured maximum signal value.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_CALC_NORM_SIGNAL_MAX">SFC_CALC_NORM_SIGNAL_MAX</A></TD>\r
+ <TD>Calculate the measured normalised maximum signal value.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_CALC_MAX_ALL_CHANNELS">SFC_CALC_MAX_ALL_CHANNELS</A></TD>\r
+ <TD>Calculate the peak value for each channel.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_CALC_NORM_MAX_ALL_CHANNELS">SFC_CALC_NORM_MAX_ALL_CHANNELS</A></TD>\r
+ <TD>Calculate the normalised peak for each channel.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_SIGNAL_MAX">SFC_GET_SIGNAL_MAX</A></TD>\r
+ <TD>Retrieve the peak value for the file (as stored in the file header).</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_MAX_ALL_CHANNELS">SFC_GET_MAX_ALL_CHANNELS</A></TD>\r
+ <TD>Retrieve the peak value for each channel (as stored in the file header).</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_SET_NORM_FLOAT">SFC_SET_NORM_FLOAT</A></TD>\r
+ <TD>Modify the normalisation behaviour of the floating point reading and writing functions.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_SET_NORM_DOUBLE">SFC_SET_NORM_DOUBLE</A></TD>\r
+ <TD>Modify the normalisation behaviour of the double precision floating point reading and writing functions.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_NORM_FLOAT">SFC_GET_NORM_FLOAT</A></TD>\r
+ <TD>Retrieve the current normalisation behaviour of the floating point reading and writing functions.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_NORM_DOUBLE">SFC_GET_NORM_DOUBLE</A></TD>\r
+ <TD>Retrieve the current normalisation behaviour of the double precision floating point reading and writing functions.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_SET_SCALE_FLOAT_INT_READ">SFC_SET_SCALE_FLOAT_INT_READ</A></TD>\r
+ <TD>Set/clear the scale factor when integer (short/int) data is read from a file\r
+ containing floating point data.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_SET_SCALE_INT_FLOAT_WRITE">SFC_SET_SCALE_INT_FLOAT_WRITE</A></TD>\r
+ <TD>Set/clear the scale factor when integer (short/int) data is written to a file\r
+ as floating point data.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_SIMPLE_FORMAT_COUNT">SFC_GET_SIMPLE_FORMAT_COUNT</A></TD>\r
+ <TD>Retrieve the number of simple formats supported by libsndfile.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_SIMPLE_FORMAT">SFC_GET_SIMPLE_FORMAT</A></TD>\r
+ <TD>Retrieve information about a simple format.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_FORMAT_INFO">SFC_GET_FORMAT_INFO</A></TD>\r
+ <TD>Retrieve information about a major or subtype format.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_FORMAT_MAJOR_COUNT">SFC_GET_FORMAT_MAJOR_COUNT</A></TD>\r
+ <TD>Retrieve the number of major formats.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_FORMAT_MAJOR">SFC_GET_FORMAT_MAJOR</A></TD>\r
+ <TD>Retrieve information about a major format type.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_FORMAT_SUBTYPE_COUNT">SFC_GET_FORMAT_SUBTYPE_COUNT</A></TD>\r
+ <TD>Retrieve the number of subformats.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_FORMAT_SUBTYPE">SFC_GET_FORMAT_SUBTYPE</A></TD>\r
+ <TD>Retrieve information about a subformat.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_SET_ADD_PEAK_CHUNK">SFC_SET_ADD_PEAK_CHUNK</A></TD>\r
+ <TD>Switch the code for adding the PEAK chunk to WAV and AIFF files on or off.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_UPDATE_HEADER_NOW">SFC_UPDATE_HEADER_NOW</A></TD>\r
+ <TD>Used when a file is open for write, this command will update the file\r
+ header to reflect the data written so far.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_SET_UPDATE_HEADER_AUTO">SFC_SET_UPDATE_HEADER_AUTO</A></TD>\r
+ <TD>Used when a file is open for write, this command will cause the file header\r
+ to be updated after each write to the file.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_FILE_TRUNCATE">SFC_FILE_TRUNCATE</A></TD>\r
+ <TD>Truncate a file open for write or for read/write.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_SET_RAW_START_OFFSET">SFC_SET_RAW_START_OFFSET</A></TD>\r
+ <TD>Change the data start offset for files opened up as SF_FORMAT_RAW.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_SET_CLIPPING">SFC_SET_CLIPPING</A></TD>\r
+ <TD>Turn on/off automatic clipping when doing floating point to integer\r
+ conversion.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_CLIPPING">SFC_GET_CLIPPING</A></TD>\r
+ <TD>Retrieve current clipping setting.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_EMBED_FILE_INFO">SFC_GET_EMBED_FILE_INFO</A></TD>\r
+ <TD>Retrieve information about audio files embedded inside other files.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_WAVEX_GET_AMBISONIC">SFC_GET_AMBISONIC</A></TD>\r
+ <TD>Test a WAVEX file for Ambisonic format</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_WAVEX_SET_AMBISONIC">SFC_SET_AMBISONIC</A></TD>\r
+ <TD>Modify a WAVEX header for Ambisonic format</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_SET_VBR_ENCODING_QUALITY">SFC_SET_VBR_ENCODING_QUALITY</A></TD>\r
+ <TD>Set the the Variable Bit Rate encoding quality</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_RAW_NEEDS_ENDSWAP">SFC_RAW_NEEDS_ENDSWAP</a></td>\r
+ <TD>Determine if raw data needs endswapping</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_BROADCAST_INFO">SFC_GET_BROADCAST_INFO</A></TD>\r
+ <TD>Retrieve the Broadcast Chunk info</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_SET_BROADCAST_INFO">SFC_SET_BROADCAST_INFO</A></TD>\r
+ <TD>Set the Broadcast Chunk info</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_LOOP_INFO">SFC_GET_LOOP_INFO</A></TD>\r
+ <TD>Get loop info</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_INSTRUMENT">SFC_GET_INSTRUMENT</A></TD>\r
+ <TD>Get instrument info</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_SET_INSTRUMENT">SFC_SET_INSTRUMENT</A></TD>\r
+ <TD>Set instrument info</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_SET_VBR_ENCODING_QUALITY">SFC_SET_VBR_ENCODING_QUALITY</A></TD>\r
+ <TD>Set variable bit rate encoding quality</TD>\r
+</TR>\r
+\r
+\r
+\r
+<!--\r
+<TR>\r
+ <TD><A HREF="#add-dither">add dither</A></TD>\r
+ <TD>Add dither to output on write.</TD>\r
+</TR>\r
+-->\r
+</TABLE>\r
+</CENTER>\r
+\r
+<BR><BR>\r
+\r
+<HR>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_LIB_VERSION"></A>\r
+<H2><BR><B>SFC_GET_LIB_VERSION</B></H2>\r
+<P>\r
+Retrieve the version of the library as a string.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : Not used\r
+ cmd : SFC_GET_LIB_VERSION\r
+ data : A pointer to a char buffer\r
+ datasize : The size of the the buffer\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ char buffer [128] ;\r
+ sf_command (NULL, SFC_GET_LIB_VERSION, buffer, sizeof (buffer)) ;\r
+</PRE>\r
+\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD><DD>This call will return the length of the retrieved version string.\r
+</DL>\r
+<DL>\r
+<DT>Notes:</DT>\r
+<DD>\r
+The string returned in the buffer passed to this function will not overflow\r
+the buffer and will always be null terminated .\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_LOG_INFO"></A>\r
+<H2><BR><B>SFC_GET_LOG_INFO</B></H2>\r
+<P>\r
+Retrieve the log buffer generated when opening a file as a string. This log\r
+buffer can often contain a good reason for why libsndfile failed to open a\r
+particular file.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_GET_LOG_INFO\r
+ data : A pointer to a char buffer\r
+ datasize : The size of the the buffer\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ char buffer [2048] ;\r
+ sf_command (sndfile, SFC_GET_LOG_INFO, buffer, sizeof (buffer)) ;\r
+</PRE>\r
+\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD><DD>This call will return the length of the retrieved version string.\r
+</DL>\r
+<DL>\r
+<DT>Notes:</DT>\r
+<DD>\r
+The string returned in the buffer passed to this function will not overflow\r
+the buffer and will always be null terminated .\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_CALC_SIGNAL_MAX"></A>\r
+<H2><BR><B>SFC_CALC_SIGNAL_MAX</B></H2>\r
+<P>\r
+Retrieve the measured maximum signal value. This involves reading through\r
+the whole file which can be slow on large files.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_CALC_SIGNAL_MAX\r
+ data : A pointer to a double\r
+ datasize : sizeof (double)\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ double max_val ;\r
+ sf_command (sndfile, SFC_CALC_SIGNAL_MAX, &max_val, sizeof (max_val)) ;\r
+</PRE>\r
+\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD><DD>Zero on success, non-zero otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_CALC_NORM_SIGNAL_MAX"></A>\r
+<H2><BR><B>SFC_CALC_NORM_SIGNAL_MAX</B></H2>\r
+<P>\r
+Retrieve the measured normalised maximum signal value. This involves reading\r
+through the whole file which can be slow on large files.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_CALC_NORM_SIGNAL_MAX\r
+ data : A pointer to a double\r
+ datasize : sizeof (double)\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ double max_val ;\r
+ sf_command (sndfile, SFC_CALC_NORM_SIGNAL_MAX, &max_val, sizeof (max_val)) ;\r
+</PRE>\r
+\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD><DD>Zero on success, non-zero otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_CALC_MAX_ALL_CHANNELS"></A>\r
+<H2><BR><B>SFC_CALC_MAX_ALL_CHANNELS</B></H2>\r
+<P>\r
+Calculate the peak value (ie a single number) for each channel.\r
+This involves reading through the whole file which can be slow on large files.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_CALC_MAX_ALL_CHANNELS\r
+ data : A pointer to a double\r
+ datasize : sizeof (double) * number_of_channels\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ double peaks [number_of_channels] ;\r
+ sf_command (sndfile, SFC_CALC_MAX_ALL_CHANNELS, peaks, sizeof (peaks)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD>Zero if peaks have been calculated successfully and non-zero otherwise.\r
+</DL>\r
+\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_CALC_NORM_MAX_ALL_CHANNELS"></A>\r
+<H2><BR><B>SFC_CALC_NORM_MAX_ALL_CHANNELS</B></H2>\r
+<P>\r
+Calculate the normalised peak for each channel.\r
+This involves reading through the whole file which can be slow on large files.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_CALC_NORM_MAX_ALL_CHANNELS\r
+ data : A pointer to a double\r
+ datasize : sizeof (double) * number_of_channels\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ double peaks [number_of_channels] ;\r
+ sf_command (sndfile, SFC_CALC_NORM_MAX_ALL_CHANNELS, peaks, sizeof (peaks)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD>Zero if peaks have been calculated successfully and non-zero otherwise.\r
+</DL>\r
+\r
+\r
+\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_SIGNAL_MAX"></A>\r
+<H2><BR><B>SFC_GET_SIGNAL_MAX</B></H2>\r
+<P>\r
+Retrieve the peak value for the file as stored in the file header.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_GET_SIGNAL_MAX\r
+ data : A pointer to a double\r
+ datasize : sizeof (double)\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ double max_peak ;\r
+ sf_command (sndfile, SFC_GET_SIGNAL_MAX, &max_peak, sizeof (max_peak)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD>SF_TRUE if the file header contained the peak value. SF_FALSE otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_MAX_ALL_CHANNELS"></A>\r
+<H2><BR><B>SFC_GET_MAX_ALL_CHANNELS</B></H2>\r
+<P>\r
+Retrieve the peak value for the file as stored in the file header.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_GET_SIGNAL_MAX\r
+ data : A pointer to an array of doubles\r
+ datasize : sizeof (double) * number_of_channels\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ double peaks [number_of_channels] ;\r
+ sf_command (sndfile, SFC_GET_MAX_ALL_CHANNELS, peaks, sizeof (peaks)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD>SF_TRUE if the file header contains per channel peak values for the file.\r
+ SF_FALSE otherwise.\r
+</DL>\r
+\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_SET_NORM_FLOAT"></A>\r
+<H2><BR><B>SFC_SET_NORM_FLOAT</B></H2>\r
+<P>\r
+This command only affects data read from or written to using the floating point functions:\r
+</P>\r
+<PRE>\r
+ size_t <A HREF="api.html#read">sf_read_float</A> (SNDFILE *sndfile, float *ptr, size_t items) ;\r
+ size_t <A HREF="api.html#readf">sf_readf_float</A> (SNDFILE *sndfile, float *ptr, size_t frames) ;\r
+\r
+ size_t <A HREF="api.html#write">sf_write_float</A> (SNDFILE *sndfile, float *ptr, size_t items) ;\r
+ size_t <A HREF="api.html#writef">sf_writef_float</A> (SNDFILE *sndfile, float *ptr, size_t frames) ;\r
+</PRE>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_SET_NORM_FLOAT\r
+ data : NULL\r
+ datasize : SF_TRUE or SF_FALSE\r
+</PRE>\r
+<P>\r
+For read operations setting normalisation to SF_TRUE means that the data from all\r
+subsequent reads will be be normalised to the range [-1.0, 1.0].\r
+</P>\r
+<P>\r
+For write operations, setting normalisation to SF_TRUE means than all data supplied\r
+to the float write functions should be in the range [-1.0, 1.0] and will be scaled\r
+for the file format as necessary.\r
+</P>\r
+<P>\r
+For both cases, setting normalisation to SF_FALSE means that no scaling will take place.\r
+</P>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ sf_command (sndfile, SFC_SET_NORM_FLOAT, NULL, SF_TRUE) ;\r
+\r
+ sf_command (sndfile, SFC_SET_NORM_FLOAT, NULL, SF_FALSE) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>Returns the previous float normalisation mode.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_SET_NORM_DOUBLE"></A>\r
+<H2><BR><B>SFC_SET_NORM_DOUBLE</B></H2>\r
+<P>\r
+This command only affects data read from or written to using the double precision\r
+floating point functions:\r
+</P>\r
+<PRE>\r
+ size_t <A HREF="api.html#read">sf_read_double</A> (SNDFILE *sndfile, double *ptr, size_t items) ;\r
+ size_t <A HREF="api.html#readf">sf_readf_double</A> (SNDFILE *sndfile, double *ptr, size_t frames) ;\r
+\r
+ size_t <A HREF="api.html#write">sf_write_double</A> (SNDFILE *sndfile, double *ptr, size_t items) ;\r
+ size_t <A HREF="api.html#writef">sf_writef_double</A> (SNDFILE *sndfile, double *ptr, size_t frames) ;\r
+</PRE>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_SET_NORM_DOUBLE\r
+ data : NULL\r
+ datasize : SF_TRUE or SF_FALSE\r
+</PRE>\r
+<P>\r
+For read operations setting normalisation to SF_TRUE means that the data\r
+from all subsequent reads will be be normalised to the range [-1.0, 1.0].\r
+</P>\r
+<P>\r
+For write operations, setting normalisation to SF_TRUE means than all data supplied\r
+to the double write functions should be in the range [-1.0, 1.0] and will be scaled\r
+for the file format as necessary.\r
+</P>\r
+<P>\r
+For both cases, setting normalisation to SF_FALSE means that no scaling will take place.\r
+</P>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ sf_command (sndfile, SFC_SET_NORM_DOUBLE, NULL, SF_TRUE) ;\r
+\r
+ sf_command (sndfile, SFC_SET_NORM_DOUBLE, NULL, SF_FALSE) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>Returns the previous double normalisation mode.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_NORM_FLOAT"></A>\r
+<H2><BR><B>SFC_GET_NORM_FLOAT</B></H2>\r
+<P>\r
+Retrieve the current float normalisation mode.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_GET_NORM_FLOAT\r
+ data : NULL\r
+ datasize : anything\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ normalisation = sf_command (sndfile, SFC_GET_NORM_FLOAT, NULL, 0) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>Returns TRUE if normalisation is on and FALSE otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_NORM_DOUBLE"></A>\r
+<H2><BR><B>SFC_GET_NORM_DOUBLE</B></H2>\r
+<P>\r
+Retrieve the current float normalisation mode.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_GET_NORM_DOUBLE\r
+ data : NULL\r
+ datasize : anything\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ normalisation = sf_command (sndfile, SFC_GET_NORM_DOUBLE, NULL, 0) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>Returns TRUE if normalisation is on and FALSE otherwise.\r
+</DL>\r
+\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_SET_SCALE_FLOAT_INT_READ"></A>\r
+<H2><BR><B>SFC_SET_SCALE_FLOAT_INT_READ</B></H2>\r
+<P>\r
+Set/clear the scale factor when integer (short/int) data is read from a file\r
+containing floating point data.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_SET_SCALE_FLOAT_INT_READ\r
+ data : NULL\r
+ datasize : TRUE or FALSE\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ sf_command (sndfile, SFC_SET_SCALE_FLOAT_INT_READ, NULL, SF_TRUE) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>Returns the previous SFC_SET_SCALE_FLOAT_INT_READ setting for this file.\r
+</DL>\r
+\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_SET_SCALE_INT_FLOAT_WRITE"></A>\r
+<H2><BR><B>SFC_SET_SCALE_INT_FLOAT_WRITE</B></H2>\r
+<P>\r
+Set/clear the scale factor when integer (short/int) data is written to a file\r
+as floating point data.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_SET_SCALE_FLOAT_INT_READ\r
+ data : NULL\r
+ datasize : TRUE or FALSE\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ sf_command (sndfile, SFC_SET_SCALE_INT_FLOAT_WRITE, NULL, SF_TRUE) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>Returns the previous SFC_SET_SCALE_INT_FLOAT_WRITE setting for this file.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_SIMPLE_FORMAT_COUNT"></A>\r
+<H2><BR><B>SFC_GET_SIMPLE_FORMAT_COUNT</B></H2>\r
+<P>\r
+Retrieve the number of simple formats supported by libsndfile.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : Not used.\r
+ cmd : SFC_GET_SIMPLE_FORMAT_COUNT\r
+ data : a pointer to an int\r
+ datasize : sizeof (int)\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ int count ;\r
+ sf_command (sndfile, SFC_GET_SIMPLE_FORMAT_COUNT, &count, sizeof (int)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>0\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_SIMPLE_FORMAT"></A>\r
+<H2><BR><B>SFC_GET_SIMPLE_FORMAT</B></H2>\r
+<P>\r
+Retrieve information about a simple format.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : Not used.\r
+ cmd : SFC_GET_SIMPLE_FORMAT\r
+ data : a pointer to an SF_FORMAT_INFO struct\r
+ datasize : sizeof (SF_FORMAT_INFO)\r
+</PRE>\r
+<P>\r
+The SF_FORMAT_INFO struct is defined in <sndfile.h> as:\r
+</P>\r
+<PRE>\r
+ typedef struct\r
+ { int format ;\r
+ const char *name ;\r
+ const char *extension ;\r
+ } SF_FORMAT_INFO ;\r
+</PRE>\r
+<P>\r
+When sf_command() is called with SF_GET_SIMPLE_FORMAT, the value of the format\r
+field should be the format number (ie 0 <= format <= count value obtained using\r
+SF_GET_SIMPLE_FORMAT_COUNT).\r
+</P>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ SF_FORMAT_INFO format_info ;\r
+ int k, count ;\r
+\r
+ sf_command (sndfile, SFC_GET_SIMPLE_FORMAT_COUNT, &count, sizeof (int)) ;\r
+\r
+ for (k = 0 ; k < count ; k++)\r
+ { format_info.format = k ;\r
+ sf_command (sndfile, SFC_GET_SIMPLE_FORMAT, &format_info, sizeof (format_info)) ;\r
+ printf ("%08x %s %s\n", format_info.format, format_info.name, format_info.extension) ;\r
+ } ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>0 on success and non-zero otherwise.\r
+ <DD>The value of the format field of the SF_FORMAT_INFO struct will be a value which\r
+ can be placed in the format field of an SF_INFO struct when a file is to be opened\r
+ for write.\r
+ <DD>The name field will contain a char* pointer to the name of the string, eg. "WAV (Microsoft 16 bit PCM)".\r
+ <DD>The extension field will contain the most commonly used file extension for that file type.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_FORMAT_INFO"></A>\r
+<H2><BR><B>SFC_GET_FORMAT_INFO</B></H2>\r
+<P>\r
+Retrieve information about a major or subtype format.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : Not used.\r
+ cmd : SFC_GET_FORMAT_INFO\r
+ data : a pointer to an SF_FORMAT_INFO struct\r
+ datasize : sizeof (SF_FORMAT_INFO)\r
+</PRE>\r
+<P>\r
+The SF_FORMAT_INFO struct is defined in <sndfile.h> as:\r
+</P>\r
+<PRE>\r
+ typedef struct\r
+ { int format ;\r
+ const char *name ;\r
+ const char *extension ;\r
+ } SF_FORMAT_INFO ;\r
+</PRE>\r
+<P>\r
+When sf_command() is called with SF_GET_FORMAT_INFO, the format field is\r
+examined and if (format & SF_FORMAT_TYPEMASK) is a valid format then the struct\r
+is filled in with information about the given major type.\r
+If (format & SF_FORMAT_TYPEMASK) is FALSE and (format & SF_FORMAT_SUBMASK) is a\r
+valid subtype format then the struct is filled in with information about the given\r
+subtype.\r
+</P>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ SF_FORMAT_INFO format_info ;\r
+\r
+ format_info.format = SF_FORMAT_WAV ;\r
+ sf_command (sndfile, SFC_GET_FORMAT_INFO, &format_info, sizeof (format_info)) ;\r
+ printf ("%08x %s %s\n", format_info.format, format_info.name, format_info.extension) ;\r
+\r
+ format_info.format = SF_FORMAT_ULAW ;\r
+ sf_command (sndfile, SFC_GET_FORMAT_INFO, &format_info, sizeof (format_info)) ;\r
+ printf ("%08x %s\n", format_info.format, format_info.name) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>0 on success and non-zero otherwise.\r
+</DL>\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_FORMAT_MAJOR_COUNT"></A>\r
+<H2><BR><B>SFC_GET_FORMAT_MAJOR_COUNT</B></H2>\r
+<P>\r
+Retrieve the number of major formats.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : Not used.\r
+ cmd : SFC_GET_FORMAT_MAJOR_COUNT\r
+ data : a pointer to an int\r
+ datasize : sizeof (int)\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ int count ;\r
+ sf_command (sndfile, SFC_GET_FORMAT_MAJOR_COUNT, &count, sizeof (int)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>0\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_FORMAT_MAJOR"></A>\r
+<H2><BR><B>SFC_GET_FORMAT_MAJOR</B></H2>\r
+<P>\r
+Retrieve information about a major format type.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : Not used.\r
+ cmd : SFC_GET_FORMAT_MAJOR\r
+ data : a pointer to an SF_FORMAT_INFO struct\r
+ datasize : sizeof (SF_FORMAT_INFO)\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ SF_FORMAT_INFO format_info ;\r
+ int k, count ;\r
+\r
+ sf_command (sndfile, SFC_GET_FORMAT_MAJOR_COUNT, &count, sizeof (int)) ;\r
+\r
+ for (k = 0 ; k < count ; k++)\r
+ { format_info.format = k ;\r
+ sf_command (sndfile, SFC_GET_FORMAT_MAJOR, &format_info, sizeof (format_info)) ;\r
+ printf ("%08x %s %s\n", format_info.format, format_info.name, format_info.extension) ;\r
+ } ;\r
+</PRE>\r
+<P>\r
+For a more comprehensive example, see the program list_formats.c in the examples/\r
+directory of the libsndfile source code distribution.\r
+</P>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>0 on success and non-zero otherwise.\r
+ <DD>The value of the format field will be one of the major format identifiers such as\r
+ SF_FORMAT_WAV or SF_FORMAT_AIFF.\r
+ <DD>The name field will contain a char* pointer to the name of the string, eg. "WAV (Microsoft)".\r
+ <DD>The extension field will contain the most commonly used file extension for that file type.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_FORMAT_SUBTYPE_COUNT"></A>\r
+<H2><BR><B>SFC_GET_FORMAT_SUBTYPE_COUNT</B></H2>\r
+<P>\r
+Retrieve the number of subformats.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : Not used.\r
+ cmd : SFC_GET_FORMAT_SUBTYPE_COUNT\r
+ data : a pointer to an int\r
+ datasize : sizeof (int)\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ int count ;\r
+ sf_command (sndfile, SFC_GET_FORMAT_SUBTYPE_COUNT, &count, sizeof (int)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>0\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_FORMAT_SUBTYPE"></A>\r
+<H2><BR><B>SFC_GET_FORMAT_SUBTYPE</B></H2>\r
+<P>\r
+Enumerate the subtypes (this function does not translate a subtype into\r
+a string describing that subtype).\r
+A typical use case might be retrieving a string description of all subtypes\r
+so that a dialog box can be filled in.\r
+</P>\r
+<P>\r
+\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : Not used.\r
+ cmd : SFC_GET_FORMAT_SUBTYPE\r
+ data : a pointer to an SF_FORMAT_INFO struct\r
+ datasize : sizeof (SF_FORMAT_INFO)\r
+</PRE>\r
+<P>\r
+Example 1: Retrieve all sybtypes supported by the WAV format.\r
+</P>\r
+<PRE>\r
+ SF_FORMAT_INFO format_info ;\r
+ int k, count ;\r
+\r
+ sf_command (sndfile, SFC_GET_FORMAT_SUBTYPE_COUNT, &count, sizeof (int)) ;\r
+\r
+ for (k = 0 ; k < count ; k++)\r
+ { format_info.format = k ;\r
+ sf_command (sndfile, SFC_GET_FORMAT_SUBTYPE, &format_info, sizeof (format_info)) ;\r
+ if (! sf_format_check (format_info.format | SF_FORMAT_WAV))\r
+ continue ;\r
+ printf ("%08x %s\n", format_info.format, format_info.name) ;\r
+ } ;\r
+</PRE>\r
+<P>\r
+Example 2: Print a string describing the SF_FORMAT_PCM_16 subtype.\r
+</P>\r
+<PRE>\r
+ SF_FORMAT_INFO format_info ;\r
+ int k, count ;\r
+\r
+ sf_command (sndfile, SFC_GET_FORMAT_SUBTYPE_COUNT, &count, sizeof (int)) ;\r
+\r
+ for (k = 0 ; k < count ; k++)\r
+ { format_info.format = k ;\r
+ sf_command (sndfile, SFC_GET_FORMAT_SUBTYPE, &format_info, sizeof (format_info)) ;\r
+ if (format_info.format == SF_FORMAT_PCM_16)\r
+ { printf ("%08x %s\n", format_info.format, format_info.name) ;\r
+ break ;\r
+ } ;\r
+ } ;\r
+</PRE>\r
+<P>\r
+For a more comprehensive example, see the program list_formats.c in the examples/\r
+directory of the libsndfile source code distribution.\r
+</P>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>0 on success and non-zero otherwise.\r
+ <DD>The value of the format field will be one of the major format identifiers such as\r
+ SF_FORMAT_WAV or SF_FORMAT_AIFF.\r
+ <DD>The name field will contain a char* pointer to the name of the string; for instance\r
+ "WAV (Microsoft)" or "AIFF (Apple/SGI)".\r
+ <DD>The extension field will be a NULL pointer.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_SET_ADD_PEAK_CHUNK"></A>\r
+<H2><BR><B>SFC_SET_ADD_PEAK_CHUNK</B></H2>\r
+<P>\r
+By default, WAV and AIFF files which contain floating point data (subtype SF_FORMAT_FLOAT\r
+or SF_FORMAT_DOUBLE) have a PEAK chunk.\r
+By using this command, the addition of a PEAK chunk can be turned on or off.\r
+</P>\r
+<P>\r
+Note : This call must be made before any data is written to the file.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_SET_ADD_PEAK_CHUNK\r
+ data : Not used (should be NULL)\r
+ datasize : TRUE or FALSE.\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ /* Turn on the PEAK chunk. */\r
+ sf_command (sndfile, SFC_SET_ADD_PEAK_CHUNK, NULL, SF_TRUE) ;\r
+\r
+ /* Turn off the PEAK chunk. */\r
+ sf_command (sndfile, SFC_SET_ADD_PEAK_CHUNK, NULL, SF_FALSE) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+<DD>Returns SF_TRUE if the peak chunk will be written after this call.\r
+<DD>Returns SF_FALSE if the peak chunk will not be written after this call.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_UPDATE_HEADER_NOW"></A>\r
+<H2><BR><B>SFC_UPDATE_HEADER_NOW</B></H2>\r
+<P>\r
+The header of an audio file is normally written by libsndfile when the file is\r
+closed using <B>sf_close()</B>.\r
+</P>\r
+<P>\r
+There are however situations where large files are being generated and it would\r
+be nice to have valid data in the header before the file is complete.\r
+Using this command will update the file header to reflect the amount of data written\r
+to the file so far.\r
+Other programs opening the file for read (before any more data is written) will\r
+then read a valid sound file header.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_UPDATE_HEADER_NOW\r
+ data : Not used (should be NULL)\r
+ datasize : Not used.\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ /* Update the header now. */\r
+ sf_command (sndfile, SFC_UPDATE_HEADER_NOW, NULL, 0) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+<DD>0\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_SET_UPDATE_HEADER_AUTO"></A>\r
+<H2><BR><B>SFC_SET_UPDATE_HEADER_AUTO</B></H2>\r
+<P>\r
+Similar to SFC_UPDATE_HEADER_NOW but updates the header at the end of every call\r
+to the <B>sf_write*</B> functions.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_UPDATE_HEADER_NOW\r
+ data : Not used (should be NULL)\r
+ datasize : SF_TRUE or SF_FALSE\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ /* Turn on auto header update. */\r
+ sf_command (sndfile, SFC_SET_UPDATE_HEADER_AUTO, NULL, SF_TRUE) ;\r
+\r
+ /* Turn off auto header update. */\r
+ sf_command (sndfile, SFC_SET_UPDATE_HEADER_AUTO, NULL, SF_FALSE) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+<DD>TRUE if auto update header is now on; FALSE otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_FILE_TRUNCATE"></A>\r
+<H2><BR><B>SFC_FILE_TRUNCATE</B></H2>\r
+<P>\r
+Truncate a file that was opened for write or read/write.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_FILE_TRUNCATE\r
+ data : A pointer to an sf_count_t.\r
+ datasize : sizeof (sf_count_t)\r
+</PRE>\r
+\r
+<P>\r
+Truncate the file to the number of frames specified by the sf_count_t pointed\r
+to by data.\r
+After this command, both the read and the write pointer will be\r
+at the new end of the file.\r
+This command will fail (returning non-zero) if the requested truncate position\r
+is beyond the end of the file.\r
+</P>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ /* Truncate the file to a length of 20 frames. */\r
+ sf_count_t frames = 20 ;\r
+ sf_command (sndfile, SFC_FILE_TRUNCATE, &frames, sizeof (frames)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD>Zero on sucess, non-zero otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_SET_RAW_START_OFFSET"></A>\r
+<H2><BR><B>SFC_SET_RAW_START_OFFSET</B></H2>\r
+<P>\r
+Change the data start offset for files opened up as SF_FORMAT_RAW.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_SET_RAW_START_OFFSET\r
+ data : A pointer to an sf_count_t.\r
+ datasize : sizeof (sf_count_t)\r
+</PRE>\r
+\r
+<P>\r
+For a file opened as format SF_FORMAT_RAW, set the data offset to the value\r
+given by data.\r
+</P>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ /* Reset the data offset to 5 bytes from the start of the file. */\r
+ sf_count_t offset = 5 ;\r
+ sf_command (sndfile, SFC_SET_RAW_START_OFFSET, &offset, sizeof (offset)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD>Zero on success, non-zero otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_SET_CLIPPING"></A>\r
+<H2><BR><B>SFC_SET_CLIPPING</B></H2>\r
+<P>\r
+Turn on/off automatic clipping when doing floating point to integer conversion.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_SET_CLIPPING\r
+ data : NULL\r
+ datasize : SF_TRUE or SF_FALSE.\r
+</PRE>\r
+\r
+<P>\r
+Turn on (datasize == SF_TRUE) or off (datasize == SF_FALSE) clipping.\r
+</P>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ sf_command (sndfile, SFC_SET_CLIPPING, NULL, SF_TRUE) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD>Clipping mode (SF_TRUE or SF_FALSE).\r
+</DL>\r
+\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_CLIPPING"></A>\r
+<H2><BR><B>SFC_GET_CLIPPING</B></H2>\r
+<P>\r
+Turn on/off automatic clipping when doing floating point to integer conversion.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_GET_CLIPPING\r
+ data : NULL\r
+ datasize : 0\r
+</PRE>\r
+\r
+<P>\r
+Retrieve the current cliiping setting.\r
+</P>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ sf_command (sndfile, SFC_GET_CLIPPING, NULL, 0) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD>Clipping mode (SF_TRUE or SF_FALSE).\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_EMBED_FILE_INFO"></A>\r
+<H2><BR><B>SFC_GET_EMBED_FILE_INFO</B></H2>\r
+<P>\r
+Get the file offset and file length of a file enbedded within another\r
+larger file.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_GET_CLIPPING\r
+ data : a pointer to an SF_EMBED_FILE_INFO struct\r
+ datasize : sizeof (SF_EMBED_FILE_INFO)\r
+</PRE>\r
+<P>\r
+The SF_EMBED_FILE_INFO struct is defined in <sndfile.h> as:\r
+</P>\r
+<PRE>\r
+ typedef struct\r
+ { sf_count_t offset ;\r
+ sf_count_t length ;\r
+ } SF_EMBED_FILE_INFO ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>0 on success and non-zero otherwise.\r
+ <DD>The value of the offset field of the SF_EMBED_FILE_INFO struct will be\r
+ the offsets in bytes from the start of the outer file to the start of\r
+ the audio file.\r
+ <DD>The value of the offset field of the SF_EMBED_FILE_INFO struct will be\r
+ the length in bytes of the embedded file.\r
+</DL>\r
+\r
+\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_WAVEX_GET_AMBISONIC"></A>\r
+<H2><BR><B>SFC_WAVEX_GET_AMBISONIC</B></H2>\r
+<P>\r
+Test if the current file has the GUID of a WAVEX file for any of the Ambisonic\r
+formats.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_WAVEX_GET_AMBISONIC\r
+ data : NULL\r
+ datasize : 0\r
+</PRE>\r
+<P>\r
+ The Ambisonic WAVEX formats are defined here :\r
+ <A HREF="http://dream.cs.bath.ac.uk/researchdev/wave-ex/bformat.html">\r
+ http://dream.cs.bath.ac.uk/researchdev/wave-ex/bformat.html</A>.\r
+</P>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>SF_AMBISONIC_NONE or SF_AMBISONIC_B_FORMAT or zero if the file format\r
+ does not support ambisonic formats.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_WAVEX_SET_AMBISONIC"></A>\r
+<H2><BR><B>SFC_WAVEX_SET_AMBISONIC</B></H2>\r
+<P>\r
+Set the GUID of a new WAVEX file to indicate an Ambisonics format.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_WAVEX_SET_AMBISONIC\r
+ data : NULL\r
+ datasize : SF_AMBISONIC_NONE or SF_AMBISONIC_B_FORMAT\r
+</PRE>\r
+<P>\r
+Turn on (SF_AMBISONIC_B_FORMAT) or off (SF_AMBISONIC_NONE) encoding.\r
+This command is currently only supported for files with SF_FORMAT_WAVEX format.\r
+</P>\r
+<P>\r
+ The Ambisonic WAVEX formats are defined here :\r
+ <A HREF="http://dream.cs.bath.ac.uk/researchdev/wave-ex/bformat.html">\r
+ http://dream.cs.bath.ac.uk/researchdev/wave-ex/bformat.html</A>.\r
+</P>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>Return the ambisonic value that has just been set or zero if the file\r
+ format does not support ambisonic encoding.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_SET_VBR_ENCODING_QUALITY"></A>\r
+<H2><BR><B>SFC_SET_VBR_ENCODING_QUALITY</B></H2>\r
+<P>\r
+Set the the Variable Bit Rate encoding quality.\r
+The encoding quality value should be between 0.0 (lowest quality) and 1.0\r
+(highest quality).\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_SET_VBR_ENCODING_QUALITY\r
+ data : A pointer to a double value\r
+ datasize : sizeof (double)\r
+</PRE>\r
+<P>\r
+The command must be sent before any audio data is written to the file.\r
+</P>\r
+<P>\r
+</P>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>Zero on success, non-zero otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_RAW_NEEDS_ENDSWAP"></A>\r
+<H2><BR><B>SFC_RAW_NEEDS_ENDSWAP</B></H2>\r
+<P>\r
+Determine if raw data read using\r
+ <a href="api.html#raw">\r
+ sf_read_raw</a>\r
+needs to be end swapped on the host CPU.\r
+</P>\r
+<P>\r
+For instance, will return SF_TRUE on when reading WAV containing\r
+SF_FORMAT_PCM_16 data on a big endian machine and SF_FALSE on a little endian\r
+machine.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_RAW_NEEDS_ENDSWAP\r
+ data : NULL\r
+ datasize : 0\r
+</PRE>\r
+\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>SF_TRUE or SF_FALSE\r
+</DL>\r
+\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_BROADCAST_INFO"></A>\r
+<H2><BR><B>SFC_GET_BROADCAST_INFO</B></H2>\r
+<P>\r
+Retrieve the Broadcast Extension Chunk from WAV (and related) files.\r
+</P>\r
+<p>\r
+Parameters:\r
+</p>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_GET_BROADCAST_INFO\r
+ data : a pointer to an SF_BROADCAST_INFO struct\r
+ datasize : sizeof (SF_BROADCAST_INFO)\r
+</PRE>\r
+<P>\r
+The SF_BROADCAST_INFO struct is defined in <sndfile.h> as:\r
+</P>\r
+<PRE>\r
+ typedef struct\r
+ { char description [256] ;\r
+ char originator [32] ;\r
+ char originator_reference [32] ;\r
+ char origination_date [10] ;\r
+ char origination_time [8] ;\r
+ unsigned int time_reference_low ;\r
+ unsigned int time_reference_high ;\r
+ short version ;\r
+ char umid [64] ;\r
+ char reserved [190] ;\r
+ unsigned int coding_history_size ;\r
+ char coding_history [256] ;\r
+ } SF_BROADCAST_INFO ;\r
+</PRE>\r
+\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>SF_TRUE if the file contained a Broadcast Extension chunk or SF_FALSE\r
+ otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_SET_BROADCAST_INFO"></A>\r
+<H2><BR><B>SFC_SET_BROADCAST_INFO</B></H2>\r
+<P>\r
+Set the Broadcast Extension Chunk for WAV (and related) files.\r
+</P>\r
+<p>\r
+Parameters:\r
+</p>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_SET_BROADCAST_INFO\r
+ data : a pointer to an SF_BROADCAST_INFO struct\r
+ datasize : sizeof (SF_BROADCAST_INFO)\r
+</PRE>\r
+\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>SF_TRUE if setting the Broadcast Extension chunk was successful and SF_FALSE\r
+ otherwise.\r
+</DL>\r
+<!-- ========================================================================= -->\r
+\r
+<A NAME="SFC_GET_LOOP_INFO"></A>\r
+<H2><BR><B>SFC_GET_LOOP_INFO</B></H2>\r
+<P>\r
+Retrieve loop information for file including time signature, length in\r
+beats and original MIDI base note\r
+</P>\r
+<p>\r
+Parameters:\r
+</p>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_GET_LOOP_INFO\r
+ data : a pointer to an SF_LOOP_INFO struct\r
+ datasize : sizeof (SF_LOOP_INFO)\r
+</PRE>\r
+<P>\r
+The SF_BROADCAST_INFO struct is defined in <sndfile.h> as:\r
+</P>\r
+<PRE>\r
+ typedef struct\r
+ { short time_sig_num ; /* any positive integer > 0 */\r
+ short time_sig_den ; /* any positive power of 2 > 0 */\r
+ int loop_mode ; /* see SF_LOOP enum */\r
+\r
+ int num_beats ; /* this is NOT the amount of quarter notes !!!*/\r
+ /* a full bar of 4/4 is 4 beats */\r
+ /* a full bar of 7/8 is 7 beats */\r
+\r
+ float bpm ; /* suggestion, as it can be calculated using other fields:*/\r
+ /* file's lenght, file's sampleRate and our time_sig_den*/\r
+ /* -> bpms are always the amount of _quarter notes_ per minute */\r
+\r
+ int root_key ; /* MIDI note, or -1 for None */\r
+ int future [6] ;\r
+ } SF_LOOP_INFO ;\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ SF_LOOP_INFO loop;\r
+ sf_command (sndfile, SFC_GET_LOOP_INFO, &loop, sizeof (loop)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD>SF_TRUE if the file header contains loop information for the file.\r
+ SF_FALSE otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+\r
+\r
+<A NAME="SFC_GET_INSTRUMENT"></A>\r
+<H2><BR><B>SFC_GET_INSTRUMENT</B></H2>\r
+<P>\r
+Retrieve instrument information from file including MIDI base note,\r
+keyboard mapping and looping informations(start/stop and mode).\r
+</P>\r
+<p>\r
+Parameters:\r
+</p>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_GET_INSTRUMENT\r
+ data : a pointer to an SF_INSTRUMENT struct\r
+ datasize : sizeof (SF_INSTRUMENT)\r
+</PRE>\r
+\r
+<P>\r
+The SF_INSTRUMENT struct is defined in <sndfile.h> as:\r
+</P>\r
+<PRE>\r
+ enum\r
+ { /*\r
+ ** The loop mode field in SF_INSTRUMENT will be one of the following.\r
+ */\r
+ SF_LOOP_NONE = 800,\r
+ SF_LOOP_FORWARD,\r
+ SF_LOOP_BACKWARD,\r
+ SF_LOOP_ALTERNATING\r
+ } ;\r
+\r
+ typedef struct\r
+ { int gain ;\r
+ char basenote, detune ;\r
+ char velocity_lo, velocity_hi ;\r
+ char key_lo, key_hi ;\r
+ int loop_count ;\r
+\r
+ struct\r
+ { int mode ;\r
+ unsigned int start ;\r
+ unsigned int end ;\r
+ unsigned int count ;\r
+ } loops [16] ; /* make variable in a sensible way */\r
+ } SF_INSTRUMENT ;\r
+</PRE>\r
+\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ SF_INSTRUMENT inst ;\r
+ sf_command (sndfile, SFC_GET_INSTRUMENT, &inst, sizeof (inst)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <dd>SF_TRUE if the file header contains instrument information for the\r
+ file. SF_FALSE otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+\r
+\r
+<A NAME="SFC_SET_INSTRUMENT"></A>\r
+<H2><BR><B>SFC_SET_INSTRUMENT</B></H2>\r
+<P>\r
+Set the instrument information for the file.\r
+</P>\r
+<p>\r
+Parameters:\r
+</p>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_GET_INSTRUMENT\r
+ data : a pointer to an SF_INSTRUMENT struct\r
+ datasize : sizeof (SF_INSTRUMENT)\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ SF_INSTRUMENT inst ;\r
+ sf_command (sndfile, SFC_SET_INSTRUMENT, &inst, sizeof (inst)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <dd>SF_TRUE if the file header contains instrument information for the\r
+ file. SF_FALSE otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+\r
+\r
+<A NAME="SFC_SET_VBR_ENCODING_QUALITY"></A>\r
+<H2><BR><B>SFC_SET_VBR_ENCODING_QUALITY</B></H2>\r
+<P>\r
+Set the Variable Bite Rate encoding quality.\r
+Currenly only implemented fro Ogg/Vorbis files.\r
+</P>\r
+<p>\r
+Parameters:\r
+</p>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_SET_VBR_ENCODING_QUALITY\r
+ data : a pointer to double specifing VBR quality\r
+ datasize : sizeof (double)\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ double quality = 0.5 ;\r
+ sf_command (sndfile, SFC_SET_VBR_ENCODING_QUALITY, &quality, sizeof (double)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <dd>SF_TRUE if VBR encoding quality was set.\r
+ SF_FALSE otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+\r
+\r
+<HR>\r
+<P>\r
+ The libsndfile home page is here :\r
+ <A HREF="http://www.mega-nerd.com/libsndfile/">\r
+ http://www.mega-nerd.com/libsndfile/</A>.\r
+<BR>\r
+Version : 1.0.25\r
+</P>\r
+\r
+</BODY>\r
+</HTML>\r
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">\r
+<HTML>\r
+\r
+<HEAD>\r
+ <TITLE>\r
+ libsndfile : the sf_command function.\r
+ </TITLE>\r
+ <META NAME="Author" CONTENT="Erik de Castro Lopo (erikd AT mega-nerd DOT com)">\r
+ <!-- Another version at the bottom of the page. -->\r
+ <META NAME="Description" CONTENT="The libsndfile API.">\r
+ <META NAME="Keywords" CONTENT="WAV AIFF AU libsndfile sound audio dsp Linux">\r
+ <LINK REL="stylesheet" HREF="libsndfile.css" TYPE="text/css" MEDIA="all">\r
+ <LINK REL="stylesheet" HREF="print.css" TYPE="text/css" MEDIA="print">\r
+</HEAD>\r
+\r
+<BODY>\r
+\r
+<H1><B>sf_command</B></H1>\r
+<PRE>\r
+\r
+ int sf_command (SNDFILE *sndfile, int cmd, void *data, int datasize) ;\r
+</PRE>\r
+<P>\r
+ This function allows the caller to retrieve information from or change aspects of the \r
+ library behaviour. \r
+ Examples include retrieving a string containing the library version or changing the \r
+ scaling applied to floating point sample data during read and write.\r
+ Most of these operations are performed on a per-file basis.\r
+</P>\r
+<P>\r
+ The cmd parameter is a integer identifier which is defined in <sndfile.h>.\r
+ All of the valid command identifiers have names begining with "SFC_".\r
+ Data is passed to and returned from the library by use of a void pointer. \r
+ The library will not read or write more than datasize bytes from the void pointer. \r
+ For some calls no data is required in which case data should be NULL and datasize \r
+ may be used for some other purpose.\r
+</P>\r
+<P>\r
+ The available commands are as follows:\r
+</P>\r
+\r
+<CENTER>\r
+<TABLE BORDER="0" WIDTH="90%" CELLPADDING="4">\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_LIB_VERSION">SFC_GET_LIB_VERSION</A></TD>\r
+ <TD>Retrieve the version of the library.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_LOG_INFO">SFC_GET_LOG_INFO</A></TD>\r
+ <TD>Retrieve the internal per-file operation log.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_CALC_SIGNAL_MAX">SFC_CALC_SIGNAL_MAX</A></TD>\r
+ <TD>Retrieve the measured maximum signal value.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_CALC_NORM_SIGNAL_MAX">SFC_CALC_NORM_SIGNAL_MAX</A></TD>\r
+ <TD>Retrieve the measured normalised maximum signal value.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_CALC_MAX_ALL_CHANNELS">SFC_CALC_MAX_ALL_CHANNELS</A></TD>\r
+ <TD>Calculate peaks for all channels.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_CALC_NORM_MAX_ALL_CHANNELS">SFC_CALC_NORM_MAX_ALL_CHANNELS</A></TD>\r
+ <TD>Calculate normalised peaks for all channels.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_SET_NORM_FLOAT">SFC_SET_NORM_FLOAT</A></TD>\r
+ <TD>Modify the normalisation behaviour of the floating point reading and writing functions.</TD>\r
+</TR>\r
+<TR> \r
+ <TD><A HREF="#SFC_SET_NORM_DOUBLE">SFC_SET_NORM_DOUBLE</A></TD>\r
+ <TD>Modify the normalisation behaviour of the double precision floating point reading and writing functions.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_NORM_FLOAT">SFC_GET_NORM_FLOAT</A></TD>\r
+ <TD>Retrieve the current normalisation behaviour of the floating point reading and writing functions.</TD>\r
+</TR>\r
+<TR> \r
+ <TD><A HREF="#SFC_GET_NORM_DOUBLE">SFC_GET_NORM_DOUBLE</A></TD>\r
+ <TD>Retrieve the current normalisation behaviour of the double precision floating point reading and writing functions.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_SIMPLE_FORMAT_COUNT">SFC_GET_SIMPLE_FORMAT_COUNT</A></TD>\r
+ <TD>Retrieve the number of simple formats supported by libsndfile.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_SIMPLE_FORMAT">SFC_GET_SIMPLE_FORMAT</A></TD>\r
+ <TD>Retrieve information about a simple format.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_FORMAT_INFO">SFC_GET_FORMAT_INFO</A></TD>\r
+ <TD>Retrieve information about a major or subtype format.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_FORMAT_MAJOR_COUNT">SFC_GET_FORMAT_MAJOR_COUNT</A></TD>\r
+ <TD>Retrieve the number of major formats.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_FORMAT_MAJOR">SFC_GET_FORMAT_MAJOR</A></TD>\r
+ <TD>Retrieve information about a major format type.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_FORMAT_SUBTYPE_COUNT">SFC_GET_FORMAT_SUBTYPE_COUNT</A></TD>\r
+ <TD>Retrieve the number of subformats.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_GET_FORMAT_SUBTYPE">SFC_GET_FORMAT_SUBTYPE</A></TD>\r
+ <TD>Retrieve information about a subformat.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_SET_ADD_PEAK_CHUNK">SFC_SET_ADD_PEAK_CHUNK</A></TD>\r
+ <TD>Switch the code for adding the PEAK chunk to WAV and AIFF files on or off.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_UPDATE_HEADER_NOW">SFC_UPDATE_HEADER_NOW</A></TD>\r
+ <TD>Used when a file is open for write, this command will update the file\r
+ header to reflect the data written so far.</TD>\r
+</TR>\r
+<TR>\r
+ <TD><A HREF="#SFC_SET_UPDATE_HEADER_AUTO">SFC_SET_UPDATE_HEADER_AUTO</A></TD>\r
+ <TD>Used when a file is open for write, this command will cause the file header\r
+ to be updated after each write to the file.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_FILE_TRUNCATE">SFC_FILE_TRUNCATE</A></TD>\r
+ <TD>Truncate a file open for write or for read/write.</TD>\r
+</TR>\r
+\r
+<TR>\r
+ <TD><A HREF="#SFC_SET_RAW_START_OFFSET">SFC_SET_RAW_START_OFFSET</A></TD>\r
+ <TD>Change the data start offset for files opened up as SF_FORMAT_RAW.</TD>\r
+</TR>\r
+\r
+\r
+\r
+<!--\r
+<TR>\r
+ <TD><A HREF="#add-dither">add dither</A></TD>\r
+ <TD>Add dither to output on write.</TD>\r
+</TR>\r
+-->\r
+</TABLE> \r
+</CENTER>\r
+\r
+<BR><BR>\r
+\r
+<HR>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_LIB_VERSION"></A>\r
+<H2><BR><B>SFC_GET_LIB_VERSION</B></H2>\r
+<P>\r
+Retrieve the version of the library as a string.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : Not used\r
+ cmd : SFC_GET_LIB_VERSION\r
+ data : A pointer to a char buffer\r
+ datasize : The size of the the buffer\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ char buffer [128] ;\r
+ sf_command (NULL, SFC_GET_LIB_VERSION, buffer, sizeof (buffer)) ;\r
+</PRE>\r
+\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD><DD>This call will return the length of the retrieved version string.\r
+</DL>\r
+<DL>\r
+<DT>Notes:</DT>\r
+<DD>\r
+The string returned in the buffer passed to this function will not overflow\r
+the buffer and will always be null terminated .\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_LOG_INFO"></A>\r
+<H2><BR><B>SFC_GET_LOG_INFO</B></H2>\r
+<P>\r
+Retrieve the log buffer generated when opening a file as a string. This log\r
+buffer can often contain a good reason for why libsndfile failed to open a\r
+particular file.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_GET_LOG_INFO\r
+ data : A pointer to a char buffer\r
+ datasize : The size of the the buffer\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ char buffer [2048] ;\r
+ sf_command (sndfile, SFC_GET_LOG_INFO, buffer, sizeof (buffer)) ;\r
+</PRE>\r
+\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD><DD>This call will return the length of the retrieved version string.\r
+</DL>\r
+<DL>\r
+<DT>Notes:</DT>\r
+<DD>\r
+The string returned in the buffer passed to this function will not overflow\r
+the buffer and will always be null terminated .\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_CALC_SIGNAL_MAX"></A>\r
+<H2><BR><B>SFC_CALC_SIGNAL_MAX</B></H2>\r
+<P>\r
+Retrieve the measured maximum signal value. This involves reading through\r
+the whole file which can be slow on large files.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_CALC_SIGNAL_MAX\r
+ data : A pointer to a double\r
+ datasize : sizeof (double)\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ double max_val ;\r
+ sf_command (sndfile, SFC_CALC_SIGNAL_MAX, &max_val, sizeof (max_val)) ;\r
+</PRE>\r
+\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD><DD>Zero on success, non-zero otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_CALC_NORM_SIGNAL_MAX"></A>\r
+<H2><BR><B>SFC_CALC_NORM_SIGNAL_MAX</B></H2>\r
+<P>\r
+Retrieve the measured normailised maximum signal value. This involves reading \r
+through the whole file which can be slow on large files.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_CALC_NORM_SIGNAL_MAX\r
+ data : A pointer to a double\r
+ datasize : sizeof (double)\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ double max_val ;\r
+ sf_command (sndfile, SFC_CALC_NORM_SIGNAL_MAX, &max_val, sizeof (max_val)) ;\r
+</PRE>\r
+\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD><DD>Zero on success, non-zero otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_CALC_MAX_ALL_CHANNELS"></A>\r
+<H2><BR><B>SFC_CALC_MAX_ALL_CHANNELS</B></H2>\r
+<P>\r
+Calculate peaks for all channels. This involves reading through\r
+the whole file which can be slow on large files.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_CALC_MAX_ALL_CHANNELS\r
+ data : A pointer to a double\r
+ datasize : sizeof (double) * number_of_channels\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ double peaks [number_of_channels] ;\r
+ sf_command (sndfile, SFC_CALC_MAX_ALL_CHANNELS, peaks, sizeof (peaks)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD>Zero if peaks have been calculated successfully and non-zero otherwise.\r
+</DL>\r
+\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_CALC_NORM_MAX_ALL_CHANNELS"></A>\r
+<H2><BR><B>SFC_CALC_NORM_MAX_ALL_CHANNELS</B></H2>\r
+<P>\r
+Calculate normalised peaks for all channels. This involves reading through\r
+the whole file which can be slow on large files.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_CALC_NORM_MAX_ALL_CHANNELS\r
+ data : A pointer to a double\r
+ datasize : sizeof (double) * number_of_channels\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ double peaks [number_of_channels] ;\r
+ sf_command (sndfile, SFC_CALC_NORM_MAX_ALL_CHANNELS, peaks, sizeof (peaks)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD>Zero if peaks have been calculated successfully and non-zero otherwise.\r
+</DL>\r
+\r
+\r
+\r
+\r
+\r
+<!-- ========================================================================= -->\r
+<!--\r
+<A NAME="read-text"></A>\r
+<H2><BR><B>Read text</B></H2>\r
+<P>\r
+Many sound file formats contain allow the inclusion of a text string describing the nature\r
+of the file. If a file contains such a string, this functions will return it to the caller.\r
+</P>\r
+<P>\r
+It should be noted that the way the string is added to the file is file format dependant\r
+but that any string added with <A HREF="#write-text">write text</A> will be returned by \r
+<A HREF="#read-text">read text</A>.\r
+</P>\r
+<P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : The text string "read text".\r
+ data : A pointer to a char buffer.\r
+ datasize : The size of the the buffer.\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ char buffer [128] ;\r
+ sf_command (sndfile, "read text", buffer, sizeof (buffer)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+<DD>If a text string is found, this call will return the length of the retrieved text \r
+ string.\r
+ <DD>If no text string is found, zero will be returned and the first element in the \r
+ buffer will be set to the null character.\r
+<DT>Notes:</DT>\r
+<DD>The string returned in the buffer passed to this function will not overflow\r
+ the buffer and will be correctly null terminated .\r
+</DL>\r
+\r
+<A NAME="write-text"></A>\r
+<H2><BR><B>Write text</B></H2>\r
+<P>\r
+Add a text string to a file. The text string added can be retrieved when the file is\r
+read using <A HREF="#read-text">read text</A>. \r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : The text string "write text".\r
+ data : A pointer to the string to be added.\r
+ datasize : Not used.\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ char text = "The sound of one hand clapping." ;\r
+ sf_command (sndfile, "write text", text, strlen (text)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>If the current file format allows the addition of text strings, the string will \r
+ be added and the length of the string will be returned. \r
+ <DD>If the file format does not allow the addition of text strings zero will be returned.\r
+ <DD>If this function is called after the file is openned but before \r
+</DL>\r
+-->\r
+\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_SET_NORM_FLOAT"></A>\r
+<H2><BR><B>SFC_SET_NORM_FLOAT</B></H2>\r
+<P>\r
+This command only affects data read from or written to using the floating point functions:\r
+</P>\r
+<PRE>\r
+ size_t <A HREF="api.html#read">sf_read_float</A> (SNDFILE *sndfile, float *ptr, size_t items) ;\r
+ size_t <A HREF="api.html#readf">sf_readf_float</A> (SNDFILE *sndfile, float *ptr, size_t frames) ;\r
+\r
+ size_t <A HREF="api.html#write">sf_write_float</A> (SNDFILE *sndfile, float *ptr, size_t items) ;\r
+ size_t <A HREF="api.html#writef">sf_writef_float</A> (SNDFILE *sndfile, float *ptr, size_t frames) ;\r
+</PRE>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_SET_NORM_FLOAT\r
+ data : NULL\r
+ datasize : SF_TRUE or SF_FALSE\r
+</PRE>\r
+<P>\r
+For read operations setting normalisation to SF_TRUE means that the data from all \r
+subsequent reads will be be normalised to the range [-1.0, 1.0].\r
+</P>\r
+<P>\r
+For write operations, setting normalisation to SF_TRUE means than all data supplied\r
+to the float write functions should be in the range [-1.0, 1.0] and will be scaled\r
+for the file format as necessary.\r
+</P>\r
+<P>\r
+For both cases, setting normalisation to SF_FALSE means that no scaling will take place.\r
+</P>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ sf_command (sndfile, SFC_SET_NORM_FLOAT, NULL, SF_TRUE) ;\r
+\r
+ sf_command (sndfile, SFC_SET_NORM_FLOAT, NULL, SF_FALSE) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>Returns 1 on success or 0 for failure.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_SET_NORM_DOUBLE"></A>\r
+<H2><BR><B>SFC_SET_NORM_DOUBLE</B></H2>\r
+<P>\r
+This command only affects data read from or written to using the double precision \r
+floating point functions:\r
+</P>\r
+<PRE>\r
+ size_t <A HREF="api.html#read">sf_read_double</A> (SNDFILE *sndfile, double *ptr, size_t items) ;\r
+ size_t <A HREF="api.html#readf">sf_readf_double</A> (SNDFILE *sndfile, double *ptr, size_t frames) ;\r
+\r
+ size_t <A HREF="api.html#write">sf_write_double</A> (SNDFILE *sndfile, double *ptr, size_t items) ;\r
+ size_t <A HREF="api.html#writef">sf_writef_double</A> (SNDFILE *sndfile, double *ptr, size_t frames) ;\r
+</PRE>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_SET_NORM_DOUBLE\r
+ data : NULL\r
+ datasize : SF_TRUE or SF_FALSE\r
+</PRE>\r
+<P>\r
+For read operations setting normalisation to SF_TRUE means that the data \r
+from all subsequent reads will be be normalised to the range [-1.0, 1.0].\r
+</P>\r
+<P>\r
+For write operations, setting normalisation to SF_TRUE means than all data supplied\r
+to the double write functions should be in the range [-1.0, 1.0] and will be scaled\r
+for the file format as necessary.\r
+</P>\r
+<P>\r
+For both cases, setting normalisation to SF_FALSE means that no scaling will take place.\r
+</P>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ sf_command (sndfile, SFC_SET_NORM_DOUBLE, NULL, SF_TRUE) ;\r
+\r
+ sf_command (sndfile, SFC_SET_NORM_DOUBLE, NULL, SF_FALSE) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>Returns 1 on success or 0 for failure.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_NORM_FLOAT"></A>\r
+<H2><BR><B>SFC_GET_NORM_FLOAT</B></H2>\r
+<P>\r
+Retrieve the current float normalisation mode.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_GET_NORM_FLOAT\r
+ data : NULL\r
+ datasize : anything\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ normalisation = sf_command (sndfile, SFC_GET_NORM_FLOAT, NULL, 0) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>Returns TRUE if normaisation is on and FALSE otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_NORM_DOUBLE"></A>\r
+<H2><BR><B>SFC_GET_NORM_DOUBLE</B></H2>\r
+<P>\r
+Retrieve the current float normalisation mode.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_GET_NORM_DOUBLE\r
+ data : NULL\r
+ datasize : anything\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ normalisation = sf_command (sndfile, SFC_GET_NORM_DOUBLE, NULL, 0) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>Returns TRUE if normalisation is on and FALSE otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_SIMPLE_FORMAT_COUNT"></A>\r
+<H2><BR><B>SFC_GET_SIMPLE_FORMAT_COUNT</B></H2>\r
+<P>\r
+Retrieve the number of simple formats supported by libsndfile.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : Not used.\r
+ cmd : SFC_GET_SIMPLE_FORMAT_COUNT\r
+ data : a pointer to an int\r
+ datasize : sizeof (int)\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ int count ;\r
+ sf_command (sndfile, SFC_GET_SIMPLE_FORMAT_COUNT, &count, sizeof (int)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>0\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_SIMPLE_FORMAT"></A>\r
+<H2><BR><B>SFC_GET_SIMPLE_FORMAT</B></H2>\r
+<P>\r
+Retrieve information about a simple format.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : Not used.\r
+ cmd : SFC_GET_SIMPLE_FORMAT\r
+ data : a pointer to an SF_FORMAT_INFO struct\r
+ datasize : sizeof (SF_FORMAT_INFO)\r
+</PRE>\r
+<P>\r
+The SF_FORMAT_INFO struct is defined in <sndfile.h> as:\r
+</P>\r
+<PRE>\r
+ typedef struct\r
+ { int format ;\r
+ const char *name ;\r
+ const char *extension ;\r
+ } SF_FORMAT_INFO ;\r
+</PRE>\r
+<P>\r
+When sf_command() is called with SF_GET_SIMPLE_FORMAT, the value of the format \r
+field should be the format number (ie 0 <= format <= count value obtained using\r
+SF_GET_SIMPLE_FORMAT_COUNT).\r
+</P>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ SF_FORMAT_INFO format_info ;\r
+ int k, count ;\r
+\r
+ sf_command (sndfile, SFC_GET_SIMPLE_FORMAT_COUNT, &count, sizeof (int)) ;\r
+\r
+ for (k = 0 ; k < count ; k++)\r
+ { format_info.format = k ;\r
+ sf_command (sndfile, SFC_GET_SIMPLE_FORMAT, &format_info, sizeof (format_info)) ;\r
+ printf ("%08x %s %s\n", format_info.format, format_info.name, format_info.extension) ;\r
+ } ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>0 on success and non-zero otherwise.\r
+ <DD>The value of the format field of the SF_FORMAT_INFO struct will be an value which \r
+ can be placed in the format field of an SF_INFO struct when a file is to be opened \r
+ for write.\r
+ <DD>The name field will contain a char* pointer to the name of the string ie "WAV (Microsoft 16 bit PCM)".\r
+ <DD>The extention field will contain the most commonly used file extension for that file type.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_FORMAT_INFO"></A>\r
+<H2><BR><B>SFC_GET_FORMAT_INFO</B></H2>\r
+<P>\r
+Retrieve information about a major or subtype format.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : Not used.\r
+ cmd : SFC_GET_FORMAT_INFO\r
+ data : a pointer to an SF_FORMAT_INFO struct\r
+ datasize : sizeof (SF_FORMAT_INFO)\r
+</PRE>\r
+<P>\r
+The SF_FORMAT_INFO struct is defined in <sndfile.h> as:\r
+</P>\r
+<PRE>\r
+ typedef struct\r
+ { int format ;\r
+ const char *name ;\r
+ const char *extension ;\r
+ } SF_FORMAT_INFO ;\r
+</PRE>\r
+<P>\r
+When sf_command() is called with SF_GET_FORMAT_INFO, the format field is \r
+examined and if (format & SF_FORMAT_TYPEMASK) is a valid format then the struct\r
+is filled in with information about the given major type.\r
+If (format & SF_FORMAT_TYPEMASK) is FALSE and (format & SF_FORMAT_SUBMASK) is a\r
+valid subtype format then the struct is filled in with information about the given \r
+subtype.\r
+</P>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ SF_FORMAT_INFO format_info ;\r
+\r
+ format_info.format = SF_FORMAT_WAV ;\r
+ sf_command (sndfile, SFC_GET_FORMAT_INFO, &format_info, sizeof (format_info)) ;\r
+ printf ("%08x %s %s\n", format_info.format, format_info.name, format_info.extension) ;\r
+\r
+ format_info.format = SF_FORMAT_ULAW ;\r
+ sf_command (sndfile, SFC_GET_FORMAT_INFO, &format_info, sizeof (format_info)) ;\r
+ printf ("%08x %s\n", format_info.format, format_info.name) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>0 on success and non-zero otherwise.\r
+</DL>\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_FORMAT_MAJOR_COUNT"></A>\r
+<H2><BR><B>SFC_GET_FORMAT_MAJOR_COUNT</B></H2>\r
+<P>\r
+Retrieve the number of major formats.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : Not used.\r
+ cmd : SFC_GET_FORMAT_MAJOR_COUNT\r
+ data : a pointer to an int\r
+ datasize : sizeof (int)\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ int count ;\r
+ sf_command (sndfile, SFC_GET_FORMAT_MAJOR_COUNT, &count, sizeof (int)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>0\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_FORMAT_MAJOR"></A>\r
+<H2><BR><B>SFC_GET_FORMAT_MAJOR</B></H2>\r
+<P>\r
+Retrieve information about a major format type.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : Not used.\r
+ cmd : SFC_GET_FORMAT_MAJOR\r
+ data : a pointer to an SF_FORMAT_INFO struct\r
+ datasize : sizeof (SF_FORMAT_INFO)\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ SF_FORMAT_INFO format_info ;\r
+ int k, count ;\r
+\r
+ sf_command (sndfile, SFC_GET_FORMAT_MAJOR_COUNT, &count, sizeof (int)) ;\r
+\r
+ for (k = 0 ; k < count ; k++)\r
+ { format_info.format = k ;\r
+ sf_command (sndfile, SFC_GET_FORMAT_MAJOR, &format_info, sizeof (format_info)) ;\r
+ printf ("%08x %s %s\n", format_info.format, format_info.name, format_info.extension) ;\r
+ } ;\r
+</PRE>\r
+<P>\r
+For a more comprehensive example, see the program list_formats.c in the examples/\r
+directory of the libsndfile source code distribution.\r
+</P>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>0 on success and non-zero otherwise.\r
+ <DD>The value of the format field will one of the major format identifiers suc as SF_FORMAT_WAV\r
+ SF_FORMAT_AIFF.\r
+ <DD>The name field will contain a char* pointer to the name of the string ie "WAV (Microsoft)".\r
+ <DD>The extention field will contain the most commonly used file extension for that file type.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_FORMAT_SUBTYPE_COUNT"></A>\r
+<H2><BR><B>SFC_GET_FORMAT_SUBTYPE_COUNT</B></H2>\r
+<P>\r
+Retrieve the number of subformats.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : Not used.\r
+ cmd : SFC_GET_FORMAT_SUBTYPE_COUNT\r
+ data : a pointer to an int\r
+ datasize : sizeof (int)\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ int count ;\r
+ sf_command (sndfile, SFC_GET_FORMAT_SUBTYPE_COUNT, &count, sizeof (int)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>0\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_GET_FORMAT_SUBTYPE"></A>\r
+<H2><BR><B>SFC_GET_FORMAT_SUBTYPE</B></H2>\r
+<P>\r
+Retrieve information about a subformat.\r
+</P>\r
+<P>\r
+Parameters:\r
+</P>\r
+<PRE>\r
+ sndfile : Not used.\r
+ cmd : SFC_GET_FORMAT_SUBTYPE\r
+ data : a pointer to an SF_FORMAT_INFO struct\r
+ datasize : sizeof (SF_FORMAT_INFO)\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ SF_FORMAT_INFO format_info ;\r
+ int k, count ;\r
+\r
+ sf_command (sndfile, SFC_GET_FORMAT_SUBTYPE_COUNT, &count, sizeof (int)) ;\r
+\r
+ /* Retrieve all the subtypes supported by the WAV format. */\r
+ for (k = 0 ; k < count ; k++)\r
+ { format_info.format = k ;\r
+ sf_command (sndfile, SFC_GET_FORMAT_SUBTYPE, &format_info, sizeof (format_info)) ;\r
+ if (! sf_format_check (format.info | SF_FORMAT_WAV))\r
+ continue ;\r
+ printf ("%08x %s\n", format_info.format, format_info.name) ;\r
+ } ;\r
+</PRE>\r
+<P>\r
+For a more comprehensive example, see the program list_formats.c in the examples/\r
+directory of the libsndfile source code distribution.\r
+</P>\r
+<DL>\r
+<DT>Return value: </DT>\r
+ <DD>0 on success and non-zero otherwise.\r
+ <DD>The value of the format field will one of the major format identifiers such as SF_FORMAT_WAV\r
+ SF_FORMAT_AIFF.\r
+ <DD>The name field will contain a char* pointer to the name of the string; for instance \r
+ "WAV (Microsoft)" or "AIFF (Apple/SGI)".\r
+ <DD>The extention field will be a NULL pointer.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_SET_ADD_PEAK_CHUNK"></A>\r
+<H2><BR><B>SFC_SET_ADD_PEAK_CHUNK</B></H2>\r
+<P>\r
+By default, WAV and AIFF files which contain floating point data (subtype SF_FORMAT_FLOAT \r
+or SF_FORMAT_DOUBLE) have a PEAK chunk.\r
+By using this command, the addition of a PEAK chunk can be turned on or off.\r
+</P>\r
+<P>\r
+Note : This call must be made before any data is written to the file.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_SET_ADD_PEAK_CHUNK\r
+ data : Not used (should be NULL)\r
+ datasize : TRUE or FALSE.\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ /* Turn on the PEAK chunk. */\r
+ sf_command (sndfile, SFC_SET_ADD_PEAK_CHUNK, NULL, SF_TRUE) ;\r
+\r
+ /* Turn off the PEAK chunk. */\r
+ sf_command (sndfile, SFC_SET_ADD_PEAK_CHUNK, NULL, SF_FALSE) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+<DD>Returns SF_TRUE if the peak chunk will be written after this call.\r
+<DD>Returns SF_FALSE if the peak chunk will not be written after this call.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_UPDATE_HEADER_NOW"></A>\r
+<H2><BR><B>SFC_UPDATE_HEADER_NOW</B></H2>\r
+<P>\r
+The header of an audio file is normally written by libsndfile when the file is\r
+closed using <B>sf_close()</B>.\r
+</P>\r
+<P>\r
+There are however situations where large files are being generated and it would\r
+be nice to have valid data in the header before the file is complete.\r
+Using this command will update the file header to reflect the amount of data written \r
+to the file so far.\r
+Other programs opening the file for read (before any more data is written) will \r
+then read a valid sound file header.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_UPDATE_HEADER_NOW\r
+ data : Not used (should be NULL)\r
+ datasize : Not used.\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ /* Update the header now. */\r
+ sf_command (sndfile, SFC_UPDATE_HEADER_NOW, NULL, 0) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+<DD>0\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_SET_UPDATE_HEADER_AUTO"></A>\r
+<H2><BR><B>SFC_SET_UPDATE_HEADER_AUTO</B></H2>\r
+<P>\r
+Similar to SFC_UPDATE_HEADER_NOW but updates the header at the end of every call\r
+to the <B>sf_write*</B> functions.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_UPDATE_HEADER_NOW\r
+ data : Not used (should be NULL)\r
+ datasize : SF_TRUE or SF_FALSE\r
+</PRE>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ /* Turn on auto header update. */\r
+ sf_command (sndfile, SFC_SET_UPDATE_HEADER_AUTO, NULL, SF_TRUE) ;\r
+\r
+ /* Turn off auto header update. */\r
+ sf_command (sndfile, SFC_SET_UPDATE_HEADER_AUTO, NULL, SF_FALSE) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+<DD>TRUE if auto update header is now on; FALSE otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_FILE_TRUNCATE"></A>\r
+<H2><BR><B>SFC_FILE_TRUNCATE</B></H2>\r
+<P>\r
+Truncate a file open for write or for read/write.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_FILE_TRUNCATE\r
+ data : A pointer to an sf_count_t.\r
+ datasize : sizeof (sf_count_t)\r
+</PRE>\r
+\r
+<P>\r
+Truncate the file to the number of frames specified by the sf_count_t pointed\r
+to by data.\r
+After this command, both the read and the write pointer will be\r
+at the new end of the file.\r
+This command will fail (returning non-zero) if the requested truncate position \r
+is beyond the end of the file.\r
+</P>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ /* Truncate the file to a length of 20 frames. */\r
+ sf_count_t frames = 20 ;\r
+ sf_command (sndfile, SFC_FILE_TRUNCATE, &frames, sizeof (frames)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD>Zero on sucess, non-zero otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+<A NAME="SFC_SET_RAW_START_OFFSET"></A>\r
+<H2><BR><B>SFC_SET_RAW_START_OFFSET</B></H2>\r
+<P>\r
+Change the data start offset for files opened up as SF_FORMAT_RAW.\r
+</P>\r
+<P>\r
+Parameters:\r
+<PRE>\r
+ sndfile : A valid SNDFILE* pointer\r
+ cmd : SFC_SET_RAW_START_OFFSET\r
+ data : A pointer to an sf_count_t.\r
+ datasize : sizeof (sf_count_t)\r
+</PRE>\r
+\r
+<P>\r
+For a file opened as format SF_FORMAT_RAW, set the data offset to the value\r
+given by data.\r
+</P>\r
+<P>\r
+Example:\r
+</P>\r
+<PRE>\r
+ /* Reset the data offset to 5 bytes from the start of the file. */\r
+ sf_count_t offset = 5 ;\r
+ sf_command (sndfile, SFC_SET_RAW_START_OFFSET, &offset, sizeof (offset)) ;\r
+</PRE>\r
+<DL>\r
+<DT>Return value:</DT>\r
+ <DD>Zero on sucess, non-zero otherwise.\r
+</DL>\r
+\r
+<!-- ========================================================================= -->\r
+\r
+<HR>\r
+<P>\r
+ The libsndfile home page is here : \r
+ <A HREF="http://www.mega-nerd.com/libsndfile/">\r
+ http://www.mega-nerd.com/libsndfile/</A>.\r
+<BR>\r
+Version : 1.0.25\r
+</P>\r
+\r
+</BODY>\r
+</HTML>\r
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">\r
+<HTML>\r
+\r
+<HEAD>\r
+ <TITLE>\r
+ libsndfile : Embedded Sound Files.\r
+ </TITLE>\r
+ <META NAME="Author" CONTENT="Erik de Castro Lopo (erikd AT mega-nerd DOT com)">\r
+ <META NAME="Description" CONTENT="The libsndfile API.">\r
+ <META NAME="Keywords" CONTENT="WAV AIFF AU libsndfile sound audio dsp Linux">\r
+ <LINK REL="stylesheet" HREF="libsndfile.css" TYPE="text/css" MEDIA="all">\r
+ <LINK REL="stylesheet" HREF="print.css" TYPE="text/css" MEDIA="print">\r
+</HEAD>\r
+<!-- pepper -->\r
+<BODY>\r
+<!-- pepper -->\r
+<H1><B>Embedded Sound Files.</B></H1>\r
+\r
+<P>\r
+By using the open SNDFILE with a file descriptor function:\r
+</P>\r
+<!-- pepper -->\r
+<PRE>\r
+ SNDFILE* sf_open_fd (int fd, int mode, SF_INFO *sfinfo, int close_desc) ;\r
+</PRE>\r
+<!-- pepper -->\r
+<P>\r
+it is possible to open sound files embedded within larger files.\r
+There are however a couple of caveats:\r
+<P>\r
+<!-- pepper -->\r
+<UL>\r
+ <LI> Read/Write mode (SFM_RDWR) is not supported.\r
+ <LI> Writing of embedded files is only supported at the end of the file.\r
+ <LI> Reading of embedded files is only supported at file offsets greater\r
+ than zero.\r
+ <LI> Not all file formats are supported (currently only WAV, AIFF and AU).\r
+</UL>\r
+<!-- pepper -->\r
+<P>\r
+The test program <B>multi_file_test.c</B> in the <B>tests/</B> directory of the\r
+source code tarball shows how this functionality is used to read and write\r
+embedded files.\r
+</P>\r
+<!-- pepper -->\r
+</BODY>\r
+</HTML>\r
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">\r
+<HTML>\r
+\r
+<HEAD>\r
+ <TITLE>\r
+ libsndfile\r
+ </TITLE>\r
+ <META NAME="Author" CONTENT="Erik de Castro Lopo (erikd AT mega-nerd DOT com)">\r
+ <META NAME="Version" CONTENT="libsndfile-1.0.25">\r
+ <META NAME="Description" CONTENT="The libsndfile Home Page">\r
+ <META NAME="Keywords" CONTENT="WAV AIFF AU SVX PAF NIST W64 libsndfile sound audio dsp Linux">\r
+ <META NAME="ROBOTS" CONTENT="NOFOLLOW">\r
+ <LINK REL="stylesheet" HREF="libsndfile.css" TYPE="text/css" MEDIA="all">\r
+ <LINK REL="stylesheet" HREF="print.css" TYPE="text/css" MEDIA="print">\r
+</HEAD>\r
+\r
+<BODY>\r
+<!-- pepper -->\r
+<CENTER>\r
+ <IMG SRC="libsndfile.jpg" HEIGHT=98 WIDTH=367 ALT="libsndfile.jpg">\r
+</CENTER>\r
+<!-- pepper -->\r
+<CENTER>\r
+ <A HREF="#History">History</A> -+-\r
+ <A HREF="#Features">Features</A> -+-\r
+ <A HREF="#Similar">Similar or Related Projects</A> -+-\r
+ <A HREF="NEWS">News</A>\r
+ <br>\r
+ <A HREF="development.html">Development</A> -+-\r
+ <A HREF="api.html">Programming Interface</A> -+-\r
+ <A HREF="bugs.html">Bug Reporting</A> -+-\r
+ <A HREF="#Download">Download</A>\r
+ <br>\r
+ <A HREF="FAQ.html">FAQ</A> -+-\r
+ <A HREF="lists.html">Mailing Lists</A> -+-\r
+ <A HREF="ChangeLog">Change Log</A> -+-\r
+ <A HREF="#Licensing">Licensing Information</A> -+-\r
+ <A HREF="#SeeAlso">See Also</A>\r
+</CENTER>\r
+\r
+<br><br>\r
+<P>\r
+ Libsndfile is a C library for reading and writing files containing sampled sound\r
+ (such as MS Windows WAV and the Apple/SGI AIFF format) through one standard\r
+ library interface. It is released in source code format under the\r
+ <A HREF="http://www.gnu.org/copyleft/lesser.html">Gnu Lesser General Public License</A>.\r
+</P>\r
+<!-- pepper -->\r
+<P>\r
+ The library was written to compile and run on a Linux system but should compile\r
+ and run on just about any Unix (including MacOS X).\r
+ There are also pre-compiled binaries available for 32 and 64 bit windows.\r
+</P>\r
+<P>\r
+ It was designed to handle both little-endian (such as WAV) and big-endian\r
+ (such as AIFF) data, and to compile and run correctly on little-endian (such as Intel\r
+ and DEC/Compaq Alpha) processor systems as well as big-endian processor systems such\r
+ as Motorola 68k, Power PC, MIPS and Sparc.\r
+ Hopefully the design of the library will also make it easy to extend for reading and\r
+ writing new sound file formats.\r
+</P>\r
+<!-- pepper -->\r
+<P>\r
+ It has been compiled and tested (at one time or another) on the following systems:\r
+</P>\r
+<!-- pepper -->\r
+<UL>\r
+ <LI>Every platform supported by Debian GNU/Linux including x86_64-linux-gnu,\r
+ i486-linux-gnu, powerpc-linux-gnu, sparc-linux-gnu, alpha-linux-gnu,\r
+ mips-linux-gnu and armel-linux-gnu.</LI>\r
+ <LI>arm-linux-androideab (Android phones OS)</LI>\r
+ <LI>powerpc-apple-darwin7.0 (Mac OS X 10.3)</LI>\r
+ <LI>sparc-sun-solaris2.8 (using gcc)</LI>\r
+ <LI>mips-sgi-irix5.3 (using gcc)</LI>\r
+ <LI>QNX 6.0</LI>\r
+ <LI>i386-unknown-openbsd2.9</LI>\r
+</UL>\r
+<!-- pepper -->\r
+<P>\r
+ At the moment, each new release is being tested on i386 Linux, x86_64 Linux,\r
+ PowerPC Linux, Win32 and Win64.\r
+</P>\r
+<!-- pepper -->\r
+\r
+<A NAME="Capabilities"></A>\r
+<A NAME="Features"></A>\r
+<H1><B>Features</B></H1>\r
+<P>\r
+ libsndfile has the following main features :\r
+</P>\r
+ <UL>\r
+ <lI> Ability to read and write a large number of file formats.\r
+ <LI> A simple, elegant and easy to use Applications Programming Interface.\r
+ <LI> Usable on Unix, Win32, MacOS and others.\r
+ <LI> On the fly format conversion, including endian-ness swapping, type conversion\r
+ and bitwidth scaling.\r
+ <LI> Optional normalisation when reading floating point data from files containing\r
+ integer data.\r
+ <LI> Ability to open files in read/write mode.\r
+ <LI> The ability to write the file header without closing the file (only on files\r
+ open for write or read/write).\r
+ <LI> Ability to query the library about all supported formats and retrieve text\r
+ strings describing each format.\r
+ </UL>\r
+<P>\r
+ libsndfile has a comprehensive test suite so that each release is as bug free\r
+ as possible.\r
+ When new bugs are found, new tests are added to the test suite to ensure that\r
+ these bugs don't creep back into the code.\r
+ When new features are added, tests are added to the test suite to make sure that\r
+ these features continue to work correctly even when they are old features.\r
+ </P>\r
+<P>\r
+ The following table lists the file formats and encodings that libsndfile can read\r
+ and write.\r
+ The file formats are arranged across the top and encodings along the left\r
+ edge.\r
+</P>\r
+<br>\r
+\r
+<TABLE BORDER="1" cellpadding="2">\r
+ <TR><TD> </TD>\r
+ <TD ALIGN="center">Micro- soft<br>WAV</TD>\r
+ <TD ALIGN="center">SGI / Apple<br>AIFF / AIFC</TD>\r
+ <TD ALIGN="center">Sun / DEC /<br>NeXT<br>AU / SND</TD>\r
+ <TD ALIGN="center">Header- less<br>RAW</TD>\r
+ <TD ALIGN="center">Paris Audio<br>File<br>PAF</TD>\r
+ <TD ALIGN="center">Commo- dore<br>Amiga<br>IFF / SVX</TD>\r
+ <TD ALIGN="center">Sphere<br>Nist<br>WAV</TD>\r
+ <TD ALIGN="center">IRCAM<br>SF</TD>\r
+ <TD ALIGN="center">Creative<br>VOC</TD>\r
+ <TD ALIGN="center">Sound forge<br>W64</TD>\r
+ <TD ALIGN="center"><A HREF="octave.html">GNU Octave 2.0</A><br>MAT4</TD>\r
+ <TD ALIGN="center"><A HREF="octave.html">GNU Octave 2.1</A><br>MAT5</TD>\r
+ <TD ALIGN="center">Portable Voice Format<br>PVF</TD>\r
+ <TD ALIGN="center">Fasttracker 2<br>XI</TD>\r
+ <TD ALIGN="center">HMM Tool Kit<br>HTK</TD>\r
+ <TD ALIGN="center">Apple<br>CAF</TD>\r
+ <TD ALIGN="center">Sound<br>Designer II<br>SD2</TD>\r
+ <TD ALIGN="center">Free Lossless Audio Codec<br>FLAC</TD>\r
+ </TR>\r
+<TR><TD>Unsigned 8 bit PCM</TD>\r
+ <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD> </TD><TD ALIGN="center">R/W</TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD>\r
+ <TD ALIGN="center">R/W</TD><TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+</TR>\r
+\r
+<TR><TD>Signed 8 bit PCM</TD>\r
+ <TD> </TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+ <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD>\r
+ <TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+</TR>\r
+\r
+<TR><TD>Signed 16 bit PCM</TD>\r
+ <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+ <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+ <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+ <TD ALIGN="center">R/W</TD><TD> </TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+ <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+</TR>\r
+\r
+<TR><TD>Signed 24 bit PCM</TD>\r
+ <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+ <TD ALIGN="center">R/W</TD><TD> </TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+ <TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+</TR>\r
+\r
+<TR><TD>Signed 32 bit PCM</TD>\r
+ <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+ <TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD> </TD>\r
+ <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+ <TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD>\r
+</TR>\r
+\r
+<TR><TD>32 bit float</TD>\r
+ <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD>\r
+ <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD>\r
+</TR>\r
+\r
+<TR><TD>64 bit double</TD>\r
+ <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+ <TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD>\r
+</TR>\r
+\r
+<TR><TD>u-law encoding</TD>\r
+ <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+ <TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+ <TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD>\r
+</TR>\r
+<TR><TD>A-law encoding</TD>\r
+ <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+ <TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD>\r
+ <TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD>\r
+</TR>\r
+\r
+<TR><TD>IMA ADPCM</TD>\r
+ <TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD>\r
+</TR>\r
+\r
+<TR><TD>MS ADPCM</TD>\r
+ <TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+</TR>\r
+\r
+<TR><TD>GSM 6.10</TD>\r
+ <TD ALIGN="center">R/W</TD><TD ALIGN="center">R/W</TD><TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+</TR>\r
+\r
+<TR><TD>G721 ADPCM 32kbps</TD>\r
+ <TD ALIGN="center">R/W</TD><TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+</TR>\r
+\r
+<TR><TD>G723 ADPCM 24kbps</TD>\r
+ <TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+</TR>\r
+\r
+<TR><TD>G723 ADPCM 40kbps</TD>\r
+ <TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+</TR>\r
+\r
+<TR><TD>12 bit DWVW</TD>\r
+ <TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+</TR>\r
+\r
+<TR><TD>16 bit DWVW</TD>\r
+ <TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+</TR>\r
+\r
+<TR><TD>24 bit DWVW</TD>\r
+ <TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+</TR>\r
+<TR><TD>Ok Dialogic ADPCM</TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+</TR>\r
+<TR><TD>8 bit DPCM</TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+</TR>\r
+<TR><TD>16 bit DPCM</TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+ <TD> </TD><TD ALIGN="center">R/W</TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>\r
+</TR>\r
+</TABLE>\r
+\r
+<p>\r
+From version 1.0.18, libsndfile also reads and writes\r
+ <a href="http://flac.sourceforge.net/">FLAC</a>\r
+and\r
+ <a href="http://www.vorbis.com/">Ogg/Vorbis</a>.\r
+</p>\r
+\r
+<!-- pepper -->\r
+\r
+<P>\r
+ Some of the file formats I am also interested in adding are:\r
+</P>\r
+ <UL>\r
+ <LI> Kurzweil K2000 sampler files.\r
+ <LI> Ogg Speex.\r
+ </UL>\r
+<P>\r
+ I have decided that I will not be adding support for MPEG Layer 3 (commonly\r
+ known as MP3) due to the patent issues surrounding this file format.\r
+ See\r
+ <a href="http://www.mega-nerd.com/libsndfile/FAQ.html#Q020">\r
+ the FAQ</a>\r
+ for more.\r
+</P>\r
+<P>\r
+ Other file formats may also be added on request.\r
+</P>\r
+\r
+<!-- pepper -->\r
+\r
+<A NAME="History"></A>\r
+<H1><B>History</B></H1>\r
+<P>\r
+ My first attempt at reading and writing WAV files was in 1990 or so under Windows\r
+ 3.1.\r
+ I started using Linux in early 1995 and contributed some code to the\r
+ <A HREF="http://www.vaxxine.com/ve3wwg/gnuwave.html">wavplay</A>\r
+ program.\r
+ That contributed code would eventually mutate into this library.\r
+ As one of my interests is Digital Signal Processing (DSP) I decided that as well as\r
+ reading data from an audio file in the native format (typically 16 bit short integers)\r
+ it would also be useful to be able to have the library do the conversion to floating\r
+ point numbers for DSP applications.\r
+ It then dawned on me that whatever file format (anything from 8 bit unsigned chars,\r
+ to 32 bit floating point numbers) the library should be able to convert the data to\r
+ whatever format the library user wishes to use it in.\r
+ For example, in a sound playback program, the library caller typically wants the sound\r
+ data in 16 bit short integers to dump into a sound card even though the data in the\r
+ file may be 32 bit floating point numbers (ie Microsoft's WAVE_FORMAT_IEEE_FLOAT\r
+ format).\r
+ Another example would be someone doing speech recognition research who has recorded\r
+ some speech as a 16 bit WAV file but wants to process it as double precision floating\r
+ point numbers.\r
+</P>\r
+<P>\r
+ Here is the release history for libsndfile :\r
+</P>\r
+ <UL>\r
+ <LI>Version 0.0.8 (Feb 15 1999) First official release.\r
+ <LI>Version 0.0.28 (Apr 26 2002) Final release of version 0 of libsndfile.\r
+ <LI>Version 1.0.0rc1 (Jun 24 2002) Release candidate 1 of version 1 of libsndfile.\r
+ <LI>Version 1.0.0rc6 (Aug 14 2002) MacOS 9 fixes.\r
+ <LI>Version 1.0.0 (Aug 16 2002) First 1.0.X release.\r
+ <LI>Version 1.0.1 (Sep 14 2002) Added MAT4 and MAT5 file formats.\r
+ <LI>Version 1.0.2 (Nov 24 2002) Added VOX ADPCM format.\r
+ <LI>Version 1.0.3 (Dec 09 2002) Fixes for Linux on ia64 CPUs.\r
+ <LI>Version 1.0.4 (Feb 02 2003) New file formats and functionality.\r
+ <LI>Version 1.0.5 (May 03 2003) One new file format and new functionality.\r
+ <LI>Version 1.0.6 (Feb 08 2004) Large file fix for Linux/Solaris, new functionality\r
+ and Win32 improvements.\r
+ <LI>Version 1.0.7 (Feb 24 2004) Fix build problems on MacOS X and fix ia64/MIPS etc\r
+ clip mode detction.\r
+ <LI>Version 1.0.8 (Mar 14 2004) Minor bug fixes.\r
+ <LI>Version 1.0.9 (Mar 30 2004) Add AVR format. Improve handling of some WAV files.\r
+ <LI>Version 1.0.10 (Jun 15 2004) Minor bug fixes. Fix support for Win32 MinGW compiler.\r
+ <LI>Version 1.0.11 (Nov 15 2004) Add SD2 file support, reading of loop data in WAV and AIFF.\r
+ Minor bug fixes.\r
+ <LI>Version 1.0.12 (Sep 30 2005) Add FLAC and CAF file support, virtual I/O interface.\r
+ Minor bug fixes and cleanups.\r
+ <LI>Version 1.0.13 (Jan 21 2006) Add read/write of instrument chunks. Minor bug fixes.\r
+ <LI>Version 1.0.14 (Feb 19 2006) Minor bug fixes. Start shipping windows binary/source ZIP.\r
+ <LI>Version 1.0.15 (Mar 16 2006) Minor bug fixes.\r
+ <LI>Version 1.0.16 (Apr 30 2006) Add support for RIFX. Other minor feature enhancements and\r
+ bug fixes.\r
+ <LI>Version 1.0.17 (Aug 31 2006) Add C++ wrapper sndfile.hh. Minor bug fixes and cleanups.\r
+ <LI>Version 1.0.18 (Feb 07 2009) Add Ogg/Vorbis suppport, remove captive libraries, many\r
+ new features and bug fixes. Generate Win32 and Win64 pre-compiled binaries.\r
+ <LI>Version 1.0.19 (Mar 02 2009) Fix for CVE-2009-0186. Huge number of minor fixes as a\r
+ result of static analysis.\r
+ <LI>Version 1.0.20 (May 14 2009) Fix for potential heap overflow.\r
+ <LI>Version 1.0.21 (December 13 2009) Bunch of minor bug fixes.\r
+ <LI>Version 1.0.22 (October 04 2010) Bunch of minor bug fixes.\r
+ <LI>Version 1.0.23 (October 10 2010) Minor bug fixes.\r
+ <LI>Version 1.0.24 (March 23 2011) Minor bug fixes.\r
+ <LI>Version 1.0.25 (July 13 2011) Fix for Secunia Advisory SA45125. Minor bug fixes and\r
+ improvements.\r
+ </UL>\r
+\r
+<A NAME="Similar"></A>\r
+<H1><B>Similar or Related Projects</B></H1>\r
+\r
+ <UL>\r
+ <LI><A HREF="http://sox.sourceforge.net/">SoX</A> is a program for\r
+ converting between sound file formats.\r
+ <LI><A HREF="http://www.hitsquad.com/smm/programs/WavPlay/">Wavplay</A> started out\r
+ as a minimal WAV file player under Linux and has mutated into Gnuwave, a client/server\r
+ application for more general multimedia and games sound playback.\r
+ <LI><A HREF="http://www.68k.org/~michael/audiofile/">Audiofile</A> (libaudiofile) is\r
+ a library similar to libsndfile but with a different programming interface. The\r
+ author Michael Pruett has set out to clone (and fix some bugs in) the libaudiofile\r
+ library which ships with SGI's IRIX OS.\r
+ <LI><A HREF="ftp://ccrma-ftp.stanford.edu/pub/Lisp/sndlib.tar.gz">sndlib.tar.gz</A> is\r
+ another library written by Bill Schottstaedt of CCRMA.\r
+ </UL>\r
+\r
+<A NAME="Licensing"></A>\r
+<H1><B>Licensing</B></H1>\r
+<P>\r
+ libsndfile is released under the terms of the GNU Lesser General Public License,\r
+ of which there are two versions;\r
+ <a href="http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html">version 2.1</a>\r
+ and\r
+ <a href="http://www.gnu.org/copyleft/lesser.html">version 3</a>.\r
+ To maximise the compatibility of libsndfile, the user may choose to use libsndfile\r
+ under either of the above two licenses.\r
+ You can also read a simple explanation of the ideas behind the GPL and the LGPL\r
+ <A HREF="http://www.gnu.org/copyleft/copyleft.html">here</A>.\r
+</P>\r
+<P>\r
+ You can use libsndfile with\r
+ <A HREF="http://www.gnu.org/">Free Software</A>,\r
+ <A HREF="http://www.opensource.org/">Open Source</A>,\r
+ proprietary, shareware or other closed source applications as long as libsndfile\r
+ is used as a dynamically loaded library and you abide by a small number of other\r
+ conditions (read the LGPL for more info).\r
+ With applications released under the GNU GPL you can also use libsndfile statically\r
+ linked to your application.\r
+</P>\r
+<P>\r
+ I would like to see libsndfile used as widely as possible but I would prefer it\r
+ if you released software that uses libsndfile as\r
+ <A HREF="http://www.gnu.org/">Free Software</A>\r
+ or\r
+ <A HREF="http://www.opensource.org/">Open Source</A>.\r
+ However, if you put in a great deal of effort building a significant application\r
+ which simply uses libsndfile for file I/O, then I have no problem with you releasing\r
+ that as closed source and charging as much money as you want for it as long as you\r
+ abide by <A HREF="http://www.gnu.org/copyleft/lesser.html">the license</A>.\r
+</P>\r
+\r
+<A NAME="Download"></A>\r
+<H1><B>Download</B></H1>\r
+<P>\r
+ Here is the latest version. It is available in the following formats:\r
+</P>\r
+ <UL>\r
+ <LI>Source code as a .tar.gz :\r
+ <A HREF="files/libsndfile-1.0.25.tar.gz">libsndfile-1.0.25.tar.gz</A>\r
+ and\r
+ <A HREF="files/libsndfile-1.0.25.tar.gz.asc">(GPG signature)</A>.\r
+ <LI>Win32 installer:\r
+ <A HREF="files/libsndfile-1.0.25-w32-setup.exe">\r
+ libsndfile-1.0.25-w32-setup.exe</A> (thoroughly tested under\r
+ <a href="http://www.winehq.com/">Wine</a> and Windows XP).\r
+ <LI>Win64 installer:\r
+ <A HREF="files/libsndfile-1.0.25-w64-setup.exe">\r
+ libsndfile-1.0.25-w64-setup.exe</A>\r
+ (thoroughly tested on 64 bit Windows 7).\r
+ </UL>\r
+\r
+<P>\r
+The Win32 installer was compiled for Windows XP but should also work on Windows\r
+2000, Vista and Windows 7.\r
+</p>\r
+\r
+<P>\r
+ Pre-release versions of libsndfile are available\r
+ <A HREF="http://www.mega-nerd.com/tmp/">here</A>\r
+ and are announced on the\r
+ <A HREF="lists.html">libsndfile-devel</A>\r
+ mailing list.\r
+</P>\r
+\r
+<A NAME="SeeAlso"></A>\r
+<H1><B>See Also</B></H1>\r
+ <UL>\r
+ <LI><a href="http://www.mega-nerd.com/libsndfile/tools/">\r
+ sndfile-tools</a>\r
+ : a small collection of programs which use libsndfile.\r
+ </UL>\r
+\r
+<br><br>\r
+\r
+<hr>\r
+\r
+<P>\r
+ The latest version of this document can be found\r
+ <A HREF="http://www.mega-nerd.com/libsndfile/">here</A>.\r
+</P>\r
+<P>\r
+Author :\r
+ <A HREF="mailto:erikd@mega-nerd.com">\r
+ Erik de Castro Lopo</a>\r
+</P>\r
+<!-- pepper -->\r
+<P>\r
+This page has been accessed\r
+ <IMG SRC=\r
+ "/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"\r
+ HEIGHT=30 WIDTH=100 ALT="counter.gif">\r
+times.\r
+</P>\r
+<!-- pepper -->\r
+<!-- pepper -->\r
+<!-- pepper -->\r
+\r
+<br><br>\r
+</BODY>\r
+</HTML>\r
--- /dev/null
+body {\r
+ background : black ;\r
+ color : white ;\r
+ font-family : arial, helvetica, sans-serif ;\r
+ line-height: 1.5 ;\r
+}\r
+td {\r
+ font-family : arial, helvetica, sans-serif ;\r
+ background : black ;\r
+ color : white ;\r
+}\r
+center {\r
+ font-family : arial, helvetica, sans-serif ;\r
+}\r
+p {\r
+ font-family : arial, helvetica, sans-serif ;\r
+ text-align : left ;\r
+ margin-left : 3% ;\r
+ margin-right : 3% ;\r
+}\r
+.indent_block {\r
+ font-family : arial, helvetica, sans-serif ;\r
+ text-align : left ;\r
+ margin-left : 10% ;\r
+ margin-right : 10% ;\r
+}\r
+br {\r
+ font-family : arial, helvetica, sans-serif ;\r
+}\r
+form {\r
+ font-family : arial, helvetica, sans-serif ;\r
+}\r
+ul {\r
+ font-family : arial, helvetica, sans-serif ;\r
+ text-align : left ;\r
+ margin-left : 3% ;\r
+ margin-right : 6% ;\r
+}\r
+ol {\r
+ font-family : arial, helvetica, sans-serif ;\r
+ text-align : left ;\r
+ margin-left : 3% ;\r
+ margin-right : 6% ;\r
+}\r
+dl {\r
+ font-family : arial, helvetica, sans-serif ;\r
+ text-align : left ;\r
+ margin-left : 3% ;\r
+ margin-right : 3% ;\r
+}\r
+h1 {\r
+ font-size : xx-large ;\r
+ background : black ;\r
+ color : #5050FF ;\r
+ text-align : left ;\r
+ margin-left : 3% ;\r
+ margin-right : 3% ;\r
+}\r
+h2 {\r
+ font-size : x-large ;\r
+ background : black ;\r
+ color : #5050FF ;\r
+ text-align : left ;\r
+ margin-left : 3% ;\r
+ margin-right : 3% ;\r
+}\r
+h3 {\r
+ font-size : large ;\r
+ background : black ;\r
+ color : #5050FF ;\r
+ text-align : left ;\r
+ margin-left : 3% ;\r
+ margin-right : 3% ;\r
+}\r
+h4 {\r
+ font-size : medium ;\r
+ background : black ;\r
+ color : #5050FF ;\r
+ text-align : left ;\r
+ margin-left : 3% ;\r
+ margin-right : 3% ;\r
+}\r
+pre {\r
+ font-family : courier, monospace ;\r
+ font-size : medium ;\r
+}\r
+a:link { color : #9090FF ; }\r
+a:visited { color : #5050FF ; }\r
+a:active { color : #FF00FF ; }\r
+a:hover { background-color : #202080 ; }\r
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">\r
+<HTML>\r
+\r
+<HEAD>\r
+ <TITLE>\r
+ libsndfile Mailing Lists\r
+ </TITLE>\r
+ <META NAME="Author" CONTENT="Erik de Castro Lopo (erikd AT mega-nerd DOT com)">\r
+ <LINK REL="stylesheet" HREF="libsndfile.css" TYPE="text/css" MEDIA="all">\r
+ <LINK REL="stylesheet" HREF="print.css" TYPE="text/css" MEDIA="print">\r
+</HEAD>\r
+\r
+<BODY>\r
+<!-- pepper -->\r
+<H1><BR>libsndfile Mailing Lists</H1>\r
+<!-- pepper -->\r
+<P>\r
+There are three mailing lists for libsndfile:\r
+</P>\r
+<!-- pepper -->\r
+<UL>\r
+ <LI> <B>libsndfile-announce@mega-nerd.com</B> <!-- pepper -->\r
+ <A HREF="mailto:libsndfile-announce-request@mega-nerd.com?subject=subscribe">Subscribe</A>\r
+ <BR>\r
+ A list which will announce each new release of libsndfile.\r
+ Noone can post to this list except the author.\r
+ <BR><BR>\r
+\r
+ <LI> <B>libsndfile-devel@mega-nerd.com</B> <!-- pepper -->\r
+ <A HREF="mailto:libsndfile-devel-request@mega-nerd.com?subject=subscribe">Subscribe</A>\r
+ <BR>\r
+ A list for discussing bugs, porting issues and feature requests.\r
+ Posting is restricted to subscribers.\r
+ <BR><BR>\r
+\r
+ <LI> <B>libsndfile-users@mega-nerd.com</B> <!-- pepper -->\r
+ <A HREF="mailto:libsndfile-users-request@mega-nerd.com?subject=subscribe">Subscribe</A>\r
+ <BR>\r
+ A list for discussing the use of libsndfile in other programs.\r
+ Posting is restricted to subscribers.\r
+ <!-- pepper -->\r
+ <BR><BR>\r
+</UL>\r
+<!-- pepper -->\r
+<P>\r
+The libsndfile-devel and libsndfile-users list will automatically receive a \r
+copy of all emails to the libsndfile-announce list.\r
+</P>\r
+<BR>\r
+<!-- pepper -->\r
+</BODY>\r
+</HTML>\r
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">\r
+<HTML>\r
+\r
+<HEAD>\r
+ <TITLE>\r
+ sndfile-info\r
+ </TITLE>\r
+ <META NAME="Author" CONTENT="Erik de Castro Lopo (erikd AT mega-nerd DOT com)">\r
+ <LINK REL="stylesheet" HREF="libsndfile.css" TYPE="text/css" MEDIA="all">\r
+ <LINK REL="stylesheet" HREF="print.css" TYPE="text/css" MEDIA="print">\r
+</HEAD>\r
+\r
+<BODY>\r
+\r
+<P>\r
+ Here is an example of the output from the <B>sndfile-info</B> program distributed with \r
+ libsndfile.\r
+</P>\r
+\r
+<P>\r
+ This file was opened and parsed correctly but had been truncated so that the values\r
+ in the <B>FORM</B> and <B>SSND</B> chunks were incorrect.\r
+</P>\r
+<PRE>\r
+ <B>erikd@hendrix ></B> examples/sndfile-info truncated.aiff \r
+ truncated.aiff\r
+ size : 200000\r
+ FORM : 307474 (should be 199992)\r
+ AIFF\r
+ COMM : 18\r
+ Sample Rate : 16000\r
+ Samples : 76857\r
+ Channels : 2\r
+ Sample Size : 16\r
+ SSND : 307436 (should be 199946)\r
+ Offset : 0\r
+ Block Size : 0\r
+ \r
+ --------------------------------\r
+ Sample Rate : 16000\r
+ Frames : 76857\r
+ Channels : 2\r
+ Bit Width : 16\r
+ Format : 0x00020001\r
+ Sections : 1\r
+ Seekable : TRUE\r
+ Signal Max : 32766\r
+ \r
+</PRE>\r
+\r
+\r
+</BODY>\r
+</HTML>\r
--- /dev/null
+/*\r
+** Copyright (C) 1999-2011Erik de Castro Lopo <erikd@mega-nerd.com>\r
+**\r
+** This program is free software; you can redistribute it and/or modify\r
+** it under the terms of the GNU Lesser General Public License as published by\r
+** the Free Software Foundation; either version 2.1 of the License, or\r
+** (at your option) any later version.\r
+**\r
+** This program is distributed in the hope that it will be useful,\r
+** but WITHOUT ANY WARRANTY; without even the implied warranty of\r
+** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\r
+** GNU Lesser General Public License for more details.\r
+**\r
+** You should have received a copy of the GNU Lesser General Public License\r
+** along with this program; if not, write to the Free Software\r
+** Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.\r
+*/\r
+\r
+/*\r
+** sndfile.h -- system-wide definitions\r
+**\r
+** API documentation is in the doc/ directory of the source code tarball\r
+** and at http://www.mega-nerd.com/libsndfile/api.html.\r
+*/\r
+\r
+#ifndef SNDFILE_H\r
+#define SNDFILE_H\r
+\r
+/* This is the version 1.0.X header file. */\r
+#define SNDFILE_1\r
+\r
+#include <stdio.h>\r
+#include <sys/types.h>\r
+\r
+#ifdef __cplusplus\r
+extern "C" {\r
+#endif /* __cplusplus */\r
+\r
+/* The following file types can be read and written.\r
+** A file type would consist of a major type (ie SF_FORMAT_WAV) bitwise\r
+** ORed with a minor type (ie SF_FORMAT_PCM). SF_FORMAT_TYPEMASK and\r
+** SF_FORMAT_SUBMASK can be used to separate the major and minor file\r
+** types.\r
+*/\r
+\r
+enum\r
+{ /* Major formats. */\r
+ SF_FORMAT_WAV = 0x010000, /* Microsoft WAV format (little endian default). */\r
+ SF_FORMAT_AIFF = 0x020000, /* Apple/SGI AIFF format (big endian). */\r
+ SF_FORMAT_AU = 0x030000, /* Sun/NeXT AU format (big endian). */\r
+ SF_FORMAT_RAW = 0x040000, /* RAW PCM data. */\r
+ SF_FORMAT_PAF = 0x050000, /* Ensoniq PARIS file format. */\r
+ SF_FORMAT_SVX = 0x060000, /* Amiga IFF / SVX8 / SV16 format. */\r
+ SF_FORMAT_NIST = 0x070000, /* Sphere NIST format. */\r
+ SF_FORMAT_VOC = 0x080000, /* VOC files. */\r
+ SF_FORMAT_IRCAM = 0x0A0000, /* Berkeley/IRCAM/CARL */\r
+ SF_FORMAT_W64 = 0x0B0000, /* Sonic Foundry's 64 bit RIFF/WAV */\r
+ SF_FORMAT_MAT4 = 0x0C0000, /* Matlab (tm) V4.2 / GNU Octave 2.0 */\r
+ SF_FORMAT_MAT5 = 0x0D0000, /* Matlab (tm) V5.0 / GNU Octave 2.1 */\r
+ SF_FORMAT_PVF = 0x0E0000, /* Portable Voice Format */\r
+ SF_FORMAT_XI = 0x0F0000, /* Fasttracker 2 Extended Instrument */\r
+ SF_FORMAT_HTK = 0x100000, /* HMM Tool Kit format */\r
+ SF_FORMAT_SDS = 0x110000, /* Midi Sample Dump Standard */\r
+ SF_FORMAT_AVR = 0x120000, /* Audio Visual Research */\r
+ SF_FORMAT_WAVEX = 0x130000, /* MS WAVE with WAVEFORMATEX */\r
+ SF_FORMAT_SD2 = 0x160000, /* Sound Designer 2 */\r
+ SF_FORMAT_FLAC = 0x170000, /* FLAC lossless file format */\r
+ SF_FORMAT_CAF = 0x180000, /* Core Audio File format */\r
+ SF_FORMAT_WVE = 0x190000, /* Psion WVE format */\r
+ SF_FORMAT_OGG = 0x200000, /* Xiph OGG container */\r
+ SF_FORMAT_MPC2K = 0x210000, /* Akai MPC 2000 sampler */\r
+ SF_FORMAT_RF64 = 0x220000, /* RF64 WAV file */\r
+\r
+ /* Subtypes from here on. */\r
+\r
+ SF_FORMAT_PCM_S8 = 0x0001, /* Signed 8 bit data */\r
+ SF_FORMAT_PCM_16 = 0x0002, /* Signed 16 bit data */\r
+ SF_FORMAT_PCM_24 = 0x0003, /* Signed 24 bit data */\r
+ SF_FORMAT_PCM_32 = 0x0004, /* Signed 32 bit data */\r
+\r
+ SF_FORMAT_PCM_U8 = 0x0005, /* Unsigned 8 bit data (WAV and RAW only) */\r
+\r
+ SF_FORMAT_FLOAT = 0x0006, /* 32 bit float data */\r
+ SF_FORMAT_DOUBLE = 0x0007, /* 64 bit float data */\r
+\r
+ SF_FORMAT_ULAW = 0x0010, /* U-Law encoded. */\r
+ SF_FORMAT_ALAW = 0x0011, /* A-Law encoded. */\r
+ SF_FORMAT_IMA_ADPCM = 0x0012, /* IMA ADPCM. */\r
+ SF_FORMAT_MS_ADPCM = 0x0013, /* Microsoft ADPCM. */\r
+\r
+ SF_FORMAT_GSM610 = 0x0020, /* GSM 6.10 encoding. */\r
+ SF_FORMAT_VOX_ADPCM = 0x0021, /* OKI / Dialogix ADPCM */\r
+\r
+ SF_FORMAT_G721_32 = 0x0030, /* 32kbs G721 ADPCM encoding. */\r
+ SF_FORMAT_G723_24 = 0x0031, /* 24kbs G723 ADPCM encoding. */\r
+ SF_FORMAT_G723_40 = 0x0032, /* 40kbs G723 ADPCM encoding. */\r
+\r
+ SF_FORMAT_DWVW_12 = 0x0040, /* 12 bit Delta Width Variable Word encoding. */\r
+ SF_FORMAT_DWVW_16 = 0x0041, /* 16 bit Delta Width Variable Word encoding. */\r
+ SF_FORMAT_DWVW_24 = 0x0042, /* 24 bit Delta Width Variable Word encoding. */\r
+ SF_FORMAT_DWVW_N = 0x0043, /* N bit Delta Width Variable Word encoding. */\r
+\r
+ SF_FORMAT_DPCM_8 = 0x0050, /* 8 bit differential PCM (XI only) */\r
+ SF_FORMAT_DPCM_16 = 0x0051, /* 16 bit differential PCM (XI only) */\r
+\r
+ SF_FORMAT_VORBIS = 0x0060, /* Xiph Vorbis encoding. */\r
+\r
+ /* Endian-ness options. */\r
+\r
+ SF_ENDIAN_FILE = 0x00000000, /* Default file endian-ness. */\r
+ SF_ENDIAN_LITTLE = 0x10000000, /* Force little endian-ness. */\r
+ SF_ENDIAN_BIG = 0x20000000, /* Force big endian-ness. */\r
+ SF_ENDIAN_CPU = 0x30000000, /* Force CPU endian-ness. */\r
+\r
+ SF_FORMAT_SUBMASK = 0x0000FFFF,\r
+ SF_FORMAT_TYPEMASK = 0x0FFF0000,\r
+ SF_FORMAT_ENDMASK = 0x30000000\r
+} ;\r
+\r
+/*\r
+** The following are the valid command numbers for the sf_command()\r
+** interface. The use of these commands is documented in the file\r
+** command.html in the doc directory of the source code distribution.\r
+*/\r
+\r
+enum\r
+{ SFC_GET_LIB_VERSION = 0x1000,\r
+ SFC_GET_LOG_INFO = 0x1001,\r
+ SFC_GET_CURRENT_SF_INFO = 0x1002,\r
+\r
+\r
+ SFC_GET_NORM_DOUBLE = 0x1010,\r
+ SFC_GET_NORM_FLOAT = 0x1011,\r
+ SFC_SET_NORM_DOUBLE = 0x1012,\r
+ SFC_SET_NORM_FLOAT = 0x1013,\r
+ SFC_SET_SCALE_FLOAT_INT_READ = 0x1014,\r
+ SFC_SET_SCALE_INT_FLOAT_WRITE = 0x1015,\r
+\r
+ SFC_GET_SIMPLE_FORMAT_COUNT = 0x1020,\r
+ SFC_GET_SIMPLE_FORMAT = 0x1021,\r
+\r
+ SFC_GET_FORMAT_INFO = 0x1028,\r
+\r
+ SFC_GET_FORMAT_MAJOR_COUNT = 0x1030,\r
+ SFC_GET_FORMAT_MAJOR = 0x1031,\r
+ SFC_GET_FORMAT_SUBTYPE_COUNT = 0x1032,\r
+ SFC_GET_FORMAT_SUBTYPE = 0x1033,\r
+\r
+ SFC_CALC_SIGNAL_MAX = 0x1040,\r
+ SFC_CALC_NORM_SIGNAL_MAX = 0x1041,\r
+ SFC_CALC_MAX_ALL_CHANNELS = 0x1042,\r
+ SFC_CALC_NORM_MAX_ALL_CHANNELS = 0x1043,\r
+ SFC_GET_SIGNAL_MAX = 0x1044,\r
+ SFC_GET_MAX_ALL_CHANNELS = 0x1045,\r
+\r
+ SFC_SET_ADD_PEAK_CHUNK = 0x1050,\r
+ SFC_SET_ADD_HEADER_PAD_CHUNK = 0x1051,\r
+\r
+ SFC_UPDATE_HEADER_NOW = 0x1060,\r
+ SFC_SET_UPDATE_HEADER_AUTO = 0x1061,\r
+\r
+ SFC_FILE_TRUNCATE = 0x1080,\r
+\r
+ SFC_SET_RAW_START_OFFSET = 0x1090,\r
+\r
+ SFC_SET_DITHER_ON_WRITE = 0x10A0,\r
+ SFC_SET_DITHER_ON_READ = 0x10A1,\r
+\r
+ SFC_GET_DITHER_INFO_COUNT = 0x10A2,\r
+ SFC_GET_DITHER_INFO = 0x10A3,\r
+\r
+ SFC_GET_EMBED_FILE_INFO = 0x10B0,\r
+\r
+ SFC_SET_CLIPPING = 0x10C0,\r
+ SFC_GET_CLIPPING = 0x10C1,\r
+\r
+ SFC_GET_INSTRUMENT = 0x10D0,\r
+ SFC_SET_INSTRUMENT = 0x10D1,\r
+\r
+ SFC_GET_LOOP_INFO = 0x10E0,\r
+\r
+ SFC_GET_BROADCAST_INFO = 0x10F0,\r
+ SFC_SET_BROADCAST_INFO = 0x10F1,\r
+\r
+ SFC_GET_CHANNEL_MAP_INFO = 0x1100,\r
+ SFC_SET_CHANNEL_MAP_INFO = 0x1101,\r
+\r
+ SFC_RAW_DATA_NEEDS_ENDSWAP = 0x1110,\r
+\r
+ /* Support for Wavex Ambisonics Format */\r
+ SFC_WAVEX_SET_AMBISONIC = 0x1200,\r
+ SFC_WAVEX_GET_AMBISONIC = 0x1201,\r
+\r
+ SFC_SET_VBR_ENCODING_QUALITY = 0x1300,\r
+\r
+ /* Following commands for testing only. */\r
+ SFC_TEST_IEEE_FLOAT_REPLACE = 0x6001,\r
+\r
+ /*\r
+ ** SFC_SET_ADD_* values are deprecated and will disappear at some\r
+ ** time in the future. They are guaranteed to be here up to and\r
+ ** including version 1.0.8 to avoid breakage of existng software.\r
+ ** They currently do nothing and will continue to do nothing.\r
+ */\r
+ SFC_SET_ADD_DITHER_ON_WRITE = 0x1070,\r
+ SFC_SET_ADD_DITHER_ON_READ = 0x1071\r
+} ;\r
+\r
+\r
+/*\r
+** String types that can be set and read from files. Not all file types\r
+** support this and even the file types which support one, may not support\r
+** all string types.\r
+*/\r
+\r
+enum\r
+{ SF_STR_TITLE = 0x01,\r
+ SF_STR_COPYRIGHT = 0x02,\r
+ SF_STR_SOFTWARE = 0x03,\r
+ SF_STR_ARTIST = 0x04,\r
+ SF_STR_COMMENT = 0x05,\r
+ SF_STR_DATE = 0x06,\r
+ SF_STR_ALBUM = 0x07,\r
+ SF_STR_LICENSE = 0x08,\r
+ SF_STR_TRACKNUMBER = 0x09,\r
+ SF_STR_GENRE = 0x10\r
+} ;\r
+\r
+/*\r
+** Use the following as the start and end index when doing metadata\r
+** transcoding.\r
+*/\r
+\r
+#define SF_STR_FIRST SF_STR_TITLE\r
+#define SF_STR_LAST SF_STR_GENRE\r
+\r
+enum\r
+{ /* True and false */\r
+ SF_FALSE = 0,\r
+ SF_TRUE = 1,\r
+\r
+ /* Modes for opening files. */\r
+ SFM_READ = 0x10,\r
+ SFM_WRITE = 0x20,\r
+ SFM_RDWR = 0x30,\r
+\r
+ SF_AMBISONIC_NONE = 0x40,\r
+ SF_AMBISONIC_B_FORMAT = 0x41\r
+} ;\r
+\r
+/* Public error values. These are guaranteed to remain unchanged for the duration\r
+** of the library major version number.\r
+** There are also a large number of private error numbers which are internal to\r
+** the library which can change at any time.\r
+*/\r
+\r
+enum\r
+{ SF_ERR_NO_ERROR = 0,\r
+ SF_ERR_UNRECOGNISED_FORMAT = 1,\r
+ SF_ERR_SYSTEM = 2,\r
+ SF_ERR_MALFORMED_FILE = 3,\r
+ SF_ERR_UNSUPPORTED_ENCODING = 4\r
+} ;\r
+\r
+\r
+/* Channel map values (used with SFC_SET/GET_CHANNEL_MAP).\r
+*/\r
+\r
+enum\r
+{ SF_CHANNEL_MAP_INVALID = 0,\r
+ SF_CHANNEL_MAP_MONO = 1,\r
+ SF_CHANNEL_MAP_LEFT, /* Apple calls this 'Left' */\r
+ SF_CHANNEL_MAP_RIGHT, /* Apple calls this 'Right' */\r
+ SF_CHANNEL_MAP_CENTER, /* Apple calls this 'Center' */\r
+ SF_CHANNEL_MAP_FRONT_LEFT,\r
+ SF_CHANNEL_MAP_FRONT_RIGHT,\r
+ SF_CHANNEL_MAP_FRONT_CENTER,\r
+ SF_CHANNEL_MAP_REAR_CENTER, /* Apple calls this 'Center Surround', Msft calls this 'Back Center' */\r
+ SF_CHANNEL_MAP_REAR_LEFT, /* Apple calls this 'Left Surround', Msft calls this 'Back Left' */\r
+ SF_CHANNEL_MAP_REAR_RIGHT, /* Apple calls this 'Right Surround', Msft calls this 'Back Right' */\r
+ SF_CHANNEL_MAP_LFE, /* Apple calls this 'LFEScreen', Msft calls this 'Low Frequency' */\r
+ SF_CHANNEL_MAP_FRONT_LEFT_OF_CENTER, /* Apple calls this 'Left Center' */\r
+ SF_CHANNEL_MAP_FRONT_RIGHT_OF_CENTER, /* Apple calls this 'Right Center */\r
+ SF_CHANNEL_MAP_SIDE_LEFT, /* Apple calls this 'Left Surround Direct' */\r
+ SF_CHANNEL_MAP_SIDE_RIGHT, /* Apple calls this 'Right Surround Direct' */\r
+ SF_CHANNEL_MAP_TOP_CENTER, /* Apple calls this 'Top Center Surround' */\r
+ SF_CHANNEL_MAP_TOP_FRONT_LEFT, /* Apple calls this 'Vertical Height Left' */\r
+ SF_CHANNEL_MAP_TOP_FRONT_RIGHT, /* Apple calls this 'Vertical Height Right' */\r
+ SF_CHANNEL_MAP_TOP_FRONT_CENTER, /* Apple calls this 'Vertical Height Center' */\r
+ SF_CHANNEL_MAP_TOP_REAR_LEFT, /* Apple and MS call this 'Top Back Left' */\r
+ SF_CHANNEL_MAP_TOP_REAR_RIGHT, /* Apple and MS call this 'Top Back Right' */\r
+ SF_CHANNEL_MAP_TOP_REAR_CENTER, /* Apple and MS call this 'Top Back Center' */\r
+\r
+ SF_CHANNEL_MAP_AMBISONIC_B_W,\r
+ SF_CHANNEL_MAP_AMBISONIC_B_X,\r
+ SF_CHANNEL_MAP_AMBISONIC_B_Y,\r
+ SF_CHANNEL_MAP_AMBISONIC_B_Z,\r
+\r
+ SF_CHANNEL_MAP_MAX\r
+} ;\r
+\r
+\r
+/* A SNDFILE* pointer can be passed around much like stdio.h's FILE* pointer. */\r
+\r
+typedef struct SNDFILE_tag SNDFILE ;\r
+\r
+/* The following typedef is system specific and is defined when libsndfile is\r
+** compiled. sf_count_t will be a 64 bit value when the underlying OS allows\r
+** 64 bit file offsets.\r
+** On windows, we need to allow the same header file to be compiler by both GCC\r
+** and the Microsoft compiler.\r
+*/\r
+\r
+#if (defined (_MSCVER) || defined (_MSC_VER))\r
+typedef __int64 sf_count_t ;\r
+#define SF_COUNT_MAX 0x7fffffffffffffffi64\r
+#else\r
+typedef __int64 sf_count_t ;\r
+#define SF_COUNT_MAX 0x7FFFFFFFFFFFFFFFLL\r
+#endif\r
+\r
+\r
+/* A pointer to a SF_INFO structure is passed to sf_open () and filled in.\r
+** On write, the SF_INFO structure is filled in by the user and passed into\r
+** sf_open ().\r
+*/\r
+\r
+struct SF_INFO\r
+{ sf_count_t frames ; /* Used to be called samples. Changed to avoid confusion. */\r
+ int samplerate ;\r
+ int channels ;\r
+ int format ;\r
+ int sections ;\r
+ int seekable ;\r
+} ;\r
+\r
+typedef struct SF_INFO SF_INFO ;\r
+\r
+/* The SF_FORMAT_INFO struct is used to retrieve information about the sound\r
+** file formats libsndfile supports using the sf_command () interface.\r
+**\r
+** Using this interface will allow applications to support new file formats\r
+** and encoding types when libsndfile is upgraded, without requiring\r
+** re-compilation of the application.\r
+**\r
+** Please consult the libsndfile documentation (particularly the information\r
+** on the sf_command () interface) for examples of its use.\r
+*/\r
+\r
+typedef struct\r
+{ int format ;\r
+ const char *name ;\r
+ const char *extension ;\r
+} SF_FORMAT_INFO ;\r
+\r
+/*\r
+** Enums and typedefs for adding dither on read and write.\r
+** See the html documentation for sf_command(), SFC_SET_DITHER_ON_WRITE\r
+** and SFC_SET_DITHER_ON_READ.\r
+*/\r
+\r
+enum\r
+{ SFD_DEFAULT_LEVEL = 0,\r
+ SFD_CUSTOM_LEVEL = 0x40000000,\r
+\r
+ SFD_NO_DITHER = 500,\r
+ SFD_WHITE = 501,\r
+ SFD_TRIANGULAR_PDF = 502\r
+} ;\r
+\r
+typedef struct\r
+{ int type ;\r
+ double level ;\r
+ const char *name ;\r
+} SF_DITHER_INFO ;\r
+\r
+/* Struct used to retrieve information about a file embedded within a\r
+** larger file. See SFC_GET_EMBED_FILE_INFO.\r
+*/\r
+\r
+typedef struct\r
+{ sf_count_t offset ;\r
+ sf_count_t length ;\r
+} SF_EMBED_FILE_INFO ;\r
+\r
+/*\r
+** Structs used to retrieve music sample information from a file.\r
+*/\r
+\r
+enum\r
+{ /*\r
+ ** The loop mode field in SF_INSTRUMENT will be one of the following.\r
+ */\r
+ SF_LOOP_NONE = 800,\r
+ SF_LOOP_FORWARD,\r
+ SF_LOOP_BACKWARD,\r
+ SF_LOOP_ALTERNATING\r
+} ;\r
+\r
+typedef struct\r
+{ int gain ;\r
+ char basenote, detune ;\r
+ char velocity_lo, velocity_hi ;\r
+ char key_lo, key_hi ;\r
+ int loop_count ;\r
+\r
+ struct\r
+ { int mode ;\r
+ unsigned int start ;\r
+ unsigned int end ;\r
+ unsigned int count ;\r
+ } loops [16] ; /* make variable in a sensible way */\r
+} SF_INSTRUMENT ;\r
+\r
+\r
+\r
+/* Struct used to retrieve loop information from a file.*/\r
+typedef struct\r
+{\r
+ short time_sig_num ; /* any positive integer > 0 */\r
+ short time_sig_den ; /* any positive power of 2 > 0 */\r
+ int loop_mode ; /* see SF_LOOP enum */\r
+\r
+ int num_beats ; /* this is NOT the amount of quarter notes !!!*/\r
+ /* a full bar of 4/4 is 4 beats */\r
+ /* a full bar of 7/8 is 7 beats */\r
+\r
+ float bpm ; /* suggestion, as it can be calculated using other fields:*/\r
+ /* file's lenght, file's sampleRate and our time_sig_den*/\r
+ /* -> bpms are always the amount of _quarter notes_ per minute */\r
+\r
+ int root_key ; /* MIDI note, or -1 for None */\r
+ int future [6] ;\r
+} SF_LOOP_INFO ;\r
+\r
+\r
+/* Struct used to retrieve broadcast (EBU) information from a file.\r
+** Strongly (!) based on EBU "bext" chunk format used in Broadcast WAVE.\r
+*/\r
+#define SF_BROADCAST_INFO_VAR(coding_hist_size) \\r
+ struct \\r
+ { char description [256] ; \\r
+ char originator [32] ; \\r
+ char originator_reference [32] ; \\r
+ char origination_date [10] ; \\r
+ char origination_time [8] ; \\r
+ unsigned int time_reference_low ; \\r
+ unsigned int time_reference_high ; \\r
+ short version ; \\r
+ char umid [64] ; \\r
+ char reserved [190] ; \\r
+ unsigned int coding_history_size ; \\r
+ char coding_history [coding_hist_size] ; \\r
+ }\r
+\r
+/* SF_BROADCAST_INFO is the above struct with coding_history field of 256 bytes. */\r
+typedef SF_BROADCAST_INFO_VAR (256) SF_BROADCAST_INFO ;\r
+\r
+\r
+/* Virtual I/O functionality. */\r
+\r
+typedef sf_count_t (*sf_vio_get_filelen) (void *user_data) ;\r
+typedef sf_count_t (*sf_vio_seek) (sf_count_t offset, int whence, void *user_data) ;\r
+typedef sf_count_t (*sf_vio_read) (void *ptr, sf_count_t count, void *user_data) ;\r
+typedef sf_count_t (*sf_vio_write) (const void *ptr, sf_count_t count, void *user_data) ;\r
+typedef sf_count_t (*sf_vio_tell) (void *user_data) ;\r
+\r
+struct SF_VIRTUAL_IO\r
+{ sf_vio_get_filelen get_filelen ;\r
+ sf_vio_seek seek ;\r
+ sf_vio_read read ;\r
+ sf_vio_write write ;\r
+ sf_vio_tell tell ;\r
+} ;\r
+\r
+typedef struct SF_VIRTUAL_IO SF_VIRTUAL_IO ;\r
+\r
+\r
+/* Open the specified file for read, write or both. On error, this will\r
+** return a NULL pointer. To find the error number, pass a NULL SNDFILE\r
+** to sf_strerror ().\r
+** All calls to sf_open() should be matched with a call to sf_close().\r
+*/\r
+\r
+SNDFILE* sf_open (const char *path, int mode, SF_INFO *sfinfo) ;\r
+\r
+\r
+/* Use the existing file descriptor to create a SNDFILE object. If close_desc\r
+** is TRUE, the file descriptor will be closed when sf_close() is called. If\r
+** it is FALSE, the descritor will not be closed.\r
+** When passed a descriptor like this, the library will assume that the start\r
+** of file header is at the current file offset. This allows sound files within\r
+** larger container files to be read and/or written.\r
+** On error, this will return a NULL pointer. To find the error number, pass a\r
+** NULL SNDFILE to sf_strerror ().\r
+** All calls to sf_open_fd() should be matched with a call to sf_close().\r
+\r
+*/\r
+\r
+SNDFILE* sf_open_fd (int fd, int mode, SF_INFO *sfinfo, int close_desc) ;\r
+\r
+SNDFILE* sf_open_virtual (SF_VIRTUAL_IO *sfvirtual, int mode, SF_INFO *sfinfo, void *user_data) ;\r
+\r
+\r
+/* sf_error () returns a error number which can be translated to a text\r
+** string using sf_error_number().\r
+*/\r
+\r
+int sf_error (SNDFILE *sndfile) ;\r
+\r
+\r
+/* sf_strerror () returns to the caller a pointer to the current error message for\r
+** the given SNDFILE.\r
+*/\r
+\r
+const char* sf_strerror (SNDFILE *sndfile) ;\r
+\r
+\r
+/* sf_error_number () allows the retrieval of the error string for each internal\r
+** error number.\r
+**\r
+*/\r
+\r
+const char* sf_error_number (int errnum) ;\r
+\r
+\r
+/* The following two error functions are deprecated but they will remain in the\r
+** library for the forseeable future. The function sf_strerror() should be used\r
+** in their place.\r
+*/\r
+\r
+int sf_perror (SNDFILE *sndfile) ;\r
+int sf_error_str (SNDFILE *sndfile, char* str, size_t len) ;\r
+\r
+\r
+/* Return TRUE if fields of the SF_INFO struct are a valid combination of values. */\r
+\r
+int sf_command (SNDFILE *sndfile, int command, void *data, int datasize) ;\r
+\r
+\r
+/* Return TRUE if fields of the SF_INFO struct are a valid combination of values. */\r
+\r
+int sf_format_check (const SF_INFO *info) ;\r
+\r
+\r
+/* Seek within the waveform data chunk of the SNDFILE. sf_seek () uses\r
+** the same values for whence (SEEK_SET, SEEK_CUR and SEEK_END) as\r
+** stdio.h function fseek ().\r
+** An offset of zero with whence set to SEEK_SET will position the\r
+** read / write pointer to the first data sample.\r
+** On success sf_seek returns the current position in (multi-channel)\r
+** samples from the start of the file.\r
+** Please see the libsndfile documentation for moving the read pointer\r
+** separately from the write pointer on files open in mode SFM_RDWR.\r
+** On error all of these functions return -1.\r
+*/\r
+\r
+sf_count_t sf_seek (SNDFILE *sndfile, sf_count_t frames, int whence) ;\r
+\r
+\r
+/* Functions for retrieving and setting string data within sound files.\r
+** Not all file types support this features; AIFF and WAV do. For both\r
+** functions, the str_type parameter must be one of the SF_STR_* values\r
+** defined above.\r
+** On error, sf_set_string() returns non-zero while sf_get_string()\r
+** returns NULL.\r
+*/\r
+\r
+int sf_set_string (SNDFILE *sndfile, int str_type, const char* str) ;\r
+\r
+const char* sf_get_string (SNDFILE *sndfile, int str_type) ;\r
+\r
+\r
+/* Return the library version string. */\r
+\r
+const char * sf_version_string (void) ;\r
+\r
+\r
+/* Functions for reading/writing the waveform data of a sound file.\r
+*/\r
+\r
+sf_count_t sf_read_raw (SNDFILE *sndfile, void *ptr, sf_count_t bytes) ;\r
+sf_count_t sf_write_raw (SNDFILE *sndfile, const void *ptr, sf_count_t bytes) ;\r
+\r
+\r
+/* Functions for reading and writing the data chunk in terms of frames.\r
+** The number of items actually read/written = frames * number of channels.\r
+** sf_xxxx_raw read/writes the raw data bytes from/to the file\r
+** sf_xxxx_short passes data in the native short format\r
+** sf_xxxx_int passes data in the native int format\r
+** sf_xxxx_float passes data in the native float format\r
+** sf_xxxx_double passes data in the native double format\r
+** All of these read/write function return number of frames read/written.\r
+*/\r
+\r
+sf_count_t sf_readf_short (SNDFILE *sndfile, short *ptr, sf_count_t frames) ;\r
+sf_count_t sf_writef_short (SNDFILE *sndfile, const short *ptr, sf_count_t frames) ;\r
+\r
+sf_count_t sf_readf_int (SNDFILE *sndfile, int *ptr, sf_count_t frames) ;\r
+sf_count_t sf_writef_int (SNDFILE *sndfile, const int *ptr, sf_count_t frames) ;\r
+\r
+sf_count_t sf_readf_float (SNDFILE *sndfile, float *ptr, sf_count_t frames) ;\r
+sf_count_t sf_writef_float (SNDFILE *sndfile, const float *ptr, sf_count_t frames) ;\r
+\r
+sf_count_t sf_readf_double (SNDFILE *sndfile, double *ptr, sf_count_t frames) ;\r
+sf_count_t sf_writef_double (SNDFILE *sndfile, const double *ptr, sf_count_t frames) ;\r
+\r
+\r
+/* Functions for reading and writing the data chunk in terms of items.\r
+** Otherwise similar to above.\r
+** All of these read/write function return number of items read/written.\r
+*/\r
+\r
+sf_count_t sf_read_short (SNDFILE *sndfile, short *ptr, sf_count_t items) ;\r
+sf_count_t sf_write_short (SNDFILE *sndfile, const short *ptr, sf_count_t items) ;\r
+\r
+sf_count_t sf_read_int (SNDFILE *sndfile, int *ptr, sf_count_t items) ;\r
+sf_count_t sf_write_int (SNDFILE *sndfile, const int *ptr, sf_count_t items) ;\r
+\r
+sf_count_t sf_read_float (SNDFILE *sndfile, float *ptr, sf_count_t items) ;\r
+sf_count_t sf_write_float (SNDFILE *sndfile, const float *ptr, sf_count_t items) ;\r
+\r
+sf_count_t sf_read_double (SNDFILE *sndfile, double *ptr, sf_count_t items) ;\r
+sf_count_t sf_write_double (SNDFILE *sndfile, const double *ptr, sf_count_t items) ;\r
+\r
+\r
+/* Close the SNDFILE and clean up all memory allocations associated with this\r
+** file.\r
+** Returns 0 on success, or an error number.\r
+*/\r
+\r
+int sf_close (SNDFILE *sndfile) ;\r
+\r
+\r
+/* If the file is opened SFM_WRITE or SFM_RDWR, call fsync() on the file\r
+** to force the writing of data to disk. If the file is opened SFM_READ\r
+** no action is taken.\r
+*/\r
+\r
+void sf_write_sync (SNDFILE *sndfile) ;\r
+\r
+\r
+\r
+/* The function sf_wchar_open() is Windows Only!\r
+** Open a file passing in a Windows Unicode filename. Otherwise, this is\r
+** the same as sf_open().\r
+**\r
+** In order for this to work, you need to do the following:\r
+**\r
+** #include <windows.h>\r
+** #define ENABLE_SNDFILE_WINDOWS_PROTOTYPES 1\r
+** #including <sndfile.h>\r
+*/\r
+\r
+#if (defined (ENABLE_SNDFILE_WINDOWS_PROTOTYPES) && ENABLE_SNDFILE_WINDOWS_PROTOTYPES)\r
+SNDFILE* sf_wchar_open (LPCWSTR wpath, int mode, SF_INFO *sfinfo) ;\r
+#endif\r
+\r
+\r
+\r
+#ifdef __cplusplus\r
+} /* extern "C" */\r
+#endif /* __cplusplus */\r
+\r
+#endif /* SNDFILE_H */\r
+\r
--- /dev/null
+/*\r
+** Copyright (C) 2005-2011 Erik de Castro Lopo <erikd@mega-nerd.com>\r
+**\r
+** All rights reserved.\r
+**\r
+** Redistribution and use in source and binary forms, with or without\r
+** modification, are permitted provided that the following conditions are\r
+** met:\r
+**\r
+** * Redistributions of source code must retain the above copyright\r
+** notice, this list of conditions and the following disclaimer.\r
+** * Redistributions in binary form must reproduce the above copyright\r
+** notice, this list of conditions and the following disclaimer in\r
+** the documentation and/or other materials provided with the\r
+** distribution.\r
+** * Neither the author nor the names of any contributors may be used\r
+** to endorse or promote products derived from this software without\r
+** specific prior written permission.\r
+**\r
+** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\r
+** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED\r
+** TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR\r
+** PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR\r
+** CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,\r
+** EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,\r
+** PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;\r
+** OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,\r
+** WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR\r
+** OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF\r
+** ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r
+*/\r
+\r
+/*\r
+** The above modified BSD style license (GPL and LGPL compatible) applies to\r
+** this file. It does not apply to libsndfile itself which is released under\r
+** the GNU LGPL or the libsndfile test suite which is released under the GNU\r
+** GPL.\r
+** This means that this header file can be used under this modified BSD style\r
+** license, but the LGPL still holds for the libsndfile library itself.\r
+*/\r
+\r
+/*\r
+** sndfile.hh -- A lightweight C++ wrapper for the libsndfile API.\r
+**\r
+** All the methods are inlines and all functionality is contained in this\r
+** file. There is no separate implementation file.\r
+**\r
+** API documentation is in the doc/ directory of the source code tarball\r
+** and at http://www.mega-nerd.com/libsndfile/api.html.\r
+*/\r
+\r
+#ifndef SNDFILE_HH\r
+#define SNDFILE_HH\r
+\r
+#include <sndfile.h>\r
+\r
+#include <string>\r
+#include <new> // for std::nothrow\r
+\r
+class SndfileHandle\r
+{ private :\r
+ struct SNDFILE_ref\r
+ { SNDFILE_ref (void) ;\r
+ ~SNDFILE_ref (void) ;\r
+\r
+ SNDFILE *sf ;\r
+ SF_INFO sfinfo ;\r
+ int ref ;\r
+ } ;\r
+\r
+ SNDFILE_ref *p ;\r
+\r
+ public :\r
+ /* Default constructor */\r
+ SndfileHandle (void) : p (NULL) {} ;\r
+ SndfileHandle (const char *path, int mode = SFM_READ,\r
+ int format = 0, int channels = 0, int samplerate = 0) ;\r
+ SndfileHandle (std::string const & path, int mode = SFM_READ,\r
+ int format = 0, int channels = 0, int samplerate = 0) ;\r
+ SndfileHandle (int fd, bool close_desc, int mode = SFM_READ,\r
+ int format = 0, int channels = 0, int samplerate = 0) ;\r
+\r
+#ifdef ENABLE_SNDFILE_WINDOWS_PROTOTYPES\r
+ SndfileHandle (LPCWSTR wpath, int mode = SFM_READ,\r
+ int format = 0, int channels = 0, int samplerate = 0) ;\r
+#endif\r
+\r
+ ~SndfileHandle (void) ;\r
+\r
+ SndfileHandle (const SndfileHandle &orig) ;\r
+ SndfileHandle & operator = (const SndfileHandle &rhs) ;\r
+\r
+ /* Mainly for debugging/testing. */\r
+ int refCount (void) const { return (p == NULL) ? 0 : p->ref ; }\r
+\r
+ operator bool () const { return (p != NULL) ; }\r
+\r
+ bool operator == (const SndfileHandle &rhs) const { return (p == rhs.p) ; }\r
+\r
+ sf_count_t frames (void) const { return p ? p->sfinfo.frames : 0 ; }\r
+ int format (void) const { return p ? p->sfinfo.format : 0 ; }\r
+ int channels (void) const { return p ? p->sfinfo.channels : 0 ; }\r
+ int samplerate (void) const { return p ? p->sfinfo.samplerate : 0 ; }\r
+\r
+ int error (void) const ;\r
+ const char * strError (void) const ;\r
+\r
+ int command (int cmd, void *data, int datasize) ;\r
+\r
+ sf_count_t seek (sf_count_t frames, int whence) ;\r
+\r
+ void writeSync (void) ;\r
+\r
+ int setString (int str_type, const char* str) ;\r
+\r
+ const char* getString (int str_type) const ;\r
+\r
+ static int formatCheck (int format, int channels, int samplerate) ;\r
+\r
+ sf_count_t read (short *ptr, sf_count_t items) ;\r
+ sf_count_t read (int *ptr, sf_count_t items) ;\r
+ sf_count_t read (float *ptr, sf_count_t items) ;\r
+ sf_count_t read (double *ptr, sf_count_t items) ;\r
+\r
+ sf_count_t write (const short *ptr, sf_count_t items) ;\r
+ sf_count_t write (const int *ptr, sf_count_t items) ;\r
+ sf_count_t write (const float *ptr, sf_count_t items) ;\r
+ sf_count_t write (const double *ptr, sf_count_t items) ;\r
+\r
+ sf_count_t readf (short *ptr, sf_count_t frames) ;\r
+ sf_count_t readf (int *ptr, sf_count_t frames) ;\r
+ sf_count_t readf (float *ptr, sf_count_t frames) ;\r
+ sf_count_t readf (double *ptr, sf_count_t frames) ;\r
+\r
+ sf_count_t writef (const short *ptr, sf_count_t frames) ;\r
+ sf_count_t writef (const int *ptr, sf_count_t frames) ;\r
+ sf_count_t writef (const float *ptr, sf_count_t frames) ;\r
+ sf_count_t writef (const double *ptr, sf_count_t frames) ;\r
+\r
+ sf_count_t readRaw (void *ptr, sf_count_t bytes) ;\r
+ sf_count_t writeRaw (const void *ptr, sf_count_t bytes) ;\r
+\r
+ /**< Raw access to the handle. SndfileHandle keeps ownership. */\r
+ SNDFILE * rawHandle (void) ;\r
+\r
+ /**< Take ownership of handle, iff reference count is 1. */\r
+ SNDFILE * takeOwnership (void) ;\r
+} ;\r
+\r
+/*==============================================================================\r
+** Nothing but implementation below.\r
+*/\r
+\r
+inline\r
+SndfileHandle::SNDFILE_ref::SNDFILE_ref (void)\r
+: ref (1)\r
+{}\r
+\r
+inline\r
+SndfileHandle::SNDFILE_ref::~SNDFILE_ref (void)\r
+{ if (sf != NULL) sf_close (sf) ; }\r
+\r
+inline\r
+SndfileHandle::SndfileHandle (const char *path, int mode, int fmt, int chans, int srate)\r
+: p (NULL)\r
+{\r
+ p = new (std::nothrow) SNDFILE_ref () ;\r
+\r
+ if (p != NULL)\r
+ { p->ref = 1 ;\r
+\r
+ p->sfinfo.frames = 0 ;\r
+ p->sfinfo.channels = chans ;\r
+ p->sfinfo.format = fmt ;\r
+ p->sfinfo.samplerate = srate ;\r
+ p->sfinfo.sections = 0 ;\r
+ p->sfinfo.seekable = 0 ;\r
+\r
+ p->sf = sf_open (path, mode, &p->sfinfo) ;\r
+ } ;\r
+\r
+ return ;\r
+} /* SndfileHandle const char * constructor */\r
+\r
+inline\r
+SndfileHandle::SndfileHandle (std::string const & path, int mode, int fmt, int chans, int srate)\r
+: p (NULL)\r
+{\r
+ p = new (std::nothrow) SNDFILE_ref () ;\r
+\r
+ if (p != NULL)\r
+ { p->ref = 1 ;\r
+\r
+ p->sfinfo.frames = 0 ;\r
+ p->sfinfo.channels = chans ;\r
+ p->sfinfo.format = fmt ;\r
+ p->sfinfo.samplerate = srate ;\r
+ p->sfinfo.sections = 0 ;\r
+ p->sfinfo.seekable = 0 ;\r
+\r
+ p->sf = sf_open (path.c_str (), mode, &p->sfinfo) ;\r
+ } ;\r
+\r
+ return ;\r
+} /* SndfileHandle std::string constructor */\r
+\r
+inline\r
+SndfileHandle::SndfileHandle (int fd, bool close_desc, int mode, int fmt, int chans, int srate)\r
+: p (NULL)\r
+{\r
+ if (fd < 0)\r
+ return ;\r
+\r
+ p = new (std::nothrow) SNDFILE_ref () ;\r
+\r
+ if (p != NULL)\r
+ { p->ref = 1 ;\r
+\r
+ p->sfinfo.frames = 0 ;\r
+ p->sfinfo.channels = chans ;\r
+ p->sfinfo.format = fmt ;\r
+ p->sfinfo.samplerate = srate ;\r
+ p->sfinfo.sections = 0 ;\r
+ p->sfinfo.seekable = 0 ;\r
+\r
+ p->sf = sf_open_fd (fd, mode, &p->sfinfo, close_desc) ;\r
+ } ;\r
+\r
+ return ;\r
+} /* SndfileHandle fd constructor */\r
+\r
+inline\r
+SndfileHandle::~SndfileHandle (void)\r
+{ if (p != NULL && --p->ref == 0)\r
+ delete p ;\r
+} /* SndfileHandle destructor */\r
+\r
+\r
+inline\r
+SndfileHandle::SndfileHandle (const SndfileHandle &orig)\r
+: p (orig.p)\r
+{ if (p != NULL)\r
+ ++p->ref ;\r
+} /* SndfileHandle copy constructor */\r
+\r
+inline SndfileHandle &\r
+SndfileHandle::operator = (const SndfileHandle &rhs)\r
+{\r
+ if (&rhs == this)\r
+ return *this ;\r
+ if (p != NULL && --p->ref == 0)\r
+ delete p ;\r
+\r
+ p = rhs.p ;\r
+ if (p != NULL)\r
+ ++p->ref ;\r
+\r
+ return *this ;\r
+} /* SndfileHandle assignment operator */\r
+\r
+inline int\r
+SndfileHandle::error (void) const\r
+{ return sf_error (p->sf) ; }\r
+\r
+inline const char *\r
+SndfileHandle::strError (void) const\r
+{ return sf_strerror (p->sf) ; }\r
+\r
+inline int\r
+SndfileHandle::command (int cmd, void *data, int datasize)\r
+{ return sf_command (p->sf, cmd, data, datasize) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::seek (sf_count_t frame_count, int whence)\r
+{ return sf_seek (p->sf, frame_count, whence) ; }\r
+\r
+inline void\r
+SndfileHandle::writeSync (void)\r
+{ sf_write_sync (p->sf) ; }\r
+\r
+inline int\r
+SndfileHandle::setString (int str_type, const char* str)\r
+{ return sf_set_string (p->sf, str_type, str) ; }\r
+\r
+inline const char*\r
+SndfileHandle::getString (int str_type) const\r
+{ return sf_get_string (p->sf, str_type) ; }\r
+\r
+inline int\r
+SndfileHandle::formatCheck (int fmt, int chans, int srate)\r
+{\r
+ SF_INFO sfinfo ;\r
+\r
+ sfinfo.frames = 0 ;\r
+ sfinfo.channels = chans ;\r
+ sfinfo.format = fmt ;\r
+ sfinfo.samplerate = srate ;\r
+ sfinfo.sections = 0 ;\r
+ sfinfo.seekable = 0 ;\r
+\r
+ return sf_format_check (&sfinfo) ;\r
+}\r
+\r
+/*---------------------------------------------------------------------*/\r
+\r
+inline sf_count_t\r
+SndfileHandle::read (short *ptr, sf_count_t items)\r
+{ return sf_read_short (p->sf, ptr, items) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::read (int *ptr, sf_count_t items)\r
+{ return sf_read_int (p->sf, ptr, items) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::read (float *ptr, sf_count_t items)\r
+{ return sf_read_float (p->sf, ptr, items) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::read (double *ptr, sf_count_t items)\r
+{ return sf_read_double (p->sf, ptr, items) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::write (const short *ptr, sf_count_t items)\r
+{ return sf_write_short (p->sf, ptr, items) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::write (const int *ptr, sf_count_t items)\r
+{ return sf_write_int (p->sf, ptr, items) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::write (const float *ptr, sf_count_t items)\r
+{ return sf_write_float (p->sf, ptr, items) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::write (const double *ptr, sf_count_t items)\r
+{ return sf_write_double (p->sf, ptr, items) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::readf (short *ptr, sf_count_t frame_count)\r
+{ return sf_readf_short (p->sf, ptr, frame_count) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::readf (int *ptr, sf_count_t frame_count)\r
+{ return sf_readf_int (p->sf, ptr, frame_count) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::readf (float *ptr, sf_count_t frame_count)\r
+{ return sf_readf_float (p->sf, ptr, frame_count) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::readf (double *ptr, sf_count_t frame_count)\r
+{ return sf_readf_double (p->sf, ptr, frame_count) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::writef (const short *ptr, sf_count_t frame_count)\r
+{ return sf_writef_short (p->sf, ptr, frame_count) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::writef (const int *ptr, sf_count_t frame_count)\r
+{ return sf_writef_int (p->sf, ptr, frame_count) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::writef (const float *ptr, sf_count_t frame_count)\r
+{ return sf_writef_float (p->sf, ptr, frame_count) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::writef (const double *ptr, sf_count_t frame_count)\r
+{ return sf_writef_double (p->sf, ptr, frame_count) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::readRaw (void *ptr, sf_count_t bytes)\r
+{ return sf_read_raw (p->sf, ptr, bytes) ; }\r
+\r
+inline sf_count_t\r
+SndfileHandle::writeRaw (const void *ptr, sf_count_t bytes)\r
+{ return sf_write_raw (p->sf, ptr, bytes) ; }\r
+\r
+inline SNDFILE *\r
+SndfileHandle::rawHandle (void)\r
+{ return (p ? p->sf : NULL) ; }\r
+\r
+inline SNDFILE *\r
+SndfileHandle::takeOwnership (void)\r
+{\r
+ if (p == NULL || (p->ref != 1))\r
+ return NULL ;\r
+\r
+ SNDFILE * sf = p->sf ;\r
+ p->sf = NULL ;\r
+ delete p ;\r
+ p = NULL ;\r
+ return sf ;\r
+}\r
+\r
+#ifdef ENABLE_SNDFILE_WINDOWS_PROTOTYPES\r
+\r
+inline\r
+SndfileHandle::SndfileHandle (LPCWSTR wpath, int mode, int fmt, int chans, int srate)\r
+: p (NULL)\r
+{\r
+ p = new (std::nothrow) SNDFILE_ref () ;\r
+\r
+ if (p != NULL)\r
+ { p->ref = 1 ;\r
+\r
+ p->sfinfo.frames = 0 ;\r
+ p->sfinfo.channels = chans ;\r
+ p->sfinfo.format = fmt ;\r
+ p->sfinfo.samplerate = srate ;\r
+ p->sfinfo.sections = 0 ;\r
+ p->sfinfo.seekable = 0 ;\r
+\r
+ p->sf = sf_wchar_open (wpath, mode, &p->sfinfo) ;\r
+ } ;\r
+\r
+ return ;\r
+} /* SndfileHandle const wchar_t * constructor */\r
+\r
+#endif\r
+\r
+#endif /* SNDFILE_HH */\r
+\r
--- /dev/null
+; Auto-generated by create_symbols_file.py
+
+LIBRARY libsndfile-1.dll
+EXPORTS
+
+sf_command @1
+sf_open @2
+sf_close @3
+sf_seek @4
+sf_error @7
+sf_perror @8
+sf_error_str @9
+sf_error_number @10
+sf_format_check @11
+sf_read_raw @16
+sf_readf_short @17
+sf_readf_int @18
+sf_readf_float @19
+sf_readf_double @20
+sf_read_short @21
+sf_read_int @22
+sf_read_float @23
+sf_read_double @24
+sf_write_raw @32
+sf_writef_short @33
+sf_writef_int @34
+sf_writef_float @35
+sf_writef_double @36
+sf_write_short @37
+sf_write_int @38
+sf_write_float @39
+sf_write_double @40
+sf_strerror @50
+sf_get_string @60
+sf_set_string @61
+sf_version_string @68
+sf_open_fd @70
+sf_wchar_open @71
+sf_open_virtual @80
+sf_write_sync @90
+
--- /dev/null
+prefix=c:/devel/target/libsndfile
+exec_prefix=${prefix}
+libdir=${exec_prefix}/lib
+includedir=${prefix}/include
+
+Name: sndfile
+Description: A library for reading and writing audio files
+Requires:
+Version: 1.0.25
+Libs: -L${libdir} -lsndfile
+Libs.private: Ext/libflac.la Ext/libvorbis.la Ext/libogg.la
+Cflags: -I${includedir}
projects / freetel-svn-tracking.git / commitdiff
