Home » Archimedes archive » Micro User » MU 1991-03.adf » PD-Stuff » Music/!Player/STmod-DOCS

Music/!Player/STmod-DOCS

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Micro User » MU 1991-03.adf » PD-Stuff
Filename: Music/!Player/STmod-DOCS
Read OK:
File size: 1287 bytes
Load address: 0000
Exec address: 0000
File contents
-------------------------------------------------------------------------------
Background SoundTracker ModulePlayer                    v1.04 30-Aug-1990 17:23
-------------------------------------------------------------------------------
                                                     Coding & design by ALT_Man

This little module will play the specified Amiga-soundtracker module until
told to stop. It allocates space from the RMA to fit the module in so it's
best to be at the supervisor '*' prompt when you load tunes. Use *PM to load
the PlayerModule.

Start a tune going using:                 *PlayMod <modulename>
where <modulename> is the name of an Amiga soundtracker module. From version
1.00, automatic selection of 15 or 31 instrument format is performed.

Note: Using a *PlayMod while one tune is playing will cause the first tune
      to be stopped and the second one loaded & started.

Stop a tune playing with:                 *PlayStop                  

Show information about a tune with:       *PlayStatus
This shows song name (not filename!), 15/31 instrument format, tune length, and
module length.

Set channel separation with:              *PlayStereo <0|1>
Where 0 is Archimedes channels (slight bias left/right so tunes can be heard
out of single-speaker archies) and 1 is Amiga channels (full left/right).

Sample rate is currently fixed at 29Khz per channel. Takes appx 25%-ish CPU time.
                                        
This is now supplied in a RISC OS-type application: the directory includes this
file, the 'PM' module, the programs 'playmoda' (plays 15 instrument modules,
commented source), and 'playmoda2' (plays 31 instrument modules).

Contact points:

      Voice: (0749)  72234 (ask for Hugo)
             (0831) 444192 (VodaFone)
      Data : (0749) 679794 (300-2400    - 1 line )
             (0749) 670030 (300-HST/V32 - 2 lines)
      Email: Prestel - 045847608, CIX - altman
      Snail: Hugo Fiennes, Burcott Manor, Wells, Somerset, BA5 1NH
                                                                  
Please note that the code contained in this player and in 'playmoda' and
'playmoda2' is copyright (c)1988/1989/1990 Hugo Fiennes and may not be used in
any commercial programs without prior permission from me. Use in public domain
demos, your own programs is permitted, as is copying of the ENTIRE !STracker
directory (not parts of it so as everyone gets all the files!). Please send me
a copy of any demos you do using this routine (or any other routine!) so I can
update the demo-library on my BBS!

Have fun, y'all!

ALT_Man        
                 
Version 0.06 (first release version)
------------
                                    
Version 0.07
------------

- My address/contant numbers updated as we have moved!

Version 1.00
------------

- Now autoselects 15/31 instrument files. 32 instrument player source included.

Version 1.01
------------

- 32 instrument play now fixed!
                                     
Version 1.02
------------

- BIG problem with me not clearing top bit of picth incase it was used in 31
  instrument tunes!

Version 1.03
------------

- Fixed now so it never (fingers crossed) loses notes, I was storing a word instead
  of a byte in the 'newdata' bit (blush). PlayModA and PlayModA2 also updated with
  this fix! The problem ONLY occurred if the buffer filling was interrupted by the
  'intr' routine (ie new note data), ie this was is you were running the player
  off interrupts. If you ran off VSYNC's (eg in main demo loop or whatever) then
  it is fine. Still, it's fixed now!

- If you have problems with modules giving address exceptions: it is probably that
  the player can't work out what format the file is in: if the player finds a
  &78 (decimal 120, ascii 'x') at position &1D7 in the file it loads, it assumes it
  is a 15 instrument file. If you have 15 instrument files without this byte,
  load an editor (eg !Edit) and find byte &1D7 (decimal 471) using f5, and key
  [copy] (to delete that character), and then [x] (must be lowercase, this is the
  hex &78). Then the module will play just fine.

Version 1.04
------------

- Just got filetype allocation from Acorn. Official filetype for
  soundtracker modules is now &cb6.

- Fixed problems with pitchbend on some tunes being a bit over-zealous and
  pitchbending off the top of the pitch range!

- 31 instrument tunes now can access the top 16 instruments (at last!). I
  was checking the wrong bit last time... oops! PlayModA2 fixed to
  incorporate this change too.

- PlayStereo command added which allows you to set the stereo separation.
       
- A few bits fixed hopefully to stop spurious crashes (clear more variables
  before restarting...)
