home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 561a.lha / DSound_v0.91a / DSound.doc < prev    next >
Text File  |  1991-09-18  |  3KB  |  60 lines
  1.  
  2.                 DSound V0.91a
  3.  
  4.      DSound is copyright 1991 by Dave Schreiber, All Rights Reserved.
  5. This program is freely distributable, but may not be sold (although a small
  6. fee for copying, media, etc. may be charged).
  7.  
  8.      DSound is utility I whipped together to play 8SVX sound samples
  9. directly off a hard drive (eventually, once 2.0 comes out for all Amigas,
  10. I'd like to revise this program to use some 2.0 features; until then,
  11. this 1.3-compliant version will be the current release).  While it only
  12. takes up a small amount of chip RAM, it can play samples of unlimited size
  13. off a hard drive (it doesn't work to well with floppies however).  I've
  14. tested it on an Amiga 3000 and a 2000 with an A2091 controller (BTW,
  15. I'd like to thank the people at HT Electronics, Sunnyvale, CA, for letting
  16. me test DSound on one of their 2000s), and it works fine on both.
  17.  
  18.      Note #1:  Currently, DSound cannot play compressed sound files.
  19.  
  20.      Note #2:  The technique DSound uses to read in the 8SVX sound samples
  21. isn't as robust as it could be.  When 2.0 comes out I'll use the iff
  22. parsing library that comes with 2.0, but for the time being, don't be
  23. surprised if DSound has trouble reading all but single sample 8SVX files.
  24. DSound works fine with mono sound samples written by the Perfect Sound V3.x
  25. software;  I haven't tried it with samples written by other packages.
  26.  
  27. Usage:
  28.      dsound [-l][-r][-f][-s<speed][-v<volume] soundfile
  29.  
  30. Where the flags are defined as such:
  31.      -l - Play the sample using the left speaker
  32.      -r - Play the sample using the right speaker
  33.      -f - Turn the low pass filter off when playing a sample
  34.      -s<speed> - Play the sample at <speed> sampes per second (up to 28000)
  35.      -s<volume> - Play the sample at a volume of <volume> (1 to 64)
  36.      -b<bufsize> -- Use two buffers of size <bufsize> (default is 30K).  If
  37.             you're experiencing breaks in the sound, try increasing
  38.             this value.
  39.  
  40. If you don't specify any flags, the defaults are to play the sound out of
  41. the first available speaker, with the filter on, at the speed and volume
  42. specified in the soundfile.
  43.  
  44.      DSound will open a window when it starts playing the sample, and will
  45. keep the window open for as long as the sample plays. If you want to stop
  46. DSound in the middle of a sample, click on the window's close gadget.
  47.  
  48. I've included the source for DSound.  To compile (using SAS/C V5.10a) type:
  49.    lc -Lcd -v DSound
  50.  
  51. If you have any questions, comments, etc. regarding DSound, don't hesitate
  52. to get in touch with me at:
  53.  
  54.                          Dave Schreiber
  55.                          1234 Collins Lane
  56.                          San Jose, CA   95129-4208
  57. e-mail:                      davids@ucscb.ucsc.edu
  58.  
  59.  
  60.