home *** CD-ROM | disk | FTP | other *** search
/ RISCWORLD 7 / RISCWORLD_VOL7.iso / Software / Issue4 / SDL / gcc346 / !SDL / doc / libsdl-sound1.2-1.0.1 / ChangeLog < prev    next >
Encoding:
Text File  |  2006-09-22  |  22.8 KB  |  349 lines

  1.  
  2. /*
  3.  * CHANGELOG.
  4.  */
  5.  
  6. 10122003 - Fixed "make dist" behaviour to not packaged generated docs, and
  7.            made sure other files are always packaged, regardless of config.
  8.            Upped version to 1.0.1.
  9. 10102003 - Changed some SDL_Error()s to __Sound_SetError() in new DLS code
  10.            to fix linking issues.
  11. 10052003 - Fixed memory corruption when freeing DLS instruments,
  12.            and bug when timidity is initialized multiple times (Thanks, Sam!).
  13. 09252003 - Sam Lantinga added support for DLS instruments to the MIDI decoder.
  14. 09132003 - Happy September. Added Speex (.spx) decoder.
  15. 08052003 - Fixed MIDI decoder on bigendian systems.
  16. 03102003 - Never actually created samplelist_mutex (Thanks, Glenn Maynard!).
  17. 01302003 - Patches to make SDL_sound more Visual C happy (Thanks, Eric!).
  18. 01122003 - Fix to smpeg.c's rewinding code (Thanks, Eric). Put Visual C 6
  19.            project files in CVS, without external binaries (Thanks, Eric).
  20. 12212002 - Fixed ogg.c to decode a full buffer at a time instead of one ogg
  21.            packet per call, and mikmod has a check during initialization to
  22.            prevent a clash with SDL_mixer (Thanks, Eric).
  23. 12092002 - Changed Sound_Init()'s call to SDL_Init() to SDL_InitSubSystem(),
  24.            to prevent unwanted use of the SDL parachute (thanks, Glenn).
  25. 10092002 - Fixed a "make dist" issue and upped version to 1.0.0! Woohoo!
  26. 09302002 - libFLAC broke their API (again!) for version 1.0.4. That was the
  27.            last straw. I ripped the version detection and obsolete FLAC
  28.            support out, so you need libFLAC 1.0.4 for that decoder now (and
  29.            they'll probably break the API again for 1.0.5. Argh).
  30. 09262002 - Happy September. Fixed SDLCALL issues in SDL_sound.h, so it should
  31.            work with Win32/WinCE builds again. I hope. Merged latest altcvt
  32.            from Frank into CVS.
  33. 08222002 - Borland project files in CVS, thanks to Dominique Louis. There are
  34.            project files for C++ Builder 6 (Windows), C++ Builder for Linux
  35.            (aka Kylix 3) and Borland's C++ Command line compiler.
  36. 08172002 - Timidity memory leak cleanup by Torbjörn.
  37. 07292002 - Valgrind cleanups; memory leak patches, etc.
  38. 07212002 - done_flag was not being reset between files in playsound, so the
  39.            first file would playback, and then any following tracks in a given
  40.            run would "finish" immediately. Fixed.
  41. 07132002 - More altcvt fixes from Frank Ranostaj.
  42. 07122002 - Changed inline keyword to compile universally.
  43. 07102002 - Fixed a bug in command line handling in playsound.c. Fixes from
  44.            Torbjörn and myself to get flac.c friendly between versions of
  45.            libFLAC. Mutex'd a potential race condition in decoders/modplug.c.
  46.            FIXME cleanups here and there.
  47. 07092002 - Fixed typo in documentation (SDL_sound.h).
  48. 07052002 - Cleaned up some stuff in playsound.c, removing some FIXMEs.
  49.            Commandline validation is improved, too. FIXME removal in
  50.            voc.c; should report i/o errors correctly now. Changed DECLSPEC
  51.            to SNDDECLSPEC to prevent SDL conflict, and added SDLCALL support.
  52.            Removed all instances of Sound_SetError()...now they are either
  53.            __Sound_SetError or BAIL*_MACRO.
  54. 07022002 - Added WinCE support pack to website, updated INSTALL with CE info.
  55.            More altcvt fixes from Frank Ranostaj.
  56. 07012002 - Fixed configure.in to work around bug in older autoconfs. Started
  57.            merging Tyler's WinCE (PocketPC) port. Added checks for assert.h
  58.            and signal.h to configure.in/config.h.in, and #if HAVE_*_H checks
  59.            where appropriate in the code. Moved #include <assert.h> (along
  60.            with the HAVE_ASSERT_H check) to SDL_sound_internal.h, and removed
  61.            unnecessary #includes from the individual source files. Added
  62.            "md_reverb = 1;" to MIKMOD_init(). Modplug got some WinCE-specific
  63.            setting tweaks, and some settings maintanance code. configure.in
  64.            checks if setbuf() is available.
  65. 06292002 - More altcvt fixes from Frank Ranostaj...mostly working now?
  66. 06252002 - More altcvt fixes from Frank Ranostaj.
  67. 06132002 - Patch from Torbjörn to fix stereo AIFF files.
  68. 06212002 - More altcvt fixes from Frank Ranostaj.
  69. 06132002 - Patch from Torbjörn to make the WAV decoder more tolerant.
  70. 06122002 - Committed some altcvt enhancements from Frank Ranostaj.
  71. 06112002 - Fixed some debug messages in smpeg.c and mpglib.c.
  72. 06072002 - Manpages! Finally installed Doxygen and scratched together a
  73.            Doxyfile. After some revision to physfs.h, we've got a rather
  74.            nice API reference.
  75. 06062002 - Added URLs for official and unofficial versions of ModPlug in
  76.            decoders/modplug.c. Cleaned up some FIXMEs.
  77. 05222002 - Torbjörn sent in some more fixes for altcvt: mono to stereo
  78.            conversion works, now.
  79. 05222002 - Torbjörn sent in some initial cleanups and fixes for altcvt, and
  80.            fixed a bug in playsound when not all three of --rate, --channels
  81.            and --format are specified.
  82. 05202002 - Some .cvsignores from Max and me. Added a seek implementations for
  83.            the SMPEG, ogg, aiff, wav-adpcm, voc, and au decoders. Added a seek
  84.            stub to quicktime.c. playsound now takes milliseconds in the seek
  85.            lists: --seek "00:00:400" or whatnot. Corrected playsound's usage
  86.            text. Other au.c cleanups for extra robustness. Added an
  87.            experimental audio converter that Frank Ranostaj sent to the SDL
  88.            mailing list about a month ago: enable it with --enable-altcvt at
  89.            configure time, but be warned that it doesn't work very well right
  90.            now.
  91. 04292002 - Darrell Walisser updated the Mac Classic and OS X project
  92.            files, fixed some portability issues, and added an
  93.            experimental decoder that uses Apple's QuickTime libraries
  94.            (see decoders/quicktime.c). I've included the Mac project files
  95.            in CVS, now. Removed all use of alloca() from playsound.
  96. 04242002 - Added --seek option and bugfixes to playsound.c. Torbjörn comes
  97.            through with seek support for the FLAC, MIDI, and ModPlug
  98.            decoders (and some stub code for MikMod), and a bugfix for sample
  99.            flag manipulation in the base library (and his own --seek code for
  100.            playsound, which unfortunately we're not using).
  101. 04232002 - Cleaned up the playsound command line handling. Most command line
  102.            options (--rate, --format, --predecode, etc) are specified per-file
  103.            and reset to their defaults after each sample is played back.
  104.            --loop now takes a numeric argument: --loop 2 will playback the
  105.            sample three times (one playback and two loops). Added Darrell
  106.            to the playsound credits.
  107. 04212002 - Initial work to add a Sound_Seek() API. Removed the NEEDSEEK
  108.            sample flag (replaced it with CANSEEK). Hack to change the internal
  109.            Sound_SetError() function to __Sound_SetError(). Added internal
  110.            function __Sound_convertMsToBytePos().
  111. 04082002 - Cleaned up the archive support in playsound a little bit, and
  112.            fixed a PhysicsFS bug in the process.
  113. 03252002 - Win32 patches and fixes from Tyler Montbriand: handled "inline"
  114.            keyword, fixed SNDDBG macros in mpglib, and renamed a conflicting
  115.            file (decoders/mpglib/common.c to decoders/mpglib/mpglib_common.c).
  116. 03172002 - Removed an unneeded #include in mpglib that broke build on BeOS.
  117.            mpglib seems to work find on BeOS. Reworked some of mpglib.c so we
  118.            can determine the audio format when accepting the data stream. Some
  119.            other minor cleanups here and there.
  120. 03162002 - Tied the PhysicsFS code into the build system (code disabled if
  121.            physfs not found or --disable-physfs passed to ./configure.)
  122. 03152002 - Added PhysicsFS support to playsound, so you can play sound files
  123.            that are in ZIP files without unzipping them. Needs to be merged
  124.            into build system (I was just testing my PhysFS->RWops glue code).
  125. 03142002 - Changed configure script's --enable-vorbis to --enable-ogg. Removed
  126.            global state variable from mpglib, so it should be reentrant now
  127.            (patches sent to mpglib's actual maintainer). playsound can now
  128.            read from stdin.
  129. 03102002 - Added a FIXME note to decoders/mpglib.c. playsound now reports
  130.            errors in the thread where they occured, which also fixes a double
  131.            report of errors during predecoding. Removed all calls to exit() in
  132.            mpglib. These calls now report errors correctly to SDL_sound, which
  133.            passes them on to the application (patch also sent to mpglib's
  134.            actual maintainer). Replaced all stderr chatter in mpglib with
  135.            Sound_SetError() calls.
  136. 03072002 - decoders/mpglib.c now disregards ID3 tags instead of passing them
  137.            on as valid MP3 data to mpglib. Added some (buggy) example code for
  138.            adjusting an audio stream's volume (via the new --volume command
  139.            line in playsound).
  140. 03032002 - Fixed mpglib's build configuration to include general build flags
  141.            so that things like --enable-debug work as expected.
  142. 02212002 - Changed SMPEG's URL to point to the icculus.org site. Added an
  143.            mpglib decoder (internal to SDL_sound; relies on no external libs)
  144.            and changes mp3.c to smpeg.c (and other associated things).
  145. 02112002 - Committed a patch from Torbjörn to fix incorrect memory accesses
  146.            in the Timidity code. Changed the magic number in the AU decoder
  147.            to be bigendian (seems appropriate). Updated README for
  148.            completeness, and TODO for accuracy. Darrell sent in updated
  149.            MacOS X Project Builder files (on the website).
  150. 02072002 - Committed a patch Torbjörn sent in awhile ago for preventing
  151.            confusion with Timidity++-specific stuff in the timidity.cfg file.
  152.            Tyler Montbriand sent in an updated Visual C package.
  153.            Updated SDL_sound.h's comments a little. Upped version to 0.1.5.
  154. 02052002 - Fixed a cleanup I broke last night. Added CWProject.sit to the
  155.            EXTRA_DIST section of Makefile.am, and updated the README with
  156.            MacOS (9/X) install instructions.
  157. 02042002 - Darrell Walisser submitted some cleanups and CodeWarrior project
  158.            files for MacOS 9. Sweet!
  159. 01232002 - Max fixed decoders/Makefile.am to work with seperate build
  160.            directories, and corrected some dates in this file.
  161. 01192002 - Torbjörn sent in patches implementing the rewind method for the
  162.            rest of the decoders except shn.c, for which I added a kludged
  163.            implementation. Added more info to the README. Hunted down the
  164.            reason why SMPEG can't decode before calling SDL_OpenAudio(), and
  165.            it can't be fixed without a change to SMPEG (not MY fault! :) ).
  166.            Made ModPlug take priority over MikMod when selecting a decoder.
  167.            Mutex-protected the internal samples list, and fixed some bugs in
  168.            the management of that list. Changed some stuff to use uniform
  169.            coding conventions.
  170. 01182002 - SDL_sound/playsound builds and runs on BeOS now. Fixed an assertion
  171.            bug I introduced yesterday.
  172. 01172002 - Implemented Sound_Rewind(), and added a --loop command line to
  173.            playsound for testing. Rewrote the audio callback to handle looping
  174.            with both predecoded and streamed samples. Most of the decoders
  175.            just have an assert(0) in their internal rewinding method at this
  176.            point. I implemented the WAV, VOC, AU, AIFF, and RAW ones, for now.
  177.            (...and skeleton.c, for what that's worth.) A few tweaks in the
  178.            core API implementation to fix unlikely but possible leaks.
  179. 01112002 - Mattias Engdegård sent in an .AU decoder. Nice! He also tweaked
  180.            playsound to try and wait until SDL has completed playing a given
  181.            sound before closing the audio device. Changed a macro in
  182.            decoders/shn.c to be more uniform with the other decoders.
  183.            SDL_sound error messages are now maintained on a per-thread basis,
  184.            and do not interfere with SDL_[GS]etError() anymore.
  185. 01112002 - Committed the rest of Torbjörn's MOD patches, to clean up file
  186.            extension handling.
  187. 01092002 - Torbjörn comes through with a ModPlug-based decoder, which should
  188.            work nicely for decoding multiple .MODs at once. Now we need to
  189.            figure out what to do with two decoders that can decode the same
  190.            file. For now, if you explicitly want either MikMod or ModPlug, you
  191.            should explicitly enable one decoder and disable the other on the
  192.            configure command line ("--enable-modplug --disable-mikmod", for
  193.            example), otherwise configure will try to sort out the best one for
  194.            your system. Choice is a wonderful thing.  :)
  195. 01042002 - Forgot to bump playsound's version to match SDL_sound's. Fixed.
  196.            Added some notes to the top of COPYING about other libraries, etc.
  197.            A real MIDI decoder (using a hacked version of the hacked version
  198.            of Timidity from SDL_mixer) is now in place and working well,
  199.            thanks to Torbjörn.
  200. 01012002 - Happy New Year. Added some debug output to wav.c for future
  201.            codecs (GSM comes to mind). Fixed the SMPEG decoder's URL to point
  202.            to Loki's webpage.
  203. 12302001 - Upped version to 0.1.4.
  204. 12272001 - Added --audiobuf and --decodebuf options to playsound to make
  205.            tracking down a bug in the ADPCM decoder easier (plus, it could
  206.            help for benchmarking, etc later on...). Found a printf() bug in
  207.            playsound (extra comma in there...). ADPCM decoder appears to be
  208.            functional now. Tried to add ElectricFence support to
  209.            configure.in, and failed. All this libtool/autoconf stuff makes my
  210.            head hurt.
  211. 12262001 - Changed remaining references to the "LICENSE" file into "COPYING".
  212.            Work progresses on the ADPCM-compressed .wav decoder. Updates to
  213.            the documentation in SDL_sound.h. Hhmm...find_chunk() in wav.c was
  214.            badly broken. Fixed.
  215. 12162001 - FLAC decoder now checks for the magic number unless the file
  216.            extension is recognized. This was changed back because searching
  217.            for metadata, while probably more effective, is VERY expensive (and
  218.            useless) on non-FLAC streams.
  219. 12052001 - Put our names in a "--credits" option in playsound, and put the
  220.            standard GNU disclaimers in there too, for good measure. Renamed
  221.            LICENSE to COPYING to match GNU standards more closely (and to
  222.            end Max's torment.  :)  ) Tweaks to wav.c, and work on aiff.c to
  223.            make it easier to support multiple audio formats (for compression
  224.            handling later down the road).
  225. 11302001 - Torbjörn and I make Sound_DecodeAll() more robust: checks for
  226.            previous decoding failures and sets an appropriate error, handles
  227.            decoders that change their buffers on the fly (such as the FLAC
  228.            decoder), and deals with out-of-memory conditions more gracefully.
  229. 11252001 - (With thanks to Andreas Umbach for pointing it out) Fixed some
  230.            problems with Sound_DecodeAll(). For local testing of this bug,
  231.            added a --predecode command line to playsound. Minor fixes to
  232.            theoretical bugs in Sound_FreeSample(). playsound no longer
  233.            buffers stdout and stderr. Updated Sound_DecodeAll()'s comments in
  234.            SDL_sound.h ...
  235. 11192001 - FLAC decoder cleanups from Torbjörn.
  236. 11092001 - Torbjörn fixes playsound's audio callback after I broke it, again.
  237.            A bug in configure.in was preventing SMPEG from being used unless
  238.            --enable-debug was set; fixed. Changed this file to list latest
  239.            changes first. Torbjörn submitted a FLAC decoder that utilizes
  240.            libFLAC (http://flac.sf.net/). Cool.
  241. 11012001 - API COMPATIBILITY BREAKAGE: Decoders can now list multiple file
  242.            extensions each. Playsound has been updated to handle this.
  243.            Playsound now registers a SIGINT handler, so you can skip tracks
  244.            and/or abort the way that mpg123 does.
  245. 10232001 - Rewrote playsound.c's audio_callback() to no longer need the
  246.            overflow buffer hack, which streamlines it a little and trims the
  247.            memory requirements for playsound by about 16 kilobytes.
  248. 10172001 - Torbjörn catches a problem with the overflow buffer in playsound's
  249.            audio callback.
  250. 10152001 - Torbjörn sends in a default sample format for the MIDI decoder,
  251.            and the starts of the audio conversion funcitonality (ripped
  252.            from SDL). Officially released 0.1.3. Added LICENSE and
  253.            CHANGELOG to the distribution. (Again, from Torbjörn) added in
  254.            the start of a tweaked audio converter.
  255. 10122001 - Torbjörn Andersson submitted command line enhancements to
  256.            playsound, and I cleaned up the --help output.
  257. 10092001 - Patches to shn.c for Visual C compatibility. Visual C project files
  258.            available from the website. Changed Corona688 to Tyler Montbriand
  259.            in CREDITS. Upped version to 0.1.3.
  260. 10082001 - Restructured decoders/wav.c to allow for multiple formats, and
  261.            put the start of a handler for the ADPCM format in place.
  262. 10072001 - Changed the way decoders/mod.c handles samplerate so that it should
  263.            work universally. This isn't an ideal solution, but it's probably
  264.            the best we can do without rewriting mikmod. Made a change to ogg.c
  265.            for portability: changed an int64_t to ogg_int64_t.
  266. 10062001 - Made a change to SDL_sound.c for compiling on non-GNU toolchains.
  267. 10052001 - Removed #include "SDL_endian" from aiff.c.
  268. 10042001 - Changed some #if (defined SOUND_SUPPORTS_*) lines to
  269.            #ifdef SOUND_SUPPORTS_* in voc.c and shn.c, for consistency with
  270.            the other decoders.
  271. 10032001 - After hours of tracking down a bogus pointer, the SHN decoder works!
  272.            I can die happy. :)  Max placated me with an --enable-debug option
  273.            so I could stop my whining. Other autoconf goodies (such as
  274.            reenabling -Werror for debug builds, etc). Torbjörn brings in a
  275.            MIDI decoder, which reads from a Timidity process through a pipe.
  276.            Changed playsound to open the audio device to match the properties
  277.            of each sound file, which results in less conversion (and therefore,
  278.            more chance of correct playback).
  279. 10022001 - Changed a comment in mod.c to not refer to "the mikmod
  280.            directory" anymore. Committed Torbjörn's patch for MP3 detection.
  281.            (better late than never). __Sound_strcasecmp() now handles NULL
  282.            strings gracefully, fixing the crash with "playsound bootstrap".
  283.            More work on the SHN decoder.
  284. 10012001 - Fixed a memory leak that Torbjörn found in the MOD decoder.
  285. 09252001 - More autoconf work. Gave Max Horn write access to the CVS
  286.            repository, so I don't drive him nuts tweaking this thing.  :)
  287.            Fixed a const complaint and some other stuff needed for compilation
  288.            under Visual C++ 6.0 (no, it isn't ported yet). Put the SHN source
  289.            in CVS, even though it isn't ready (and doesn't even compile). Do
  290.            NOT enable it in your build!
  291. 09242001 - Thank goodness, Torbjörn came through with the MP3 fix. Apparently
  292.            SMPEG mixes each chunk of decoded data with whatever is already
  293.            in the buffer you give it. I hate that. I'm going to patch SMPEG
  294.            to let the programmer enable and disable that behaviour in a given
  295.            (SMPEG *), since it's just a CPU eater in this case. The _D(())
  296.            macro is now SNDDBG(()), since _D is taken on MacOS X's version of
  297.            gcc (which was bound to happen on some platform sooner than later
  298.            anyhow). Renamed test_sdlsound to playsound, and made it more
  299.            robust in general: fixed potential overflow in audio_callback,
  300.            made it chatter less, made it take multiple files and some other
  301.            command lines. Initial autoconf support, thanks to Max Horn.
  302. 09222001 - Torbjörn Andersson strikes again, with a collection of patches.
  303.            First, some cosmetic tweaks for decoders/aiff.c. Next, a MOD player
  304.            based on MikMod. This inspired me to add two more methods to
  305.            Sound_DecoderFunctions: init() and quit(). Third, a fix to
  306.            decoders/mp3.c so that SMPEG won't claim every stream it sees, MP3
  307.            or not. I removed the multiple-streams-per-rwops code, after
  308.            discussion on the mailing list. The init() and quit() methods
  309.            led to the possibility that certain decoders will flag themselves
  310.            as unavailable at runtime, and SDL_sound now handles this.
  311.            Added [LIB|INC]PATH_[OGG|MOD]. Bigendian fixes; now works on
  312.            PowerPC Linux. MikMod tweaks. Changed version to 0.1.2.
  313. 09202001 - Torbjörn Andersson submitted several patches: fixed a comment in
  314.            the .WAV decoder (whoops...screwed up my own search-and-replace.
  315.            Hah.), made an attempt at putting multiple sound streams behind
  316.            one RWops (gotta think on that one first), and, most importantly,
  317.            added an AIFF decoder, which is very cool.
  318. 09192001 - Added a skeleton decoder source file. Changed voc_read() to
  319.            voc_read_waveform(), so it wouldn't be confused with VOC_read().
  320.            Fixed a byte ordering bug in voc.c (reported as AUDIO_S16LSB, but
  321.            we were swapping byte order of data ourselves. Fixed). Added basic
  322.            .WAV support. Fixed Makefile so that -I. is always first;
  323.            otherwise, a previously installed header might get used for the
  324.            compiles, which is not good. SDL_sound.h now includes SDL_endian.h,
  325.            since SDL.h doesn't, for some reason. Moved version defines in
  326.            SDL_sound.h to top of file so I can find them.  :)
  327.            Changed version to 0.1.1. Committed patch from Tsuyoshi Iguchi to
  328.            fix a segfault (I forgot to put a NULL terminator at the end of
  329.            the available_decoders array), fixing the only bug preventing the
  330.            test program from running on FreeBSD 4.3. Sweet. Added Ogg Vorbis
  331.            decoder. Rewrote the test program's SDL audio callback to be more
  332.            robust (Ogg exposed a nasty bug in it). Fixed a byte-ordering issue
  333.            in the VOC decoder.
  334. 09182001 - Implemented MP3 support through SMPEG (not working yet, though) and
  335.            wrote the Reference Counting RWops wrapper. Added other little
  336.            things like the _D(()) macro. Added VOC support, which went up with
  337.            surprisingly little struggle, which means it MUST be leaking
  338.            memory.  :)
  339. 09172001 - Changed some overlooked "voice" to "sound". Implemented base API.
  340.            So...tired. Everything's different.  :)
  341.            Also put in a RAW decoder and a simple test program.
  342. 09142001 - Changed name to SDL_sound, added Sound_DecodeAll() to spec.
  343. 09132001 - Initial spec proposed on SDL mailing list, under name "SDL_voice".
  344.  
  345. --ryan. (icculus@clutteredmind.org)
  346.  
  347. /* end of CHANGELOG ... */
  348.  
  349.