00000000  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000040  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 0a  |---------------.|
00000050  42 61 63 6b 67 72 6f 75  6e 64 20 53 6f 75 6e 64  |Background Sound|
00000060  54 72 61 63 6b 65 72 20  4d 6f 64 75 6c 65 50 6c  |Tracker ModulePl|
00000070  61 79 65 72 20 20 20 20  20 20 20 20 20 20 20 20  |ayer            |
00000080  20 20 20 20 20 20 20 20  76 31 2e 30 34 20 33 30  |        v1.04 30|
00000090  2d 41 75 67 2d 31 39 39  30 20 31 37 3a 32 33 0a  |-Aug-1990 17:23.|
000000a0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000000e0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 0a  |---------------.|
000000f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000120  20 20 20 20 20 43 6f 64  69 6e 67 20 26 20 64 65  |     Coding & de|
00000130  73 69 67 6e 20 62 79 20  41 4c 54 5f 4d 61 6e 0a  |sign by ALT_Man.|
00000140  0a 54 68 69 73 20 6c 69  74 74 6c 65 20 6d 6f 64  |.This little mod|
00000150  75 6c 65 20 77 69 6c 6c  20 70 6c 61 79 20 74 68  |ule will play th|
00000160  65 20 73 70 65 63 69 66  69 65 64 20 41 6d 69 67  |e specified Amig|
00000170  61 2d 73 6f 75 6e 64 74  72 61 63 6b 65 72 20 6d  |a-soundtracker m|
00000180  6f 64 75 6c 65 20 75 6e  74 69 6c 0a 74 6f 6c 64  |odule until.told|
00000190  20 74 6f 20 73 74 6f 70  2e 20 49 74 20 61 6c 6c  | to stop. It all|
000001a0  6f 63 61 74 65 73 20 73  70 61 63 65 20 66 72 6f  |ocates space fro|
000001b0  6d 20 74 68 65 20 52 4d  41 20 74 6f 20 66 69 74  |m the RMA to fit|
000001c0  20 74 68 65 20 6d 6f 64  75 6c 65 20 69 6e 20 73  | the module in s|
000001d0  6f 20 69 74 27 73 0a 62  65 73 74 20 74 6f 20 62  |o it's.best to b|
000001e0  65 20 61 74 20 74 68 65  20 73 75 70 65 72 76 69  |e at the supervi|
000001f0  73 6f 72 20 27 2a 27 20  70 72 6f 6d 70 74 20 77  |sor '*' prompt w|
00000200  68 65 6e 20 79 6f 75 20  6c 6f 61 64 20 74 75 6e  |hen you load tun|
00000210  65 73 2e 20 55 73 65 20  2a 50 4d 20 74 6f 20 6c  |es. Use *PM to l|
00000220  6f 61 64 0a 74 68 65 20  50 6c 61 79 65 72 4d 6f  |oad.the PlayerMo|
00000230  64 75 6c 65 2e 0a 0a 53  74 61 72 74 20 61 20 74  |dule...Start a t|
00000240  75 6e 65 20 67 6f 69 6e  67 20 75 73 69 6e 67 3a  |une going using:|
00000250  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000260  20 2a 50 6c 61 79 4d 6f  64 20 3c 6d 6f 64 75 6c  | *PlayMod <modul|
00000270  65 6e 61 6d 65 3e 0a 77  68 65 72 65 20 3c 6d 6f  |ename>.where <mo|
00000280  64 75 6c 65 6e 61 6d 65  3e 20 69 73 20 74 68 65  |dulename> is the|
00000290  20 6e 61 6d 65 20 6f 66  20 61 6e 20 41 6d 69 67  | name of an Amig|
000002a0  61 20 73 6f 75 6e 64 74  72 61 63 6b 65 72 20 6d  |a soundtracker m|
000002b0  6f 64 75 6c 65 2e 20 46  72 6f 6d 20 76 65 72 73  |odule. From vers|
000002c0  69 6f 6e 0a 31 2e 30 30  2c 20 61 75 74 6f 6d 61  |ion.1.00, automa|
000002d0  74 69 63 20 73 65 6c 65  63 74 69 6f 6e 20 6f 66  |tic selection of|
000002e0  20 31 35 20 6f 72 20 33  31 20 69 6e 73 74 72 75  | 15 or 31 instru|
000002f0  6d 65 6e 74 20 66 6f 72  6d 61 74 20 69 73 20 70  |ment format is p|
00000300  65 72 66 6f 72 6d 65 64  2e 0a 0a 4e 6f 74 65 3a  |erformed...Note:|
00000310  20 55 73 69 6e 67 20 61  20 2a 50 6c 61 79 4d 6f  | Using a *PlayMo|
00000320  64 20 77 68 69 6c 65 20  6f 6e 65 20 74 75 6e 65  |d while one tune|
00000330  20 69 73 20 70 6c 61 79  69 6e 67 20 77 69 6c 6c  | is playing will|
00000340  20 63 61 75 73 65 20 74  68 65 20 66 69 72 73 74  | cause the first|
00000350  20 74 75 6e 65 0a 20 20  20 20 20 20 74 6f 20 62  | tune.      to b|
00000360  65 20 73 74 6f 70 70 65  64 20 61 6e 64 20 74 68  |e stopped and th|
00000370  65 20 73 65 63 6f 6e 64  20 6f 6e 65 20 6c 6f 61  |e second one loa|
00000380  64 65 64 20 26 20 73 74  61 72 74 65 64 2e 0a 0a  |ded & started...|
00000390  53 74 6f 70 20 61 20 74  75 6e 65 20 70 6c 61 79  |Stop a tune play|
000003a0  69 6e 67 20 77 69 74 68  3a 20 20 20 20 20 20 20  |ing with:       |
000003b0  20 20 20 20 20 20 20 20  20 20 2a 50 6c 61 79 53  |          *PlayS|
000003c0  74 6f 70 20 20 20 20 20  20 20 20 20 20 20 20 20  |top             |
000003d0  20 20 20 20 20 0a 0a 53  68 6f 77 20 69 6e 66 6f  |     ..Show info|
000003e0  72 6d 61 74 69 6f 6e 20  61 62 6f 75 74 20 61 20  |rmation about a |
000003f0  74 75 6e 65 20 77 69 74  68 3a 20 20 20 20 20 20  |tune with:      |
00000400  20 2a 50 6c 61 79 53 74  61 74 75 73 0a 54 68 69  | *PlayStatus.Thi|
00000410  73 20 73 68 6f 77 73 20  73 6f 6e 67 20 6e 61 6d  |s shows song nam|
00000420  65 20 28 6e 6f 74 20 66  69 6c 65 6e 61 6d 65 21  |e (not filename!|
00000430  29 2c 20 31 35 2f 33 31  20 69 6e 73 74 72 75 6d  |), 15/31 instrum|
00000440  65 6e 74 20 66 6f 72 6d  61 74 2c 20 74 75 6e 65  |ent format, tune|
00000450  20 6c 65 6e 67 74 68 2c  20 61 6e 64 0a 6d 6f 64  | length, and.mod|
00000460  75 6c 65 20 6c 65 6e 67  74 68 2e 0a 0a 53 65 74  |ule length...Set|
00000470  20 63 68 61 6e 6e 65 6c  20 73 65 70 61 72 61 74  | channel separat|
00000480  69 6f 6e 20 77 69 74 68  3a 20 20 20 20 20 20 20  |ion with:       |
00000490  20 20 20 20 20 20 20 2a  50 6c 61 79 53 74 65 72  |       *PlaySter|
000004a0  65 6f 20 3c 30 7c 31 3e  0a 57 68 65 72 65 20 30  |eo <0|1>.Where 0|
000004b0  20 69 73 20 41 72 63 68  69 6d 65 64 65 73 20 63  | is Archimedes c|
000004c0  68 61 6e 6e 65 6c 73 20  28 73 6c 69 67 68 74 20  |hannels (slight |
000004d0  62 69 61 73 20 6c 65 66  74 2f 72 69 67 68 74 20  |bias left/right |
000004e0  73 6f 20 74 75 6e 65 73  20 63 61 6e 20 62 65 20  |so tunes can be |
000004f0  68 65 61 72 64 0a 6f 75  74 20 6f 66 20 73 69 6e  |heard.out of sin|
00000500  67 6c 65 2d 73 70 65 61  6b 65 72 20 61 72 63 68  |gle-speaker arch|
00000510  69 65 73 29 20 61 6e 64  20 31 20 69 73 20 41 6d  |ies) and 1 is Am|
00000520  69 67 61 20 63 68 61 6e  6e 65 6c 73 20 28 66 75  |iga channels (fu|
00000530  6c 6c 20 6c 65 66 74 2f  72 69 67 68 74 29 2e 0a  |ll left/right)..|
00000540  0a 53 61 6d 70 6c 65 20  72 61 74 65 20 69 73 20  |.Sample rate is |
00000550  63 75 72 72 65 6e 74 6c  79 20 66 69 78 65 64 20  |currently fixed |
00000560  61 74 20 32 39 4b 68 7a  20 70 65 72 20 63 68 61  |at 29Khz per cha|
00000570  6e 6e 65 6c 2e 20 54 61  6b 65 73 20 61 70 70 78  |nnel. Takes appx|
00000580  20 32 35 25 2d 69 73 68  20 43 50 55 20 74 69 6d  | 25%-ish CPU tim|
00000590  65 2e 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |e..             |
000005a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000005b0  20 20 20 20 20 20 20 20  20 20 20 0a 54 68 69 73  |           .This|
000005c0  20 69 73 20 6e 6f 77 20  73 75 70 70 6c 69 65 64  | is now supplied|
000005d0  20 69 6e 20 61 20 52 49  53 43 20 4f 53 2d 74 79  | in a RISC OS-ty|
000005e0  70 65 20 61 70 70 6c 69  63 61 74 69 6f 6e 3a 20  |pe application: |
000005f0  74 68 65 20 64 69 72 65  63 74 6f 72 79 20 69 6e  |the directory in|
00000600  63 6c 75 64 65 73 20 74  68 69 73 0a 66 69 6c 65  |cludes this.file|
00000610  2c 20 74 68 65 20 27 50  4d 27 20 6d 6f 64 75 6c  |, the 'PM' modul|
00000620  65 2c 20 74 68 65 20 70  72 6f 67 72 61 6d 73 20  |e, the programs |
00000630  27 70 6c 61 79 6d 6f 64  61 27 20 28 70 6c 61 79  |'playmoda' (play|
00000640  73 20 31 35 20 69 6e 73  74 72 75 6d 65 6e 74 20  |s 15 instrument |
00000650  6d 6f 64 75 6c 65 73 2c  0a 63 6f 6d 6d 65 6e 74  |modules,.comment|
00000660  65 64 20 73 6f 75 72 63  65 29 2c 20 61 6e 64 20  |ed source), and |
00000670  27 70 6c 61 79 6d 6f 64  61 32 27 20 28 70 6c 61  |'playmoda2' (pla|
00000680  79 73 20 33 31 20 69 6e  73 74 72 75 6d 65 6e 74  |ys 31 instrument|
00000690  20 6d 6f 64 75 6c 65 73  29 2e 0a 0a 43 6f 6e 74  | modules)...Cont|
000006a0  61 63 74 20 70 6f 69 6e  74 73 3a 0a 0a 20 20 20  |act points:..   |
000006b0  20 20 20 56 6f 69 63 65  3a 20 28 30 37 34 39 29  |   Voice: (0749)|
000006c0  20 20 37 32 32 33 34 20  28 61 73 6b 20 66 6f 72  |  72234 (ask for|
000006d0  20 48 75 67 6f 29 0a 20  20 20 20 20 20 20 20 20  | Hugo).         |
000006e0  20 20 20 20 28 30 38 33  31 29 20 34 34 34 31 39  |    (0831) 44419|
000006f0  32 20 28 56 6f 64 61 46  6f 6e 65 29 0a 20 20 20  |2 (VodaFone).   |
00000700  20 20 20 44 61 74 61 20  3a 20 28 30 37 34 39 29  |   Data : (0749)|
00000710  20 36 37 39 37 39 34 20  28 33 30 30 2d 32 34 30  | 679794 (300-240|
00000720  30 20 20 20 20 2d 20 31  20 6c 69 6e 65 20 29 0a  |0    - 1 line ).|
00000730  20 20 20 20 20 20 20 20  20 20 20 20 20 28 30 37  |             (07|
00000740  34 39 29 20 36 37 30 30  33 30 20 28 33 30 30 2d  |49) 670030 (300-|
00000750  48 53 54 2f 56 33 32 20  2d 20 32 20 6c 69 6e 65  |HST/V32 - 2 line|
00000760  73 29 0a 20 20 20 20 20  20 45 6d 61 69 6c 3a 20  |s).      Email: |
00000770  50 72 65 73 74 65 6c 20  2d 20 30 34 35 38 34 37  |Prestel - 045847|
00000780  36 30 38 2c 20 43 49 58  20 2d 20 61 6c 74 6d 61  |608, CIX - altma|
00000790  6e 0a 20 20 20 20 20 20  53 6e 61 69 6c 3a 20 48  |n.      Snail: H|
000007a0  75 67 6f 20 46 69 65 6e  6e 65 73 2c 20 42 75 72  |ugo Fiennes, Bur|
000007b0  63 6f 74 74 20 4d 61 6e  6f 72 2c 20 57 65 6c 6c  |cott Manor, Well|
000007c0  73 2c 20 53 6f 6d 65 72  73 65 74 2c 20 42 41 35  |s, Somerset, BA5|
000007d0  20 31 4e 48 0a 20 20 20  20 20 20 20 20 20 20 20  | 1NH.           |
000007e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000810  20 20 20 20 20 20 20 0a  50 6c 65 61 73 65 20 6e  |       .Please n|
00000820  6f 74 65 20 74 68 61 74  20 74 68 65 20 63 6f 64  |ote that the cod|
00000830  65 20 63 6f 6e 74 61 69  6e 65 64 20 69 6e 20 74  |e contained in t|
00000840  68 69 73 20 70 6c 61 79  65 72 20 61 6e 64 20 69  |his player and i|
00000850  6e 20 27 70 6c 61 79 6d  6f 64 61 27 20 61 6e 64  |n 'playmoda' and|
00000860  0a 27 70 6c 61 79 6d 6f  64 61 32 27 20 69 73 20  |.'playmoda2' is |
00000870  63 6f 70 79 72 69 67 68  74 20 28 63 29 31 39 38  |copyright (c)198|
00000880  38 2f 31 39 38 39 2f 31  39 39 30 20 48 75 67 6f  |8/1989/1990 Hugo|
00000890  20 46 69 65 6e 6e 65 73  20 61 6e 64 20 6d 61 79  | Fiennes and may|
000008a0  20 6e 6f 74 20 62 65 20  75 73 65 64 20 69 6e 0a  | not be used in.|
000008b0  61 6e 79 20 63 6f 6d 6d  65 72 63 69 61 6c 20 70  |any commercial p|
000008c0  72 6f 67 72 61 6d 73 20  77 69 74 68 6f 75 74 20  |rograms without |
000008d0  70 72 69 6f 72 20 70 65  72 6d 69 73 73 69 6f 6e  |prior permission|
000008e0  20 66 72 6f 6d 20 6d 65  2e 20 55 73 65 20 69 6e  | from me. Use in|
000008f0  20 70 75 62 6c 69 63 20  64 6f 6d 61 69 6e 0a 64  | public domain.d|
00000900  65 6d 6f 73 2c 20 79 6f  75 72 20 6f 77 6e 20 70  |emos, your own p|
00000910  72 6f 67 72 61 6d 73 20  69 73 20 70 65 72 6d 69  |rograms is permi|
00000920  74 74 65 64 2c 20 61 73  20 69 73 20 63 6f 70 79  |tted, as is copy|
00000930  69 6e 67 20 6f 66 20 74  68 65 20 45 4e 54 49 52  |ing of the ENTIR|
00000940  45 20 21 53 54 72 61 63  6b 65 72 0a 64 69 72 65  |E !STracker.dire|
00000950  63 74 6f 72 79 20 28 6e  6f 74 20 70 61 72 74 73  |ctory (not parts|
00000960  20 6f 66 20 69 74 20 73  6f 20 61 73 20 65 76 65  | of it so as eve|
00000970  72 79 6f 6e 65 20 67 65  74 73 20 61 6c 6c 20 74  |ryone gets all t|
00000980  68 65 20 66 69 6c 65 73  21 29 2e 20 50 6c 65 61  |he files!). Plea|
00000990  73 65 20 73 65 6e 64 20  6d 65 0a 61 20 63 6f 70  |se send me.a cop|
000009a0  79 20 6f 66 20 61 6e 79  20 64 65 6d 6f 73 20 79  |y of any demos y|
000009b0  6f 75 20 64 6f 20 75 73  69 6e 67 20 74 68 69 73  |ou do using this|
000009c0  20 72 6f 75 74 69 6e 65  20 28 6f 72 20 61 6e 79  | routine (or any|
000009d0  20 6f 74 68 65 72 20 72  6f 75 74 69 6e 65 21 29  | other routine!)|
000009e0  20 73 6f 20 49 20 63 61  6e 0a 75 70 64 61 74 65  | so I can.update|
000009f0  20 74 68 65 20 64 65 6d  6f 2d 6c 69 62 72 61 72  | the demo-librar|
00000a00  79 20 6f 6e 20 6d 79 20  42 42 53 21 0a 0a 48 61  |y on my BBS!..Ha|
00000a10  76 65 20 66 75 6e 2c 20  79 27 61 6c 6c 21 0a 0a  |ve fun, y'all!..|
00000a20  41 4c 54 5f 4d 61 6e 20  20 20 20 20 20 20 20 0a  |ALT_Man        .|
00000a30  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000a40  20 0a 56 65 72 73 69 6f  6e 20 30 2e 30 36 20 28  | .Version 0.06 (|
00000a50  66 69 72 73 74 20 72 65  6c 65 61 73 65 20 76 65  |first release ve|
00000a60  72 73 69 6f 6e 29 0a 2d  2d 2d 2d 2d 2d 2d 2d 2d  |rsion).---------|
00000a70  2d 2d 2d 0a 20 20 20 20  20 20 20 20 20 20 20 20  |---.            |
00000a80  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000a90  20 20 20 20 20 20 20 20  0a 56 65 72 73 69 6f 6e  |        .Version|
00000aa0  20 30 2e 30 37 0a 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  | 0.07.----------|
00000ab0  2d 2d 0a 0a 2d 20 4d 79  20 61 64 64 72 65 73 73  |--..- My address|
00000ac0  2f 63 6f 6e 74 61 6e 74  20 6e 75 6d 62 65 72 73  |/contant numbers|
00000ad0  20 75 70 64 61 74 65 64  20 61 73 20 77 65 20 68  | updated as we h|
00000ae0  61 76 65 20 6d 6f 76 65  64 21 0a 0a 56 65 72 73  |ave moved!..Vers|
00000af0  69 6f 6e 20 31 2e 30 30  0a 2d 2d 2d 2d 2d 2d 2d  |ion 1.00.-------|
00000b00  2d 2d 2d 2d 2d 0a 0a 2d  20 4e 6f 77 20 61 75 74  |-----..- Now aut|
00000b10  6f 73 65 6c 65 63 74 73  20 31 35 2f 33 31 20 69  |oselects 15/31 i|
00000b20  6e 73 74 72 75 6d 65 6e  74 20 66 69 6c 65 73 2e  |nstrument files.|
00000b30  20 33 32 20 69 6e 73 74  72 75 6d 65 6e 74 20 70  | 32 instrument p|
00000b40  6c 61 79 65 72 20 73 6f  75 72 63 65 20 69 6e 63  |layer source inc|
00000b50  6c 75 64 65 64 2e 0a 0a  56 65 72 73 69 6f 6e 20  |luded...Version |
00000b60  31 2e 30 31 0a 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |1.01.-----------|
00000b70  2d 0a 0a 2d 20 33 32 20  69 6e 73 74 72 75 6d 65  |-..- 32 instrume|
00000b80  6e 74 20 70 6c 61 79 20  6e 6f 77 20 66 69 78 65  |nt play now fixe|
00000b90  64 21 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |d!.             |
00000ba0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000bb0  20 20 20 20 20 20 20 20  0a 56 65 72 73 69 6f 6e  |        .Version|
00000bc0  20 31 2e 30 32 0a 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  | 1.02.----------|
00000bd0  2d 2d 0a 0a 2d 20 42 49  47 20 70 72 6f 62 6c 65  |--..- BIG proble|
00000be0  6d 20 77 69 74 68 20 6d  65 20 6e 6f 74 20 63 6c  |m with me not cl|
00000bf0  65 61 72 69 6e 67 20 74  6f 70 20 62 69 74 20 6f  |earing top bit o|
00000c00  66 20 70 69 63 74 68 20  69 6e 63 61 73 65 20 69  |f picth incase i|
00000c10  74 20 77 61 73 20 75 73  65 64 20 69 6e 20 33 31  |t was used in 31|
00000c20  0a 20 20 69 6e 73 74 72  75 6d 65 6e 74 20 74 75  |.  instrument tu|
00000c30  6e 65 73 21 0a 0a 56 65  72 73 69 6f 6e 20 31 2e  |nes!..Version 1.|
00000c40  30 33 0a 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 0a  |03.------------.|
00000c50  0a 2d 20 46 69 78 65 64  20 6e 6f 77 20 73 6f 20  |.- Fixed now so |
00000c60  69 74 20 6e 65 76 65 72  20 28 66 69 6e 67 65 72  |it never (finger|
00000c70  73 20 63 72 6f 73 73 65  64 29 20 6c 6f 73 65 73  |s crossed) loses|
00000c80  20 6e 6f 74 65 73 2c 20  49 20 77 61 73 20 73 74  | notes, I was st|
00000c90  6f 72 69 6e 67 20 61 20  77 6f 72 64 20 69 6e 73  |oring a word ins|
00000ca0  74 65 61 64 0a 20 20 6f  66 20 61 20 62 79 74 65  |tead.  of a byte|
00000cb0  20 69 6e 20 74 68 65 20  27 6e 65 77 64 61 74 61  | in the 'newdata|
00000cc0  27 20 62 69 74 20 28 62  6c 75 73 68 29 2e 20 50  |' bit (blush). P|
00000cd0  6c 61 79 4d 6f 64 41 20  61 6e 64 20 50 6c 61 79  |layModA and Play|
00000ce0  4d 6f 64 41 32 20 61 6c  73 6f 20 75 70 64 61 74  |ModA2 also updat|
00000cf0  65 64 20 77 69 74 68 0a  20 20 74 68 69 73 20 66  |ed with.  this f|
00000d00  69 78 21 20 54 68 65 20  70 72 6f 62 6c 65 6d 20  |ix! The problem |
00000d10  4f 4e 4c 59 20 6f 63 63  75 72 72 65 64 20 69 66  |ONLY occurred if|
00000d20  20 74 68 65 20 62 75 66  66 65 72 20 66 69 6c 6c  | the buffer fill|
00000d30  69 6e 67 20 77 61 73 20  69 6e 74 65 72 72 75 70  |ing was interrup|
00000d40  74 65 64 20 62 79 20 74  68 65 0a 20 20 27 69 6e  |ted by the.  'in|
00000d50  74 72 27 20 72 6f 75 74  69 6e 65 20 28 69 65 20  |tr' routine (ie |
00000d60  6e 65 77 20 6e 6f 74 65  20 64 61 74 61 29 2c 20  |new note data), |
00000d70  69 65 20 74 68 69 73 20  77 61 73 20 69 73 20 79  |ie this was is y|
00000d80  6f 75 20 77 65 72 65 20  72 75 6e 6e 69 6e 67 20  |ou were running |
00000d90  74 68 65 20 70 6c 61 79  65 72 0a 20 20 6f 66 66  |the player.  off|
00000da0  20 69 6e 74 65 72 72 75  70 74 73 2e 20 49 66 20  | interrupts. If |
00000db0  79 6f 75 20 72 61 6e 20  6f 66 66 20 56 53 59 4e  |you ran off VSYN|
00000dc0  43 27 73 20 28 65 67 20  69 6e 20 6d 61 69 6e 20  |C's (eg in main |
00000dd0  64 65 6d 6f 20 6c 6f 6f  70 20 6f 72 20 77 68 61  |demo loop or wha|
00000de0  74 65 76 65 72 29 20 74  68 65 6e 0a 20 20 69 74  |tever) then.  it|
00000df0  20 69 73 20 66 69 6e 65  2e 20 53 74 69 6c 6c 2c  | is fine. Still,|
00000e00  20 69 74 27 73 20 66 69  78 65 64 20 6e 6f 77 21  | it's fixed now!|
00000e10  0a 0a 2d 20 49 66 20 79  6f 75 20 68 61 76 65 20  |..- If you have |
00000e20  70 72 6f 62 6c 65 6d 73  20 77 69 74 68 20 6d 6f  |problems with mo|
00000e30  64 75 6c 65 73 20 67 69  76 69 6e 67 20 61 64 64  |dules giving add|
00000e40  72 65 73 73 20 65 78 63  65 70 74 69 6f 6e 73 3a  |ress exceptions:|
00000e50  20 69 74 20 69 73 20 70  72 6f 62 61 62 6c 79 20  | it is probably |
00000e60  74 68 61 74 0a 20 20 74  68 65 20 70 6c 61 79 65  |that.  the playe|
00000e70  72 20 63 61 6e 27 74 20  77 6f 72 6b 20 6f 75 74  |r can't work out|
00000e80  20 77 68 61 74 20 66 6f  72 6d 61 74 20 74 68 65  | what format the|
00000e90  20 66 69 6c 65 20 69 73  20 69 6e 3a 20 69 66 20  | file is in: if |
00000ea0  74 68 65 20 70 6c 61 79  65 72 20 66 69 6e 64 73  |the player finds|
00000eb0  20 61 0a 20 20 26 37 38  20 28 64 65 63 69 6d 61  | a.  &78 (decima|
00000ec0  6c 20 31 32 30 2c 20 61  73 63 69 69 20 27 78 27  |l 120, ascii 'x'|
00000ed0  29 20 61 74 20 70 6f 73  69 74 69 6f 6e 20 26 31  |) at position &1|
00000ee0  44 37 20 69 6e 20 74 68  65 20 66 69 6c 65 20 69  |D7 in the file i|
00000ef0  74 20 6c 6f 61 64 73 2c  20 69 74 20 61 73 73 75  |t loads, it assu|
00000f00  6d 65 73 20 69 74 0a 20  20 69 73 20 61 20 31 35  |mes it.  is a 15|
00000f10  20 69 6e 73 74 72 75 6d  65 6e 74 20 66 69 6c 65  | instrument file|
00000f20  2e 20 49 66 20 79 6f 75  20 68 61 76 65 20 31 35  |. If you have 15|
00000f30  20 69 6e 73 74 72 75 6d  65 6e 74 20 66 69 6c 65  | instrument file|
00000f40  73 20 77 69 74 68 6f 75  74 20 74 68 69 73 20 62  |s without this b|
00000f50  79 74 65 2c 0a 20 20 6c  6f 61 64 20 61 6e 20 65  |yte,.  load an e|
00000f60  64 69 74 6f 72 20 28 65  67 20 21 45 64 69 74 29  |ditor (eg !Edit)|
00000f70  20 61 6e 64 20 66 69 6e  64 20 62 79 74 65 20 26  | and find byte &|
00000f80  31 44 37 20 28 64 65 63  69 6d 61 6c 20 34 37 31  |1D7 (decimal 471|
00000f90  29 20 75 73 69 6e 67 20  66 35 2c 20 61 6e 64 20  |) using f5, and |
00000fa0  6b 65 79 0a 20 20 5b 63  6f 70 79 5d 20 28 74 6f  |key.  [copy] (to|
00000fb0  20 64 65 6c 65 74 65 20  74 68 61 74 20 63 68 61  | delete that cha|
00000fc0  72 61 63 74 65 72 29 2c  20 61 6e 64 20 74 68 65  |racter), and the|
00000fd0  6e 20 5b 78 5d 20 28 6d  75 73 74 20 62 65 20 6c  |n [x] (must be l|
00000fe0  6f 77 65 72 63 61 73 65  2c 20 74 68 69 73 20 69  |owercase, this i|
00000ff0  73 20 74 68 65 0a 20 20  68 65 78 20 26 37 38 29  |s the.  hex &78)|
00001000  2e 20 54 68 65 6e 20 74  68 65 20 6d 6f 64 75 6c  |. Then the modul|
00001010  65 20 77 69 6c 6c 20 70  6c 61 79 20 6a 75 73 74  |e will play just|
00001020  20 66 69 6e 65 2e 0a 0a  56 65 72 73 69 6f 6e 20  | fine...Version |
00001030  31 2e 30 34 0a 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |1.04.-----------|
00001040  2d 0a 0a 2d 20 4a 75 73  74 20 67 6f 74 20 66 69  |-..- Just got fi|
00001050  6c 65 74 79 70 65 20 61  6c 6c 6f 63 61 74 69 6f  |letype allocatio|
00001060  6e 20 66 72 6f 6d 20 41  63 6f 72 6e 2e 20 4f 66  |n from Acorn. Of|
00001070  66 69 63 69 61 6c 20 66  69 6c 65 74 79 70 65 20  |ficial filetype |
00001080  66 6f 72 0a 20 20 73 6f  75 6e 64 74 72 61 63 6b  |for.  soundtrack|
00001090  65 72 20 6d 6f 64 75 6c  65 73 20 69 73 20 6e 6f  |er modules is no|
000010a0  77 20 26 63 62 36 2e 0a  0a 2d 20 46 69 78 65 64  |w &cb6...- Fixed|
000010b0  20 70 72 6f 62 6c 65 6d  73 20 77 69 74 68 20 70  | problems with p|
000010c0  69 74 63 68 62 65 6e 64  20 6f 6e 20 73 6f 6d 65  |itchbend on some|
000010d0  20 74 75 6e 65 73 20 62  65 69 6e 67 20 61 20 62  | tunes being a b|
000010e0  69 74 20 6f 76 65 72 2d  7a 65 61 6c 6f 75 73 20  |it over-zealous |
000010f0  61 6e 64 0a 20 20 70 69  74 63 68 62 65 6e 64 69  |and.  pitchbendi|
00001100  6e 67 20 6f 66 66 20 74  68 65 20 74 6f 70 20 6f  |ng off the top o|
00001110  66 20 74 68 65 20 70 69  74 63 68 20 72 61 6e 67  |f the pitch rang|
00001120  65 21 0a 0a 2d 20 33 31  20 69 6e 73 74 72 75 6d  |e!..- 31 instrum|
00001130  65 6e 74 20 74 75 6e 65  73 20 6e 6f 77 20 63 61  |ent tunes now ca|
00001140  6e 20 61 63 63 65 73 73  20 74 68 65 20 74 6f 70  |n access the top|
00001150  20 31 36 20 69 6e 73 74  72 75 6d 65 6e 74 73 20  | 16 instruments |
00001160  28 61 74 20 6c 61 73 74  21 29 2e 20 49 0a 20 20  |(at last!). I.  |
00001170  77 61 73 20 63 68 65 63  6b 69 6e 67 20 74 68 65  |was checking the|
00001180  20 77 72 6f 6e 67 20 62  69 74 20 6c 61 73 74 20  | wrong bit last |
00001190  74 69 6d 65 2e 2e 2e 20  6f 6f 70 73 21 20 50 6c  |time... oops! Pl|
000011a0  61 79 4d 6f 64 41 32 20  66 69 78 65 64 20 74 6f  |ayModA2 fixed to|
000011b0  0a 20 20 69 6e 63 6f 72  70 6f 72 61 74 65 20 74  |.  incorporate t|
000011c0  68 69 73 20 63 68 61 6e  67 65 20 74 6f 6f 2e 0a  |his change too..|
000011d0  0a 2d 20 50 6c 61 79 53  74 65 72 65 6f 20 63 6f  |.- PlayStereo co|
000011e0  6d 6d 61 6e 64 20 61 64  64 65 64 20 77 68 69 63  |mmand added whic|
000011f0  68 20 61 6c 6c 6f 77 73  20 79 6f 75 20 74 6f 20  |h allows you to |
00001200  73 65 74 20 74 68 65 20  73 74 65 72 65 6f 20 73  |set the stereo s|
00001210  65 70 61 72 61 74 69 6f  6e 2e 0a 20 20 20 20 20  |eparation..     |
00001220  20 20 0a 2d 20 41 20 66  65 77 20 62 69 74 73 20  |  .- A few bits |
00001230  66 69 78 65 64 20 68 6f  70 65 66 75 6c 6c 79 20  |fixed hopefully |
00001240  74 6f 20 73 74 6f 70 20  73 70 75 72 69 6f 75 73  |to stop spurious|
00001250  20 63 72 61 73 68 65 73  20 28 63 6c 65 61 72 20  | crashes (clear |
00001260  6d 6f 72 65 20 76 61 72  69 61 62 6c 65 73 0a 20  |more variables. |
00001270  20 62 65 66 6f 72 65 20  72 65 73 74 61 72 74 69  | before restarti|
00001280  6e 67 2e 2e 2e 29 0a                              |ng...).|
00001287