home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / demos / g / gym / !Gym / STmod-DOCS < prev    next >
Encoding:
Text File  |  1990-08-30  |  4.6 KB  |  114 lines
  1. -------------------------------------------------------------------------------
  2. Background SoundTracker ModulePlayer                    v1.04 30-Aug-1990 17:23
  3. -------------------------------------------------------------------------------
  4.                                                      Coding & design by ALT_Man
  5.  
  6. This little module will play the specified Amiga-soundtracker module until
  7. told to stop. It allocates space from the RMA to fit the module in so it's
  8. best to be at the supervisor '*' prompt when you load tunes. Use *PM to load
  9. the PlayerModule.
  10.  
  11. Start a tune going using:                 *PlayMod <modulename>
  12. where <modulename> is the name of an Amiga soundtracker module. From version
  13. 1.00, automatic selection of 15 or 31 instrument format is performed.
  14.  
  15. Note: Using a *PlayMod while one tune is playing will cause the first tune
  16.       to be stopped and the second one loaded & started.
  17.  
  18. Stop a tune playing with:                 *PlayStop                  
  19.  
  20. Show information about a tune with:       *PlayStatus
  21. This shows song name (not filename!), 15/31 instrument format, tune length, and
  22. module length.
  23.  
  24. Set channel separation with:              *PlayStereo <0|1>
  25. Where 0 is Archimedes channels (slight bias left/right so tunes can be heard
  26. out of single-speaker archies) and 1 is Amiga channels (full left/right).
  27.  
  28. Sample rate is currently fixed at 29Khz per channel. Takes appx 25%-ish CPU time.
  29.                                         
  30. This is now supplied in a RISC OS-type application: the directory includes this
  31. file, the 'PM' module, the programs 'playmoda' (plays 15 instrument modules,
  32. commented source), and 'playmoda2' (plays 31 instrument modules).
  33.  
  34. Contact points:
  35.  
  36.       Voice: (0749)  72234 (ask for Hugo)
  37.              (0831) 444192 (VodaFone)
  38.       Data : (0749) 679794 (300-2400    - 1 line )
  39.              (0749) 670030 (300-HST/V32 - 2 lines)
  40.       Email: Prestel - 045847608, CIX - altman
  41.       Snail: Hugo Fiennes, Burcott Manor, Wells, Somerset, BA5 1NH
  42.                                                                   
  43. Please note that the code contained in this player and in 'playmoda' and
  44. 'playmoda2' is copyright (c)1988/1989/1990 Hugo Fiennes and may not be used in
  45. any commercial programs without prior permission from me. Use in public domain
  46. demos, your own programs is permitted, as is copying of the ENTIRE !STracker
  47. directory (not parts of it so as everyone gets all the files!). Please send me
  48. a copy of any demos you do using this routine (or any other routine!) so I can
  49. update the demo-library on my BBS!
  50.  
  51. Have fun, y'all!
  52.  
  53. ALT_Man        
  54.                  
  55. Version 0.06 (first release version)
  56. ------------
  57.                                     
  58. Version 0.07
  59. ------------
  60.  
  61. - My address/contant numbers updated as we have moved!
  62.  
  63. Version 1.00
  64. ------------
  65.  
  66. - Now autoselects 15/31 instrument files. 32 instrument player source included.
  67.  
  68. Version 1.01
  69. ------------
  70.  
  71. - 32 instrument play now fixed!
  72.                                      
  73. Version 1.02
  74. ------------
  75.  
  76. - BIG problem with me not clearing top bit of picth incase it was used in 31
  77.   instrument tunes!
  78.  
  79. Version 1.03
  80. ------------
  81.  
  82. - Fixed now so it never (fingers crossed) loses notes, I was storing a word instead
  83.   of a byte in the 'newdata' bit (blush). PlayModA and PlayModA2 also updated with
  84.   this fix! The problem ONLY occurred if the buffer filling was interrupted by the
  85.   'intr' routine (ie new note data), ie this was is you were running the player
  86.   off interrupts. If you ran off VSYNC's (eg in main demo loop or whatever) then
  87.   it is fine. Still, it's fixed now!
  88.  
  89. - If you have problems with modules giving address exceptions: it is probably that
  90.   the player can't work out what format the file is in: if the player finds a
  91.   &78 (decimal 120, ascii 'x') at position &1D7 in the file it loads, it assumes it
  92.   is a 15 instrument file. If you have 15 instrument files without this byte,
  93.   load an editor (eg !Edit) and find byte &1D7 (decimal 471) using f5, and key
  94.   [copy] (to delete that character), and then [x] (must be lowercase, this is the
  95.   hex &78). Then the module will play just fine.
  96.  
  97. Version 1.04
  98. ------------
  99.  
  100. - Just got filetype allocation from Acorn. Official filetype for
  101.   soundtracker modules is now &cb6.
  102.  
  103. - Fixed problems with pitchbend on some tunes being a bit over-zealous and
  104.   pitchbending off the top of the pitch range!
  105.  
  106. - 31 instrument tunes now can access the top 16 instruments (at last!). I
  107.   was checking the wrong bit last time... oops! PlayModA2 fixed to
  108.   incorporate this change too.
  109.  
  110. - PlayStereo command added which allows you to set the stereo separation.
  111.        
  112. - A few bits fixed hopefully to stop spurious crashes (clear more variables
  113.   before restarting...)
  114.