MIDAS Digital Audio System v1.1.2 by Sahara Surfers
MIDAS Digital Audio System 1.1.1, release notes ----------------------------------------------- A Sahara Surfers production. Copyright 1996, 1997 Housemarque Inc. Written by Petteri Kangaslampi and Jarno Paananen (a.k.a. Alfred & Guru / S2) This file is part of MIDAS Digital Audio System, and may only be used, modified and distributed under the terms of the MIDAS Digital Audio System license, "license.txt". By continuing to use, modify or distribute this file you indicate that you have read the license and understand and accept it fully. 1. Introduction and news ------------------------ This is the 1.1.1 release of MIDAS Digital Audio System. This release contains just some bug fixes and optimizations over 1.1.0, no new functionality has been added. This release should be 100% compatible with 1.1.0, and can simply be dropped in place of 1.1.0. Updating the libraries is enough, and even re-linking is not necessary for programs that use the dynamic link libraries. The most important change in this release is the fixed MS-DOS Gravis UltraSound support. The code in MIDAS now follows very accurately the procedures used in the SDK example code, and we are fairly confident it will now work with all cards. Please note, however, that MIDAS is not able to support GUS cards with GF1 IRQs above 7 with DOS/4GW. This is a limitation in the DOS/4GW IRQ support. MIDAS versions prior to 1.0 were not affected by this, as they did not use the GUS IRQs. In addition to the GUS bug fix, we have added Pentium Pro/Pentium II optimizations to the mixing routines - PPro/PII users should experience a considerable speedup. Some less commonly routines were also optimized, including ADPCM decoding, although this doesn't affect most programs. A small memory leak in MIDASloadModule/MIDASfreeModule was also fixed (approximately 2500 bytes of memory was left allocated), as were some other minor problems. After this 1.1.1 release, MIDAS Digital Audio System development will continue mainly towards the future 1.2 and 2.0 versions. We hope that no further updates to 1.1 will be necessary, but they will be made released if needed. We have a pretty clear idea about what the 1.2 release will include, and work is proceeding towards the first beta releases, but suggestions are still welcome. Finally, a note to all shareware-developers among the audience: We have added a new "shareware trial license" to the MIDAS licensing alternatives we offer. This license will let you build shareware programs using MIDAS, and sell a limited number of them yourself, for a much lower price than the normal MIDAS licenses. There are some limitations though, but e-mail "midas@housemarque.fi" and ask for the latest licensing information if you are interested. 2. Brief introduction to MIDAS Digital Audio System --------------------------------------------------- So what is MIDAS Digital Audio System anyway? In brief, MIDAS is a multichannel digital sound and music system, capable of playing an unlimited number of channels of digital sound on all supported platforms. It can play music modules, individual samples, and digital audio streams, in any combination. MIDAS supports the following module formats: - 4-channel Protracker modules plus 1-32-channel variants (.MOD) - 1-32 -channel Scream Tracker 3 modules (.S3M) - 2-32 -channel FastTracker 2 modules (.XM) - 1-64 -channel Impulse Tracker modules (.IT) In the Win32 and Linux platforms, MIDAS accesses the sound hardware through the system sound drivers, and thus works with any sound card that has proper drivers available. In Win95/NT, both the standard multimedia APIs and DirectSound are supported. Under MS-DOS, MIDAS supports the following sound cards: - Creative Labs Sound Blaster series (1.0 through SB 16 and AWE32) - Gravis UltraSound (regular, MAX, and Plug and Play, with native Interwave support) - Media Vision Pro Audio Spectrum series (PAS, PAS+ and PAS16) - Microsoft Windows Sound System and compatible cards using the Crystal/Analog CODEC. Most inexpensive 16-bit sound cards sold nowadays are WSS compatible. This release of MIDAS can be used for free for free programs, but commercial usage requires a separate license. Contact "midas@housemarque.fi" for details. 3. What's New? -------------- Changes since MIDAS 1.0 include: - Completely new mixing routines - Echo effect support - Support for Impulse Tracker modules - Automatic filtering - Built-in setup functions for Win32 - Updated MS-DOS setup - Sample playback status checking functions In addition, changes since MIDAS 0.6 releases include: - Stream support for MS-DOS - DirectSound support - WAVE file support for both samples and streams - Enhanced documentation, now also in WinHelp format - Sound output filtering - The ability to play multiple modules simultaneously (but with some restrictions - see the documentation) - Music channel fading - 4:1 ADPCM compression for streams - Miscellaneous smaller changes and bug fixes 4. Supported platforms ---------------------- MIDAS supports the following platforms and compilers: - 32-bit MS-DOS under DOS/4GW, with Watcom C/C++ - 32-bit MS-DOS under any DPMI host (such as CWSDPMI) with DJGPP - Windows NT/95 with Watcom C/C++ - Windows NT/95 with Visual C/C++ - Windows NT/95 with Borland Delphi - Linux with GNU C/C++ In addition, under Win32 MIDAS can be used with any programming environment that supports DLLs. Direct examples are provided only for Watcom and Visual C and Borland Delphi though. Under Linux background and stream playing needs a pthreads compatible package, preferably the LinuxThreads-package available at: ftp://ftp.inria.fr/INRIA/Projects/cristal/Xavier.Leroy/linuxthreads.tar.gz 5. Using MIDAS -------------- Before trying to use MIDAS Digital Audio System, make sure you read all documentation available in the "doc" directory. The documentation is included in several formats: WinHelp, Plain ASCII text (*.txt), PostScript (*.ps), Adobe PDF (*.pdf) and HTML (separate directories). PostScript or PDF is recommended for printing, and WinHelp for reading online. If you prefer, you can also use Adobe Acrobat Reader for reading the PDF documents. At the moment the HTML documentation requires long filenames, so it is not very usable from plain DOS. After at least browsing through the documentation, you should check of the examples in the "samples" directory. The directory "samples/common" should be especially useful, as it contains several small programs that demonstrate the MIDAS API. DOS programmer's should also check "samples/dos". "samples/midpnt" contains the source code for MIDAS Module Player for Windows NT, a slightly bigger and more complex program. Finally, see "samples/dsound" for an example on how to use DirectSound. Some of the examples might require a bit tweaking, depending your target system. In particular, you may need to edit a few lines at the beginning of the Makefiles in the directories. However, the code itself should compile cleanly on all supported platforms. When you are ready to use MIDAS Digital Audio System in your own programs, it is probably useful to use one of the examples as a model. Remember that you are allowed to use MIDAS for free programs as is, but for commercial usage you will need to negotiate a license with us. In addition, your program HAS to include proper credits for MIDAS, either in the program itself or its documentation. This is even a requirement in the MIDAS license, and if you fail to include the credits you are breaking it. 6. Contact Information ---------------------- Comments? Bug reports? Want more information about MIDAS Digital Audio System licensing? Contact us! Just select the correct e-mail address: Technical questions and comments: Petteri Kangaslampi, pekangas@sci.fi Licensing information: Housemarque Inc., midas@housemarque.fi Linux-specific questions: Jarno Paananen, jpaana@iki.fi The updated MIDAS Digital Audio System WWW-pages are now on-line at http://www.s2.org/midas/. The pages are being moved to www.housemarque.com, at least partially, but for the time being the most up-to-date information will be available at s2.org. In addition, there is a mailing list available for MIDAS-related announcements. Send mail to "majordomo@s2.org", with the words "subscribe midas" in the BODY of the message. This is a standard Majordomo list, so all normal Majordomo commands apply. 7. Getting MIDAS ---------------- The best and fastest way to get MIDAS is the Internet. The latest MIDAS version is always at "http://www.s2.org/midas/". In addition, you can find there the latest MIDAS news, MIDP releases, and general information. In addition, MIDAS is available at the following fine BBSes: Edge Of Delight Node 1: +32-2-3755651 Boca 28.8K (V34/VFAST) Node 2: +32-2-3758923 ZyXEL 19.2K (V32terbo) Node 3: +32-2-3721089 ISDN 64K (X75) Chaos Managers: Cobra, aCceSs & Fredy The Underworld BBS Node 1: +41-22-9600621 USR Courier V.34+, ISDN Analog Node 2: +41-22-9600622 USR Courier V.34+, ISDN Analog Node 3: +41-22-9600623 ZyXEL Elite 2864I 64kb ISDN, ISDN Digital Sysop: Synoptic WarmBoot BBS Node 1: +55-194-261993 Sysop: Warmbooter South of Heaven BBS Node 1: +1-916-567-1090 (2x28.8k) Sysop: Pantera Psycho Beaver BBS Node 1: +972-9-8320175 (2x28.8k) Sysop: riff raff Splatter Punk BBS Node 1: +49-2378-2627 (28.8k, 20:00-06:00 CET) Sysop: Teasy Boiled Sweets Music BBS Node 1: +44-171-686-0135 (USR Courier V.34+ 33.6k) Node 2: +44-171-686-0136 (USR Sportster V.34+ 33.6k) Sysop: Dweezil BBS [P]OWER (C)HA][ENGE Node 1: +45-97-250117 Sysop: x-otic Apologies for any boards we forgot - email us with your current information and you are back on the list. I have to confess I haven't kept very good track on our distribution sites, and now deliberately left out everybody I haven't heard from in a year or so... 8. Acknowledgements ------------------- There is no way we could have MIDAS what it is alone, and we feel we really owe a big "thank you" to the following people: Otto Chrons: Thanks for the sound cards, programming information, plus optimization and debugging hints. Teemu Kalvas: Thanks for some serious beta-testing, optimization ideas, and just general helpfulness. Jarno Heikkinen: Thanks for your support and the GUS PnP code, although it went along with SW mixing support. Francois Baligant: One of the most supportive people I know. Nice meeting you at Wired'96, too bad I couldn't make it this year. Mikko Karvonen and Janne Oksanen: Thanks for composing all that wicked music :) Hannu Koivisto: Thanks for testing and commenting on MidpNT -- maybe some day the instrument list will get fixed... Khaled Agrama: Thanks for the cooperation so far, hopefully I'll have more time to help you in the future. All authors of MIDAS-based module players: Thanks for your support, now go and upgrade to 1.1! And everybody who has sent us feedback on MIDAS - too numerous to mention, and all extremely important. Keep it coming! Plus some traditional hillos to our friends in the scene and beyond: #cokers - you know who you are Jesse Hallio Alik. Katainen J-P :) Kari-Pekka Koljonen Kraku Nemesis1 Statix Unreal The whole Virtual Visions team Everybody in Parallax Our friends in Prime Byterapers CNCD Complex Doomsday Productions Paranoids Virtual Dreams And finally, thanks to all our friends, both real and virtual - thank you for being who you are, for doing what you do, the way you do. -- Petteri Kangaslampi and Jarno Paananen, 22 Sep 1997
[ back to the prod ]