home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 24 / CD_ASCQ_24_0995.iso / dos / prg / dsik205 / dsik.dat / README.TXT < prev    next >
Text File  |  1995-04-10  |  7KB  |  183 lines
  1. -----------------------------------------------------------------------------
  2.                      Digital Sound Interface Kit (DSIK)
  3.                                 Version 2.00
  4.  
  5.       32-bit Protected Mode Sound System for Watcom C/C++ and DOS/4GW.
  6.  
  7.          Copyright (c) 1993-95 by Carlos Hasan. All Rights Reserved.
  8. -----------------------------------------------------------------------------
  9.  
  10. Table of Contents:
  11.  
  12.     1.  What is DSIK?
  13.     2.  Features
  14.     3.  Requirements
  15.     4.  Licensing DSIK
  16.     5.  Known Bugs
  17.     6.  List of Files
  18.     7.  Equipment used for Development of DSIK
  19.     8.  Final Words
  20.  
  21.  
  22. 1. What is DSIK?
  23.  
  24.     DSIK is a 32-bit protected mode sound system for Watcom C/C++ which can
  25.     play music module and sound files simultaneously. It is one of the few
  26.     systems currently available that works in native 32-bit protected mode
  27.     taking adventage of the advanced features of 80386, 80486 and Pentium
  28.     processors.
  29.  
  30.  
  31. 2. Features:
  32.  
  33.     - Written in 32-bit protected mode.
  34.     - 8 or 16 bit playback. Stereo or Monophonic.
  35.     - Playback rates up to 44.1 kHz.
  36.     - 32 digital voices (registered version only).
  37.     - Each voice has its own volume settings, playback rate,
  38.       and pan (balance) position.
  39.     - Amplified output for 8-bit soundcards.
  40.     - Supports the following soundcard devices:
  41.             - Sound Blaster 1.x
  42.             - Sound Blaster 2.x
  43.             - Sound Blaster Pro
  44.             - Sound Blaster 16/16ASP
  45.             - Pro Audio Spectrum
  46.             - Pro Audio Spectrum+
  47.             - Pro Audio Spectrum 16
  48.             - Windows Sound System
  49.             - Gravis UltraSound
  50.     - Supports the following music module formats:
  51.             - Protracker/Fastracker modules (MOD)
  52.             - Scream Tracker 3.0 modules (S3M)
  53.             - Multitracker 1.0 modules (MTM)
  54.             - Composer 669 modules (669)
  55.             - Scream Tracker 2.0 modules (STM)
  56.     - Supports the following sound file formats:
  57.             - Microsoft Wave files (WAV)
  58.             - Creative Labs Voice files (VOC)
  59.             - Amiga IFF/8SVX files (IFF)
  60.             - 8-bit RAW files (RAW)
  61.  
  62.  
  63. 3. Requirements:
  64.  
  65.     - 80386 or better CPU (33 MHz minimum recommended)
  66.     - Soundcard device (UltraSound recommended)
  67.     - 4 Mb of system memory (8 Mb recommended)
  68.     - WATCOM C/C++ Compiler version 9.5 or better
  69.     - DOS/4GW Extender 1.95 or later (DOS/4GW Professional recommended)
  70.  
  71.  
  72. 4. Licensing DSIK:
  73.  
  74.     This is the shareware version of the DSIK library that allow
  75.     only up to 6 voices for playback and is not registered for use
  76.     in freeware, shareware or commercial programs except for
  77.     evaluation purposes.
  78.  
  79.     If you wish to use the DSIK library in your programs, you must
  80.     purchase a license. For more details, execute the ORDER.BAT file
  81.     from the DOS prompt or look at the LICENSE.TXT text file.
  82.  
  83.  
  84. 5. Known Bugs:
  85.  
  86.     - The sound system does not support IRQ interrupt lines higher
  87.       than 7 if you are using DOS/4GW. I suggest to use PMODE/W,
  88.       DOS/4GW Professional or DOS/4G to avoid this problem.
  89.     - The system cannot play MTM modules with more than 16 tracks.
  90.     - The sound system uses standard Protracker commands, so some
  91.       Scream Tracker modules may sound slightly different.
  92.     - The system only supports 8-bit mono WAV/VOC/IFF sound files.
  93.  
  94.  
  95. 6. List of Files:
  96.  
  97.     This software consists of the following files:
  98.  
  99.         AUDIO.LIB       -   The main library file
  100.         AUDIO.INC       -   The library ASM include file
  101.         AUDIO.H         -   The library include file
  102.         IMPORT.H        -   Import routines include file
  103.         TIMER.H         -   Timer services include file
  104.         PE.H            -   Dynamic-link loader include file
  105.         DETECT.C        -   Soundcard autodetection routines
  106.         MODLOAD.C       -   Basic file loading routines
  107.         IMPORT.C        -   Import routines
  108.         TIMER.C         -   Timer services routines
  109.         PE.C            -   Dynamic-link library loader
  110.         PLAY.C          -   Module player source code
  111.         SETUP.C         -   Soundcard setup source code
  112.         M2DSM.C         -   Module converter source code
  113.         EXAMP*.C        -   Example C source files
  114.         EXAMP*.ASM      -   Example ASM source files
  115.         MAKEFILE        -   Makefile for all the examples
  116.         MANUAL.TXT      -   User's Manual
  117.         GUIDE.TXT       -   Reference Guide
  118.         FAQ.TXT         -   Frequently Asked Questions
  119.         LICENSE.TXT     -   License Agreement document
  120.         README.TXT      -   This file
  121.  
  122.  
  123. 7. Equipment used for Development of DSIK:
  124.  
  125.     Many people are curious about this, so here it is:
  126.  
  127.     Hardware:
  128.         - Intel 80486DX2/66, 256 Kb cache, 4 Mb RAM, VLB.
  129.         - 408 Mb of harddisk space (Seagate, IDE).
  130.         - Hercules Dynamite Pro VL graphics card, Tseng Labs
  131.           ET4000/W32p chip, 1 Mb, truecolor.
  132.         - 14" color SVGA monitor.
  133.         - Sound Blaster 16 value edition.
  134.         - Genius mouse, three buttons.
  135.         - 2400 baud modem.
  136.         - Lots of 3.5" HD floppy disks (mainly Memorex).
  137.  
  138.     Software:
  139.         - WATCOM C/C++ Compiler 9.5 by WATCOM Int.
  140.         - Turbo Assembler 4.0 by Borland Int.
  141.         - DOS/4GW DOS Extender 1.97 by Rational Systems.
  142.         - PMODE/W 1.01 by Charles Scheffold and Thomas Pytel.
  143.         - MultiEdit 7.00P by American Cybernetics, Inc.
  144.  
  145.     Special thanks to:
  146.         Ray Bingham, Otto Chrons, Trey Cobb, Joel Duerksen,
  147.         Peter Edsbäcker, Barry Egerter, Chris Egerter, Paul Fisher,
  148.         Ryan Geithman, Dan Goldstein, Josh Jensen, Minh Ma,
  149.         Michael Riedel, Charles Scheffold, Andy Sega,
  150.         Giovanni Tummarello, and all of my beta testers!
  151.  
  152.  
  153. 8.  Final Words:
  154.  
  155.     The work started in July of 1994. The goal of this project was to
  156.     develop a powerful and easy to use sound system for WATCOM C/C++
  157.     and DOS/4GW 32-bit DOS Extender.
  158.  
  159.     The basic DSIK kernel routines are written in pure 32-bit protected
  160.     mode assembly language, everything else is written in C language.
  161.  
  162.     The DSIK library provides procedures to play multiple digital voices
  163.     simultaneously. It contains routines used to change the frequency,
  164.     volume and balance of every voice.
  165.  
  166.     The method of sound synthesis used is called Wave Table Synthesis.
  167.     Either sampled data from actual instruments or other synthetized
  168.     digital audio is used to recreate real sounds. The 32 voices are
  169.     independent and can concurrently be producing different sounds.
  170.  
  171.     Many people are curious about the source code, so here it is:
  172.  
  173.         - The assembly source code is 7028 lines long and 208 Kb large.
  174.         - The C source code is 4138 lines long and 124 Kb large.
  175.  
  176.     I really hope you find this program useful. The multiple digital
  177.     voices should make it very useful for games and multimedia programs,
  178.     and one of the best sound systems availables for WATCOM C/C++.
  179.  
  180.                                     Carlos Hasan
  181.                                     December 31th, 1994.
  182.                                     Santiago, Chile.
  183.