+-----------------------------------------------------------------------------+
|                                                                             |
|         ---===          D       S       M       I          ===---           |
|                                                                             |
|      ---===          Digital Sound & Music Interface          ===---        |
|                                                                             |
|         ---===          (C) 1993,1994 Otto Chrons          ===---           |
|                                                                             |
+-----------------------------------------------------------------------------+


        DSMI is a sound interface for PC compatible computers. It
        provides programmers with a variety of functions to play music
        and sound effects in their programs.

        Here are some of DSMI's capabilities:

        * Supports following sound sources:
           - General DAC (also known as Covox)
           - Stereo DACs (also Stereo-on-1)
	   - PC speaker
           - Sound Blaster 1.0 - 2.0
           - Sound Blaster Pro (stereo)
           - Pro Audio Spectrum (stereo)
           - Pro Audio Spectrum+ (stereo)
           - Pro Audio Spectrum 16 (16-bit, stereo)
           - Sound Blaster 16 (16-bit, stereo)
           - Aria based sound cards (16-bit, stereo)
           - Windows Sound System (16-bit, stereo)
           - AudioTrix Pro (16-bit, stereo)
           - Gravis Ultrasound (16-bit, stereo)
	* Up to 32 simultaneous channels
        * Plays MODs, STMs, S3Ms, 669s, MTMs, FARs and other formats
        * Two operating modes for 8-bit sound sources:
           - Fast mode
           - Quality mode (better sound quality)
        * Special 16-bit support, which means GREAT sound quality on
          16-bit cards
 * NEW! * Quality mode for 16-bit sound cards
        * Very extensive programming interface that lets YOU decide what
          to do
        * Modular structure means easier upgrades (e.g. new sound cards)
        * Printed manual (40 pages)
 * NEW! * On-line hypertext reference guide! (over 130kB)
        * Example programs
        * Utilizes 386 instruction mix to reach maximum performance,
          286 NOT supported
        * Free 'Timer Service'-pack for easy timer handling
	* Free 'EMS heap manager' for accessing EMS memory
        * Comes in 'C' and 'Pascal' versions, 'C' version also supports
          assembler and 32-bit protected mode.
        * All C (or Pascal) source code is included for recompiling or
          changing (yes, that means DMP or PMP too!)
        * All assembly language source code is included!
        * Practically FREE upgrades!
          And you can upgrade as many times as you wish
          - via Internet, totally free
          - via mail: you send me two 3.5" disks and I send one back with
            new DSMI code.

        And last but not the least:
        * DSMI IS DEFINITELY THE MOST EXTENSIVE PLAYER ON EARTH!!


WHAT'S IN DSMI------------------------------------------------------------

                          +-----------------+
                          |                 |
                          |    C version    |
                          |                 |
                          +-----------------+

        - Made with Borland C++ 3.1, but should also work fine with
          other compilers
        - Comes with DSMI/32, a 32-bit protected mode version of DSMI which
          works with 32-bit C compilers. Have been tested on Watcom C/C++
        - All C source code is included
        - Compiled OBJ files for all files are included
        - All assembly language source code is included (requires TASM 3.1
          or newer to compile)
        - A library (DSMI.LIB, DSMIEMS.LIB and DSMI32.LIB) is provided for
          easy linking
        - Following parts are written in C:
                * Loaders for MOD, STM, 669, S3M, MTM, FAR and AMF
                * Function to free module
                * initDSMI() for easy initialization
                * Detection routine for GUS and SB
                * EMS and GUS heap managers

        - Everything else is written in assembly language
        - C source is compiled with BC++/Watcom C/C++ and uses
          386 instruction set
        - If your C compiler is very old, make sure it can link with
          assembler code using 386 instructions


                          +------------------+
                          |                  |
                          |  Pascal version  |
                          |                  |
                          +------------------+

        - Works with Turbo/Borland Pascal 7 and above
        - Has TPUs for TP7/BP7 (also protected mode)
        - Comes with full Pascal source code, so you can recompile all
          the TPUs
        - All OBJs for assembler parts are included
        - All assembly language source code is included (requires TASM 3.1
          to compile)
        - Supports Protected Mode (BP7 only)
        - Following parts are written in Pascal:
                * Loaders for MOD, STM, 669, S3M, MTM, FAR and AMF
                * Function to free module
                * initDSMI() for easy initialization
                * Some functions to provide "C" memory handling
                * Protected mode API
                * EMS heap manager
                * Detection routine for GUS and SB
        - Everything else is written in assembly language
        - If you have older version than TP7, you may need to retouch some
          of the functions

HOW TO BUY DSMI--------------------------------------------------------

        Files LICENSE.DSM and ORDER.DSM should come with this README
        file. You need to print them, sign the License Agreement and
        fill out the order form. Then just mail them to me and pay the
        price. See ORDER.DSM for detailed information.

