home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / MISC / MUSIC / TUNPLAY.DOC < prev    next >
Encoding:
Text File  |  1994-10-26  |  2.2 KB  |  44 lines
  1. rem -------------------------------------------------------------
  2. rem |                         TUNPLAY                           |
  3. rem |                        Version 2.0                        |
  4. rem |               Copyright 1994 Berthold Daum                |
  5. rem |-----------------------------------------------------------|
  6. rem |  r% = tunplay%:(file$,i%)                                 |
  7. rem |-----------------------------------------------------------|
  8. rem | file$:    filename of tune (.TUN) if not specified        |
  9. rem | i%:       i%=1 key press aborts tune                      |
  10. rem |           i%=0 no interrupt possible                      |
  11. rem |           + 2*loudness (0-4)                              |
  12. rem |             (no change, 1 very loud, 4 very low)          |
  13. rem | r%:       r%=0 normal execution                           |
  14. rem |           r%=-2 file does not exist                       |
  15. rem |           r%=-3 file error (wrong format)                 |
  16. rem |           r%=-1 other error                               |
  17. rem |           r%>0  interrupt via key (r%=key+1024*kmod)      |
  18. rem -------------------------------------------------------------
  19. rem
  20. rem
  21. rem        Example: tunplay%:("maplerag",1)
  22. rem
  23. rem                see also MUSITEST.OPL
  24. rem
  25. rem        Note: TunPlay checks only for keypresses.
  26. rem              Events go unnoticed. So if used in an application
  27. rem              bracket it by (lock on ... lock off).
  28. rem
  29. rem -------------------------------------------------------------------
  30. rem SND file layout:
  31. rem                        0: byte: tempo (120 is S3a default tempo)
  32. rem                        1: byte: Shift value (for display purposes only)
  33. rem                        2: word: number of notes voice 1(n1)
  34. rem                        4: word: number of notes voice 3(n2)
  35. rem                        6: n1*2 words: voice 1
  36. rem                   6+4*n1: n2*2 words: voice 2
  37. rem              6+4*(n1+n2): r*2 words: metastructure
  38. rem                              (for display purposes only)
  39. rem
  40. rem The voice strings are in SOUND-Device format as described in the 
  41. rem PSION S3a Programming Manual.
  42. rem ------------------------------------------------------------------
  43.  
  44.