home *** CD-ROM | disk | FTP | other *** search
/ Sound, Music & MIDI Collection 2 / SMMVOL2.bin / PROG / SMIXW124.ZIP / SMIXW124.DOC < prev    next >
Encoding:
Text File  |  1995-10-26  |  7.5 KB  |  153 lines
  1.           _____      __    __     ____     __   __       _     _
  2.          /  _  \    |  \  /  |   |    |   |  \ /  |     | |   | |
  3.         |  / \__|   |   \/   |    |  |     \  ~  /      | |   | |
  4.         |  \___     |        |    |  |      |   |       | |   | |
  5.          \___  \    |  /\/\  |    |  |      |   |       | | _ | |
  6.          __  \  |   |  |  |  |    |  |      |   |       | |/ \| |
  7.         |  \_/  |   |  |  |  |    |  |     /  ^  \      |   _   |
  8.          \_____/    |__|  |__|   |____|   |__/ \__|     \__/ \__/
  9.  
  10.                   for Watcom C DOS/4GW protected mode
  11.  
  12.                               Version 1.24
  13.                    Written by Ethan Brodsky (10/26/95)
  14.          Copyright 1995 by Ethan Brodsky.  All rights reserved.
  15.  
  16. This library is distributed AS IS.  The author specifically disclaims
  17. responsibility for any loss of profit or any consequential, incidental,
  18. or other damages.  SMIXW is freeware and is distributed with full source
  19. code, which is copyright by Ethan Brodsky.  You are free to incorporate
  20. the code in full or part into your own programs as long as credit is
  21. given to Ethan Brodsky.  The source code may be distributed in its
  22. original form only, including this documentation and the copyright
  23. notices.
  24.  
  25. ------------------------------------------------------------------------
  26.  
  27. You may have used my SBVOX and SBDSP units.  They both played one VOC
  28. file at a time.  The whole VOC file had to be loaded into conventional
  29. memory, taking valuable memory from a real mode program.
  30.  
  31. SMIXW will play up to 8 simultaneous sounds on a Sound Blaster or
  32. compatible in protected mode.  The sounds are stored anywhere in memory
  33. and are mixed into a small buffer as needed.  It uses auto initialized
  34. DMA if a SBPro or higher is installed, eliminating clicks between
  35. blocks. On a SB16 is installed, it will use 16-bit sound output,
  36. increasing the sound quality.  Full source for Watcom C protected mode
  37. using the DOS/4GW extender is included.
  38.  
  39. The sounds are stored on disk as raw signed 8-bit sample data at a
  40. sampling rate of 22050 HZ and are loaded anywhere in memory.  The
  41. data is mixed into a 16-bit buffer one block at a time, then copied
  42. down to an 8 or 16 bit buffer in conventional memory for DMA output.
  43.  
  44. Please test this on your setup (Especially if you have a Sound Blaster
  45. compatible or a configuration out of the ordinary) and report any
  46. incompatibilities to me.  I have personally tested this version on my
  47. SB16 and SBPro, but I have received reports that it works on many SB
  48. compatibles.
  49.  
  50. As the block size is increased, the sound latency will also increase.
  51. New sound effects are only started at the beginning of each block,
  52. so a block size of 512 gives a latency of about 1/43 of a second.
  53. This is the maximum time that can pass between when the StartSound
  54. procedure is called and when the sound starts playing.  In case you are
  55. wondering about the three counters displayed by the test program, the
  56. first one counts in the CPU's free time, the second counts the number
  57. of interrupts that have occurred, and the third is the number of sounds
  58. currently being played.  If you have an incompatibility problem, please
  59. tell me what each counter is doing.
  60.  
  61. SMIXW either uses a raw 8-bit unsigned file format, or in a combined
  62. resource file.  I have included a program that will convert WAV files to
  63. the raw format necessary, and a program to combine raw sound files into
  64. a resource file.  The WAV files must be 8-bit and sampled at 22050 HZ, or
  65. the output will be distorted.
  66.  
  67. Use the SNDLIB utility included with this package to build sound resource
  68. files.  The syntax for SNDLIB is similar to that of Borland's TLIB, but
  69. it is much more restrictive.  Remember that resources are identified by
  70. their "key", which comes after the filename when adding a resource.  The
  71. key is an 8 character case-insensitive string that is should be passsed to
  72. load sound function after you have opened the resource file.
  73.  
  74. One important pointer:  The SMIX module MUST be compiled using the "-zu"
  75. compiler switch.  The Watcom code generator erroneously assumes that
  76. SS == DS when generating code for an interrupt handler.  The compiler
  77. then uses EBP to address data in DS and your program will terminate
  78. with a stack fault upon the first sound interrupt.  "-zu" tells the
  79. compiler not to make this assumption and is the best workaround for
  80. this compiler bug.  (Another option is to disable optimizations, but
  81. then the compiler will generate terrible code)  Due to the DOS/4GW
  82. extender used for Watcom C protected mode, sound cards on IRQ10 are
  83. not supported by this version of SMIX.
  84.  
  85. I have several improvements planned, but I need feedback.  If you are
  86. using my code, I would greatly appreciate it if you would mail me and
  87. tell me about it.  If you have any bug reports, suggestions, or have
  88. made improvements, please tell me!  I also have available a FM synthesis
  89. MIDI music library and am working on a digital music library, so tell me
  90. what you are interested in!
  91.  
  92. This library is freeware, but I would appreciate contributions so I can
  93. continue to buy development kits and upgrade my computer.  You don't
  94. NEED to send me anything, but if you are making money using this, please
  95. send whatever you feel that it is worth.
  96.  
  97. Features:
  98.   * Up to 8 sounds played simultaneously
  99.   * Sampling rate of 22050 HZ
  100.   * Autoinitialized DMA prevents clicking
  101.   * 16-bit sound output increases quality
  102.   * Mixes in the background using a fraction of CPU time
  103.   * Sound volume control supported
  104.   * Sound resource files allow you to store all sounds in one file
  105.  
  106. ------------------------------------------------------------------------
  107.  
  108. There are several ways to contact me:
  109.     E-Mail:  ebrodsky@pobox.com       (Preferred)
  110.              ericbrodsky@psl.wisc.edu
  111.     WWW:     http://www.pobox.com/~ebrodsky/
  112.              http://www.xraylith.wisc.edu/~ebrodsky/
  113.     Phone:   (608) 238-4830
  114.     Mail:
  115.         Ethan Brodsky
  116.       4010 Cherokee Dr.
  117.       Madison, WI 53711
  118.  
  119. Bug fixes and other announcements will be posted in:
  120.     alt.sb.programmer
  121.     comp.sys.ibm.pc.soundcard.tech
  122.     rec.games.programmer
  123.  
  124. Up-to-date versions may be downloaded from:
  125.     x2ftp.oulu.fi /pub/msdos/programming/mxlibs/smixw*.zip
  126.       The directory structure at x2ftp is currently under reorganization
  127.       and the file will probably be moved to a different directory.
  128.     http://www.pobox.com/~ebrodsky/smix/smix.html
  129.  
  130. Revision history:
  131.  1.11 - Initial release
  132.  1.20 - Switched to a new mixing algorithm that doesn't reduce sound
  133.         volume on 8-bit sound cards.  Added support for sound volume
  134.         control.  Fixed a problem with output on Sound BlasterPros.
  135.         Optimized mixing code.  Modified code in exit procedure to
  136.         reset sound card on termination.
  137.  1.21 - Modifed shutdown code
  138.  1.22 - Fixed a detection problem with sound cards on DMA0.  Commented
  139.         SMIX interface.  Modified interrrupt acknowledgement.  Added a
  140.         sound_playing function to check if a sound is still playing.
  141.  1.23 - Fixed setup for SB16s that use an 8-bit DMA channel for 16-bit
  142.         sound.  Made all internal functions static.  Added sound_playing
  143.         function to smix.h and copied the interface documentation from
  144.         smix.c to smix.h.
  145.  1.24 - Added support for sound resource files.  New WAV2RAW converter
  146.         that correctly converts all conformant WAV files containing the
  147.         correct type of data.
  148.  
  149. I've been looking to get in with a commercial software company.  If any
  150. companies are interested, write to me at the above address.  Thanks!
  151.  
  152.     Ethan Brodsky
  153.