home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / sound / misc / play-handler.lha / play-handler.doc < prev    next >
Encoding:
Text File  |  1995-01-25  |  3.1 KB  |  73 lines
  1.  
  2.                 PLAY-Handler   Docu
  3.  
  4. Attention: This program is shareware. It may be freely copied and
  5. distributed as long as there is no charge for anything else than reasonable
  6. media costs. Besides, the following files have to be left unchanged and
  7. together: play-handler.dok, play-handler.doc, play-handler, PLAY,
  8. PLAY.info, mountlist.play, install
  9. I am _not_ responsible for any harm to your enviroment, espescially to your
  10. computer or hifi-rack, that might occur through the use of this software.
  11. It may also not included as an extra to commercial products without written
  12. permission.
  13.  
  14. This version is limited to only one open. After closing the device it will
  15. remove itself completly from memory, so that you have to mount it again for
  16. another use.
  17. Those who like this program as much as to get the full version please send
  18. me 10DM. Those who want it shipped on disk, add 5DM for disk, envelope and
  19. postage. (alltogether 15DM). Alternativly you can send me a disk and
  20. adressed and prepaid envelope, then it is left to 10DM. If you have an
  21. e-mail adresse I can mail it to you (uuencoded, tarred and gzipped).
  22. I accept cash (of course) (no coins please) and eurocheques. All other will
  23. cost me more for cashing than it is worth.
  24.  
  25. I can be reached at the following address:
  26.  
  27. Joerg Dorchain
  28. Harspergerflur 23
  29. D-66740 Saarlouis
  30. Germany
  31. Tel.:+49/6831/892656 (occasionally)
  32.  
  33. E-Mail: dorchain@mpi-sb.mpg.de
  34.  
  35.  
  36. Now, after that legal stuff for the interesting part.
  37.  
  38. Installation: copy play-handler to your l: directory and PLAY and PLAY.info
  39. to devs:dosdrivers respectly append mountlist.play to your devs:mountlist.
  40. Now you can start it with mount play:. Alternativly you can use the
  41. install-sript.
  42.  
  43. Use: play: offers an interface to the audio.device. You open it, write a
  44. sample (raw or iff 8svx) into it and you hear it. (Caution: copy uses upto
  45. your MaxTransfer amount of memory. But you can use join which is more
  46. memory-friendly.) If you feed play: with too small pieces (<256 bytes) you
  47. will hear some sounds of silence because play doesn't get it's data fast
  48. enough. Samples will be played with double-buffering, so you hear the sound
  49. continuously if you put it to play without interrupt. Play: has an internal
  50. buffer for the sample beeing played which can be changed in size by the
  51. addbuffers command.
  52. The behaviour of play: is controlled by the name you open it.
  53. play: opens a mono channelleft to default sampling rate (8192) for raw
  54.     samples. (iff samples will be played at thier stored rate)
  55. play:s plays a sample in stereo. (Both channels the same)
  56. play:l plays only on left channels
  57. play:r plays only on right channels
  58. play:<number> plays the sample at <number> samples per second.
  59.  
  60. Both can be combined with the character before the number. play:s10000 will
  61. play the sample in stereo with 10000 samples per second. Caution: the
  62. sampling rate will not be checked for sense, so extreme values will produce
  63. strange results. play: can be open more often, as long as there is enough
  64. memory and sound channels.
  65.  
  66. Play: should work with all OS-Version. (tested with V3.0)
  67.  
  68. Bugs, improvements or anything else are welcome.
  69. Have fun when trying it out!
  70.  
  71. Joerg
  72.  
  73.