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