Home » Personal collection » Acorn ADFS disks » Greaseweazled » adfs_jaychan.adf » !STracker/STDocs4\06 » Compare

Compare !STracker/STDocs4\06 with Music/!S_Tracker/!Help

File: Personal collection » Acorn ADFS disks » Greaseweazled » adfs_jaychan.adf » !STracker/STDocs4\06
Compared with: Archimedes archive » Micro User » MU 1991-10.adf » PD-Stuff » Music/!S_Tracker/!Help
Similarity: 69% of bytes duplicated

68.5% of the bytes in these files are duplicated between them. Duplicated Different Padding (ignored)

Bytes are marked as duplicated if they lie within a run of at least 16 bytes which also appears somewhere in the other file, in any position. Long runs of padding bytes (zeros, spaces, &FF and &E5) are ignored.

!STracker/STDocs4\06
00000000  21 53 2f 54 72 61 63 6b  65 72 20 28 53 6f 75 6e  |!S/Tracker (Soun|
00000010  64 74 72 61 63 6b 65 72  2f 54 72 61 63 6b 65 72  |dtracker/Tracker|
00000020  20 6d 6f 64 75 6c 65 20  6d 75 73 69 63 20 70 6c  | module music pl|
00000030  61 79 65 72 29 0a 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |ayer).----------|
00000040  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000060  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 0a 0a 56 65 72  |-----------..Ver|
00000070  73 69 6f 6e 20 34 2e 30  36 20 28 31 31 20 44 65  |sion 4.06 (11 De|
00000080  63 20 31 39 39 31 29 0a  0a 4f 72 69 67 69 6e 61  |c 1991)..Origina|
00000090  6c 6c 79 20 77 72 69 74  74 65 6e 20 62 79 20 48  |lly written by H|
000000a0  75 67 6f 20 46 69 65 6e  6e 65 73 20 61 6e 64 20  |ugo Fiennes and |
000000b0  46 61 62 72 69 63 65 20  4d 65 72 63 69 65 72 20  |Fabrice Mercier |
000000c0  5b 28 63 29 20 54 68 65  20 53 65 72 69 61 6c 20  |[(c) The Serial |
000000d0  50 6f 72 74 5d 0a 53 57  49 20 69 6e 74 65 72 66  |Port].SWI interf|
000000e0  61 63 65 20 61 6e 64 20  6f 74 68 65 72 20 62 69  |ace and other bi|
000000f0  74 73 20 61 64 64 65 64  20 62 79 20 4d 61 74 74  |ts added by Matt|
00000100  20 46 61 72 72 6f 77 0a  0a 20 46 65 65 6c 20 66  | Farrow.. Feel f|
00000110  72 65 65 20 74 6f 20 75  73 65 20 74 68 69 73 20  |ree to use this |
00000120  6d 6f 64 75 6c 65 20 69  6e 20 61 6e 79 20 70 2e  |module in any p.|
00000130  64 2e 20 64 65 6d 6f 73  20 6f 72 20 70 72 6f 67  |d. demos or prog|
00000140  72 61 6d 73 20 65 74 63  2e 2c 20 61 6e 64 20 66  |rams etc., and f|
00000150  6f 72 0a 69 6e 63 6c 75  73 69 6f 6e 20 77 69 74  |or.inclusion wit|
00000160  68 20 63 6f 6d 6d 65 72  63 69 61 6c 20 70 72 6f  |h commercial pro|
00000170  67 72 61 6d 73 20 69 66  20 6e 65 65 64 65 64 20  |grams if needed |
00000180  28 62 75 74 20 6c 65 74  20 75 73 20 6b 6e 6f 77  |(but let us know|
00000190  20 66 69 72 73 74 21 21  29 0a 20 4d 75 63 68 20  | first!!). Much |
000001a0  74 69 6d 65 20 61 6e 64  20 65 66 66 6f 72 74 20  |time and effort |
000001b0  68 61 73 20 62 65 65 6e  20 73 70 65 6e 74 20 6f  |has been spent o|
000001c0  6e 20 64 65 76 65 6c 6f  70 69 6e 67 20 74 68 69  |n developing thi|
000001d0  73 20 6d 6f 64 75 6c 65  20 28 66 6f 72 20 6e 6f  |s module (for no|
000001e0  0a 63 6f 6d 6d 65 72 63  69 61 6c 20 67 61 69 6e  |.commercial gain|
000001f0  29 2c 20 61 6e 64 20 69  74 20 77 6f 75 6c 64 20  |), and it would |
00000200  62 65 20 61 20 63 6f 75  72 74 65 73 79 20 69 66  |be a courtesy if|
00000210  20 79 6f 75 20 63 6f 75  6c 64 20 63 72 65 64 69  | you could credi|
00000220  74 20 74 68 65 20 61 75  74 68 6f 72 73 0a 77 68  |t the authors.wh|
00000230  65 6e 65 76 65 72 20 79  6f 75 20 75 73 65 20 69  |enever you use i|
00000240  74 2c 20 61 6e 64 20 69  6e 66 6f 72 6d 20 75 73  |t, and inform us|
00000250  20 69 66 20 79 6f 75 20  69 6e 74 65 6e 64 20 74  | if you intend t|
00000260  6f 20 64 69 73 74 72 69  62 75 74 65 20 69 74 20  |o distribute it |
00000270  6f 6e 20 61 20 6c 61 72  67 65 0a 73 63 61 6c 65  |on a large.scale|
00000280  2e 0a 0a 20 54 68 65 20  21 53 2f 54 72 61 63 6b  |... The !S/Track|
00000290  65 72 20 61 70 70 6c 69  63 61 74 69 6f 6e 20 69  |er application i|
000002a0  73 20 61 20 50 2e 44 2e  20 61 70 70 6c 69 63 61  |s a P.D. applica|
000002b0  74 69 6f 6e 2c 20 61 6e  64 20 6d 61 79 20 62 65  |tion, and may be|
000002c0  20 66 72 65 65 6c 79 20  63 6f 70 69 65 64 0a 69  | freely copied.i|
000002d0  66 20 6e 6f 74 68 69 6e  67 20 6d 6f 72 65 20 74  |f nothing more t|
000002e0  68 61 6e 20 74 68 65 20  63 6f 73 74 20 6f 66 20  |han the cost of |
000002f0  61 20 64 69 73 63 20 61  6e 64 20 61 20 73 6d 61  |a disc and a sma|
00000300  6c 6c 20 61 6d 6f 75 6e  74 20 66 6f 72 20 74 68  |ll amount for th|
00000310  65 20 74 72 6f 75 62 6c  65 20 69 73 0a 63 68 61  |e trouble is.cha|
00000320  72 67 65 64 2c 20 62 75  74 20 69 74 20 6d 75 73  |rged, but it mus|
00000330  74 20 62 65 20 64 69 73  74 72 69 62 75 74 65 64  |t be distributed|
00000340  20 77 69 74 68 20 61 6c  6c 20 74 68 65 20 66 69  | with all the fi|
00000350  6c 65 73 20 63 6f 6d 70  6c 65 74 65 20 61 6e 64  |les complete and|
00000360  20 75 6e 63 68 61 6e 67  65 64 0a 28 77 69 74 68  | unchanged.(with|
00000370  20 74 68 65 20 70 6f 73  73 69 62 6c 65 20 65 78  | the possible ex|
00000380  63 65 70 74 69 6f 6e 20  6f 66 20 74 68 65 20 27  |ception of the '|
00000390  53 54 44 6f 63 73 58 2f  58 58 27 20 66 69 6c 65  |STDocsX/XX' file|
000003a0  29 2e 0a 0a 0a 20 4f 76  65 72 76 69 65 77 0a 20  |).... Overview. |
000003b0  2d 2d 2d 2d 2d 2d 2d 2d  0a 20 20 54 68 65 20 6d  |--------.  The m|
000003c0  6f 64 75 6c 65 20 65 78  69 73 74 73 20 70 72 69  |odule exists pri|
000003d0  6e 63 69 70 61 6c 6c 79  20 74 6f 20 73 75 70 70  |ncipally to supp|
000003e0  6f 72 74 20 74 68 65 20  6d 75 6c 74 69 2d 74 61  |ort the multi-ta|
000003f0  73 6b 69 6e 67 20 70 6c  61 79 69 6e 67 20 6f 66  |sking playing of|
00000400  0a 62 6f 74 68 20 74 68  65 20 53 65 72 69 61 6c  |.both the Serial|
00000410  20 50 6f 72 74 20 54 72  61 63 6b 65 72 20 61 6e  | Port Tracker an|
00000420  64 20 61 6d 69 67 61 20  53 6f 75 6e 64 2f 50 72  |d amiga Sound/Pr|
00000430  6f 74 72 61 63 6b 65 72  20 6d 75 73 69 63 20 6d  |otracker music m|
00000440  6f 64 75 6c 65 20 66 6f  72 6d 61 74 73 2e 0a 20  |odule formats.. |
00000450  20 56 69 61 20 65 69 74  68 65 72 20 61 20 66 75  | Via either a fu|
00000460  6c 6c 20 63 6f 6d 6d 61  6e 64 20 6c 69 6e 65 20  |ll command line |
00000470  69 6e 74 65 72 66 61 63  65 2c 20 6f 72 20 75 73  |interface, or us|
00000480  69 6e 67 20 53 57 49 27  73 20 28 77 69 74 68 20  |ing SWI's (with |
00000490  64 65 73 6b 74 6f 70 0a  66 72 6f 6e 74 2d 65 6e  |desktop.front-en|
000004a0  64 73 20 69 66 20 64 65  73 69 72 65 64 29 2c 20  |ds if desired), |
000004b0  61 20 77 68 6f 6c 65 20  72 61 6e 67 65 20 6f 66  |a whole range of|
000004c0  20 6f 70 65 72 61 74 69  6f 6e 73 20 63 61 6e 20  | operations can |
000004d0  62 65 20 70 65 72 66 6f  72 6d 65 64 20 28 73 75  |be performed (su|
000004e0  63 68 0a 61 73 20 73 65  74 74 69 6e 67 20 74 68  |ch.as setting th|
000004f0  65 20 73 74 65 72 65 6f  20 70 6f 73 69 74 69 6f  |e stereo positio|
00000500  6e 3b 20 66 61 64 69 6e  67 20 69 6e 20 61 6e 64  |n; fading in and|
00000510  20 66 61 64 69 6e 67 20  6f 75 74 3b 20 70 6c 61  | fading out; pla|
00000520  79 69 6e 67 20 73 6f 75  6e 64 0a 65 66 66 65 63  |ying sound.effec|
00000530  74 73 3b 20 63 68 61 6e  67 69 6e 67 20 74 68 65  |ts; changing the|
00000540  20 73 61 6d 70 6c 65 20  71 75 61 6c 69 74 79 3b  | sample quality;|
00000550  20 6d 6f 6e 69 74 6f 72  69 6e 67 20 74 68 65 20  | monitoring the |
00000560  73 74 61 74 65 20 6f 66  20 65 61 63 68 20 63 68  |state of each ch|
00000570  61 6e 6e 65 6c 2c 0a 65  74 63 2e 29 2e 0a 20 20  |annel,.etc.)..  |
00000580  41 73 20 6d 65 6e 74 69  6f 6e 65 64 20 65 61 72  |As mentioned ear|
00000590  6c 69 65 72 2c 20 74 68  65 20 6d 6f 64 75 6c 65  |lier, the module|
000005a0  20 77 69 6c 6c 20 70 6c  61 79 20 28 61 6e 64 20  | will play (and |
000005b0  61 75 74 6f 6d 61 74 69  63 61 6c 6c 79 20 64 65  |automatically de|
000005c0  74 65 63 74 29 20 0a 73  65 76 65 72 61 6c 20 64  |tect) .several d|
000005d0  69 66 66 65 72 65 6e 74  20 66 6f 72 6d 61 74 73  |ifferent formats|
000005e0  3a 0a 0a 20 20 20 31 29  20 41 72 63 68 69 6d 65  |:..   1) Archime|
000005f0  64 65 73 20 54 72 61 63  6b 65 72 20 2d 20 41 20  |des Tracker - A |
00000600  66 75 6c 6c 20 69 6d 70  6c 65 6d 65 6e 74 61 74  |full implementat|
00000610  69 6f 6e 20 64 69 66 66  65 72 69 6e 67 20 66 72  |ion differing fr|
00000620  6f 6d 20 74 68 65 20 6f  72 69 67 69 6e 61 6c 0a  |om the original.|
00000630  20 20 20 20 20 20 20 20  20 20 20 72 6f 75 74 69  |           routi|
00000640  6e 65 73 20 6f 6e 6c 79  20 69 6e 20 77 61 79 73  |nes only in ways|
00000650  20 77 68 69 63 68 20 61  72 65 20 61 6e 20 69 6d  | which are an im|
00000660  70 72 6f 76 65 6d 65 6e  74 20 28 69 65 2e 20 76  |provement (ie. v|
00000670  6f 6c 75 6d 65 20 73 6c  69 64 65 73 0a 20 20 20  |olume slides.   |
00000680  20 20 20 20 20 20 20 20  6f 66 20 31 20 64 6f 6e  |        of 1 don|
00000690  27 74 20 63 61 75 73 65  20 64 69 73 74 6f 72 74  |'t cause distort|
000006a0  69 6f 6e 29 2e 0a 20 20  20 20 20 20 20 20 20 20  |ion)..          |
000006b0  20 20 20 54 72 61 63 6b  65 72 20 74 75 6e 65 73  |   Tracker tunes|
000006c0  20 61 72 65 20 6e 6f 74  20 63 6f 6e 76 65 72 74  | are not convert|
000006d0  65 64 20 69 6e 20 61 6e  79 20 77 61 79 20 77 68  |ed in any way wh|
000006e0  65 6e 20 74 68 65 79 20  61 72 65 20 6c 6f 61 64  |en they are load|
000006f0  65 64 2c 0a 20 20 20 20  20 20 20 20 20 20 20 61  |ed,.           a|
00000700  6e 64 20 73 6f 20 61 72  65 20 70 72 65 73 65 72  |nd so are preser|
00000710  76 65 64 20 69 6e 20 6d  65 6d 6f 72 79 20 28 73  |ved in memory (s|
00000720  75 69 74 61 62 6c 65 20  66 6f 72 20 65 64 69 74  |uitable for edit|
00000730  69 6e 67 29 2e 0a 20 20  20 32 29 20 41 6d 69 67  |ing)..   2) Amig|
00000740  61 20 66 6f 72 6d 61 74  73 20 28 73 6f 75 6e 64  |a formats (sound|
00000750  74 72 61 63 6b 65 72 20  31 35 2f 33 31 20 69 6e  |tracker 15/31 in|
00000760  73 74 2c 20 70 72 6f 74  72 61 63 6b 65 72 29 20  |st, protracker) |
00000770  2d 0a 20 20 20 20 20 20  20 20 20 20 20 46 72 6f  |-.           Fro|
00000780  6d 20 76 65 72 73 69 6f  6e 20 34 2e 30 36 20 6f  |m version 4.06 o|
00000790  6e 77 61 72 64 73 20 74  68 65 73 65 20 61 72 65  |nwards these are|
000007a0  20 72 65 70 6c 61 79 65  64 20 61 73 20 61 63 63  | replayed as acc|
000007b0  75 72 61 74 65 6c 79 20  61 73 0a 20 20 20 20 20  |urately as.     |
000007c0  20 20 20 20 20 20 70 6f  73 73 69 62 6c 65 20 28  |      possible (|
000007d0  69 6e 63 6c 75 64 69 6e  67 20 76 6f 6c 75 6d 65  |including volume|
000007e0  73 29 2c 20 77 69 74 68  20 74 68 65 20 75 6e 69  |s), with the uni|
000007f0  6d 70 6c 65 6d 65 6e 74  65 64 20 63 6f 6d 6d 61  |mplemented comma|
00000800  6e 64 73 0a 20 20 20 20  20 20 20 20 20 20 20 62  |nds.           b|
00000810  65 69 6e 67 20 35 2d 37  2c 20 39 2c 20 45 20 28  |eing 5-7, 9, E (|
00000820  6d 6f 73 74 6c 79 20 75  6e 75 73 65 64 20 6f 72  |mostly unused or|
00000830  20 68 2f 77 20 64 65 70  65 6e 64 65 6e 74 20 61  | h/w dependent a|
00000840  6e 79 77 61 79 29 2e 0a  20 20 20 20 20 20 20 20  |nyway)..        |
00000850  20 20 20 20 20 57 68 65  6e 20 61 6e 20 61 6d 69  |     When an ami|
00000860  67 61 20 66 6f 72 6d 61  74 20 74 75 6e 65 20 69  |ga format tune i|
00000870  73 20 6c 6f 61 64 65 64  2c 20 69 74 20 69 73 20  |s loaded, it is |
00000880  63 6f 6e 76 65 72 74 65  64 20 62 65 66 6f 72 65  |converted before|
00000890  0a 20 20 20 20 20 20 20  20 20 20 20 62 65 69 6e  |.           bein|
000008a0  67 20 70 6c 61 79 65 64  20 28 74 68 65 20 70 61  |g played (the pa|
000008b0  74 74 65 72 6e 20 64 61  74 61 20 69 73 20 63 6f  |ttern data is co|
000008c0  6e 76 65 72 74 65 64 20  69 6e 74 6f 20 54 72 61  |nverted into Tra|
000008d0  63 6b 65 72 20 66 6f 72  6d 61 74 0a 20 20 20 20  |cker format.    |
000008e0  20 20 20 20 20 20 20 64  61 74 61 2c 20 65 78 63  |       data, exc|
000008f0  65 70 74 20 61 6e 79 20  76 6f 6c 75 6d 65 20 6f  |ept any volume o|
00000900  72 20 73 6c 69 64 65 20  63 6f 6d 6d 61 6e 64 73  |r slide commands|
00000910  20 61 72 65 20 70 72 65  73 65 72 76 65 64 29 2e  | are preserved).|
00000920  0a 20 20 20 20 20 20 20  20 20 20 20 59 6f 75 20  |.           You |
00000930  73 68 6f 75 6c 64 20 6e  6f 74 2c 20 74 68 65 72  |should not, ther|
00000940  65 66 6f 72 65 2c 20 73  61 76 65 20 73 6f 75 6e  |efore, save soun|
00000950  64 74 72 61 63 6b 65 72  20 74 75 6e 65 73 20 77  |dtracker tunes w|
00000960  68 69 6c 65 20 74 68 65  79 20 61 72 65 0a 20 20  |hile they are.  |
00000970  20 20 20 20 20 20 20 20  20 70 6c 61 79 69 6e 67  |         playing|
00000980  20 6f 72 20 69 6e 20 70  61 75 73 65 20 6d 6f 64  | or in pause mod|
00000990  65 2c 20 62 75 74 20 69  66 20 74 68 65 79 20 68  |e, but if they h|
000009a0  61 76 65 20 62 65 65 6e  20 27 4d 65 6d 6f 72 79  |ave been 'Memory|
000009b0  4c 6f 61 64 27 65 64 0a  20 20 20 20 20 20 20 20  |Load'ed.        |
000009c0  20 20 20 74 68 65 79 20  77 69 6c 6c 20 62 65 20  |   they will be |
000009d0  63 6f 6e 76 65 72 74 65  64 20 62 61 63 6b 20 61  |converted back a|
000009e0  66 74 65 72 20 61 20 2a  50 6c 61 79 53 74 6f 70  |fter a *PlayStop|
000009f0  20 65 74 63 2e 20 28 62  75 74 20 61 6e 79 0a 20  | etc. (but any. |
00000a00  20 20 20 20 20 20 20 20  20 20 69 6e 73 74 72 75  |          instru|
00000a10  6d 65 6e 74 73 20 6f 75  74 20 6f 66 20 72 61 6e  |ments out of ran|
00000a20  67 65 20 5b 33 32 2d 33  36 5d 20 65 74 63 2e 20  |ge [32-36] etc. |
00000a30  77 69 6c 6c 20 62 65 20  69 67 6e 6f 72 65 64 2f  |will be ignored/|
00000a40  6d 69 73 2d 0a 20 20 20  20 20 20 20 20 20 20 20  |mis-.           |
00000a50  63 6f 6e 76 65 72 74 65  64 29 2e 0a 0a 20 20 54  |converted)...  T|
00000a60  68 69 73 20 64 6f 63 75  6d 65 6e 74 61 74 69 6f  |his documentatio|
00000a70  6e 20 77 61 73 20 77 72  69 74 74 65 6e 20 74 6f  |n was written to|
00000a80  20 61 63 63 6f 6d 70 61  6e 79 20 74 68 65 20 21  | accompany the !|
00000a90  53 2f 54 72 61 63 6b 65  72 20 61 70 70 6c 69 63  |S/Tracker applic|
00000aa0  61 74 69 6f 6e 0a 63 6f  6e 74 61 69 6e 69 6e 67  |ation.containing|
00000ab0  20 74 68 65 20 6c 61 74  65 73 74 20 54 72 61 63  | the latest Trac|
00000ac0  6b 65 72 6d 6f 64 75 6c  65 20 28 27 50 4d 27 29  |kermodule ('PM')|
00000ad0  20 61 6e 64 20 6e 6f 74  20 6d 75 63 68 20 65 6c  | and not much el|
00000ae0  73 65 20 28 74 68 69 73  20 77 61 73 20 73 6f 0a  |se (this was so.|
00000af0  74 68 61 74 20 66 69 6c  65 20 6c 65 6e 67 74 68  |that file length|
00000b00  73 20 63 6f 75 6c 64 20  62 65 20 6b 65 70 74 20  |s could be kept |
00000b10  64 6f 77 6e 20 61 6e 64  20 74 68 65 20 6d 6f 64  |down and the mod|
00000b20  75 6c 65 20 6d 61 64 65  20 72 65 61 73 6f 6e 61  |ule made reasona|
00000b30  62 6c 79 20 65 61 73 79  20 74 6f 0a 64 69 73 74  |bly easy to.dist|
00000b40  72 69 62 75 74 65 29 2e  20 49 74 20 77 61 73 20  |ribute). It was |
00000b50  69 6e 74 65 6e 64 65 64  20 74 68 61 74 20 33 72  |intended that 3r|
00000b60  64 20 70 61 72 74 79 20  50 44 20 77 72 69 74 65  |d party PD write|
00000b70  72 73 20 63 6f 75 6c 64  20 77 72 69 74 65 20 74  |rs could write t|
00000b80  68 65 69 72 20 6f 77 6e  0a 66 72 6f 6e 74 2d 65  |heir own.front-e|
00000b90  6e 64 73 20 66 6f 72 20  74 68 65 20 6d 6f 64 75  |nds for the modu|
00000ba0  6c 65 20 61 6e 64 20 6b  65 65 70 20 74 68 65 20  |le and keep the |
00000bb0  69 6e 74 65 72 66 61 63  65 73 20 27 63 6c 65 61  |interfaces 'clea|
00000bc0  6e 27 20 73 6f 20 74 68  61 74 20 69 74 20 69 73  |n' so that it is|
00000bd0  20 61 20 0a 73 69 6d 70  6c 65 20 74 61 73 6b 20  | a .simple task |
00000be0  74 6f 20 6b 65 65 70 20  75 70 20 77 69 74 68 20  |to keep up with |
00000bf0  63 68 61 6e 67 65 73 20  69 6e 20 74 68 65 20 54  |changes in the T|
00000c00  72 61 63 6b 65 72 20 66  6f 72 6d 61 74 2c 20 66  |racker format, f|
00000c10  6f 72 20 65 78 61 6d 70  6c 65 2c 20 62 79 0a 6a  |or example, by.j|
00000c20  75 73 74 20 72 65 70 6c  61 63 69 6e 67 20 74 68  |ust replacing th|
00000c30  65 20 6d 6f 64 75 6c 65  20 69 6e 20 74 68 65 20  |e module in the |
00000c40  61 70 70 6c 69 63 61 74  69 6f 6e 20 64 69 72 65  |application dire|
00000c50  63 74 6f 72 79 2e 0a 0a  0a 20 20 20 20 20 20 20  |ctory....       |
00000c60  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000c70  20 20 20 20 20 20 20 20  0a 20 20 20 20 20 20 20  |        .       |
00000c80  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000ca0  20 20 20 20 20 20 20 0a  0a 0a 44 4f 43 55 4d 45  |       ...DOCUME|
00000cb0  4e 54 41 54 49 4f 4e 20  4f 46 20 2a 20 43 4f 4d  |NTATION OF * COM|
00000cc0  4d 41 4e 44 53 20 41 4e  44 20 53 57 49 27 73 0a  |MANDS AND SWI's.|
00000cd0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000cf0  2d 2d 2d 2d 2d 0a 0a 2a  50 6c 61 79 4d 6f 64 20  |-----..*PlayMod |
00000d00  20 20 20 20 2d 20 4c 6f  61 64 73 20 69 6e 74 6f  |    - Loads into|
00000d10  20 6d 65 6d 6f 72 79 20  61 6e 64 20 73 74 61 72  | memory and star|
00000d20  74 73 20 74 6f 20 70 6c  61 79 20 74 68 65 20 73  |ts to play the s|
00000d30  70 65 63 69 66 69 65 64  20 54 72 61 63 6b 65 72  |pecified Tracker|
00000d40  20 6f 72 0a 20 20 20 20  20 20 20 20 20 20 20 20  | or.            |
00000d50  20 20 20 53 6f 75 6e 64  74 72 61 63 6b 65 72 20  |   Soundtracker |
00000d60  6d 6f 64 75 6c 65 2c 20  64 65 74 65 72 6d 69 6e  |module, determin|
00000d70  69 6e 67 20 61 75 74 6f  6d 61 74 69 63 61 6c 6c  |ing automaticall|
00000d80  79 20 77 68 69 63 68 20  66 6f 72 6d 61 74 20 69  |y which format i|
00000d90  74 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |t.              |
00000da0  20 69 73 2e 0a 0a 20 20  20 20 20 20 20 20 20 20  | is...          |
00000db0  20 20 20 20 20 53 79 6e  74 61 78 3a 20 2a 50 6c  |     Syntax: *Pl|
00000dc0  61 79 4d 6f 64 20 3c 66  69 6c 65 6e 61 6d 65 3e  |ayMod <filename>|
00000dd0  0a 20 20 20 20 20 20 20  20 20 0a 0a 0a 0a 2a 50  |.         ....*P|
00000de0  6c 61 79 50 61 75 73 65  20 20 20 2d 20 57 69 6c  |layPause   - Wil|
00000df0  6c 20 70 61 75 73 65 20  74 68 65 20 63 75 72 72  |l pause the curr|
00000e00  65 6e 74 6c 79 20 70 6c  61 79 69 6e 67 20 74 75  |ently playing tu|
00000e10  6e 65 20 28 6b 69 6c 6c  73 20 61 6c 6c 20 73 6f  |ne (kills all so|
00000e20  75 6e 64 20 69 6d 6d 65  64 2d 0a 20 20 20 20 20  |und immed-.     |
00000e30  20 20 20 20 20 20 20 20  20 20 69 61 74 65 6c 79  |          iately|
00000e40  29 20 62 75 74 20 72 65  74 61 69 6e 73 20 74 68  |) but retains th|
00000e50  65 20 73 6f 75 6e 64 74  72 61 63 6b 65 72 2f 74  |e soundtracker/t|
00000e60  72 61 63 6b 65 72 20 6d  6f 64 75 6c 65 20 69 6e  |racker module in|
00000e70  20 6d 65 6d 6f 72 79 2e  0a 20 20 20 20 20 20 20  | memory..       |
00000e80  20 20 20 20 20 20 20 20  54 68 65 20 74 75 6e 65  |        The tune|
00000e90  20 63 61 6e 20 62 65 20  72 65 73 74 61 72 74 65  | can be restarte|
00000ea0  64 20 77 69 74 68 20 61  20 2a 50 6c 61 79 53 74  |d with a *PlaySt|
00000eb0  61 72 74 20 63 6f 6d 6d  61 6e 64 2e 0a 0a 20 20  |art command...  |
00000ec0  20 20 20 20 20 20 20 20  20 20 20 20 20 53 79 6e  |             Syn|
00000ed0  74 61 78 3a 20 2a 50 6c  61 79 50 61 75 73 65 0a  |tax: *PlayPause.|
00000ee0  0a 0a 0a 0a 2a 50 6c 61  79 53 74 61 72 74 20 20  |....*PlayStart  |
00000ef0  20 2d 20 57 69 6c 6c 20  72 65 73 75 6d 65 20 70  | - Will resume p|
00000f00  6c 61 79 69 6e 67 20 61  20 74 75 6e 65 20 61 66  |laying a tune af|
00000f10  74 65 72 20 61 20 2a 50  6c 61 79 50 61 75 73 65  |ter a *PlayPause|
00000f20  20 63 6f 6d 6d 61 6e 64  2e 0a 0a 20 20 20 20 20  | command...     |
00000f30  20 20 20 20 20 20 20 20  20 20 53 79 6e 74 61 78  |          Syntax|
00000f40  3a 20 2a 50 6c 61 79 53  74 61 72 74 0a 0a 20 0a  |: *PlayStart.. .|
00000f50  0a 0a 2a 50 6c 61 79 50  6f 73 20 20 20 20 20 2d  |..*PlayPos     -|
00000f60  20 57 69 6c 6c 20 73 65  74 20 74 68 65 20 63 75  | Will set the cu|
00000f70  72 72 65 6e 74 20 70 6f  73 69 74 69 6f 6e 20 69  |rrent position i|
00000f80  6e 20 74 68 65 20 73 65  71 75 65 6e 63 65 20 74  |n the sequence t|
00000f90  61 62 6c 65 2c 20 6f 72  20 69 66 20 6e 6f 0a 20  |able, or if no. |
00000fa0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 70 61  |              pa|
00000fb0  72 61 6d 65 74 65 72 20  69 73 20 67 69 76 65 6e  |rameter is given|
00000fc0  2c 20 77 69 6c 6c 20 73  69 6d 70 6c 79 20 72 65  |, will simply re|
00000fd0  74 75 72 6e 20 74 68 65  20 63 75 72 72 65 6e 74  |turn the current|
00000fe0  20 70 6f 73 69 74 69 6f  6e 2e 0a 0a 20 20 20 20  | position...    |
00000ff0  20 20 20 20 20 20 20 20  20 20 20 53 79 6e 74 61  |           Synta|
00001000  78 3a 20 2a 50 6c 61 79  50 6f 73 20 5b 3c 30 2d  |x: *PlayPos [<0-|
00001010  31 32 37 3e 5d 0a 0a 20  20 20 20 20 20 20 20 20  |127>]..         |
00001020  20 20 20 20 20 20 20 0a  0a 0a 2a 50 6c 61 79 53  |       ...*PlayS|
00001030  61 6d 70 6c 65 73 20 2d  20 57 69 6c 6c 20 6c 69  |amples - Will li|
00001040  73 74 20 61 6c 6c 20 74  68 65 20 73 61 6d 70 6c  |st all the sampl|
00001050  65 73 20 61 73 73 6f 63  69 61 74 65 64 20 77 69  |es associated wi|
00001060  74 68 20 74 68 65 20 63  75 72 72 65 6e 74 6c 79  |th the currently|
00001070  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00001080  69 6e 73 74 61 6c 6c 65  64 20 6d 75 73 69 63 20  |installed music |
00001090  6d 6f 64 75 6c 65 2e 20  0a 0a 20 20 20 20 20 20  |module. ..      |
000010a0  20 20 20 20 20 20 20 20  20 53 79 6e 74 61 78 3a  |         Syntax:|
000010b0  20 2a 50 6c 61 79 53 61  6d 70 6c 65 73 0a 0a 0a  | *PlaySamples...|
000010c0  0a 2a 50 6c 61 79 53 70  65 65 64 20 20 20 2d 20  |.*PlaySpeed   - |
000010d0  57 69 6c 6c 20 63 68 61  6e 67 65 20 74 68 65 20  |Will change the |
000010e0  73 61 6d 70 6c 65 20 70  6c 61 79 62 61 63 6b 20  |sample playback |
000010f0  72 61 74 65 20 61 6e 64  20 74 68 65 72 65 66 6f  |rate and therefo|
00001100  72 65 20 76 61 72 79 20  74 68 65 0a 20 20 20 20  |re vary the.    |
00001110  20 20 20 20 20 20 20 20  20 20 20 61 70 70 72 6f  |           appro|
00001120  78 69 6d 61 74 65 20 61  6d 6f 75 6e 74 20 6f 66  |ximate amount of|
00001130  20 43 50 55 20 74 69 6d  65 20 74 61 6b 65 6e 20  | CPU time taken |
00001140  75 70 20 62 79 20 74 68  65 20 70 6c 61 79 72 6f  |up by the playro|
00001150  75 74 69 6e 65 2e 0a 20  20 20 20 20 20 20 20 20  |utine..         |
00001160  20 20 20 20 20 20 43 75  72 72 65 6e 74 6c 79 2c  |      Currently,|
00001170  20 74 68 65 20 6f 6e 6c  79 20 66 6f 75 72 20 6f  | the only four o|
00001180  70 74 69 6f 6e 73 20 61  72 65 3a 0a 20 20 20 20  |ptions are:.    |
00001190  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000011a0  20 20 20 30 20 2d 20 6e  6f 72 6d 61 6c 20 73 61  |   0 - normal sa|
000011b0  6d 70 6c 65 20 72 61 74  65 0a 20 20 20 20 20 20  |mple rate.      |
000011c0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000011d0  20 31 20 2d 20 68 61 6c  66 20 73 61 6d 70 6c 65  | 1 - half sample|
000011e0  20 72 61 74 65 0a 20 20  20 20 20 20 20 20 20 20  | rate.          |
000011f0  20 20 20 20 20 20 20 20  20 20 20 20 20 32 20 2d  |             2 -|
00001200  20 6e 6f 72 6d 61 6c 20  73 61 6d 70 6c 65 20 72  | normal sample r|
00001210  61 74 65 20 28 66 6f 72  20 56 49 44 43 20 65 6e  |ate (for VIDC en|
00001220  68 61 6e 63 65 72 73 29  0a 20 20 20 20 20 20 20  |hancers).       |
00001230  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001240  33 20 2d 20 68 61 6c 66  20 73 61 6d 70 6c 65 20  |3 - half sample |
00001250  72 61 74 65 20 28 66 6f  72 20 56 49 44 43 20 65  |rate (for VIDC e|
00001260  6e 68 61 6e 63 65 72 73  29 0a 20 20 20 20 20 20  |nhancers).      |
00001270  20 20 20 20 20 20 20 20  20 49 66 20 6f 70 74 69  |         If opti|
00001280  6f 6e 20 31 20 6f 72 20  33 20 69 73 20 73 65 6c  |on 1 or 3 is sel|
00001290  65 63 74 65 64 2c 20 74  68 65 20 73 61 6d 70 6c  |ected, the sampl|
000012a0  65 20 71 75 61 6c 69 74  79 20 69 73 20 72 65 64  |e quality is red|
000012b0  75 63 65 64 2c 0a 20 20  20 20 20 20 20 20 20 20  |uced,.          |
000012c0  20 20 20 20 20 62 75 74  20 38 20 63 68 61 6e 6e  |     but 8 chann|
000012d0  65 6c 20 74 75 6e 65 73  20 77 69 6c 6c 20 74 61  |el tunes will ta|
000012e0  6b 65 20 75 70 20 6f 6e  6c 79 20 61 20 6c 69 74  |ke up only a lit|
000012f0  74 6c 65 20 6d 6f 72 65  20 74 69 6d 65 20 74 68  |tle more time th|
00001300  61 6e 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |an.             |
00001310  20 20 34 20 63 68 61 6e  6e 65 6c 20 74 75 6e 65  |  4 channel tune|
00001320  73 20 6f 72 69 67 69 6e  61 6c 6c 79 2e 0a 20 20  |s originally..  |
00001330  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 54  |               T|
00001340  68 65 20 66 75 6e 63 74  69 6f 6e 20 6f 66 20 2a  |he function of *|
00001350  50 6c 61 79 53 70 65 65  64 20 69 73 20 64 75 70  |PlaySpeed is dup|
00001360  6c 69 63 61 74 65 64 20  62 79 20 74 68 65 20 53  |licated by the S|
00001370  57 49 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |WI.             |
00001380  20 20 27 54 72 61 63 6b  65 72 5f 53 70 65 65 64  |  'Tracker_Speed|
00001390  27 20 28 73 65 65 20 6c  61 74 65 72 29 2e 0a 0a  |' (see later)...|
000013a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 53  |               S|
000013b0  79 6e 74 61 78 3a 20 2a  50 6c 61 79 53 70 65 65  |yntax: *PlaySpee|
000013c0  64 20 3c 30 7c 31 7c 32  7c 33 3e 0a 0a 0a 0a 0a  |d <0|1|2|3>.....|
000013d0  2a 50 6c 61 79 53 74 61  74 75 73 20 20 2d 20 57  |*PlayStatus  - W|
000013e0  69 6c 6c 20 70 72 69 6e  74 20 69 6e 66 6f 72 6d  |ill print inform|
000013f0  61 74 69 6f 6e 20 61 62  6f 75 74 20 74 68 65 20  |ation about the |
00001400  63 75 72 72 65 6e 74 20  74 75 6e 65 20 6d 6f 64  |current tune mod|
00001410  75 6c 65 20 6c 6f 61 64  65 64 0a 20 20 20 20 20  |ule loaded.     |
00001420  20 20 20 20 20 20 20 20  20 20 0a 20 20 20 20 20  |          .     |
00001430  20 20 20 20 20 20 20 20  20 20 53 79 6e 74 61 78  |          Syntax|
00001440  3a 20 2a 50 6c 61 79 53  74 61 74 75 73 0a 0a 0a  |: *PlayStatus...|
00001450  0a 0a 2a 50 6c 61 79 53  74 65 72 65 6f 20 20 2d  |..*PlayStereo  -|
00001460  20 43 6f 6e 74 72 6f 6c  73 20 74 68 65 20 73 74  | Controls the st|
00001470  65 72 65 6f 20 73 65 74  74 69 6e 67 73 20 77 68  |ereo settings wh|
00001480  69 6c 65 20 74 68 65 20  6f 6c 64 65 72 20 66 6f  |ile the older fo|
00001490  72 6d 61 74 20 73 6f 75  6e 64 2d 0a 20 20 20 20  |rmat sound-.    |
000014a0  20 20 20 20 20 20 20 20  20 20 20 74 72 61 63 6b  |           track|
000014b0  65 72 20 6d 6f 64 75 6c  65 73 20 61 72 65 20 70  |er modules are p|
000014c0  6c 61 79 69 6e 67 20 28  74 68 65 20 73 74 65 72  |laying (the ster|
000014d0  65 6f 20 69 73 20 66 69  78 65 64 20 6f 6e 20 61  |eo is fixed on a|
000014e0  6e 20 41 6d 69 67 61 29  2c 0a 20 20 20 20 20 20  |n Amiga),.      |
000014f0  20 20 20 20 20 20 20 20  20 61 6e 64 20 77 69 6c  |         and wil|
00001500  6c 20 73 77 69 74 63 68  20 62 65 74 77 65 65 6e  |l switch between|
00001510  20 66 69 76 65 20 70 6f  73 73 69 62 6c 65 20 73  | five possible s|
00001520  65 74 74 69 6e 67 73 20  74 6f 20 63 61 74 65 72  |ettings to cater|
00001530  20 66 6f 72 0a 20 20 20  20 20 20 20 20 20 20 20  | for.           |
00001540  20 20 20 20 6d 6f 73 74  20 63 6f 6e 66 69 67 75  |    most configu|
00001550  72 61 74 69 6f 6e 73 3a  0a 20 20 20 20 20 20 20  |rations:.       |
00001560  20 20 20 20 20 20 20 20  20 20 20 20 30 20 2d 20  |            0 - |
00001570  53 6c 69 67 68 74 6c 79  20 6f 66 66 2d 63 65 6e  |Slightly off-cen|
00001580  74 72 65 20 6c 65 66 74  20 61 6e 64 20 72 69 67  |tre left and rig|
00001590  68 74 20 28 6e 6f 72 6d  61 6c 29 0a 20 20 20 20  |ht (normal).    |
000015a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 31  |               1|
000015b0  20 2d 20 46 75 6c 6c 79  20 6c 65 66 74 20 61 6e  | - Fully left an|
000015c0  64 20 72 69 67 68 74 20  28 61 6d 69 67 61 2d 73  |d right (amiga-s|
000015d0  74 79 6c 65 29 0a 20 20  20 20 20 20 20 20 20 20  |tyle).          |
000015e0  20 20 20 20 20 20 20 20  20 32 20 2d 20 46 75 6c  |         2 - Ful|
000015f0  6c 79 20 6c 65 66 74 0a  20 20 20 20 20 20 20 20  |ly left.        |
00001600  20 20 20 20 20 20 20 20  20 20 20 33 20 2d 20 46  |           3 - F|
00001610  75 6c 6c 79 20 72 69 67  68 74 0a 20 20 20 20 20  |ully right.     |
00001620  20 20 20 20 20 20 20 20  20 20 20 20 20 20 34 20  |              4 |
00001630  2d 20 44 6f 6e 27 74 20  61 6c 74 65 72 20 73 74  |- Don't alter st|
00001640  65 72 65 6f 20 73 65 74  74 69 6e 67 73 0a 20 20  |ereo settings.  |
00001650  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001660  20 20 20 20 20 20 20 20  28 6e 6f 72 6d 61 6c 6c  |        (normall|
00001670  79 20 61 6c 74 65 72 73  20 73 65 74 74 69 6e 67  |y alters setting|
00001680  73 20 77 68 65 6e 20 61  20 74 75 6e 65 20 69 73  |s when a tune is|
00001690  20 6c 6f 61 64 65 64 20  20 20 20 20 20 20 20 20  | loaded         |
000016a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000016b0  20 20 20 20 20 20 61 6e  64 20 77 68 65 6e 20 69  |      and when i|
000016c0  74 20 70 6c 61 79 73 20  61 20 74 72 61 63 6b 65  |t plays a tracke|
000016d0  72 20 73 74 65 72 65 6f  20 63 6f 6d 6d 61 6e 64  |r stereo command|
000016e0  20 2d 20 73 65 65 0a 20  20 20 20 20 20 20 20 20  | - see.         |
000016f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001700  20 20 53 57 49 20 54 72  61 63 6b 65 72 5f 53 74  |  SWI Tracker_St|
00001710  65 72 65 6f 29 0a 0a 20  20 20 20 20 20 20 20 20  |ereo)..         |
00001720  20 20 20 20 20 20 53 79  6e 74 61 78 3a 20 2a 50  |      Syntax: *P|
00001730  6c 61 79 53 74 65 72 65  6f 20 3c 30 7c 31 7c 32  |layStereo <0|1|2|
00001740  7c 33 3e 0a 0a 0a 0a 0a  2a 50 6c 61 79 53 74 6f  ||3>.....*PlaySto|
00001750  70 20 20 20 20 2d 20 57  69 6c 6c 20 73 74 6f 70  |p    - Will stop|
00001760  20 61 6e 64 20 6b 69 6c  6c 20 74 68 65 20 63 75  | and kill the cu|
00001770  72 72 65 6e 74 6c 79 20  70 6c 61 79 69 6e 67 20  |rrently playing |
00001780  74 75 6e 65 20 6d 6f 64  75 6c 65 2c 0a 20 20 20  |tune module,.   |
00001790  20 20 20 20 20 20 20 20  20 20 20 20 72 65 6d 6f  |            remo|
000017a0  76 69 6e 67 20 69 74 20  66 72 6f 6d 20 6d 65 6d  |ving it from mem|
000017b0  6f 72 79 2e 0a 0a 20 20  20 20 20 20 20 20 20 20  |ory...          |
000017c0  20 20 20 20 20 53 79 6e  74 61 78 3a 20 2a 50 6c  |     Syntax: *Pl|
000017d0  61 79 53 74 6f 70 0a 0a  0a 20 20 20 20 20 20 20  |ayStop...       |
000017e0  20 20 20 20 20 20 20 20  0a 0a 2a 50 6c 61 79 56  |        ..*PlayV|
000017f0  6f 6c 75 6d 65 20 20 2d  20 43 68 61 6e 67 65 73  |olume  - Changes|
00001800  20 74 68 65 20 6f 76 65  72 61 6c 6c 20 6c 6f 75  | the overall lou|
00001810  64 6e 65 73 73 20 6f 66  20 61 6e 79 20 74 75 6e  |dness of any tun|
00001820  65 73 20 70 6c 61 79 69  6e 67 2e 20 54 68 65 20  |es playing. The |
00001830  73 63 61 6c 65 0a 20 20  20 20 20 20 20 20 20 20  |scale.          |
00001840  20 20 20 20 20 69 73 20  6c 6f 67 61 72 69 74 68  |     is logarith|
00001850  6d 69 63 20 61 6e 64 20  67 6f 65 73 20 66 72 6f  |mic and goes fro|
00001860  6d 20 31 20 28 73 69 6c  65 6e 74 29 20 74 6f 20  |m 1 (silent) to |
00001870  31 32 37 20 28 66 75 6c  6c 20 76 6f 6c 75 6d 65  |127 (full volume|
00001880  29 2e 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |)..             |
00001890  20 20 2a 50 6c 61 79 56  6f 6c 75 6d 65 20 77 69  |  *PlayVolume wi|
000018a0  74 68 20 6e 6f 20 70 61  72 61 6d 65 74 65 72 73  |th no parameters|
000018b0  20 64 69 73 70 6c 61 79  73 20 74 68 65 20 63 75  | displays the cu|
000018c0  72 72 65 6e 74 20 76 6f  6c 75 6d 65 2e 0a 0a 20  |rrent volume... |
000018d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 53 79  |              Sy|
000018e0  6e 74 61 78 3a 20 2a 50  6c 61 79 56 6f 6c 75 6d  |ntax: *PlayVolum|
000018f0  65 20 5b 3c 30 2d 31 32  37 3e 5d 0a 0a 0a 0a 0a  |e [<0-127>].....|
00001900  0a 53 57 49 20 43 4f 4d  4d 41 4e 44 53 0a 2d 2d  |.SWI COMMANDS.--|
00001910  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 0a 53 65 76 65 72  |----------.Sever|
00001920  61 6c 20 53 57 49 20 63  6f 6d 6d 61 6e 64 73 20  |al SWI commands |
00001930  68 61 76 65 20 62 65 65  6e 20 61 64 64 65 64 20  |have been added |
00001940  74 6f 20 74 68 65 20 6d  6f 64 75 6c 65 20 69 6e  |to the module in|
00001950  20 6f 72 64 65 72 20 74  6f 20 73 69 6d 70 6c 69  | order to simpli|
00001960  66 79 20 74 68 65 0a 74  61 73 6b 20 6f 66 20 61  |fy the.task of a|
00001970  64 64 69 6e 67 20 73 6f  75 6e 64 74 72 61 63 6b  |dding soundtrack|
00001980  65 72 2f 74 72 61 63 6b  65 72 20 6d 75 73 69 63  |er/tracker music|
00001990  20 74 6f 20 79 6f 75 72  20 64 65 6d 6f 73 20 65  | to your demos e|
000019a0  74 63 2e 20 28 65 73 70  65 63 69 61 6c 6c 79 0a  |tc. (especially.|
000019b0  6d 75 6c 74 69 2d 74 61  73 6b 69 6e 67 20 73 69  |multi-tasking si|
000019c0  74 75 61 74 69 6f 6e 73  29 2e 20 54 68 65 73 65  |tuations). These|
000019d0  20 70 72 6f 76 69 64 65  20 61 6c 6c 20 6f 66 20  | provide all of |
000019e0  74 68 65 20 66 61 63 69  6c 69 74 69 65 73 20 6f  |the facilities o|
000019f0  66 66 65 72 65 64 20 62  79 0a 74 68 65 20 76 61  |ffered by.the va|
00001a00  72 69 6f 75 73 20 2a 20  63 6f 6d 6d 61 6e 64 73  |rious * commands|
00001a10  2c 20 62 75 74 20 61 6c  73 6f 20 61 6c 6c 6f 77  |, but also allow|
00001a20  20 61 20 6d 6f 72 65 20  64 65 74 61 69 6c 65 64  | a more detailed|
00001a30  20 63 6f 6e 74 72 6f 6c  20 6f 66 20 73 6f 6d 65  | control of some|
00001a40  20 6f 66 20 74 68 65 0a  6d 6f 64 75 6c 65 27 73  | of the.module's|
00001a50  20 66 65 61 74 75 72 65  73 2e 0a 41 6c 6c 20 74  | features..All t|
00001a60  68 65 20 53 57 49 27 73  20 72 65 6d 61 69 6e 20  |he SWI's remain |
00001a70  69 6e 20 53 56 43 20 6d  6f 64 65 2c 20 61 6e 64  |in SVC mode, and|
00001a80  20 64 6f 20 6e 6f 74 20  61 6c 74 65 72 20 74 68  | do not alter th|
00001a90  65 20 69 6e 74 65 72 72  75 70 74 20 73 74 61 74  |e interrupt stat|
00001aa0  75 73 2e 0a 49 20 74 68  69 6e 6b 20 6d 6f 73 74  |us..I think most|
00001ab0  20 61 72 65 20 72 65 2d  65 6e 74 72 61 6e 74 2c  | are re-entrant,|
00001ac0  20 65 78 63 65 70 74 20  74 68 6f 73 65 20 77 68  | except those wh|
00001ad0  69 63 68 20 75 73 65 20  73 79 73 74 65 6d 20 53  |ich use system S|
00001ae0  57 49 27 73 20 28 6c 6f  61 64 2c 20 70 6c 61 79  |WI's (load, play|
00001af0  2c 0a 73 74 6f 70 20 65  74 63 2e 29 2c 20 73 6f  |,.stop etc.), so|
00001b00  20 61 76 6f 69 64 20 63  61 6c 6c 69 6e 67 20 74  | avoid calling t|
00001b10  68 65 6d 20 66 72 6f 6d  20 69 6e 74 65 72 72 75  |hem from interru|
00001b20  70 74 73 20 69 66 20 79  6f 75 20 63 61 6e 20 61  |pts if you can a|
00001b30  76 6f 69 64 20 69 74 2e  0a 0a 54 68 65 20 53 57  |void it...The SW|
00001b40  49 20 63 68 75 6e 6b 20  6e 75 6d 62 65 72 20 67  |I chunk number g|
00001b50  69 76 65 6e 20 68 65 72  65 20 28 26 34 33 32 30  |iven here (&4320|
00001b60  30 29 20 69 73 20 61 6e  20 6f 66 66 69 63 69 61  |0) is an officia|
00001b70  6c 6c 79 20 72 65 63 6f  67 6e 69 73 65 64 20 63  |lly recognised c|
00001b80  68 75 6e 6b 0a 6e 75 6d  62 65 72 20 69 73 73 75  |hunk.number issu|
00001b90  65 64 20 62 79 20 41 63  6f 72 6e 2e 0a 0a 0a 2d  |ed by Acorn....-|
00001ba0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00001be0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 0a 54 72 61  |------------.Tra|
00001bf0  63 6b 65 72 5f 56 65 72  73 69 6f 6e 20 20 20 20  |cker_Version    |
00001c00  20 20 20 20 28 53 57 49  20 26 34 33 32 30 30 29  |    (SWI &43200)|
00001c10  0a 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
00001c20  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00001c50  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 0a 0a  |--------------..|
00001c60  4f 6e 20 45 6e 74 72 79  3a 20 20 2d 0a 0a 4f 6e  |On Entry:  -..On|
00001c70  20 45 78 69 74 20 3a 20  20 52 30 20 3d 20 76 65  | Exit :  R0 = ve|
00001c80  72 73 69 6f 6e 20 6e 75  6d 62 65 72 2a 31 30 30  |rsion number*100|
00001c90  20 20 28 69 65 2e 20 66  6f 72 20 56 31 2e 32 33  |  (ie. for V1.23|
00001ca0  20 3d 20 31 32 33 29 0a  0a 55 73 65 20 74 68 69  | = 123)..Use thi|
00001cb0  73 20 63 61 6c 6c 20 74  6f 20 65 6e 73 75 72 65  |s call to ensure|
00001cc0  20 74 68 61 74 20 74 68  65 20 74 72 61 63 6b 65  | that the tracke|
00001cd0  72 6d 6f 64 75 6c 65 20  69 6e 73 74 61 6c 6c 65  |rmodule installe|
00001ce0  64 20 69 73 20 61 20 72  65 63 65 6e 74 20 65 6e  |d is a recent en|
00001cf0  6f 75 67 68 0a 76 65 72  73 69 6f 6e 20 74 6f 20  |ough.version to |
00001d00  73 75 70 70 6f 72 74 20  74 68 65 20 53 57 49 27  |support the SWI'|
00001d10  73 20 79 6f 75 20 77 69  73 68 20 74 6f 20 75 73  |s you wish to us|
00001d20  65 2e 20 56 65 72 73 69  6f 6e 73 20 34 2e 30 30  |e. Versions 4.00|
00001d30  20 6f 6e 77 61 72 64 73  20 69 6e 63 6f 72 70 6f  | onwards incorpo|
00001d40  72 2d 0a 61 74 65 20 74  68 65 20 53 57 49 27 73  |r-.ate the SWI's|
00001d50  2e 0a 0a 0a 0a 0a 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |......----------|
00001d60  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00001da0  2d 2d 2d 0a 54 72 61 63  6b 65 72 5f 4c 6f 61 64  |---.Tracker_Load|
00001db0  20 20 20 20 20 20 20 20  20 20 20 28 53 57 49 20  |           (SWI |
00001dc0  26 34 33 32 30 31 29 0a  2d 2d 2d 2d 2d 2d 2d 2d  |&43201).--------|
00001dd0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00001e10  2d 2d 2d 2d 2d 0a 0a 4f  6e 20 45 6e 74 72 79 3a  |-----..On Entry:|
00001e20  20 20 52 30 20 3d 20 70  6f 69 6e 74 65 72 20 74  |  R0 = pointer t|
00001e30  6f 20 66 69 6c 65 6e 61  6d 65 20 6f 66 20 73 6f  |o filename of so|
00001e40  75 6e 64 74 72 61 63 6b  65 72 2f 74 72 61 63 6b  |undtracker/track|
00001e50  65 72 20 6d 6f 64 75 6c  65 0a 0a 4f 6e 20 45 78  |er module..On Ex|
00001e60  69 74 20 3a 20 20 52 30  20 70 72 65 73 65 72 76  |it :  R0 preserv|
00001e70  65 64 0a 0a 54 68 69 73  20 63 61 6c 6c 20 77 69  |ed..This call wi|
00001e80  6c 6c 20 63 6c 61 69 6d  20 6d 65 6d 6f 72 79 20  |ll claim memory |
00001e90  66 72 6f 6d 20 74 68 65  20 52 4d 41 20 61 6e 64  |from the RMA and|
00001ea0  20 6c 6f 61 64 20 74 68  65 20 73 70 65 63 69 66  | load the specif|
00001eb0  69 65 64 20 74 75 6e 65  20 6d 6f 64 75 6c 65 2c  |ied tune module,|
00001ec0  0a 69 6e 69 74 69 61 6c  69 73 65 20 74 68 65 20  |.initialise the |
00001ed0  73 6f 75 6e 64 20 73 79  73 74 65 6d 2c 20 61 6e  |sound system, an|
00001ee0  64 20 73 65 74 20 74 68  65 20 70 6c 61 79 72 6f  |d set the playro|
00001ef0  75 74 69 6e 65 20 69 6e  20 70 61 75 73 65 20 6d  |utine in pause m|
00001f00  6f 64 65 2e 0a 59 6f 75  20 6d 75 73 74 20 74 68  |ode..You must th|
00001f10  65 6e 20 75 73 65 20 74  68 65 20 53 57 49 20 54  |en use the SWI T|
00001f20  72 61 63 6b 65 72 5f 50  6c 61 79 20 74 6f 20 73  |racker_Play to s|
00001f30  74 61 72 74 20 74 68 65  20 74 75 6e 65 20 70 6c  |tart the tune pl|
00001f40  61 79 69 6e 67 2e 0a 54  68 65 20 63 6f 6d 6d 61  |aying..The comma|
00001f50  6e 64 20 2a 50 6c 61 79  4d 6f 64 20 63 61 6c 6c  |nd *PlayMod call|
00001f60  73 20 74 68 69 73 20 72  6f 75 74 69 6e 65 2c 20  |s this routine, |
00001f70  61 6e 64 20 74 68 65 6e  20 74 68 65 20 53 57 49  |and then the SWI|
00001f80  20 54 72 61 63 6b 65 72  5f 50 6c 61 79 2e 0a 0a  | Tracker_Play...|
00001f90  41 6e 20 65 72 72 6f 72  20 77 69 6c 6c 20 62 65  |An error will be|
00001fa0  20 67 65 6e 65 72 61 74  65 64 20 69 66 20 74 68  | generated if th|
00001fb0  65 20 6d 6f 64 75 6c 65  20 63 61 6e 6e 6f 74 20  |e module cannot |
00001fc0  62 65 20 6c 6f 61 64 65  64 20 6f 72 20 6e 6f 74  |be loaded or not|
00001fd0  20 65 6e 6f 75 67 68 0a  6d 65 6d 6f 72 79 20 63  | enough.memory c|
00001fe0  61 6e 20 62 65 20 63 6c  61 69 6d 65 64 2e 0a 0a  |an be claimed...|
00001ff0  0a 0a 0a 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |...-------------|
00002000  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00002040  0a 54 72 61 63 6b 65 72  5f 4d 65 6d 6f 72 79 4c  |.Tracker_MemoryL|
00002050  6f 61 64 20 20 20 20 20  28 53 57 49 20 26 34 33  |oad     (SWI &43|
00002060  32 30 32 29 0a 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |202).-----------|
00002070  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000020b0  2d 2d 0a 0a 4f 6e 20 45  6e 74 72 79 3a 20 20 52  |--..On Entry:  R|
000020c0  30 20 3d 20 70 6f 69 6e  74 65 72 20 74 6f 20 66  |0 = pointer to f|
000020d0  69 72 73 74 20 77 6f 72  64 20 6f 66 20 73 6f 75  |irst word of sou|
000020e0  6e 64 74 72 61 63 6b 65  72 2f 74 72 61 63 6b 65  |ndtracker/tracke|
000020f0  72 20 6d 6f 64 75 6c 65  20 69 6e 0a 20 20 20 20  |r module in.    |
00002100  20 20 20 20 20 20 20 20  20 20 20 20 6d 65 6d 6f  |            memo|
00002110  72 79 20 28 4e 42 20 6d  75 73 74 20 62 65 20 77  |ry (NB must be w|
00002120  6f 72 64 2d 61 6c 69 67  6e 65 64 29 0a 20 20 20  |ord-aligned).   |
00002130  20 20 20 20 20 20 20 20  52 31 20 3d 20 6c 65 6e  |        R1 = len|
00002140  67 74 68 20 6f 66 20 6d  6f 64 75 6c 65 20 69 6e  |gth of module in|
00002150  20 62 79 74 65 73 0a 0a  4f 6e 20 45 78 69 74 20  | bytes..On Exit |
00002160  3a 20 20 52 30 20 61 6e  64 20 52 31 20 70 72 65  |:  R0 and R1 pre|
00002170  73 65 72 76 65 64 0a 0a  54 68 69 73 20 63 61 6c  |served..This cal|
00002180  6c 20 63 61 6e 20 62 65  20 75 73 65 64 20 62 79  |l can be used by|
00002190  20 61 20 6e 6f 6e 2d 6d  75 6c 74 69 74 61 73 6b  | a non-multitask|
000021a0  69 6e 67 20 61 70 70 6c  69 63 61 74 69 6f 6e 20  |ing application |
000021b0  74 6f 20 73 70 65 63 69  66 79 20 61 6e 20 61 72  |to specify an ar|
000021c0  65 61 0a 6f 66 20 6d 65  6d 6f 72 79 20 61 73 20  |ea.of memory as |
000021d0  61 20 74 75 6e 65 20 6d  6f 64 75 6c 65 2c 20 61  |a tune module, a|
000021e0  6e 64 20 74 68 65 72 65  62 79 20 72 65 6d 6f 76  |nd thereby remov|
000021f0  65 20 74 68 65 20 6e 65  65 64 20 66 6f 72 20 61  |e the need for a|
00002200  20 73 65 70 65 72 61 74  65 20 66 69 6c 65 0a 74  | seperate file.t|
00002210  6f 20 68 6f 6c 64 20 61  20 74 75 6e 65 2c 20 61  |o hold a tune, a|
00002220  6e 64 20 74 68 65 72 65  20 69 73 20 6e 6f 20 6e  |nd there is no n|
00002230  65 65 64 20 74 6f 20 63  6c 61 69 6d 20 61 20 6c  |eed to claim a l|
00002240  61 72 67 65 20 61 6d 6f  75 6e 74 20 6f 66 20 52  |arge amount of R|
00002250  4d 41 20 73 70 61 63 65  2e 0a 4f 6e 63 65 20 74  |MA space..Once t|
00002260  68 69 73 20 53 57 49 20  69 73 20 63 61 6c 6c 65  |his SWI is calle|
00002270  64 2c 20 74 68 65 20 6d  6f 64 75 6c 65 20 77 69  |d, the module wi|
00002280  6c 6c 20 62 65 20 74 72  65 61 74 65 64 20 61 73  |ll be treated as|
00002290  20 69 66 20 69 74 20 77  61 73 20 6c 6f 61 64 65  | if it was loade|
000022a0  64 20 69 6e 0a 74 68 65  20 6d 6f 64 75 6c 65 27  |d in.the module'|
000022b0  73 20 6f 77 6e 20 77 6f  72 6b 73 70 61 63 65 2e  |s own workspace.|
000022c0  0a 20 49 6d 70 6f 72 74  61 6e 74 3a 20 59 6f 75  |. Important: You|
000022d0  20 6d 75 73 74 20 74 65  6c 6c 20 74 68 65 20 74  | must tell the t|
000022e0  72 61 63 6b 65 72 6d 6f  64 75 6c 65 20 74 6f 20  |rackermodule to |
000022f0  66 6f 72 67 65 74 20 74  68 65 20 6d 6f 64 75 6c  |forget the modul|
00002300  65 20 69 66 20 74 68 65  0a 6d 65 6d 6f 72 79 20  |e if the.memory |
00002310  77 69 6c 6c 20 62 65 20  6f 76 65 72 77 72 69 74  |will be overwrit|
00002320  74 65 6e 2c 20 6f 74 68  65 72 77 69 73 65 20 74  |ten, otherwise t|
00002330  68 65 20 6d 6f 64 75 6c  65 20 6d 61 79 20 63 72  |he module may cr|
00002340  61 73 68 2e 0a 28 2a 50  6c 61 79 53 74 6f 70 20  |ash..(*PlayStop |
00002350  6f 72 20 54 72 61 63 6b  65 72 5f 53 74 6f 70 20  |or Tracker_Stop |
00002360  53 57 49 29 0a 0a 4e 42  20 54 68 69 73 20 63 61  |SWI)..NB This ca|
00002370  6c 6c 20 77 69 6c 6c 20  6e 6f 74 20 77 6f 72 6b  |ll will not work|
00002380  20 66 6f 72 20 70 72 6f  67 72 61 6d 73 20 72 75  | for programs ru|
00002390  6e 6e 69 6e 67 20 75 6e  64 65 72 20 74 68 65 20  |nning under the |
000023a0  64 65 73 6b 74 6f 70 20  69 66 20 74 68 65 0a 20  |desktop if the. |
000023b0  20 20 6d 6f 64 75 6c 65  20 69 73 20 6c 6f 61 64  |  module is load|
000023c0  65 64 20 69 6e 20 75 73  65 72 20 6d 65 6d 6f 72  |ed in user memor|
000023d0  79 2e 0a 0a 20 20 20 57  68 65 6e 20 61 20 73 6f  |y...   When a so|
000023e0  75 6e 64 74 72 61 63 6b  65 72 20 6d 6f 64 75 6c  |undtracker modul|
000023f0  65 20 69 73 20 6c 6f 61  64 65 64 2c 20 74 68 65  |e is loaded, the|
00002400  20 70 61 74 74 65 72 6e  20 64 61 74 61 20 69 73  | pattern data is|
00002410  20 63 6f 6e 76 65 72 74  65 64 20 74 6f 0a 20 20  | converted to.  |
00002420  20 54 72 61 63 6b 65 72  20 66 6f 72 6d 61 74 20  | Tracker format |
00002430  64 61 74 61 20 28 65 78  63 65 70 74 20 66 6f 72  |data (except for|
00002440  20 76 6f 6c 75 6d 65 73  20 77 68 69 63 68 20 72  | volumes which r|
00002450  65 6d 61 69 6e 20 30 2d  36 34 29 2c 20 73 6f 20  |emain 0-64), so |
00002460  0a 20 20 20 66 6f 72 20  74 68 65 20 70 75 72 70  |.   for the purp|
00002470  6f 73 65 73 20 6f 66 20  65 64 69 74 69 6e 67 2c  |oses of editing,|
00002480  20 61 73 20 6c 6f 6e 67  20 61 73 20 54 72 61 63  | as long as Trac|
00002490  6b 65 72 5f 52 65 61 64  2f 57 72 69 74 65 53 61  |ker_Read/WriteSa|
000024a0  6d 70 6c 65 54 61 62 6c  65 20 61 72 65 0a 20 20  |mpleTable are.  |
000024b0  20 75 73 65 64 2c 20 74  68 65 20 6d 6f 64 75 6c  | used, the modul|
000024c0  65 20 63 61 6e 20 62 65  20 63 6f 6e 73 69 64 65  |e can be conside|
000024d0  72 65 64 20 61 73 20 61  20 54 72 61 63 6b 65 72  |red as a Tracker|
000024e0  20 6d 6f 64 75 6c 65 2e  20 57 68 65 6e 20 53 57  | module. When SW|
000024f0  49 0a 20 20 20 54 72 61  63 6b 65 72 5f 53 74 6f  |I.   Tracker_Sto|
00002500  70 2f 2a 50 6c 61 79 53  74 6f 70 20 69 73 20 63  |p/*PlayStop is c|
00002510  61 6c 6c 65 64 2c 20 74  68 65 20 64 61 74 61 20  |alled, the data |
00002520  69 73 20 63 6f 6e 76 65  72 74 65 64 20 62 61 63  |is converted bac|
00002530  6b 2e 0a 0a 0a 0a 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |k.....----------|
00002540  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00002580  2d 2d 2d 0a 54 72 61 63  6b 65 72 5f 50 6c 61 79  |---.Tracker_Play|
00002590  20 20 20 20 20 20 20 20  20 20 20 28 53 57 49 20  |           (SWI |
000025a0  26 34 33 32 30 33 29 0a  2d 2d 2d 2d 2d 2d 2d 2d  |&43203).--------|
000025b0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000025f0  2d 2d 2d 2d 2d 0a 0a 4f  6e 20 45 6e 74 72 79 3a  |-----..On Entry:|
00002600  20 20 2d 0a 0a 4f 6e 20  45 78 69 74 20 3a 20 20  |  -..On Exit :  |
00002610  2d 0a 0a 54 68 69 73 20  63 61 6c 6c 20 77 69 6c  |-..This call wil|
00002620  6c 20 72 65 73 74 61 72  74 20 61 20 74 75 6e 65  |l restart a tune|
00002630  20 61 66 74 65 72 20 69  74 20 68 61 73 20 62 65  | after it has be|
00002640  65 6e 20 70 61 75 73 65  64 20 6f 72 20 6c 6f 61  |en paused or loa|
00002650  64 65 64 20 77 69 74 68  20 74 68 65 0a 54 72 61  |ded with the.Tra|
00002660  63 6b 65 72 5f 4c 6f 61  64 20 53 57 49 2e 0a 0a  |cker_Load SWI...|
00002670  0a 0a 0a 0a 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |....------------|
00002680  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000026c0  2d 0a 54 72 61 63 6b 65  72 5f 53 74 6f 70 20 20  |-.Tracker_Stop  |
000026d0  20 20 20 20 20 20 20 20  20 28 53 57 49 20 26 34  |         (SWI &4|
000026e0  33 32 30 34 29 0a 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |3204).----------|
000026f0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00002730  2d 2d 2d 0a 0a 4f 6e 20  45 6e 74 72 79 3a 20 20  |---..On Entry:  |
00002740  2d 0a 0a 4f 6e 20 45 78  69 74 20 3a 20 20 2d 0a  |-..On Exit :  -.|
00002750  0a 54 68 69 73 20 70 65  72 66 6f 72 6d 73 20 74  |.This performs t|
00002760  68 65 20 73 61 6d 65 20  61 63 74 69 6f 6e 73 20  |he same actions |
00002770  61 73 20 2a 50 6c 61 79  53 74 6f 70 0a 55 73 69  |as *PlayStop.Usi|
00002780  6e 67 20 2a 50 6c 61 79  53 74 6f 70 20 6f 72 20  |ng *PlayStop or |
00002790  74 68 69 73 20 53 57 49  20 69 73 20 74 68 65 20  |this SWI is the |
000027a0  6f 6e 6c 79 20 77 61 79  20 74 6f 20 67 65 74 20  |only way to get |
000027b0  74 68 65 20 74 72 61 63  6b 65 72 6d 6f 64 75 6c  |the trackermodul|
000027c0  65 20 74 6f 0a 72 65 6c  65 61 73 65 20 74 68 65  |e to.release the|
000027d0  20 6d 65 6d 6f 72 79 20  74 61 6b 65 6e 20 75 70  | memory taken up|
000027e0  20 62 79 20 74 68 65 20  74 75 6e 65 20 6d 6f 64  | by the tune mod|
000027f0  75 6c 65 2c 20 6f 72 20  74 6f 20 66 6f 72 63 65  |ule, or to force|
00002800  20 69 74 20 74 6f 20 66  6f 72 67 65 74 20 74 68  | it to forget th|
00002810  65 0a 61 64 64 72 65 73  73 20 6f 66 20 61 20 6d  |e.address of a m|
00002820  6f 64 75 6c 65 20 69 66  20 69 74 20 68 61 73 20  |odule if it has |
00002830  62 65 65 6e 20 6c 6f 61  64 65 64 20 77 69 74 68  |been loaded with|
00002840  20 74 68 65 20 27 54 72  61 63 6b 65 72 5f 4d 65  | the 'Tracker_Me|
00002850  6d 6f 72 79 4c 6f 61 64  27 20 53 57 49 2e 0a 49  |moryLoad' SWI..I|
00002860  66 20 74 68 65 20 6d 6f  64 75 6c 65 20 69 73 20  |f the module is |
00002870  73 6f 75 6e 64 74 72 61  63 6b 65 72 20 61 6e 64  |soundtracker and|
00002880  20 68 61 73 20 62 65 65  6e 20 6c 6f 61 64 65 64  | has been loaded|
00002890  20 77 69 74 68 20 54 72  61 63 6b 65 72 5f 4d 65  | with Tracker_Me|
000028a0  6d 6f 72 79 4c 6f 61 64  2c 0a 63 61 6c 6c 69 6e  |moryLoad,.callin|
000028b0  67 20 74 68 69 73 20 53  57 49 20 6f 72 20 2a 50  |g this SWI or *P|
000028c0  6c 61 79 53 74 6f 70 20  77 69 6c 6c 20 63 6f 6e  |layStop will con|
000028d0  76 65 72 74 20 74 68 65  20 64 61 74 61 20 62 61  |vert the data ba|
000028e0  63 6b 20 74 6f 20 74 68  65 20 6f 72 69 67 69 6e  |ck to the origin|
000028f0  61 6c 0a 66 6f 72 6d 61  74 2e 0a 0a 0a 0a 2d 2d  |al.format.....--|
00002900  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00002940  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 0a 54 72 61 63  |-----------.Trac|
00002950  6b 65 72 5f 50 61 75 73  65 20 20 20 20 20 20 20  |ker_Pause       |
00002960  20 20 20 28 53 57 49 20  26 34 33 32 30 35 29 0a  |   (SWI &43205).|
00002970  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000029b0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 0a 0a 4f  |-------------..O|
000029c0  6e 20 45 6e 74 72 79 3a  20 20 2d 0a 0a 4f 6e 20  |n Entry:  -..On |
000029d0  45 78 69 74 20 3a 20 20  2d 0a 0a 54 68 69 73 20  |Exit :  -..This |
000029e0  70 65 72 66 6f 72 6d 73  20 74 68 65 20 73 61 6d  |performs the sam|
000029f0  65 20 61 63 74 69 6f 6e  73 20 61 73 20 2a 50 6c  |e actions as *Pl|
00002a00  61 79 50 61 75 73 65 0a  0a 0a 0a 0a 0a 2d 2d 2d  |ayPause......---|
00002a10  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00002a50  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 0a 54 72 61 63 6b  |----------.Track|
00002a60  65 72 5f 53 74 65 72 65  6f 20 20 20 20 20 20 20  |er_Stereo       |
00002a70  20 20 28 53 57 49 20 26  34 33 32 30 36 29 0a 2d  |  (SWI &43206).-|
00002a80  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00002ac0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 0a 0a 4f 6e  |------------..On|
00002ad0  20 45 6e 74 72 79 3a 20  20 52 30 20 3d 20 53 74  | Entry:  R0 = St|
00002ae0  65 72 65 6f 20 73 65 74  74 69 6e 67 20 28 30 2d  |ereo setting (0-|
00002af0  34 29 20 6f 72 20 2d 31  20 74 6f 20 72 65 61 64  |4) or -1 to read|
00002b00  20 63 75 72 72 65 6e 74  20 73 65 74 74 69 6e 67  | current setting|
00002b10  0a 0a 4f 6e 20 45 78 69  74 20 3a 20 20 49 66 20  |..On Exit :  If |
00002b20  52 30 3e 3d 30 20 6f 6e  20 65 6e 74 72 79 3a 20  |R0>=0 on entry: |
00002b30  52 30 20 70 72 65 73 65  72 76 65 64 0a 20 20 20  |R0 preserved.   |
00002b40  0a 20 20 20 20 20 20 20  20 20 20 20 49 66 20 52  |.           If R|
00002b50  30 3d 2d 31 20 6f 6e 20  65 6e 74 72 79 3a 20 52  |0=-1 on entry: R|
00002b60  30 20 3d 20 63 75 72 72  65 6e 74 20 50 6c 61 79  |0 = current Play|
00002b70  53 74 65 72 65 6f 20 73  65 74 74 69 6e 67 0a 20  |Stereo setting. |
00002b80  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002b90  20 20 20 20 20 20 20 20  20 20 20 20 20 52 31 20  |             R1 |
00002ba0  3d 20 70 6f 69 6e 74 65  72 20 74 6f 20 38 2d 62  |= pointer to 8-b|
00002bb0  79 74 65 20 73 74 65 72  65 6f 20 70 6f 73 69 74  |yte stereo posit|
00002bc0  69 6f 6e 20 74 61 62 6c  65 0a 20 20 20 20 20 20  |ion table.      |
00002bd0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002be0  20 20 20 20 20 0a 0a 54  68 69 73 20 70 65 72 66  |     ..This perf|
00002bf0  6f 72 6d 73 20 74 68 65  20 73 61 6d 65 20 61 63  |orms the same ac|
00002c00  74 69 6f 6e 73 20 61 73  20 2a 50 6c 61 79 53 74  |tions as *PlaySt|
00002c10  65 72 65 6f 2c 20 77 69  74 68 20 52 30 20 70 61  |ereo, with R0 pa|
00002c20  73 73 65 64 20 61 73 20  61 20 70 61 72 61 6d 65  |ssed as a parame|
00002c30  74 65 72 2e 0a 49 66 20  52 30 20 69 73 20 73 65  |ter..If R0 is se|
00002c40  74 20 74 6f 20 34 20 6f  6e 20 65 6e 74 72 79 2c  |t to 4 on entry,|
00002c50  20 74 68 65 6e 20 74 68  65 20 73 74 65 72 65 6f  | then the stereo|
00002c60  20 73 65 74 74 69 6e 67  73 20 77 69 6c 6c 20 62  | settings will b|
00002c70  65 20 75 6e 61 6c 74 65  72 65 64 0a 77 68 65 6e  |e unaltered.when|
00002c80  65 76 65 72 20 61 20 6d  6f 64 75 6c 65 20 69 73  |ever a module is|
00002c90  20 6c 6f 61 64 65 64 20  6f 72 20 6b 69 6c 6c 65  | loaded or kille|
00002ca0  64 2c 20 61 6e 64 20 64  69 73 61 62 6c 65 73 20  |d, and disables |
00002cb0  61 6e 79 20 73 74 65 72  65 6f 20 63 6f 6d 6d 61  |any stereo comma|
00002cc0  6e 64 73 20 69 6e 0a 74  72 61 63 6b 65 72 20 6d  |nds in.tracker m|
00002cd0  6f 64 75 6c 65 73 2e 20  54 68 69 73 20 69 73 20  |odules. This is |
00002ce0  74 6f 20 61 6c 6c 6f 77  20 69 6e 74 65 72 66 61  |to allow interfa|
00002cf0  63 69 6e 67 20 70 72 6f  67 72 61 6d 73 20 74 6f  |cing programs to|
00002d00  20 70 72 6f 76 69 64 65  20 74 68 65 69 72 20 6f  | provide their o|
00002d10  77 6e 0a 73 74 65 72 65  6f 20 6f 70 74 69 6f 6e  |wn.stereo option|
00002d20  73 2c 20 6f 72 20 74 6f  20 61 6c 6c 6f 77 20 61  |s, or to allow a|
00002d30  64 6a 75 73 74 6d 65 6e  74 20 74 6f 20 74 68 65  |djustment to the|
00002d40  20 73 74 65 72 65 6f 20  70 6f 73 69 74 69 6f 6e  | stereo position|
00002d50  73 20 77 68 69 6c 65 20  74 72 61 63 6b 65 72 0a  |s while tracker.|
00002d60  74 75 6e 65 73 20 61 72  65 20 70 6c 61 79 69 6e  |tunes are playin|
00002d70  67 20 28 77 68 69 63 68  20 68 61 76 65 20 64 65  |g (which have de|
00002d80  66 61 75 6c 74 20 73 74  65 72 65 6f 20 73 65 74  |fault stereo set|
00002d90  74 69 6e 67 73 20 73 74  6f 72 65 64 20 61 73 20  |tings stored as |
00002da0  70 61 72 74 20 6f 66 20  74 68 65 0a 74 75 6e 65  |part of the.tune|
00002db0  29 2e 0a 20 41 6c 74 65  72 6e 61 74 69 76 65 6c  |).. Alternativel|
00002dc0  79 2c 20 69 66 20 52 30  3d 2d 31 20 6f 6e 20 65  |y, if R0=-1 on e|
00002dd0  6e 74 72 79 2c 20 52 30  20 77 69 6c 6c 20 62 65  |ntry, R0 will be|
00002de0  20 74 68 65 20 6c 61 73  74 20 70 61 72 61 6d 65  | the last parame|
00002df0  74 65 72 20 70 61 73 73  65 64 20 74 6f 0a 74 68  |ter passed to.th|
00002e00  69 73 20 53 57 49 20 6f  72 20 74 68 65 20 2a 50  |is SWI or the *P|
00002e10  6c 61 79 53 74 65 72 65  6f 20 63 6f 6d 6d 61 6e  |layStereo comman|
00002e20  64 2c 20 61 6e 64 20 52  31 20 70 6f 69 6e 74 73  |d, and R1 points|
00002e30  20 74 6f 20 61 6e 20 38  2d 62 79 74 65 20 74 61  | to an 8-byte ta|
00002e40  62 6c 65 20 28 6f 6e 65  0a 62 79 74 65 20 70 65  |ble (one.byte pe|
00002e50  72 20 63 68 61 6e 6e 65  6c 29 20 77 68 69 63 68  |r channel) which|
00002e60  20 69 73 20 75 70 64 61  74 65 64 20 65 76 65 72  | is updated ever|
00002e70  79 20 74 69 6d 65 20 65  69 74 68 65 72 20 61 20  |y time either a |
00002e80  74 75 6e 65 20 73 74 61  72 74 73 3b 20 74 68 69  |tune starts; thi|
00002e90  73 20 53 57 49 0a 6f 72  20 2a 50 6c 61 79 53 74  |s SWI.or *PlaySt|
00002ea0  65 72 65 6f 20 69 73 20  63 61 6c 6c 65 64 20 77  |ereo is called w|
00002eb0  69 74 68 20 61 20 70 61  72 61 6d 65 74 65 72 20  |ith a parameter |
00002ec0  6f 66 20 30 2d 33 3b 20  6f 72 20 69 66 20 61 20  |of 0-3; or if a |
00002ed0  73 74 65 72 65 6f 20 63  6f 6d 6d 61 6e 64 20 69  |stereo command i|
00002ee0  73 0a 65 78 65 63 75 74  65 64 20 69 6e 20 61 20  |s.executed in a |
00002ef0  54 72 61 63 6b 65 72 20  74 75 6e 65 2e 20 54 68  |Tracker tune. Th|
00002f00  65 20 62 79 74 65 20 77  69 6c 6c 20 62 65 20 69  |e byte will be i|
00002f10  6e 20 74 68 65 20 72 61  6e 67 65 20 6f 66 20 31  |n the range of 1|
00002f20  2d 37 20 28 77 68 65 72  65 20 31 20 69 73 0a 66  |-7 (where 1 is.f|
00002f30  75 6c 6c 20 6c 65 66 74  2c 20 37 20 69 73 20 66  |ull left, 7 is f|
00002f40  75 6c 6c 20 72 69 67 68  74 2c 20 61 6e 64 20 34  |ull right, and 4|
00002f50  20 69 73 20 63 65 6e 74  72 65 29 2e 20 53 6f 6d  | is centre). Som|
00002f60  65 20 54 72 61 63 6b 65  72 20 74 75 6e 65 73 20  |e Tracker tunes |
00002f70  6d 61 79 20 63 6f 6e 74  61 69 6e 0a 73 74 65 72  |may contain.ster|
00002f80  65 6f 20 73 65 74 74 69  6e 67 73 20 6f 75 74 20  |eo settings out |
00002f90  6f 66 20 72 61 6e 67 65  2e 0a 0a 0a 0a 2d 2d 2d  |of range.....---|
00002fa0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00002fe0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 0a 54 72 61 63 6b  |----------.Track|
00002ff0  65 72 5f 53 65 74 50 6f  73 20 20 20 20 20 20 20  |er_SetPos       |
00003000  20 20 28 53 57 49 20 26  34 33 32 30 37 29 0a 2d  |  (SWI &43207).-|
00003010  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003050  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 0a 0a 4f 6e  |------------..On|
00003060  20 45 6e 74 72 79 3a 20  20 52 30 20 3d 20 4e 65  | Entry:  R0 = Ne|
00003070  77 20 73 65 71 75 65 6e  63 65 20 70 6f 73 69 74  |w sequence posit|
00003080  69 6f 6e 20 28 30 2d 31  32 37 20 6d 61 78 29 0a  |ion (0-127 max).|
00003090  20 20 20 20 20 20 20 20  20 20 20 52 31 20 3d 20  |           R1 = |
000030a0  45 76 65 6e 74 20 28 30  2d 36 33 20 6d 61 78 29  |Event (0-63 max)|
000030b0  0a 0a 4f 6e 20 45 78 69  74 20 3a 20 20 52 30 20  |..On Exit :  R0 |
000030c0  70 72 65 73 65 72 76 65  64 0a 0a 54 68 69 73 20  |preserved..This |
000030d0  70 65 72 66 6f 72 6d 73  20 74 68 65 20 73 61 6d  |performs the sam|
000030e0  65 20 61 63 74 69 6f 6e  73 20 61 73 20 2a 50 6c  |e actions as *Pl|
000030f0  61 79 50 6f 73 2c 20 65  78 63 65 70 74 20 74 68  |ayPos, except th|
00003100  61 74 20 74 68 65 20 65  76 65 6e 74 20 77 69 74  |at the event wit|
00003110  68 20 74 68 65 0a 70 61  74 74 65 72 6e 20 63 61  |h the.pattern ca|
00003120  6e 20 62 65 20 73 70 65  63 69 66 69 65 64 20 28  |n be specified (|
00003130  30 2d 36 33 20 6e 6f 72  6d 61 6c 6c 79 29 2e 20  |0-63 normally). |
00003140  49 66 20 61 6e 20 65 76  65 6e 74 20 6e 75 6d 62  |If an event numb|
00003150  65 72 20 68 69 67 68 65  72 20 74 68 61 6e 20 74  |er higher than t|
00003160  68 65 0a 6e 75 6d 62 65  72 20 6f 66 20 65 76 65  |he.number of eve|
00003170  6e 74 73 20 69 6e 20 74  68 65 20 63 75 72 72 65  |nts in the curre|
00003180  6e 74 20 70 61 74 74 65  72 6e 20 69 73 20 73 70  |nt pattern is sp|
00003190  65 63 69 66 69 65 64 2c  20 74 68 65 20 70 61 74  |ecified, the pat|
000031a0  74 65 72 6e 20 77 69 6c  6c 20 62 65 67 69 6e 0a  |tern will begin.|
000031b0  61 74 20 65 76 65 6e 74  20 30 2e 0a 0a 49 66 20  |at event 0...If |
000031c0  74 68 65 72 65 20 69 73  20 6e 6f 20 74 75 6e 65  |there is no tune|
000031d0  20 63 75 72 72 65 6e 74  6c 79 20 6c 6f 61 64 65  | currently loade|
000031e0  64 2c 20 61 6e 20 65 72  72 6f 72 20 69 73 20 67  |d, an error is g|
000031f0  65 6e 65 72 61 74 65 64  2e 0a 0a 0a 0a 0a 0a 2d  |enerated.......-|
00003200  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003240  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 0a 54 72 61  |------------.Tra|
00003250  63 6b 65 72 5f 52 65 61  64 50 6f 73 20 20 20 20  |cker_ReadPos    |
00003260  20 20 20 20 28 53 57 49  20 26 34 33 32 30 38 29  |    (SWI &43208)|
00003270  0a 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
00003280  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000032b0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 0a 0a  |--------------..|
000032c0  4f 6e 20 45 6e 74 72 79  3a 20 20 2d 0a 0a 4f 6e  |On Entry:  -..On|
000032d0  20 45 78 69 74 20 3a 20  20 52 30 20 3d 20 43 75  | Exit :  R0 = Cu|
000032e0  72 72 65 6e 74 20 70 6f  73 69 74 69 6f 6e 20 69  |rrent position i|
000032f0  6e 20 73 65 71 75 65 6e  63 65 20 74 61 62 6c 65  |n sequence table|
00003300  20 28 30 2d 31 32 37 20  6d 61 78 29 0a 20 20 20  | (0-127 max).   |
00003310  20 20 20 20 20 20 20 20  52 31 20 3d 20 43 75 72  |        R1 = Cur|
00003320  72 65 6e 74 20 70 6f 73  69 74 69 6f 6e 20 69 6e  |rent position in|
00003330  20 70 61 74 74 65 72 6e  20 28 30 2d 36 33 20 6d  | pattern (0-63 m|
00003340  61 78 29 0a 20 20 20 20  20 20 20 20 20 20 20 52  |ax).           R|
00003350  32 20 3d 20 4d 61 78 69  6d 75 6d 20 70 6f 73 69  |2 = Maximum posi|
00003360  74 69 6f 6e 20 69 6e 20  73 65 71 75 65 6e 63 65  |tion in sequence|
00003370  20 74 61 62 6c 65 0a 0a  54 68 69 73 20 70 65 72  | table..This per|
00003380  66 6f 72 6d 73 20 74 68  65 20 73 61 6d 65 20 61  |forms the same a|
00003390  63 74 69 6f 6e 73 20 61  73 20 2a 50 6c 61 79 50  |ctions as *PlayP|
000033a0  6f 73 20 77 69 74 68 20  6e 6f 20 70 61 72 61 6d  |os with no param|
000033b0  65 74 65 72 73 2c 20 62  75 74 20 61 6c 73 6f 0a  |eters, but also.|
000033c0  72 65 74 75 72 6e 73 20  74 68 65 20 63 75 72 72  |returns the curr|
000033d0  65 6e 74 20 70 6f 73 69  74 69 6f 6e 20 69 6e 20  |ent position in |
000033e0  74 68 65 20 63 75 72 72  65 6e 74 20 70 61 74 74  |the current patt|
000033f0  65 72 6e 20 28 69 6e 20  63 61 73 65 20 73 6f 6d  |ern (in case som|
00003400  65 20 61 70 70 6c 69 63  2d 0a 61 74 69 6f 6e 73  |e applic-.ations|
00003410  20 6e 65 65 64 20 74 6f  20 73 79 6e 63 68 72 6f  | need to synchro|
00003420  6e 69 7a 65 20 65 76 65  6e 74 73 20 77 69 74 68  |nize events with|
00003430  20 74 68 65 20 74 75 6e  65 20 62 65 69 6e 67 20  | the tune being |
00003440  70 6c 61 79 65 64 29 2e  0a 0a 0a 0a 0a 0a 2d 2d  |played).......--|
00003450  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003490  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 0a 54 72 61 63  |-----------.Trac|
000034a0  6b 65 72 5f 50 6c 61 79  4e 6f 74 65 20 20 20 20  |ker_PlayNote    |
000034b0  20 20 20 28 53 57 49 20  26 34 33 32 30 39 29 0a  |   (SWI &43209).|
000034c0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003500  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 0a 0a 4f  |-------------..O|
00003510  6e 20 45 6e 74 72 79 3a  20 20 52 30 20 3d 20 53  |n Entry:  R0 = S|
00003520  6f 75 6e 64 20 63 68 61  6e 6e 65 6c 20 74 6f 20  |ound channel to |
00003530  73 6f 75 6e 64 20 6e 6f  74 65 20 6f 6e 20 28 31  |sound note on (1|
00003540  2d 38 20 6d 61 78 29 0a  20 20 20 20 20 20 20 20  |-8 max).        |
00003550  20 20 20 52 31 20 3d 20  54 72 61 63 6b 65 72 20  |   R1 = Tracker |
00003560  66 6f 72 6d 61 74 20 6e  6f 74 65 20 6e 75 6d 62  |format note numb|
00003570  65 72 20 28 31 2d 33 36  29 0a 20 20 20 20 20 20  |er (1-36).      |
00003580  20 20 20 20 20 52 32 20  3d 20 53 61 6d 70 6c 65  |     R2 = Sample|
00003590  20 74 6f 20 70 6c 61 79  20 28 31 2d 33 36 29 0a  | to play (1-36).|
000035a0  20 20 20 20 20 20 20 20  20 20 20 52 33 20 3d 20  |           R3 = |
000035b0  56 6f 6c 75 6d 65 20 28  30 2d 32 35 35 29 20 5b  |Volume (0-255) [|
000035c0  54 72 61 63 6b 65 72 20  76 6f 6c 75 6d 65 20 65  |Tracker volume e|
000035d0  76 65 6e 20 69 66 20 73  6f 75 6e 64 74 72 61 63  |ven if soundtrac|
000035e0  6b 65 72 20 74 75 6e 65  0a 20 20 20 20 20 20 20  |ker tune.       |
000035f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00003620  20 20 20 20 20 20 20 20  20 20 20 20 6c 6f 61 64  |            load|
00003630  65 64 5d 2e 0a 4f 6e 20  45 78 69 74 20 3a 20 20  |ed]..On Exit :  |
00003640  52 30 2d 52 33 20 70 72  65 73 65 72 76 65 64 0a  |R0-R3 preserved.|
00003650  20 20 20 20 20 20 20 20  20 20 20 49 66 20 74 75  |           If tu|
00003660  6e 65 20 6e 6f 74 20 70  61 75 73 65 64 20 74 68  |ne not paused th|
00003670  65 6e 20 43 20 66 6c 61  67 20 73 65 74 20 6f 74  |en C flag set ot|
00003680  68 65 72 77 69 73 65 20  43 20 66 6c 61 67 20 63  |herwise C flag c|
00003690  6c 65 61 72 65 64 2e 0a  0a 49 66 20 74 68 65 72  |leared...If ther|
000036a0  65 20 69 73 20 6e 6f 20  74 75 6e 65 20 6c 6f 61  |e is no tune loa|
000036b0  64 65 64 2c 20 61 6e 20  65 72 72 6f 72 20 77 69  |ded, an error wi|
000036c0  6c 6c 20 62 65 20 67 65  6e 65 72 61 74 65 64 2e  |ll be generated.|
000036d0  0a 0a 49 74 20 70 6c 61  79 73 20 6f 6e 65 20 6f  |..It plays one o|
000036e0  66 20 74 68 65 20 73 61  6d 70 6c 65 73 20 77 68  |f the samples wh|
000036f0  69 63 68 20 61 72 65 20  70 61 72 74 20 6f 66 20  |ich are part of |
00003700  74 68 65 20 70 61 75 73  65 64 20 74 75 6e 65 20  |the paused tune |
00003710  61 74 20 61 20 67 69 76  65 6e 0a 70 69 74 63 68  |at a given.pitch|
00003720  20 28 31 3d 6c 6f 77 2c  20 33 36 3d 68 69 67 68  | (1=low, 36=high|
00003730  29 20 61 6e 64 20 76 6f  6c 75 6d 65 20 28 30 3d  |) and volume (0=|
00003740  73 69 6c 65 6e 74 2c 20  32 35 35 3d 6c 6f 75 64  |silent, 255=loud|
00003750  29 2e 20 49 66 20 61 6e  79 20 6f 66 20 74 68 65  |). If any of the|
00003760  20 76 61 6c 75 65 73 0a  61 72 65 20 6f 75 74 20  | values.are out |
00003770  6f 66 20 72 61 6e 67 65  2c 20 61 6e 20 65 72 72  |of range, an err|
00003780  6f 72 20 77 69 6c 6c 20  62 65 20 72 65 70 6f 72  |or will be repor|
00003790  74 65 64 2e 0a 54 68 65  20 6e 75 6d 62 65 72 20  |ted..The number |
000037a0  6f 66 20 73 6f 75 6e 64  20 63 68 61 6e 6e 65 6c  |of sound channel|
000037b0  73 20 74 68 61 74 20 63  61 6e 20 62 65 20 75 73  |s that can be us|
000037c0  65 64 20 64 65 70 65 6e  64 73 20 6f 6e 20 74 68  |ed depends on th|
000037d0  65 20 6d 6f 64 75 6c 65  20 6c 6f 61 64 65 64 0a  |e module loaded.|
000037e0  28 73 6f 75 6e 64 74 72  61 63 6b 65 72 20 6d 6f  |(soundtracker mo|
000037f0  64 75 6c 65 73 20 77 69  6c 6c 20 61 6c 77 61 79  |dules will alway|
00003800  73 20 75 73 65 20 34 20  76 6f 69 63 65 73 2c 20  |s use 4 voices, |
00003810  77 68 65 72 65 61 73 20  54 72 61 63 6b 65 72 20  |whereas Tracker |
00003820  6d 6f 64 75 6c 65 73 20  63 61 6e 0a 75 73 65 20  |modules can.use |
00003830  75 70 20 74 6f 20 38 29  2e 0a 55 73 65 20 74 68  |up to 8)..Use th|
00003840  65 20 54 72 61 63 6b 65  72 5f 54 75 6e 65 49 6e  |e Tracker_TuneIn|
00003850  66 6f 20 53 57 49 20 74  6f 20 66 69 6e 64 20 6f  |fo SWI to find o|
00003860  75 74 20 74 68 65 20 6d  61 78 69 6d 75 6d 20 6e  |ut the maximum n|
00003870  75 6d 62 65 72 20 6f 66  20 76 6f 69 63 65 73 20  |umber of voices |
00003880  69 66 20 79 6f 75 0a 69  6e 74 65 6e 64 20 74 6f  |if you.intend to|
00003890  20 70 6c 61 79 20 6d 6f  72 65 20 74 68 61 6e 20  | play more than |
000038a0  6f 6e 65 20 6e 6f 74 65  20 61 74 20 61 20 74 69  |one note at a ti|
000038b0  6d 65 2e 0a 4e 42 20 54  68 69 73 20 63 61 6c 6c  |me..NB This call|
000038c0  20 73 68 6f 75 6c 64 20  62 65 20 61 76 6f 69 64  | should be avoid|
000038d0  65 64 20 69 66 20 70 6f  73 73 69 62 6c 65 2c 20  |ed if possible, |
000038e0  75 6e 6c 65 73 73 20 74  68 65 20 70 75 72 70 6f  |unless the purpo|
000038f0  73 65 20 69 73 20 74 6f  20 68 65 61 72 0a 20 20  |se is to hear.  |
00003900  20 65 61 63 68 20 73 61  6d 70 6c 65 20 73 65 70  | each sample sep|
00003910  65 72 61 74 65 6c 79 2e  0a 0a 0a 0a 0a 0a 2d 2d  |erately.......--|
00003920  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003960  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 0a 54 72 61 63  |-----------.Trac|
00003970  6b 65 72 5f 54 75 6e 65  49 6e 66 6f 20 20 20 20  |ker_TuneInfo    |
00003980  20 20 20 28 53 57 49 20  26 34 33 32 30 41 29 0a  |   (SWI &4320A).|
00003990  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000039d0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 0a 0a 4f  |-------------..O|
000039e0  6e 20 45 6e 74 72 79 3a  20 20 2d 0a 0a 4f 6e 20  |n Entry:  -..On |
000039f0  45 78 69 74 20 3a 20 20  52 30 20 3d 20 53 65 71  |Exit :  R0 = Seq|
00003a00  75 65 6e 63 65 20 74 61  62 6c 65 20 6c 65 6e 67  |uence table leng|
00003a10  74 68 20 28 31 2d 31 32  38 29 0a 20 20 20 20 20  |th (1-128).     |
00003a20  20 20 20 20 20 20 52 31  20 3d 20 4e 75 6d 62 65  |      R1 = Numbe|
00003a30  72 20 6f 66 20 76 6f 69  63 65 73 20 28 31 2d 38  |r of voices (1-8|
00003a40  29 0a 20 20 20 20 20 20  20 20 20 20 20 52 32 20  |).           R2 |
00003a50  3d 20 43 75 72 72 65 6e  74 20 73 70 65 65 64 20  |= Current speed |
00003a60  28 31 2d 31 35 29 0a 20  20 20 20 20 20 20 20 20  |(1-15).         |
00003a70  20 20 52 33 20 3d 20 50  6f 69 6e 74 65 72 20 74  |  R3 = Pointer t|
00003a80  6f 20 74 75 6e 65 20 6e  61 6d 65 20 28 74 65 72  |o tune name (ter|
00003a90  6d 69 6e 61 74 65 64 20  62 79 20 30 2c 20 6d 61  |minated by 0, ma|
00003aa0  78 20 6c 65 6e 67 74 68  20 33 32 20 63 68 61 72  |x length 32 char|
00003ab0  73 29 0a 20 20 20 20 20  20 20 20 20 20 20 52 34  |s).           R4|
00003ac0  20 3d 20 50 6f 69 6e 74  65 72 20 74 6f 20 61 75  | = Pointer to au|
00003ad0  74 68 6f 72 27 73 20 6e  61 6d 65 20 28 30 20 74  |thor's name (0 t|
00003ae0  65 72 6d 69 6e 61 74 65  64 2c 20 6d 61 78 20 6c  |erminated, max l|
00003af0  65 6e 67 74 68 20 33 32  20 63 68 61 72 73 29 0a  |ength 32 chars).|
00003b00  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003b10  6f 72 20 7a 65 72 6f 20  69 66 20 73 6f 75 6e 64  |or zero if sound|
00003b20  74 72 61 63 6b 65 72 20  66 6f 72 6d 61 74 20 6d  |tracker format m|
00003b30  6f 64 75 6c 65 20 28 6e  6f 74 20 61 70 70 6c 69  |odule (not appli|
00003b40  63 61 62 6c 65 29 0a 20  20 20 20 20 20 20 20 20  |cable).         |
00003b50  20 20 52 35 20 3d 20 41  64 64 72 65 73 73 20 6f  |  R5 = Address o|
00003b60  66 20 63 75 72 72 65 6e  74 6c 79 20 6c 6f 61 64  |f currently load|
00003b70  65 64 20 74 75 6e 65 20  6d 6f 64 75 6c 65 0a 20  |ed tune module. |
00003b80  20 20 20 20 20 20 20 20  20 20 0a 20 20 20 20 20  |          .     |
00003b90  20 20 20 20 20 20 49 66  20 74 68 65 20 74 75 6e  |      If the tun|
00003ba0  65 20 69 73 20 70 61 75  73 65 64 2c 20 74 68 65  |e is paused, the|
00003bb0  20 43 20 66 6c 61 67 20  69 73 20 73 65 74 2c 20  | C flag is set, |
00003bc0  6f 74 68 65 72 77 69 73  65 20 74 68 65 20 43 20  |otherwise the C |
00003bd0  66 6c 61 67 20 69 73 0a  20 20 20 20 20 20 20 20  |flag is.        |
00003be0  20 20 20 63 6c 65 61 72  65 64 2e 0a 0a 20 20 20  |   cleared...   |
00003bf0  20 20 20 20 20 20 20 20  49 66 20 74 68 65 72 65  |        If there|
00003c00  20 69 73 20 6e 6f 20 74  75 6e 65 20 6c 6f 61 64  | is no tune load|
00003c10  65 64 2c 20 52 30 20 69  73 20 73 65 74 20 74 6f  |ed, R0 is set to|
00003c20  20 7a 65 72 6f 2c 20 61  6e 64 20 52 31 2d 52 35  | zero, and R1-R5|
00003c30  20 61 72 65 0a 20 20 20  20 20 20 20 20 20 20 20  | are.           |
00003c40  70 72 65 73 65 72 76 65  64 2e 0a 20 20 20 20 20  |preserved..     |
00003c50  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00003c80  20 20 20 20 20 20 20 20  20 20 20 20 20 20 0a 0a  |              ..|
00003c90  54 68 69 73 20 63 61 6c  6c 20 70 72 6f 76 69 64  |This call provid|
00003ca0  65 73 20 6d 69 73 63 65  6c 6c 61 6e 65 6f 75 73  |es miscellaneous|
00003cb0  20 69 6e 66 6f 72 6d 61  74 69 6f 6e 20 61 62 6f  | information abo|
00003cc0  75 74 20 74 68 65 20 74  75 6e 65 20 63 75 72 72  |ut the tune curr|
00003cd0  65 6e 74 6c 79 20 6c 6f  61 64 65 64 2e 0a 0a 59  |ently loaded...Y|
00003ce0  6f 75 20 73 68 6f 75 6c  64 20 6e 6f 74 20 6e 65  |ou should not ne|
00003cf0  65 64 20 74 6f 20 64 69  72 65 63 74 6c 79 20 61  |ed to directly a|
00003d00  63 63 65 73 73 20 74 68  65 20 74 75 6e 65 20 6d  |ccess the tune m|
00003d10  6f 64 75 6c 65 20 28 75  73 69 6e 67 20 74 68 65  |odule (using the|
00003d20  20 61 64 64 72 65 73 73  0a 70 61 73 73 65 64 20  | address.passed |
00003d30  69 6e 20 52 35 29 2c 20  62 65 63 61 75 73 65 20  |in R5), because |
00003d40  61 6c 6c 20 69 6e 66 6f  72 6d 61 74 69 6f 6e 20  |all information |
00003d50  69 73 20 61 76 61 69 6c  61 62 6c 65 20 76 69 61  |is available via|
00003d60  20 74 68 65 20 76 61 72  69 6f 75 73 20 53 57 49  | the various SWI|
00003d70  27 73 2c 0a 61 6e 64 20  73 6f 75 6e 64 74 72 61  |'s,.and soundtra|
00003d80  63 6b 65 72 20 66 6f 72  6d 61 74 20 6d 6f 64 75  |cker format modu|
00003d90  6c 65 73 20 77 69 6c 6c  20 68 61 76 65 20 62 65  |les will have be|
00003da0  65 6e 20 63 6f 6e 76 65  72 74 65 64 20 70 61 72  |en converted par|
00003db0  74 69 61 6c 6c 79 20 74  6f 20 54 72 61 63 6b 65  |tially to Tracke|
00003dc0  72 0a 66 6f 72 6d 61 74  20 77 68 65 6e 20 6c 6f  |r.format when lo|
00003dd0  61 64 65 64 20 28 61 6e  64 20 74 68 65 72 65 66  |aded (and theref|
00003de0  6f 72 65 20 69 6e 20 61  6e 20 75 6e 6b 6e 6f 77  |ore in an unknow|
00003df0  6e 20 66 6f 72 6d 61 74  29 2e 20 54 68 69 73 20  |n format). This |
00003e00  69 6e 66 6f 72 6d 61 74  69 6f 6e 20 69 73 0a 70  |information is.p|
00003e10  72 6f 76 69 64 65 64 20  69 66 2c 20 66 6f 72 20  |rovided if, for |
00003e20  65 78 61 6d 70 6c 65 2c  20 6d 75 6c 74 69 2d 74  |example, multi-t|
00003e30  61 73 6b 69 6e 67 20 70  6c 61 79 65 72 73 2f 65  |asking players/e|
00003e40  64 69 74 6f 72 73 20 6e  65 65 64 20 74 6f 20 6b  |ditors need to k|
00003e50  6e 6f 77 20 69 66 20 74  68 65 0a 74 75 6e 65 20  |now if the.tune |
00003e60  63 75 72 72 65 6e 74 6c  79 20 70 6c 61 79 69 6e  |currently playin|
00003e70  67 20 69 73 20 72 75 6e  6e 69 6e 67 20 66 72 6f  |g is running fro|
00003e80  6d 20 6f 72 64 69 6e 61  72 79 20 52 4d 41 2c 20  |m ordinary RMA, |
00003e90  6f 72 20 74 68 65 20 70  6c 61 79 65 72 27 73 2f  |or the player's/|
00003ea0  65 64 69 74 6f 72 27 73  0a 6f 77 6e 20 77 6f 72  |editor's.own wor|
00003eb0  6b 73 70 61 63 65 2e 0a  0a 0a 20 20 20 20 20 20  |kspace....      |
00003ec0  20 20 20 20 20 20 20 20  20 20 20 20 20 0a 0a 0a  |             ...|
00003ed0  0a 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
00003ee0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003f10  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 0a 54  |--------------.T|
00003f20  72 61 63 6b 65 72 5f 53  6f 75 6e 64 49 6e 66 6f  |racker_SoundInfo|
00003f30  20 20 20 20 20 20 28 53  57 49 20 26 34 33 32 30  |      (SWI &4320|
00003f40  42 29 0a 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |B).-------------|
00003f50  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003f90  0a 0a 4f 6e 20 45 6e 74  72 79 3a 20 20 52 30 20  |..On Entry:  R0 |
00003fa0  3d 20 50 6f 69 6e 74 65  72 20 74 6f 20 77 6f 72  |= Pointer to wor|
00003fb0  64 2d 61 6c 69 67 6e 65  64 20 32 35 36 20 62 79  |d-aligned 256 by|
00003fc0  74 65 20 62 6c 6f 63 6b  20 74 6f 20 68 6f 6c 64  |te block to hold|
00003fd0  20 73 6f 75 6e 64 20 64  61 74 61 0a 0a 4f 6e 20  | sound data..On |
00003fe0  45 78 69 74 20 3a 20 20  52 30 20 70 72 65 73 65  |Exit :  R0 prese|
00003ff0  72 76 65 64 0a 20 20 20  20 20 20 20 20 20 20 20  |rved.           |
00004000  20 20 20 0a 20 20 20 20  20 20 20 20 20 20 20 69  |   .           i|
00004010  66 20 74 68 65 20 74 75  6e 65 20 69 73 20 70 61  |f the tune is pa|
00004020  75 73 65 64 2c 20 74 68  65 20 43 20 66 6c 61 67  |used, the C flag|
00004030  20 77 69 6c 6c 20 62 65  20 73 65 74 2c 20 6f 74  | will be set, ot|
00004040  68 65 72 77 69 73 65 20  74 68 65 20 43 0a 20 20  |herwise the C.  |
00004050  20 20 20 20 20 20 20 20  20 66 6c 61 67 20 77 69  |         flag wi|
00004060  6c 6c 20 62 65 20 63 6c  65 61 72 65 64 2e 0a 0a  |ll be cleared...|
00004070  49 66 20 74 68 65 72 65  20 69 73 20 6e 6f 20 74  |If there is no t|
00004080  75 6e 65 20 6c 6f 61 64  65 64 20 61 6e 20 65 72  |une loaded an er|
00004090  72 6f 72 20 77 69 6c 6c  20 62 65 20 67 65 6e 65  |ror will be gene|
000040a0  72 61 74 65 64 2e 0a 0a  54 68 69 73 20 63 61 6c  |rated...This cal|
000040b0  6c 20 69 73 20 6f 6e 6c  79 20 70 72 6f 76 69 64  |l is only provid|
000040c0  65 64 20 66 6f 72 20 61  64 76 61 6e 63 65 64 20  |ed for advanced |
000040d0  75 73 65 73 20 6f 66 20  74 68 65 20 74 72 61 63  |uses of the trac|
000040e0  6b 65 72 6d 6f 64 75 6c  65 2c 20 61 6e 64 0a 69  |kermodule, and.i|
000040f0  6e 76 6f 6c 76 65 73 20  69 6e 66 6f 72 6d 61 74  |nvolves informat|
00004100  69 6f 6e 20 6f 66 20 61  20 68 69 67 68 6c 79 20  |ion of a highly |
00004110  74 65 63 68 6e 69 63 61  6c 20 6e 61 74 75 72 65  |technical nature|
00004120  2e 20 49 74 20 69 73 20  61 64 76 69 73 65 64 20  |. It is advised |
00004130  74 68 61 74 20 79 6f 75  0a 64 6f 20 6e 6f 74 20  |that you.do not |
00004140  75 73 65 20 74 68 69 73  20 63 61 6c 6c 20 69 66  |use this call if|
00004150  20 79 6f 75 20 63 61 6e  20 61 76 6f 69 64 20 69  | you can avoid i|
00004160  74 2e 0a 0a 54 68 65 20  63 61 6c 6c 20 77 69 6c  |t...The call wil|
00004170  6c 20 74 72 61 6e 73 66  65 72 20 74 68 65 20 63  |l transfer the c|
00004180  75 72 72 65 6e 74 20 63  6f 6e 74 65 6e 74 73 20  |urrent contents |
00004190  6f 66 20 74 68 65 20 73  6f 75 6e 64 20 76 6f 69  |of the sound voi|
000041a0  63 65 20 69 6e 66 6f 20  74 61 62 6c 65 0a 74 6f  |ce info table.to|
000041b0  20 74 68 65 20 6c 6f 63  61 74 69 6f 6e 20 70 6f  | the location po|
000041c0  69 6e 74 65 64 20 74 6f  20 62 79 20 52 30 2e 20  |inted to by R0. |
000041d0  32 35 36 20 62 79 74 65  73 20 28 36 34 20 77 6f  |256 bytes (64 wo|
000041e0  72 64 73 29 20 77 69 6c  6c 20 62 65 20 74 72 61  |rds) will be tra|
000041f0  6e 73 66 65 72 72 65 64  0a 69 6e 20 74 6f 74 61  |nsferred.in tota|
00004200  6c 20 28 38 20 77 6f 72  64 73 20 70 65 72 20 73  |l (8 words per s|
00004210  6f 75 6e 64 20 63 68 61  6e 6e 65 6c 29 2c 20 72  |ound channel), r|
00004220  65 67 61 72 64 6c 65 73  73 20 6f 66 20 74 68 65  |egardless of the|
00004230  20 6e 75 6d 62 65 72 20  6f 66 20 76 6f 69 63 65  | number of voice|
00004240  73 0a 61 63 74 75 61 6c  6c 79 20 61 63 74 69 76  |s.actually activ|
00004250  65 2e 0a 0a 57 68 65 6e  20 61 20 6e 6f 74 65 20  |e...When a note |
00004260  69 73 20 70 6c 61 79 65  64 20 61 6e 64 20 74 68  |is played and th|
00004270  65 6e 20 65 6e 64 73 2c  20 77 6f 72 64 20 36 20  |en ends, word 6 |
00004280  6f 66 20 74 68 65 20 61  70 70 72 6f 70 72 69 61  |of the appropria|
00004290  74 65 20 63 68 61 6e 6e  65 6c 20 69 73 0a 7a 65  |te channel is.ze|
000042a0  72 6f 65 64 2e 20 54 68  65 20 73 6f 75 6e 64 20  |roed. The sound |
000042b0  72 6f 75 74 69 6e 65 73  20 77 69 6c 6c 20 6f 6e  |routines will on|
000042c0  6c 79 20 74 72 79 20 61  6e 64 20 70 6c 61 79 20  |ly try and play |
000042d0  74 68 65 20 73 61 6d 70  6c 65 20 69 66 20 74 68  |the sample if th|
000042e0  69 73 20 77 6f 72 64 20  69 73 0a 6e 6f 6e 2d 7a  |is word is.non-z|
000042f0  65 72 6f 2e 0a 0a 57 68  65 6e 20 61 20 74 75 6e  |ero...When a tun|
00004300  65 20 69 73 20 70 61 75  73 65 64 2c 20 74 68 65  |e is paused, the|
00004310  20 62 6c 6f 63 6b 20 69  73 20 73 61 76 65 64 20  | block is saved |
00004320  61 6e 64 20 6f 76 65 72  77 72 69 74 74 65 6e 20  |and overwritten |
00004330  77 69 74 68 20 7a 65 72  6f 73 2e 20 57 68 65 6e  |with zeros. When|
00004340  0a 74 68 65 20 74 75 6e  65 20 69 73 20 72 65 73  |.the tune is res|
00004350  74 61 72 74 65 64 2c 20  74 68 65 20 6f 6c 64 20  |tarted, the old |
00004360  63 6f 6e 74 65 6e 74 73  20 61 72 65 20 72 65 73  |contents are res|
00004370  74 6f 72 65 64 2c 20 73  6f 20 74 68 61 74 20 74  |tored, so that t|
00004380  68 65 20 73 61 6d 70 6c  65 73 0a 77 69 6c 6c 20  |he samples.will |
00004390  63 6f 6e 74 69 6e 75 65  20 74 6f 20 70 6c 61 79  |continue to play|
000043a0  20 66 72 6f 6d 20 74 68  65 20 73 61 6d 65 20 70  | from the same p|
000043b0  6f 69 6e 74 2e 0a 0a 20  54 68 65 20 66 6f 72 6d  |oint... The form|
000043c0  61 74 20 6f 66 20 74 68  65 20 74 61 62 6c 65 20  |at of the table |
000043d0  69 73 20 61 73 20 66 6f  6c 6c 6f 77 73 3a 2d 0a  |is as follows:-.|
000043e0  0a 57 6f 72 64 20 20 4f  66 66 73 65 74 20 20 20  |.Word  Offset   |
000043f0  20 20 20 20 53 6f 75 6e  64 20 63 68 61 6e 6e 65  |    Sound channe|
00004400  6c 20 31 2e 2e 2e 0a 30  20 20 20 20 20 2b 30 20  |l 1....0     +0 |
00004410  20 20 20 20 20 54 68 65  20 63 75 72 72 65 6e 74  |     The current|
00004420  20 70 69 74 63 68 20 61  63 63 75 6d 75 6c 61 74  | pitch accumulat|
00004430  6f 72 2e 20 28 73 68 69  66 74 20 72 69 67 68 74  |or. (shift right|
00004440  20 31 36 20 62 69 74 73  20 74 6f 20 67 65 74 20  | 16 bits to get |
00004450  74 68 65 0a 20 20 20 20  20 20 20 20 20 20 20 20  |the.            |
00004460  20 20 61 63 74 75 61 6c  20 62 79 74 65 20 6f 66  |  actual byte of|
00004470  66 73 65 74 20 69 6e 74  6f 20 74 68 65 20 73 61  |fset into the sa|
00004480  6d 70 6c 65 20 62 65 69  6e 67 20 70 6c 61 79 65  |mple being playe|
00004490  64 29 2e 0a 0a 31 20 20  20 20 20 2b 34 20 20 20  |d)...1     +4   |
000044a0  20 20 20 54 68 65 20 63  75 72 72 65 6e 74 20 70  |   The current p|
000044b0  69 74 63 68 20 69 6e 63  72 65 6d 65 6e 74 20 28  |itch increment (|
000044c0  61 64 64 65 64 20 74 6f  20 61 63 63 75 6d 75 6c  |added to accumul|
000044d0  61 74 6f 72 20 61 66 74  65 72 20 65 76 65 72 79  |ator after every|
000044e0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 62  |.              b|
000044f0  79 74 65 20 66 69 6c 6c  65 64 29 2e 20 54 68 69  |yte filled). Thi|
00004500  73 20 69 73 20 6f 62 74  61 69 6e 65 64 20 75 73  |s is obtained us|
00004510  69 6e 67 20 69 6e 74 65  72 6e 61 6c 20 74 61 62  |ing internal tab|
00004520  6c 65 73 20 67 69 76 65  6e 20 74 68 65 0a 20 20  |les given the.  |
00004530  20 20 20 20 20 20 20 20  20 20 20 20 73 61 6d 70  |            samp|
00004540  6c 65 20 70 65 72 69 6f  64 20 28 77 6f 72 64 20  |le period (word |
00004550  37 29 0a 0a 32 20 20 20  20 20 2b 38 20 20 20 20  |7)..2     +8    |
00004560  20 20 54 68 65 20 73 61  6d 70 6c 65 20 6c 6f 6f  |  The sample loo|
00004570  70 20 6f 66 66 73 65 74  20 28 67 69 76 65 6e 20  |p offset (given |
00004580  69 6e 20 62 79 74 65 73  29 2e 20 57 68 65 6e 20  |in bytes). When |
00004590  74 68 65 20 72 6f 75 74  69 6e 65 0a 20 20 20 20  |the routine.    |
000045a0  20 20 20 20 20 20 20 20  20 20 72 65 61 63 68 65  |          reache|
000045b0  73 20 74 68 65 20 65 6e  64 20 6f 66 20 61 20 73  |s the end of a s|
000045c0  61 6d 70 6c 65 20 6f 72  20 74 68 65 20 73 61 6d  |ample or the sam|
000045d0  70 6c 65 20 6c 65 6e 67  74 68 2c 20 74 68 65 20  |ple length, the |
000045e0  61 63 63 75 6d 75 6c 2d  0a 20 20 20 20 20 20 20  |accumul-.       |
000045f0  20 20 20 20 20 20 20 61  74 6f 72 20 69 73 20 6c  |       ator is l|
00004600  6f 61 64 65 64 20 77 69  74 68 20 74 68 69 73 20  |oaded with this |
00004610  76 61 6c 75 65 20 73 68  69 66 74 65 64 20 6c 65  |value shifted le|
00004620  66 74 20 31 36 20 62 69  74 73 20 28 69 65 2e 20  |ft 16 bits (ie. |
00004630  74 6f 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |to.             |
00004640  20 67 69 76 65 20 61 20  62 79 74 65 20 6f 66 66  | give a byte off|
00004650  73 65 74 29 2e 20 49 66  20 74 68 69 73 20 69 73  |set). If this is|
00004660  20 61 20 7a 65 72 6f 20  76 61 6c 75 65 2c 20 74  | a zero value, t|
00004670  68 65 20 73 61 6d 70 6c  65 20 77 69 6c 6c 0a 20  |he sample will. |
00004680  20 20 20 20 20 20 20 20  20 20 20 20 20 73 74 6f  |             sto|
00004690  70 20 69 6e 73 74 65 61  64 20 6f 66 20 6c 6f 6f  |p instead of loo|
000046a0  70 69 6e 67 2e 0a 0a 33  20 20 20 20 20 2b 31 32  |ping...3     +12|
000046b0  20 20 20 20 20 54 68 65  20 73 61 6d 70 6c 65 20  |     The sample |
000046c0  6c 65 6e 67 74 68 20 2f  20 72 65 70 65 61 74 20  |length / repeat |
000046d0  6c 65 6e 67 74 68 20 28  69 6e 20 62 79 74 65 73  |length (in bytes|
000046e0  29 2e 20 54 68 65 20 72  6f 75 74 69 6e 65 0a 20  |). The routine. |
000046f0  20 20 20 20 20 20 20 20  20 20 20 20 20 63 68 65  |             che|
00004700  63 6b 73 20 65 76 65 72  79 20 34 20 62 79 74 65  |cks every 4 byte|
00004710  73 20 66 69 6c 6c 65 64  20 74 6f 20 73 65 65 20  |s filled to see |
00004720  69 66 20 74 68 65 20 63  75 72 72 65 6e 74 20 61  |if the current a|
00004730  63 63 75 6d 75 6c 61 74  6f 72 0a 20 20 20 20 20  |ccumulator.     |
00004740  20 20 20 20 20 20 20 20  20 65 78 63 65 65 64 73  |         exceeds|
00004750  20 74 68 69 73 20 76 61  6c 75 65 20 77 68 65 6e  | this value when|
00004760  20 73 68 69 66 74 65 64  20 72 69 67 68 74 20 31  | shifted right 1|
00004770  36 20 62 69 74 73 2e 20  28 53 65 65 20 61 62 6f  |6 bits. (See abo|
00004780  76 65 29 0a 0a 34 20 20  20 20 20 2b 31 36 20 20  |ve)..4     +16  |
00004790  20 20 20 54 68 65 20 73  61 6d 70 6c 65 20 6e 75  |   The sample nu|
000047a0  6d 62 65 72 20 28 31 2d  33 36 29 2e 0a 0a 35 20  |mber (1-36)...5 |
000047b0  20 20 20 20 2b 32 30 20  20 20 20 20 54 68 65 20  |    +20     The |
000047c0  63 75 72 72 65 6e 74 20  76 6f 6c 75 6d 65 20 28  |current volume (|
000047d0  30 2d 32 35 35 29 2e 20  54 68 69 73 20 76 61 6c  |0-255). This val|
000047e0  75 65 20 69 73 20 73 75  62 74 72 61 63 74 65 64  |ue is subtracted|
000047f0  20 66 72 6f 6d 20 65 76  65 72 79 0a 20 20 20 20  | from every.    |
00004800  20 20 20 20 20 20 20 20  20 20 62 79 74 65 20 66  |          byte f|
00004810  69 6c 6c 65 64 2c 20 74  68 65 72 65 66 6f 72 65  |illed, therefore|
00004820  20 30 20 3d 20 6d 61 78  69 6d 75 6d 20 76 6f 6c  | 0 = maximum vol|
00004830  75 6d 65 20 61 6e 64 20  32 35 35 20 3d 20 73 69  |ume and 255 = si|
00004840  6c 65 6e 74 2e 0a 20 20  20 20 20 20 20 20 20 20  |lent..          |
00004850  20 20 20 20 4e 42 20 54  68 69 73 20 69 73 20 74  |    NB This is t|
00004860  68 65 20 72 65 76 65 72  73 65 20 6f 66 20 74 68  |he reverse of th|
00004870  65 20 6e 6f 72 6d 61 6c  20 76 6f 6c 75 6d 65 20  |e normal volume |
00004880  63 6f 6d 6d 61 6e 64 2e  0a 0a 36 20 20 20 20 20  |command...6     |
00004890  2b 32 34 20 20 20 20 20  54 68 69 73 20 69 73 20  |+24     This is |
000048a0  74 68 65 20 74 72 61 63  6b 65 72 20 66 6f 72 6d  |the tracker form|
000048b0  61 74 20 6e 6f 74 65 20  6e 75 6d 62 65 72 20 6f  |at note number o|
000048c0  66 20 74 68 65 20 73 61  6d 70 6c 65 20 62 65 69  |f the sample bei|
000048d0  6e 67 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |ng.             |
000048e0  20 70 6c 61 79 65 64 20  28 31 2d 33 36 2c 20 31  | played (1-36, 1|
000048f0  3d 43 20 6f 63 74 61 76  65 20 31 20 33 36 3d 42  |=C octave 1 36=B|
00004900  20 6f 63 74 61 76 65 20  33 29 2e 20 54 68 65 20  | octave 3). The |
00004910  61 72 70 65 67 67 69 6f  20 63 6f 6d 6d 61 6e 64  |arpeggio command|
00004920  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 6d  |.              m|
00004930  61 6b 65 73 20 75 73 65  20 6f 66 20 74 68 69 73  |akes use of this|
00004940  20 77 6f 72 64 2e 20 49  66 20 74 68 69 73 20 77  | word. If this w|
00004950  6f 72 64 20 69 73 20 7a  65 72 6f 2c 20 6e 6f 20  |ord is zero, no |
00004960  73 6f 75 6e 64 20 77 69  6c 6c 20 62 65 0a 20 20  |sound will be.  |
00004970  20 20 20 20 20 20 20 20  20 20 20 20 70 6c 61 79  |            play|
00004980  65 64 2e 0a 0a 37 20 20  20 20 20 2b 32 38 20 20  |ed...7     +28  |
00004990  20 20 20 54 68 69 73 20  69 73 20 61 20 63 6f 70  |   This is a cop|
000049a0  79 20 6f 66 20 74 68 65  20 73 61 6d 70 6c 65 20  |y of the sample |
000049b0  70 65 72 69 6f 64 20 28  66 72 6f 6d 20 77 68 69  |period (from whi|
000049c0  63 68 20 74 68 65 20 70  69 74 63 68 0a 20 20 20  |ch the pitch.   |
000049d0  20 20 20 20 20 20 20 20  20 20 20 69 6e 63 72 65  |           incre|
000049e0  6d 65 6e 74 20 76 61 6c  75 65 20 69 73 20 63 61  |ment value is ca|
000049f0  6c 63 75 6c 61 74 65 64  29 2c 20 61 6e 64 20 69  |lculated), and i|
00004a00  73 20 75 73 65 64 20 62  79 20 74 68 65 20 70 6f  |s used by the po|
00004a10  72 74 61 6d 65 6e 74 6f  0a 20 20 20 20 20 20 20  |rtamento.       |
00004a20  20 20 20 20 20 20 20 63  6f 6d 6d 61 6e 64 73 2e  |       commands.|
00004a30  20 54 68 65 20 72 61 6e  67 65 20 6f 66 20 74 68  | The range of th|
00004a40  65 20 73 61 6d 70 6c 65  20 70 65 72 69 6f 64 20  |e sample period |
00004a50  69 73 20 66 72 6f 6d 20  31 20 74 6f 20 68 65 78  |is from 1 to hex|
00004a60  20 26 34 30 30 0a 20 20  20 20 20 20 20 20 20 20  | &400.          |
00004a70  20 20 20 20 28 61 6c 74  68 6f 75 67 68 20 74 68  |    (although th|
00004a80  65 20 70 6f 72 74 61 6d  65 6e 74 6f 20 63 6f 6d  |e portamento com|
00004a90  6d 61 6e 64 73 20 68 61  76 65 20 73 6d 61 6c 6c  |mands have small|
00004aa0  65 72 20 6c 69 6d 69 74  73 20 69 6e 0a 20 20 20  |er limits in.   |
00004ab0  20 20 20 20 20 20 20 20  20 20 20 70 72 61 63 74  |           pract|
00004ac0  69 63 65 29 2e 0a 0a 38  20 20 20 20 20 2b 33 32  |ice)...8     +32|
00004ad0  20 20 20 20 20 57 6f 72  64 20 30 20 6f 66 20 73  |     Word 0 of s|
00004ae0  6f 75 6e 64 20 63 68 61  6e 6e 65 6c 20 32 2e 2e  |ound channel 2..|
00004af0  2e 0a 0a 39 20 20 20 20  20 2b 33 36 20 20 20 20  |...9     +36    |
00004b00  20 57 6f 72 64 20 31 20  6f 66 20 73 6f 75 6e 64  | Word 1 of sound|
00004b10  20 63 68 61 6e 6e 65 6c  20 32 2e 2e 2e 20 20 65  | channel 2...  e|
00004b20  74 63 2e 20 0a 20 20 20  20 20 0a 20 20 20 20 2d  |tc. .     .    -|
00004b30  3e 20 77 6f 72 64 20 38  20 6f 66 20 73 6f 75 6e  |> word 8 of soun|
00004b40  64 20 63 68 61 6e 6e 65  6c 20 38 0a 0a 0a 0a 0a  |d channel 8.....|
00004b50  0a 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
00004b60  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00004b90  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 0a 54  |--------------.T|
00004ba0  72 61 63 6b 65 72 5f 52  65 61 64 53 61 6d 70 6c  |racker_ReadSampl|
00004bb0  65 54 61 62 6c 65 20 20  20 28 53 57 49 20 26 34  |eTable   (SWI &4|
00004bc0  33 32 30 43 29 0a 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |320C).----------|
00004bd0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00004c10  2d 2d 2d 0a 0a 4f 6e 20  45 6e 74 72 79 3a 20 20  |---..On Entry:  |
00004c20  52 30 20 3d 20 53 61 6d  70 6c 65 20 6e 75 6d 62  |R0 = Sample numb|
00004c30  65 72 20 28 31 2d 33 36  29 0a 0a 4f 6e 20 45 78  |er (1-36)..On Ex|
00004c40  69 74 20 3a 20 20 52 30  20 70 72 65 73 65 72 76  |it :  R0 preserv|
00004c50  65 64 0a 20 20 20 20 20  20 20 20 20 20 20 52 31  |ed.           R1|
00004c60  20 3d 20 50 6f 69 6e 74  65 72 20 74 6f 20 73 61  | = Pointer to sa|
00004c70  6d 70 6c 65 20 6e 61 6d  65 20 28 30 2d 74 65 72  |mple name (0-ter|
00004c80  6d 69 6e 61 74 65 64 2c  20 6d 61 78 20 6c 65 6e  |minated, max len|
00004c90  67 74 68 20 32 32 20 63  68 61 72 73 29 20 0a 20  |gth 22 chars) . |
00004ca0  20 20 20 20 20 20 20 20  20 20 52 32 20 3d 20 53  |          R2 = S|
00004cb0  61 6d 70 6c 65 20 76 6f  6c 75 6d 65 20 28 30 2d  |ample volume (0-|
00004cc0  32 35 35 2c 20 32 35 35  3d 6d 61 78 69 6d 75 6d  |255, 255=maximum|
00004cd0  20 76 6f 6c 75 6d 65 2c  20 30 3d 73 69 6c 65 6e  | volume, 0=silen|
00004ce0  74 29 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |t).             |
00004cf0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004d00  20 28 6f 72 20 30 2d 36  34 20 5b 73 6f 75 6e 64  | (or 0-64 [sound|
00004d10  74 72 61 63 6b 65 72 5d  2c 20 36 34 3d 6d 61 78  |tracker], 64=max|
00004d20  20 76 6f 6c 2e 29 20 0a  20 20 20 20 20 20 20 20  | vol.) .        |
00004d30  20 20 20 52 33 20 3d 20  53 61 6d 70 6c 65 20 6c  |   R3 = Sample l|
00004d40  65 6e 67 74 68 20 28 62  79 74 65 73 29 0a 20 20  |ength (bytes).  |
00004d50  20 20 20 20 20 20 20 20  20 52 34 20 3d 20 52 65  |         R4 = Re|
00004d60  70 65 61 74 20 6f 66 66  73 65 74 20 28 62 79 74  |peat offset (byt|
00004d70  65 73 29 0a 20 20 20 20  20 20 20 20 20 20 20 52  |es).           R|
00004d80  35 20 3d 20 52 65 70 65  61 74 20 6c 65 6e 67 74  |5 = Repeat lengt|
00004d90  68 20 28 62 79 74 65 73  29 0a 20 20 20 20 20 20  |h (bytes).      |
00004da0  20 20 20 20 20 52 36 20  3d 20 41 64 64 72 65 73  |     R6 = Addres|
00004db0  73 20 6f 66 20 72 61 77  20 73 61 6d 70 6c 65 20  |s of raw sample |
00004dc0  64 61 74 61 0a 0a 54 68  69 73 20 63 61 6c 6c 20  |data..This call |
00004dd0  72 65 74 75 72 6e 73 20  61 6c 6c 20 72 65 6c 65  |returns all rele|
00004de0  76 61 6e 74 20 69 6e 66  6f 72 6d 61 74 69 6f 6e  |vant information|
00004df0  20 61 62 6f 75 74 20 74  68 65 20 73 70 65 63 69  | about the speci|
00004e00  66 69 65 64 20 73 61 6d  70 6c 65 2e 20 0a 0a 49  |fied sample. ..I|
00004e10  66 20 74 68 65 72 65 20  69 73 20 6e 6f 20 74 75  |f there is no tu|
00004e20  6e 65 20 6c 6f 61 64 65  64 2c 20 61 6e 20 65 72  |ne loaded, an er|
00004e30  72 6f 72 20 77 69 6c 6c  20 62 65 20 67 65 6e 65  |ror will be gene|
00004e40  72 61 74 65 64 2e 0a 0a  49 66 20 74 68 65 20 73  |rated...If the s|
00004e50  61 6d 70 6c 65 20 6e 75  6d 62 65 72 20 69 73 20  |ample number is |
00004e60  6f 75 74 20 6f 66 20 72  61 6e 67 65 20 28 66 6f  |out of range (fo|
00004e70  72 20 65 78 61 6d 70 6c  65 2c 20 69 66 20 72 65  |r example, if re|
00004e80  61 64 69 6e 67 20 73 61  6d 70 6c 65 20 31 36 20  |ading sample 16 |
00004e90  6f 6e 20 61 0a 31 35 2d  69 6e 73 74 72 75 6d 65  |on a.15-instrume|
00004ea0  6e 74 20 6d 6f 64 75 6c  65 29 2c 20 52 31 20 61  |nt module), R1 a|
00004eb0  6e 64 20 52 36 20 77 69  6c 6c 20 70 6f 69 6e 74  |nd R6 will point|
00004ec0  20 74 6f 20 61 20 7a 65  72 6f 2c 20 61 6e 64 20  | to a zero, and |
00004ed0  52 32 2d 52 35 20 77 69  6c 6c 20 63 6f 6e 74 61  |R2-R5 will conta|
00004ee0  69 6e 0a 61 20 7a 65 72  6f 2e 0a 0a 20 20 20 20  |in.a zero...    |
00004ef0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00004f10  20 20 20 20 20 20 20 20  20 20 20 20 20 20 0a 0a  |              ..|
00004f20  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00004f60  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 0a 54 72  |-------------.Tr|
00004f70  61 63 6b 65 72 5f 57 72  69 74 65 53 61 6d 70 6c  |acker_WriteSampl|
00004f80  65 54 61 62 6c 65 20 20  28 53 57 49 20 26 34 33  |eTable  (SWI &43|
00004f90  32 31 33 29 0a 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |213).-----------|
00004fa0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00004fe0  2d 2d 0a 0a 4f 6e 20 45  6e 74 72 79 3a 20 20 52  |--..On Entry:  R|
00004ff0  30 20 3d 20 53 61 6d 70  6c 65 20 6e 75 6d 62 65  |0 = Sample numbe|
00005000  72 20 28 31 2d 33 36 29  0a 20 20 20 20 20 20 20  |r (1-36).       |
00005010  20 20 20 20 52 31 20 3d  20 4e 65 77 20 73 61 6d  |    R1 = New sam|
00005020  70 6c 65 20 76 6f 6c 75  6d 65 20 28 30 2d 32 35  |ple volume (0-25|
00005030  35 2f 30 2d 36 34 29 20  6f 72 20 2d 31 20 74 6f  |5/0-64) or -1 to|
00005040  20 6c 65 61 76 65 20 75  6e 63 68 61 6e 67 65 64  | leave unchanged|
00005050  2e 0a 20 20 20 20 20 20  20 20 20 20 20 52 32 20  |..           R2 |
00005060  3d 20 52 65 70 65 61 74  20 6f 66 66 73 65 74 20  |= Repeat offset |
00005070  28 62 79 74 65 73 29 20  6f 72 20 2d 31 20 74 6f  |(bytes) or -1 to|
00005080  20 6c 65 61 76 65 20 75  6e 63 68 61 6e 67 65 64  | leave unchanged|
00005090  2e 0a 20 20 20 20 20 20  20 20 20 20 20 52 33 20  |..           R3 |
000050a0  3d 20 52 65 70 65 61 74  20 6c 65 6e 67 74 68 20  |= Repeat length |
000050b0  28 62 79 74 65 73 29 20  6f 72 20 2d 31 20 74 6f  |(bytes) or -1 to|
000050c0  20 6c 65 61 76 65 20 75  6e 63 68 61 6e 67 65 64  | leave unchanged|
000050d0  2e 0a 0a 20 59 6f 75 20  73 68 6f 75 6c 64 20 75  |... You should u|
000050e0  73 65 20 74 68 69 73 20  53 57 49 20 69 66 20 79  |se this SWI if y|
000050f0  6f 75 20 77 69 73 68 20  74 6f 20 61 6c 74 65 72  |ou wish to alter|
00005100  20 74 68 65 20 73 61 6d  70 6c 65 20 64 61 74 61  | the sample data|
00005110  20 77 69 74 68 6f 75 74  20 6e 65 65 64 69 6e 67  | without needing|
00005120  0a 74 6f 20 6b 6e 6f 77  20 74 68 65 20 72 65 6c  |.to know the rel|
00005130  65 76 61 6e 74 20 6d 6f  64 75 6c 65 20 66 6f 72  |evant module for|
00005140  6d 61 74 2e 20 53 61 6d  70 6c 65 20 6c 65 6e 67  |mat. Sample leng|
00005150  74 68 20 69 73 20 6e 6f  74 20 61 6c 74 65 72 61  |th is not altera|
00005160  62 6c 65 2c 20 62 65 63  61 75 73 65 0a 74 68 65  |ble, because.the|
00005170  20 6f 63 63 61 73 69 6f  6e 73 20 77 68 65 6e 20  | occasions when |
00005180  74 68 69 73 20 69 73 20  6e 65 63 65 73 73 61 72  |this is necessar|
00005190  79 20 28 65 67 2e 20 6c  6f 61 64 69 6e 67 20 6e  |y (eg. loading n|
000051a0  65 77 20 73 61 6d 70 6c  65 20 69 6e 29 20 6e 65  |ew sample in) ne|
000051b0  65 64 0a 64 69 72 65 63  74 20 6d 61 6e 69 70 75  |ed.direct manipu|
000051c0  6c 61 74 69 6f 6e 20 6f  66 20 74 68 65 20 6d 6f  |lation of the mo|
000051d0  64 75 6c 65 20 69 6e 20  6d 65 6d 6f 72 79 20 61  |dule in memory a|
000051e0  6e 79 77 61 79 2c 20 61  6e 64 20 70 72 6f 62 6c  |nyway, and probl|
000051f0  65 6d 73 20 6f 63 63 75  72 20 77 68 65 6e 0a 74  |ems occur when.t|
00005200  68 65 20 73 61 6d 70 6c  65 20 6c 65 6e 67 74 68  |he sample length|
00005210  20 69 73 20 73 65 74 20  61 62 6f 76 65 20 74 68  | is set above th|
00005220  65 20 61 63 74 75 61 6c  20 6c 65 6e 67 74 68 2e  |e actual length.|
00005230  0a 20 56 65 72 73 69 6f  6e 73 20 62 65 74 77 65  |. Versions betwe|
00005240  65 6e 20 33 2e 30 30 20  61 6e 64 20 34 2e 30 35  |en 3.00 and 4.05|
00005250  20 63 6f 70 69 65 64 20  74 68 65 20 73 61 6d 70  | copied the samp|
00005260  6c 65 20 69 6e 66 6f 72  6d 61 74 69 6f 6e 20 69  |le information i|
00005270  6e 74 6f 20 61 20 6d 6f  72 65 0a 63 6f 6e 76 65  |nto a more.conve|
00005280  6e 69 65 6e 74 20 66 6f  72 6d 61 74 20 77 68 65  |nient format whe|
00005290  6e 20 74 68 65 20 6d 6f  64 75 6c 65 20 77 61 73  |n the module was|
000052a0  20 69 6e 69 74 69 61 6c  69 73 65 64 2c 20 61 6e  | initialised, an|
000052b0  64 20 73 6f 20 61 6c 74  65 72 69 6e 67 20 74 68  |d so altering th|
000052c0  65 20 64 61 74 61 0a 64  69 72 65 63 74 6c 79 20  |e data.directly |
000052d0  77 6f 75 6c 64 20 68 61  76 65 20 68 61 64 20 6e  |would have had n|
000052e0  6f 20 65 66 66 65 63 74  20 28 63 61 75 73 69 6e  |o effect (causin|
000052f0  67 20 70 72 6f 62 6c 65  6d 73 20 66 6f 72 20 65  |g problems for e|
00005300  64 69 74 6f 72 73 20 77  68 69 63 68 20 6e 65 65  |ditors which nee|
00005310  64 65 64 0a 74 6f 20 64  6f 20 74 68 69 73 2e 2e  |ded.to do this..|
00005320  29 2e 0a 20 53 68 6f 75  6c 64 20 79 6f 75 20 77  |).. Should you w|
00005330  69 73 68 20 74 6f 20 61  6c 74 65 72 20 61 6e 79  |ish to alter any|
00005340  20 6f 74 68 65 72 20 61  73 70 65 63 74 20 6f 66  | other aspect of|
00005350  20 74 68 65 20 6d 6f 64  75 6c 65 20 64 69 72 65  | the module dire|
00005360  63 74 6c 79 20 77 68 69  63 68 20 6d 69 67 68 74  |ctly which might|
00005370  0a 61 66 66 65 63 74 20  74 68 65 20 70 6c 61 79  |.affect the play|
00005380  72 6f 75 74 69 6e 65 20  28 69 65 2e 20 6e 75 6d  |routine (ie. num|
00005390  62 65 72 20 6f 66 20 76  6f 69 63 65 73 29 2c 20  |ber of voices), |
000053a0  79 6f 75 20 73 68 6f 75  6c 64 20 63 61 6c 6c 0a  |you should call.|
000053b0  27 54 72 61 63 6b 65 72  5f 55 70 64 61 74 65 44  |'Tracker_UpdateD|
000053c0  61 74 61 27 20 28 73 65  65 20 62 65 6c 6f 77 2e  |ata' (see below.|
000053d0  2e 29 2e 0a 0a 20 41 6e  20 65 72 72 6f 72 20 69  |.)... An error i|
000053e0  73 20 67 65 6e 65 72 61  74 65 64 20 69 66 3a 0a  |s generated if:.|
000053f0  2a 20 4e 6f 20 6d 6f 64  75 6c 65 20 69 73 20 6c  |* No module is l|
00005400  6f 61 64 65 64 0a 2a 20  54 68 65 20 73 61 6d 70  |oaded.* The samp|
00005410  6c 65 20 6e 75 6d 62 65  72 20 74 6f 20 63 68 61  |le number to cha|
00005420  6e 67 65 20 65 78 63 65  65 64 73 20 74 68 65 20  |nge exceeds the |
00005430  6d 61 78 2e 20 6f 66 20  74 68 65 20 66 6f 72 6d  |max. of the form|
00005440  61 74 20 28 69 65 2e 20  31 35 2f 33 31 2f 33 36  |at (ie. 15/31/36|
00005450  29 0a 2a 20 54 68 65 20  72 65 6c 65 76 61 6e 74  |).* The relevant|
00005460  20 69 6e 66 6f 72 6d 61  74 69 6f 6e 20 69 73 20  | information is |
00005470  6f 75 74 20 6f 66 20 72  61 6e 67 65 20 28 69 65  |out of range (ie|
00005480  2e 20 76 6f 6c 20 3e 20  5b 36 34 20 6f 72 20 32  |. vol > [64 or 2|
00005490  35 35 5d 29 0a 2a 20 41  20 63 6f 6d 62 69 6e 61  |55]).* A combina|
000054a0  74 69 6f 6e 20 6f 66 20  72 65 70 65 61 74 20 6f  |tion of repeat o|
000054b0  66 66 73 65 74 20 61 6e  64 20 72 65 70 65 61 74  |ffset and repeat|
000054c0  20 6c 65 6e 67 74 68 20  77 6f 75 6c 64 20 63 61  | length would ca|
000054d0  75 73 65 20 74 68 65 20  70 6c 61 79 65 72 0a 20  |use the player. |
000054e0  20 20 20 20 74 6f 20 6c  6f 6f 70 20 6f 75 74 73  |    to loop outs|
000054f0  69 64 65 20 74 68 65 20  73 61 6d 70 6c 65 20 6c  |ide the sample l|
00005500  69 6d 69 74 2e 0a 0a 20  54 68 69 73 20 53 57 49  |imit... This SWI|
00005510  20 69 73 20 70 61 72 74  20 6f 66 20 74 68 65 20  | is part of the |
00005520  6c 6f 63 6b 69 6e 67 20  73 79 73 74 65 6d 2e 0a  |locking system..|
00005530  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00005550  20 20 20 20 20 20 0a 0a  0a 2d 2d 2d 2d 2d 2d 2d  |      ...-------|
00005560  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000055a0  2d 2d 2d 2d 2d 2d 0a 54  72 61 63 6b 65 72 5f 4c  |------.Tracker_L|
000055b0  6f 63 6b 20 20 20 20 20  20 20 20 20 20 20 20 20  |ock             |
000055c0  20 28 53 57 49 20 26 34  33 32 30 44 29 0a 2d 2d  | (SWI &4320D).--|
000055d0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00005610  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 0a 0a 4f 6e 20  |-----------..On |
00005620  45 6e 74 72 79 3a 20 20  52 30 20 3d 20 6c 6f 63  |Entry:  R0 = loc|
00005630  6b 69 6e 67 20 63 6f 64  65 20 28 70 61 73 73 65  |king code (passe|
00005640  64 20 69 6e 20 52 34 20  74 6f 20 53 57 49 27 73  |d in R4 to SWI's|
00005650  29 0a 0a 4f 6e 20 45 78  69 74 20 3a 20 20 2d 20  |)..On Exit :  - |
00005660  20 20 20 20 0a 0a 0a 20  54 68 69 73 20 53 57 49  |    ... This SWI|
00005670  20 61 6e 64 20 74 68 65  20 63 6f 72 72 65 73 70  | and the corresp|
00005680  6f 6e 64 69 6e 67 20 54  72 61 63 6b 65 72 5f 55  |onding Tracker_U|
00005690  6e 6c 6f 63 6b 20 53 57  49 20 61 72 65 20 70 72  |nlock SWI are pr|
000056a0  6f 76 69 64 65 64 20 74  6f 0a 70 72 65 76 65 6e  |ovided to.preven|
000056b0  74 20 75 73 65 72 20 69  6e 74 65 72 76 65 6e 74  |t user intervent|
000056c0  69 6f 6e 20 77 69 74 68  20 61 6e 79 20 6f 66 20  |ion with any of |
000056d0  74 68 65 20 66 65 61 74  75 72 65 73 20 6f 66 20  |the features of |
000056e0  74 68 65 20 6d 6f 64 75  6c 65 20 77 68 65 6e 20  |the module when |
000056f0  74 68 69 73 0a 77 6f 75  6c 64 20 62 65 20 75 6e  |this.would be un|
00005700  64 65 73 69 72 61 62 6c  65 20 66 6f 72 20 61 6e  |desirable for an|
00005710  79 20 6d 75 6c 74 69 2d  74 61 73 6b 69 6e 67 20  |y multi-tasking |
00005720  61 70 70 6c 69 63 61 74  69 6f 6e 73 20 75 73 69  |applications usi|
00005730  6e 67 20 74 68 65 20 6d  6f 64 75 6c 65 20 0a 28  |ng the module .(|
00005740  66 6f 72 20 65 78 61 6d  70 6c 65 20 69 73 73 75  |for example issu|
00005750  69 6e 67 20 61 20 2a 50  6c 61 79 53 74 6f 70 20  |ing a *PlayStop |
00005760  63 6f 6d 6d 61 6e 64 29  2e 20 42 79 20 63 61 6c  |command). By cal|
00005770  6c 69 6e 67 20 74 68 69  73 20 53 57 49 2c 20 61  |ling this SWI, a|
00005780  6e 20 61 70 70 6c 69 63  2d 0a 61 74 69 6f 6e 20  |n applic-.ation |
00005790  63 61 6e 20 67 61 69 6e  20 63 6f 6d 70 6c 65 74  |can gain complet|
000057a0  65 20 63 6f 6e 74 72 6f  6c 20 6f 66 20 74 68 65  |e control of the|
000057b0  20 6d 6f 64 75 6c 65 2c  20 62 75 74 20 61 73 20  | module, but as |
000057c0  61 20 72 65 73 75 6c 74  2c 20 74 68 69 73 20 66  |a result, this f|
000057d0  65 61 74 75 72 65 0a 6d  75 73 74 20 62 65 20 75  |eature.must be u|
000057e0  73 65 64 20 63 61 72 65  66 75 6c 6c 79 2c 20 62  |sed carefully, b|
000057f0  65 63 61 75 73 65 20 74  68 65 20 6d 6f 64 75 6c  |ecause the modul|
00005800  65 20 63 61 6e 6e 6f 74  20 74 68 65 6e 20 62 65  |e cannot then be|
00005810  20 75 6e 6c 6f 63 6b 65  64 20 75 6e 6c 65 73 73  | unlocked unless|
00005820  0a 74 68 65 20 63 6f 64  65 20 73 70 65 63 69 66  |.the code specif|
00005830  69 65 64 20 69 6e 20 74  68 65 20 6c 6f 63 6b 20  |ied in the lock |
00005840  53 57 49 20 69 73 20 6b  6e 6f 77 6e 20 28 61 6e  |SWI is known (an|
00005850  64 20 69 66 20 6e 6f 74  2c 20 74 68 65 20 6d 6f  |d if not, the mo|
00005860  64 75 6c 65 20 6d 75 73  74 20 62 65 0a 72 65 2d  |dule must be.re-|
00005870  69 6e 69 74 69 61 6c 69  73 65 64 29 2e 0a 20 57  |initialised).. W|
00005880  68 65 6e 20 74 68 65 20  6d 6f 64 75 6c 65 20 69  |hen the module i|
00005890  73 20 6c 6f 63 6b 65 64  2c 20 63 61 6c 6c 69 6e  |s locked, callin|
000058a0  67 20 61 6e 79 20 63 6f  6d 6d 61 6e 64 73 20 6f  |g any commands o|
000058b0  72 20 53 57 49 27 73 20  77 68 69 63 68 20 61 6c  |r SWI's which al|
000058c0  74 65 72 0a 61 6e 79 74  68 69 6e 67 20 28 73 75  |ter.anything (su|
000058d0  63 68 20 61 73 20 63 68  61 6e 67 69 6e 67 20 74  |ch as changing t|
000058e0  68 65 20 63 75 72 72 65  6e 74 20 70 6c 61 79 20  |he current play |
000058f0  70 6f 73 69 74 69 6f 6e  2c 20 6c 6f 61 64 69 6e  |position, loadin|
00005900  67 20 6f 72 20 6b 69 6c  6c 69 6e 67 0a 74 75 6e  |g or killing.tun|
00005910  65 73 2c 20 70 6c 61 79  69 6e 67 20 6e 6f 74 65  |es, playing note|
00005920  73 29 20 77 69 6c 6c 20  63 61 75 73 65 20 61 6e  |s) will cause an|
00005930  20 65 72 72 6f 72 2c 20  62 75 74 20 53 57 49 27  | error, but SWI'|
00005940  73 20 72 65 74 75 72 6e  69 6e 67 20 69 6e 66 6f  |s returning info|
00005950  72 6d 61 74 69 6f 6e 0a  77 69 6c 6c 20 66 75 6e  |rmation.will fun|
00005960  63 74 69 6f 6e 20 61 73  20 6e 6f 72 6d 61 6c 2e  |ction as normal.|
00005970  20 46 6f 72 20 74 68 65  20 61 70 70 6c 69 63 61  | For the applica|
00005980  74 69 6f 6e 20 77 68 69  63 68 20 69 73 20 72 65  |tion which is re|
00005990  73 70 6f 6e 73 69 62 6c  65 20 66 6f 72 20 74 68  |sponsible for th|
000059a0  65 0a 6c 6f 63 6b 69 6e  67 20 74 6f 20 62 65 20  |e.locking to be |
000059b0  61 62 6c 65 20 74 6f 20  75 73 65 20 74 68 65 20  |able to use the |
000059c0  61 66 66 65 63 74 65 64  20 53 57 49 27 73 2c 20  |affected SWI's, |
000059d0  52 34 20 6d 75 73 74 20  62 65 20 73 65 74 20 74  |R4 must be set t|
000059e0  6f 20 74 68 65 20 6c 6f  63 6b 69 6e 67 0a 63 6f  |o the locking.co|
000059f0  64 65 20 28 70 61 73 73  65 64 20 69 6e 20 52 30  |de (passed in R0|
00005a00  29 20 62 65 66 6f 72 65  20 61 6e 79 20 6f 66 20  |) before any of |
00005a10  74 68 65 20 61 66 66 65  63 74 65 64 20 53 57 49  |the affected SWI|
00005a20  27 73 20 69 73 20 63 61  6c 6c 65 64 20 28 6e 6f  |'s is called (no|
00005a30  20 63 6f 6d 6d 61 6e 64  73 0a 77 69 6c 6c 20 77  | commands.will w|
00005a40  6f 72 6b 20 65 76 65 6e  20 69 66 20 74 68 65 20  |ork even if the |
00005a50  6c 6f 63 6b 69 6e 67 20  63 6f 64 65 20 69 73 20  |locking code is |
00005a60  6b 6e 6f 77 6e 29 2e 0a  20 49 66 20 74 68 65 20  |known).. If the |
00005a70  74 72 61 63 6b 65 72 6d  6f 64 75 6c 65 20 69 73  |trackermodule is|
00005a80  20 61 6c 72 65 61 64 79  20 27 6c 6f 63 6b 65 64  | already 'locked|
00005a90  27 20 77 68 65 6e 20 74  68 69 73 20 53 57 49 20  |' when this SWI |
00005aa0  69 73 20 63 61 6c 6c 65  64 2c 20 61 6e 20 65 72  |is called, an er|
00005ab0  72 6f 72 0a 77 69 6c 6c  20 62 65 20 67 65 6e 65  |ror.will be gene|
00005ac0  72 61 74 65 64 2e 0a 20  49 74 20 69 73 20 61 64  |rated.. It is ad|
00005ad0  76 69 73 61 62 6c 65 20  74 6f 20 61 76 6f 69 64  |visable to avoid|
00005ae0  20 75 73 69 6e 67 20 74  68 69 73 20 63 61 6c 6c  | using this call|
00005af0  20 75 6e 6c 65 73 73 20  61 62 73 6f 6c 75 74 65  | unless absolute|
00005b00  6c 79 20 6e 65 63 63 65  73 73 61 72 79 2e 0a 20  |ly neccessary.. |
00005b10  20 20 20 20 20 20 20 20  20 20 0a 0a 54 68 65 20  |          ..The |
00005b20  72 65 73 74 72 69 63 74  65 64 20 63 6f 6d 6d 61  |restricted comma|
00005b30  6e 64 73 20 61 72 65 3a  0a 2a 50 6c 61 79 4d 6f  |nds are:.*PlayMo|
00005b40  64 2c 20 2a 50 6c 61 79  50 61 75 73 65 2c 20 2a  |d, *PlayPause, *|
00005b50  50 6c 61 79 53 74 61 72  74 2c 20 2a 50 6c 61 79  |PlayStart, *Play|
00005b60  50 6f 73 2c 20 2a 50 6c  61 79 53 74 65 72 65 6f  |Pos, *PlayStereo|
00005b70  2c 20 2a 50 6c 61 79 53  74 6f 70 2c 0a 2a 50 6c  |, *PlayStop,.*Pl|
00005b80  61 79 56 6f 6c 75 6d 65  2e 0a 0a 54 68 65 20 72  |ayVolume...The r|
00005b90  65 73 74 72 69 63 74 65  64 20 53 57 49 27 73 20  |estricted SWI's |
00005ba0  61 72 65 3a 20 20 20 20  20 20 20 20 20 20 20 20  |are:            |
00005bb0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00005bc0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 0a 54  |              .T|
00005bd0  72 61 63 6b 65 72 5f 4c  6f 61 64 2c 20 54 72 61  |racker_Load, Tra|
00005be0  63 6b 65 72 5f 4d 65 6d  6f 72 79 4c 6f 61 64 2c  |cker_MemoryLoad,|
00005bf0  20 54 72 61 63 6b 65 72  5f 50 6c 61 79 2c 20 54  | Tracker_Play, T|
00005c00  72 61 63 6b 65 72 5f 53  74 6f 70 2c 20 54 72 61  |racker_Stop, Tra|
00005c10  63 6b 65 72 5f 53 74 65  72 65 6f 2c 0a 54 72 61  |cker_Stereo,.Tra|
00005c20  63 6b 65 72 5f 53 65 74  50 6f 73 2c 20 54 72 61  |cker_SetPos, Tra|
00005c30  63 6b 65 72 5f 50 6c 61  79 4e 6f 74 65 2c 20 54  |cker_PlayNote, T|
00005c40  72 61 63 6b 65 72 5f 56  6f 6c 75 6d 65 2e 0a 0a  |racker_Volume...|
00005c50  0a 20 20 20 20 20 20 20  20 20 20 20 0a 0a 2d 2d  |.           ..--|
00005c60  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00005c70  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00005c80  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00005c90  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00005ca0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 0a 54 72 61 63  |-----------.Trac|
00005cb0  6b 65 72 5f 55 6e 6c 6f  63 6b 20 20 20 20 20 20  |ker_Unlock      |
00005cc0  20 20 20 20 20 20 28 53  57 49 20 26 34 33 32 30  |      (SWI &4320|
00005cd0  45 29 0a 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |E).-------------|
00005ce0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00005d10  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00005d20  0a 0a 4f 6e 20 45 6e 74  72 79 3a 20 20 52 30 20  |..On Entry:  R0 |
00005d30  3d 20 6c 6f 63 6b 69 6e  67 20 63 6f 64 65 20 28  |= locking code (|
00005d40  73 70 65 63 69 66 69 65  64 20 69 6e 20 54 72 61  |specified in Tra|
00005d50  63 6b 65 72 5f 4c 6f 63  6b 29 0a 0a 4f 6e 20 45  |cker_Lock)..On E|
00005d60  78 69 74 20 3a 20 20 2d  0a 0a 0a 20 54 68 69 73  |xit :  -... This|
00005d70  20 53 57 49 20 73 68 6f  75 6c 64 20 62 65 20 63  | SWI should be c|
00005d80  61 6c 6c 65 64 20 74 6f  20 75 6e 6c 6f 63 6b 20  |alled to unlock |
00005d90  74 68 65 20 6d 6f 64 75  6c 65 20 61 66 74 65 72  |the module after|
00005da0  20 69 74 20 68 61 73 20  62 65 65 6e 20 6c 6f 63  | it has been loc|
00005db0  6b 65 64 20 77 69 74 68  0a 27 54 72 61 63 6b 65  |ked with.'Tracke|
00005dc0  72 5f 4c 6f 63 6b 27 2e  20 49 66 20 74 68 65 20  |r_Lock'. If the |
00005dd0  76 61 6c 75 65 20 70 61  73 73 65 64 20 69 6e 20  |value passed in |
00005de0  52 30 20 69 73 20 64 69  66 66 65 72 65 6e 74 20  |R0 is different |
00005df0  74 6f 20 74 68 65 20 6c  6f 63 6b 69 6e 67 20 63  |to the locking c|
00005e00  6f 64 65 0a 67 69 76 65  6e 20 69 6e 20 74 68 65  |ode.given in the|
00005e10  20 6c 6f 63 6b 20 53 57  49 2c 20 6f 72 20 74 68  | lock SWI, or th|
00005e20  65 20 6d 6f 64 75 6c 65  20 68 61 73 20 6e 6f 74  |e module has not|
00005e30  20 62 65 65 6e 20 6c 6f  63 6b 65 64 2c 20 61 6e  | been locked, an|
00005e40  20 65 72 72 6f 72 20 69  73 0a 67 65 6e 65 72 61  | error is.genera|
00005e50  74 65 64 2e 0a 0a 0a 0a  0a 2d 2d 2d 2d 2d 2d 2d  |ted......-------|
00005e60  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00005e70  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00005ea0  2d 2d 2d 2d 2d 2d 0a 54  72 61 63 6b 65 72 5f 4d  |------.Tracker_M|
00005eb0  75 74 65 43 68 61 6e 6e  65 6c 20 20 20 20 20 20  |uteChannel      |
00005ec0  20 28 53 57 49 20 26 34  33 32 30 46 29 0a 2d 2d  | (SWI &4320F).--|
00005ed0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00005f10  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 0a 0a 4f 6e 20  |-----------..On |
00005f20  45 6e 74 72 79 3a 20 20  52 30 20 3d 20 63 68 61  |Entry:  R0 = cha|
00005f30  6e 6e 65 6c 20 74 6f 20  6d 75 74 65 20 28 31 2d  |nnel to mute (1-|
00005f40  38 29 0a 0a 4f 6e 20 45  78 69 74 20 3a 20 20 2d  |8)..On Exit :  -|
00005f50  0a 0a 0a 20 54 68 69 73  20 53 57 49 20 61 6c 6c  |... This SWI all|
00005f60  6f 77 73 20 79 6f 75 20  74 6f 20 74 75 72 6e 20  |ows you to turn |
00005f70  6f 66 66 20 73 65 6c 65  63 74 65 64 20 63 68 61  |off selected cha|
00005f80  6e 6e 65 6c 73 20 77 68  69 6c 65 20 6c 65 61 76  |nnels while leav|
00005f90  69 6e 67 20 61 6c 6c 20  74 68 65 0a 6f 74 68 65  |ing all the.othe|
00005fa0  72 20 63 68 61 6e 6e 65  6c 73 20 75 6e 61 66 66  |r channels unaff|
00005fb0  65 63 74 65 64 2e 20 54  68 65 20 63 68 61 6e 6e  |ected. The chann|
00005fc0  65 6c 73 20 63 61 6e 20  62 65 20 74 75 72 6e 65  |els can be turne|
00005fd0  64 20 62 61 63 6b 20 6f  6e 20 62 79 20 75 73 69  |d back on by usi|
00005fe0  6e 67 20 74 68 65 0a 27  54 72 61 63 6b 65 72 5f  |ng the.'Tracker_|
00005ff0  52 65 73 74 6f 72 65 43  68 61 6e 6e 65 6c 27 20  |RestoreChannel' |
00006000  53 57 49 2e 0a 20 4e 6f  20 65 72 72 6f 72 20 69  |SWI.. No error i|
00006010  73 20 67 65 6e 65 72 61  74 65 64 20 69 66 20 74  |s generated if t|
00006020  68 65 20 63 68 61 6e 6e  65 6c 20 6e 75 6d 62 65  |he channel numbe|
00006030  72 20 69 73 20 68 69 67  68 65 72 20 74 68 61 6e  |r is higher than|
00006040  20 74 68 65 20 6e 75 6d  62 65 72 20 6f 66 0a 63  | the number of.c|
00006050  68 61 6e 6e 65 6c 73 20  61 63 74 75 61 6c 6c 79  |hannels actually|
00006060  20 62 65 69 6e 67 20 75  73 65 64 20 62 79 20 74  | being used by t|
00006070  68 65 20 74 72 61 63 6b  65 72 6d 6f 64 75 6c 65  |he trackermodule|
00006080  2e 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |..              |
00006090  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000060b0  20 20 20 20 20 20 20 20  0a 0a 0a 2d 2d 2d 2d 2d  |        ...-----|
000060c0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00006100  2d 2d 2d 2d 2d 2d 2d 2d  0a 54 72 61 63 6b 65 72  |--------.Tracker|
00006110  5f 52 65 73 74 6f 72 65  43 68 61 6e 6e 65 6c 20  |_RestoreChannel |
00006120  20 20 20 28 53 57 49 20  26 34 33 32 31 30 29 0a  |   (SWI &43210).|
00006130  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00006170  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 0a 0a 4f  |-------------..O|
00006180  6e 20 45 6e 74 72 79 3a  20 20 52 30 20 3d 20 63  |n Entry:  R0 = c|
00006190  68 61 6e 6e 65 6c 20 74  6f 20 74 75 72 6e 20 6f  |hannel to turn o|
000061a0  6e 20 28 31 2d 38 29 0a  0a 4f 6e 20 45 78 69 74  |n (1-8)..On Exit|
000061b0  20 3a 20 20 2d 0a 0a 0a  20 54 68 69 73 20 53 57  | :  -... This SW|
000061c0  49 20 77 69 6c 6c 20 72  65 76 65 72 73 65 20 74  |I will reverse t|
000061d0  68 65 20 65 66 66 65 63  74 20 6f 66 20 61 20 27  |he effect of a '|
000061e0  54 72 61 63 6b 65 72 5f  4d 75 74 65 43 68 61 6e  |Tracker_MuteChan|
000061f0  6e 65 6c 27 20 53 57 49  2c 20 61 6e 64 20 74 75  |nel' SWI, and tu|
00006200  72 6e 0a 74 68 65 20 73  65 6c 65 63 74 65 64 20  |rn.the selected |
00006210  63 68 61 6e 6e 65 6c 20  62 61 63 6b 20 6f 6e 2e  |channel back on.|
00006220  0a 20 4e 6f 20 65 72 72  6f 72 20 69 73 20 67 65  |. No error is ge|
00006230  6e 65 72 61 74 65 64 20  69 66 20 74 68 65 20 63  |nerated if the c|
00006240  68 61 6e 6e 65 6c 20 6e  75 6d 62 65 72 20 69 73  |hannel number is|
00006250  20 68 69 67 68 65 72 20  74 68 61 6e 20 74 68 65  | higher than the|
00006260  20 6e 75 6d 62 65 72 20  6f 66 0a 63 68 61 6e 6e  | number of.chann|
00006270  65 6c 73 20 61 63 74 75  61 6c 6c 79 20 62 65 69  |els actually bei|
00006280  6e 67 20 75 73 65 64 20  62 79 20 74 68 65 20 74  |ng used by the t|
00006290  72 61 63 6b 65 72 6d 6f  64 75 6c 65 2e 0a 20 20  |rackermodule..  |
000062a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000062b0  20 20 20 20 20 20 20 20  20 0a 0a 0a 2d 2d 2d 2d  |         ...----|
000062c0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00006300  2d 2d 2d 2d 2d 2d 2d 2d  2d 0a 54 72 61 63 6b 65  |---------.Tracke|
00006310  72 5f 53 70 65 65 64 20  20 20 20 20 20 20 20 20  |r_Speed         |
00006320  20 20 20 20 28 53 57 49  20 26 34 33 32 31 31 29  |    (SWI &43211)|
00006330  0a 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
00006340  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00006370  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 0a 0a  |--------------..|
00006380  4f 6e 20 45 6e 74 72 79  3a 20 20 52 30 20 3d 20  |On Entry:  R0 = |
00006390  6e 65 77 20 73 70 65 65  64 20 73 65 74 74 69 6e  |new speed settin|
000063a0  67 20 28 30 2d 33 29 0a  0a 4f 6e 20 45 78 69 74  |g (0-3)..On Exit|
000063b0  20 3a 20 20 2d 0a 0a 0a  20 54 68 69 73 20 53 57  | :  -... This SW|
000063c0  49 20 77 69 6c 6c 20 73  65 6c 65 63 74 20 74 68  |I will select th|
000063d0  65 20 66 75 74 75 72 65  20 73 61 6d 70 6c 65 20  |e future sample |
000063e0  72 61 74 65 20 61 6e 64  20 6f 76 65 72 61 6c 6c  |rate and overall|
000063f0  20 70 69 74 63 68 20 74  6f 20 63 61 74 65 72 20  | pitch to cater |
00006400  66 6f 72 0a 56 49 44 43  20 65 6e 68 61 6e 63 65  |for.VIDC enhance|
00006410  72 73 20 61 6e 64 20 38  2d 63 68 61 6e 6e 65 6c  |rs and 8-channel|
00006420  20 74 75 6e 65 73 2c 20  74 61 6b 69 6e 67 20 65  | tunes, taking e|
00006430  66 66 65 63 74 20 69 6d  6d 65 64 69 61 74 65 6c  |ffect immediatel|
00006440  79 20 69 66 20 61 20 74  75 6e 65 20 69 73 0a 63  |y if a tune is.c|
00006450  75 72 72 65 6e 74 6c 79  20 70 6c 61 79 69 6e 67  |urrently playing|
00006460  2e 0a 20 46 6f 72 20 64  65 74 61 69 6c 73 20 6f  |.. For details o|
00006470  66 20 74 68 65 20 64 69  66 66 65 72 65 6e 74 20  |f the different |
00006480  6f 70 74 69 6f 6e 73 20  73 65 65 20 74 68 65 20  |options see the |
00006490  63 6f 6d 6d 61 6e 64 20  2a 50 6c 61 79 53 70 65  |command *PlaySpe|
000064a0  65 64 2e 0a 20 54 68 69  73 20 53 57 49 20 69 73  |ed.. This SWI is|
000064b0  20 6e 6f 74 20 69 6e 63  6c 75 64 65 64 20 69 6e  | not included in|
000064c0  20 74 68 65 20 6c 6f 63  6b 69 6e 67 20 73 79 73  | the locking sys|
000064d0  74 65 6d 20 62 65 63 61  75 73 65 20 69 74 20 77  |tem because it w|
000064e0  61 73 20 6f 6e 6c 79 20  69 6e 74 72 6f 2d 0a 64  |as only intro-.d|
000064f0  75 63 65 64 20 69 6e 20  76 65 72 73 69 6f 6e 20  |uced in version |
00006500  34 2e 30 34 2c 20 61 6e  64 20 73 6f 6d 65 20 70  |4.04, and some p|
00006510  72 6f 67 72 61 6d 73 20  6d 61 79 20 68 61 76 65  |rograms may have|
00006520  20 61 6c 72 65 61 64 79  20 62 65 65 6e 20 77 72  | already been wr|
00006530  69 74 74 65 6e 20 77 68  69 63 68 0a 75 73 65 20  |itten which.use |
00006540  74 68 65 20 6c 6f 63 6b  69 6e 67 20 73 79 73 74  |the locking syst|
00006550  65 6d 20 62 75 74 20 64  6f 6e 27 74 20 63 6f 6e  |em but don't con|
00006560  74 72 6f 6c 20 74 68 65  20 73 61 6d 70 6c 65 20  |trol the sample |
00006570  73 70 65 65 64 2f 70 69  74 63 68 20 65 74 63 2e  |speed/pitch etc.|
00006580  0a 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |..              |
00006590  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000065b0  20 0a 0a 0a 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  | ...------------|
000065c0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00006600  2d 0a 54 72 61 63 6b 65  72 5f 56 6f 6c 75 6d 65  |-.Tracker_Volume|
00006610  20 20 20 20 20 20 20 20  20 20 20 20 28 53 57 49  |            (SWI|
00006620  20 26 34 33 32 31 32 29  0a 2d 2d 2d 2d 2d 2d 2d  | &43212).-------|
00006630  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00006670  2d 2d 2d 2d 2d 2d 0a 0a  4f 6e 20 45 6e 74 72 79  |------..On Entry|
00006680  3a 20 20 52 30 20 3d 20  6e 65 77 20 6f 76 65 72  |:  R0 = new over|
00006690  61 6c 6c 20 76 6f 6c 75  6d 65 20 28 30 2d 31 32  |all volume (0-12|
000066a0  37 29 20 6f 72 20 2d 31  20 74 6f 20 72 65 61 64  |7) or -1 to read|
000066b0  20 76 6f 6c 75 6d 65 0a  0a 4f 6e 20 45 78 69 74  | volume..On Exit|
000066c0  20 3a 20 20 52 30 20 3d  20 6f 6c 64 20 76 6f 6c  | :  R0 = old vol|
000066d0  75 6d 65 0a 0a 0a 20 54  68 69 73 20 53 57 49 20  |ume... This SWI |
000066e0  77 69 6c 6c 20 73 65 74  20 74 68 65 20 6f 76 65  |will set the ove|
000066f0  72 61 6c 6c 20 76 6f 6c  75 6d 65 20 6f 66 20 61  |rall volume of a|
00006700  6e 79 20 74 75 6e 65 73  20 70 6c 61 79 69 6e 67  |ny tunes playing|
00006710  20 62 79 20 73 75 62 74  72 61 63 74 69 6e 67 0a  | by subtracting.|
00006720  28 32 35 34 2d 76 6f 6c  75 6d 65 2a 32 29 20 66  |(254-volume*2) f|
00006730  72 6f 6d 20 74 68 65 20  76 6f 6c 75 6d 65 20 6f  |rom the volume o|
00006740  66 20 61 6e 79 20 73 61  6d 70 6c 65 20 70 6c 61  |f any sample pla|
00006750  79 69 6e 67 2e 20 54 68  69 73 20 74 61 6b 65 73  |ying. This takes|
00006760  20 65 66 66 65 63 74 0a  69 6d 6d 65 64 69 61 74  | effect.immediat|
00006770  65 6c 79 2c 20 61 6e 64  20 61 6c 73 6f 20 61 66  |ely, and also af|
00006780  66 65 63 74 73 20 73 61  6d 70 6c 65 73 20 77 68  |fects samples wh|
00006790  69 63 68 20 61 72 65 20  69 6e 20 6d 69 64 2d 70  |ich are in mid-p|
000067a0  6c 61 79 2e 0a 20 43 61  6c 6c 69 6e 67 20 74 68  |lay.. Calling th|
000067b0  65 20 53 57 49 20 77 69  74 68 20 52 30 3d 2d 31  |e SWI with R0=-1|
000067c0  20 77 69 6c 6c 20 72 65  74 75 72 6e 20 74 68 65  | will return the|
000067d0  20 63 75 72 72 65 6e 74  20 76 6f 6c 75 6d 65 20  | current volume |
000067e0  69 6e 20 52 30 2e 0a 20  59 6f 75 20 63 61 6e 20  |in R0.. You can |
000067f0  75 73 65 20 74 68 69 73  20 53 57 49 20 74 6f 20  |use this SWI to |
00006800  70 72 6f 76 69 64 65 20  73 6d 6f 6f 74 68 20 66  |provide smooth f|
00006810  61 64 65 2d 6f 75 74 73  20 61 6e 64 20 66 61 64  |ade-outs and fad|
00006820  65 2d 69 6e 73 2c 20 66  6f 72 20 65 78 61 6d 70  |e-ins, for examp|
00006830  6c 65 2e 0a 20 54 68 69  73 20 53 57 49 20 69 73  |le.. This SWI is|
00006840  20 70 61 72 74 20 6f 66  20 74 68 65 20 6c 6f 63  | part of the loc|
00006850  6b 69 6e 67 20 73 79 73  74 65 6d 2e 0a 0a 20 20  |king system...  |
00006860  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00006880  20 20 20 20 20 20 20 20  20 20 20 20 20 0a 0a 2d  |             ..-|
00006890  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000068d0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 0a 54 72 61  |------------.Tra|
000068e0  63 6b 65 72 5f 54 72 61  6e 73 6c 61 74 65 56 6f  |cker_TranslateVo|
000068f0  6c 75 6d 65 20 20 20 28  53 57 49 20 26 34 33 32  |lume   (SWI &432|
00006900  31 34 29 0a 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |14).------------|
00006910  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00006950  2d 0a 0a 4f 6e 20 45 6e  74 72 79 3a 20 20 52 30  |-..On Entry:  R0|
00006960  20 3d 20 53 6f 75 6e 64  74 72 61 63 6b 65 72 20  | = Soundtracker |
00006970  76 6f 6c 75 6d 65 20 74  6f 20 63 6f 6e 76 65 72  |volume to conver|
00006980  74 20 28 30 2d 36 34 29  0a 0a 4f 6e 20 45 78 69  |t (0-64)..On Exi|
00006990  74 20 3a 20 20 52 30 20  3d 20 4c 6f 67 61 72 69  |t :  R0 = Logari|
000069a0  74 68 6d 69 63 20 76 6f  6c 75 6d 65 20 28 30 2d  |thmic volume (0-|
000069b0  32 35 35 29 2c 20 32 35  35 3d 6d 61 78 2e 0a 0a  |255), 255=max...|
000069c0  54 68 69 73 20 53 57 49  20 77 69 6c 6c 20 63 6f  |This SWI will co|
000069d0  6e 76 65 72 74 20 61 20  73 6f 75 6e 64 74 72 61  |nvert a soundtra|
000069e0  63 6b 65 72 20 76 6f 6c  75 6d 65 20 28 61 73 20  |cker volume (as |
000069f0  72 65 74 75 72 6e 65 64  20 62 79 20 74 68 65 20  |returned by the |
00006a00  53 57 49 0a 54 72 61 63  6b 65 72 5f 52 65 61 64  |SWI.Tracker_Read|
00006a10  53 61 6d 70 6c 65 54 61  62 6c 65 20 77 68 65 6e  |SampleTable when|
00006a20  20 61 20 73 6f 75 6e 64  74 72 61 63 6b 65 72 20  | a soundtracker |
00006a30  74 75 6e 65 20 69 73 20  70 6c 61 79 69 6e 67 29  |tune is playing)|
00006a40  20 69 6e 74 6f 20 61 20  54 72 61 63 6b 65 72 0a  | into a Tracker.|
00006a50  66 6f 72 6d 61 74 20 6c  6f 67 61 72 69 74 68 6d  |format logarithm|
00006a60  69 63 20 76 6f 6c 75 6d  65 20 28 30 2d 32 35 35  |ic volume (0-255|
00006a70  29 2e 0a 0a 0a 0a 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |).....----------|
00006a80  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00006ac0  2d 2d 2d 0a 54 72 61 63  6b 65 72 5f 55 70 64 61  |---.Tracker_Upda|
00006ad0  74 65 44 61 74 61 20 20  20 20 20 20 20 20 28 53  |teData        (S|
00006ae0  57 49 20 26 34 33 32 31  35 29 0a 2d 2d 2d 2d 2d  |WI &43215).-----|
00006af0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00006b30  2d 2d 2d 2d 2d 2d 2d 2d  0a 0a 4f 6e 20 45 6e 74  |--------..On Ent|
00006b40  72 79 3a 20 20 2d 0a 0a  4f 6e 20 45 78 69 74 20  |ry:  -..On Exit |
00006b50  3a 20 20 2d 0a 0a 54 68  69 73 20 69 73 20 72 65  |:  -..This is re|
00006b60  61 6c 6c 79 20 61 6e 20  65 64 69 74 6f 72 20 53  |ally an editor S|
00006b70  57 49 20 77 68 69 63 68  20 79 6f 75 20 73 68 6f  |WI which you sho|
00006b80  75 6c 64 20 63 61 6c 6c  20 77 68 65 6e 65 76 65  |uld call wheneve|
00006b90  72 20 79 6f 75 20 61 6c  74 65 72 20 6f 6e 65 20  |r you alter one |
00006ba0  6f 66 0a 74 68 65 20 66  6f 6c 6c 6f 77 69 6e 67  |of.the following|
00006bb0  2c 20 73 6f 20 74 68 61  74 20 74 68 65 20 6d 6f  |, so that the mo|
00006bc0  64 75 6c 65 20 63 61 6e  20 75 70 64 61 74 65 20  |dule can update |
00006bd0  69 74 73 20 64 61 74 61  3a 2d 0a 20 2a 20 4e 75  |its data:-. * Nu|
00006be0  6d 62 65 72 20 6f 66 20  76 6f 69 63 65 73 20 28  |mber of voices (|
00006bf0  61 6e 64 20 74 68 65 72  65 66 6f 72 65 20 70 61  |and therefore pa|
00006c00  74 74 65 72 6e 20 6c 65  6e 67 74 68 29 0a 20 2a  |ttern length). *|
00006c10  20 53 61 6d 70 6c 65 20  6c 65 6e 67 74 68 2f 6c  | Sample length/l|
00006c20  6f 61 64 20 6e 65 77 20  73 61 6d 70 6c 65 0a 20  |oad new sample. |
00006c30  2a 20 4d 75 73 69 63 20  6c 65 6e 67 74 68 0a 20  |* Music length. |
00006c40  2a 20 53 74 65 72 65 6f  20 73 65 74 74 69 6e 67  |* Stereo setting|
00006c50  73 20 28 54 72 61 63 6b  65 72 29 0a 20 20 20 20  |s (Tracker).    |
00006c60  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00006c80  20 20 20 20 20 20 20 20  20 20 20 0a 0a 3d 3d 3d  |           ..===|
00006c90  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00006cd0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 0a 0a 4e 6f 74 65  |==========..Note|
00006ce0  20 74 72 61 6e 73 6c 61  74 69 6f 6e 20 74 61 62  | translation tab|
00006cf0  6c 65 0a 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |le.-------------|
00006d00  2d 2d 2d 2d 2d 2d 2d 2d  2d 0a 0a 54 68 65 20 74  |---------..The t|
00006d10  72 61 63 6b 65 72 20 66  6f 72 6d 61 74 20 6e 6f  |racker format no|
00006d20  74 65 20 6e 75 6d 62 65  72 73 20 61 6e 64 20 74  |te numbers and t|
00006d30  68 65 20 6e 6f 74 65 73  20 74 68 65 79 20 72 65  |he notes they re|
00006d40  66 65 72 20 74 6f 20 61  72 65 20 61 73 20 66 6f  |fer to are as fo|
00006d50  6c 6c 6f 77 73 3a 0a 0a  6e 6f 2e 20 20 6e 6f 74  |llows:..no.  not|
00006d60  65 20 20 20 73 61 6d 70  6c 65 20 70 65 72 69 6f  |e   sample perio|
00006d70  64 0a 2d 2d 2d 20 20 2d  2d 2d 2d 20 20 20 2d 2d  |d.---  ----   --|
00006d80  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 0a 31 20 20 20  |-----------.1   |
00006d90  20 43 20 2d 31 20 20 20  26 33 35 38 0a 32 20 20  | C -1   &358.2  |
00006da0  20 20 43 23 2d 31 20 20  20 26 33 32 38 0a 33 20  |  C#-1   &328.3 |
00006db0  20 20 20 44 20 2d 31 20  20 20 26 32 46 41 0a 34  |   D -1   &2FA.4|
00006dc0  20 20 20 20 44 23 2d 31  20 20 20 26 32 44 30 0a  |    D#-1   &2D0.|
00006dd0  35 20 20 20 20 45 20 2d  31 20 20 20 26 32 41 36  |5    E -1   &2A6|
00006de0  0a 36 20 20 20 20 46 20  2d 31 20 20 20 26 32 38  |.6    F -1   &28|
00006df0  30 0a 37 20 20 20 20 46  23 2d 31 20 20 20 26 32  |0.7    F#-1   &2|
00006e00  35 43 0a 38 20 20 20 20  47 20 2d 31 20 20 20 26  |5C.8    G -1   &|
00006e10  32 33 41 0a 39 20 20 20  20 47 23 2d 31 20 20 20  |23A.9    G#-1   |
00006e20  26 32 31 41 0a 31 30 20  20 20 41 20 2d 31 20 20  |&21A.10   A -1  |
00006e30  20 26 31 46 43 0a 31 31  20 20 20 41 23 2d 31 20  | &1FC.11   A#-1 |
00006e40  20 20 26 31 45 30 0a 31  32 20 20 20 42 20 2d 31  |  &1E0.12   B -1|
00006e50  20 20 20 26 31 43 35 0a  31 33 20 20 20 43 20 2d  |   &1C5.13   C -|
00006e60  32 20 20 20 26 31 41 43  0a 31 34 20 20 20 43 23  |2   &1AC.14   C#|
00006e70  2d 32 20 20 20 26 31 39  34 0a 31 35 20 20 20 44  |-2   &194.15   D|
00006e80  20 2d 32 20 20 20 26 31  37 44 0a 31 36 20 20 20  | -2   &17D.16   |
00006e90  44 23 2d 32 20 20 20 26  31 36 38 0a 31 37 20 20  |D#-2   &168.17  |
00006ea0  20 45 20 2d 32 20 20 20  26 31 35 33 0a 31 38 20  | E -2   &153.18 |
00006eb0  20 20 46 20 2d 32 20 20  20 26 31 34 30 0a 31 39  |  F -2   &140.19|
00006ec0  20 20 20 46 23 2d 32 20  20 20 26 31 32 45 0a 32  |   F#-2   &12E.2|
00006ed0  30 20 20 20 47 20 2d 32  20 20 20 26 31 31 44 0a  |0   G -2   &11D.|
00006ee0  32 31 20 20 20 47 23 2d  32 20 20 20 26 31 30 44  |21   G#-2   &10D|
00006ef0  0a 32 32 20 20 20 41 20  2d 32 20 20 20 20 26 46  |.22   A -2    &F|
00006f00  45 0a 32 33 20 20 20 41  23 2d 32 20 20 20 20 26  |E.23   A#-2    &|
00006f10  46 30 0a 32 34 20 20 20  42 20 2d 32 20 20 20 20  |F0.24   B -2    |
00006f20  26 45 32 0a 32 35 20 20  20 43 20 2d 33 20 20 20  |&E2.25   C -3   |
00006f30  20 26 44 36 0a 32 36 20  20 20 43 23 2d 33 20 20  | &D6.26   C#-3  |
00006f40  20 20 26 43 41 0a 32 37  20 20 20 44 20 2d 33 20  |  &CA.27   D -3 |
00006f50  20 20 20 26 42 45 0a 32  38 20 20 20 44 23 2d 33  |   &BE.28   D#-3|
00006f60  20 20 20 20 26 42 34 0a  32 39 20 20 20 45 20 2d  |    &B4.29   E -|
00006f70  33 20 20 20 20 26 41 41  0a 33 30 20 20 20 46 20  |3    &AA.30   F |
00006f80  2d 33 20 20 20 20 26 41  30 0a 33 31 20 20 20 46  |-3    &A0.31   F|
00006f90  23 2d 33 20 20 20 20 26  39 37 0a 33 32 20 20 20  |#-3    &97.32   |
00006fa0  47 20 2d 33 20 20 20 20  26 38 46 0a 33 33 20 20  |G -3    &8F.33  |
00006fb0  20 47 23 2d 33 20 20 20  20 26 38 37 0a 33 34 20  | G#-3    &87.34 |
00006fc0  20 20 41 20 2d 33 20 20  20 20 26 37 46 0a 33 35  |  A -3    &7F.35|
00006fd0  20 20 20 41 23 2d 33 20  20 20 20 26 37 38 0a 33  |   A#-3    &78.3|
00006fe0  36 20 20 20 42 20 2d 33  20 20 20 20 26 37 31 0a  |6   B -3    &71.|
00006ff0  0a 0a 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |..==============|
00007000  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00007030  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 0a  |===============.|
00007040  0a 0a 54 72 61 63 6b 65  72 20 61 6e 64 20 53 6f  |..Tracker and So|
00007050  75 6e 64 74 72 61 63 6b  65 72 20 63 6f 6d 6d 61  |undtracker comma|
00007060  6e 64 73 0a 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |nds.------------|
00007070  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00007080  2d 2d 2d 2d 2d 0a 0a 20  49 6e 20 61 6c 6c 20 74  |-----.. In all t|
00007090  75 6e 65 73 2c 20 74 68  65 72 65 20 61 72 65 20  |unes, there are |
000070a0  73 70 65 63 69 61 6c 20  63 6f 6d 6d 61 6e 64 73  |special commands|
000070b0  20 77 68 69 63 68 20 68  61 76 65 20 61 20 74 79  | which have a ty|
000070c0  70 65 20 28 30 2d 26 46  20 66 6f 72 20 61 6d 69  |pe (0-&F for ami|
000070d0  67 61 2c 0a 30 2d 39 20  26 20 41 2d 5a 20 66 6f  |ga,.0-9 & A-Z fo|
000070e0  72 20 54 72 61 63 6b 65  72 29 20 61 6e 64 20 64  |r Tracker) and d|
000070f0  61 74 61 20 28 75 73 75  61 6c 6c 79 20 70 72 65  |ata (usually pre|
00007100  73 65 6e 74 65 64 20 61  73 20 61 20 68 65 78 20  |sented as a hex |
00007110  62 79 74 65 2c 20 69 65  2e 20 26 58 58 29 2c 0a  |byte, ie. &XX),.|
00007120  77 68 69 63 68 20 69 73  20 73 6f 6d 65 74 69 6d  |which is sometim|
00007130  65 73 20 74 72 65 61 74  65 64 20 61 73 20 74 77  |es treated as tw|
00007140  6f 20 73 65 70 65 72 61  74 65 20 6e 69 62 62 6c  |o seperate nibbl|
00007150  65 73 20 28 69 65 2e 20  61 72 70 65 67 67 69 6f  |es (ie. arpeggio|
00007160  29 2e 0a 20 41 20 6c 69  73 74 20 6f 66 20 74 68  |).. A list of th|
00007170  65 20 63 6f 6d 6d 61 6e  64 73 20 66 6f 75 6e 64  |e commands found|
00007180  20 69 6e 20 54 72 61 63  6b 65 72 2f 53 54 72 61  | in Tracker/STra|
00007190  63 6b 65 72 20 74 75 6e  65 73 20 69 73 20 61 73  |cker tunes is as|
000071a0  20 66 6f 6c 6c 6f 77 73  3a 0a 0a 20 43 6f 6d 6d  | follows:.. Comm|
000071b0  61 6e 64 20 20 20 20 45  66 66 65 63 74 0a 20 2d  |and    Effect. -|
000071c0  2d 2d 2d 2d 2d 2d 20 20  20 20 2d 2d 2d 2d 2d 2d  |------    ------|
000071d0  0a 20 30 20 28 62 6f 74  68 29 20 20 20 41 72 70  |. 0 (both)   Arp|
000071e0  65 67 67 69 6f 20 2d 0a  20 20 20 20 20 20 20 20  |eggio -.        |
000071f0  20 20 20 20 20 20 20 20  20 6e 6f 74 65 32 3d 62  |         note2=b|
00007200  61 73 65 20 6e 6f 74 65  2b 28 66 69 72 73 74 20  |ase note+(first |
00007210  64 69 67 69 74 20 6f 66  20 64 61 74 61 29 20 73  |digit of data) s|
00007220  65 6d 69 74 6f 6e 65 73  0a 20 20 20 20 20 20 20  |emitones.       |
00007230  20 20 20 20 20 20 20 20  20 20 6e 6f 74 65 33 3d  |          note3=|
00007240  20 22 20 20 20 20 20 22  20 2b 28 73 65 63 6f 6e  | "     " +(secon|
00007250  64 20 22 20 20 20 20 22  20 20 20 22 20 20 29 20  |d "    "   "  ) |
00007260  20 20 22 0a 20 20 20 20  20 20 20 20 20 20 20 20  |  ".            |
00007270  20 20 20 50 6c 61 79 20  6e 6f 74 65 33 20 66 6f  |   Play note3 fo|
00007280  72 20 6f 6e 65 20 76 73  79 6e 63 2c 20 74 68 65  |r one vsync, the|
00007290  6e 20 6e 6f 74 65 32 2c  20 62 61 73 65 20 6e 6f  |n note2, base no|
000072a0  74 65 2c 20 6e 6f 74 65  33 2c 20 6e 6f 74 65 32  |te, note3, note2|
000072b0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000072c0  61 6e 64 20 74 68 65 6e  20 74 68 65 20 62 61 73  |and then the bas|
000072d0  65 20 6e 6f 74 65 20 74  6f 20 61 63 68 69 65 76  |e note to achiev|
000072e0  65 20 61 20 63 68 6f 72  64 20 65 66 66 65 63 74  |e a chord effect|
000072f0  20 28 69 65 2e 20 43 2d  32 0a 20 20 20 20 20 20  | (ie. C-2.      |
00007300  20 20 20 20 20 20 20 20  20 77 69 74 68 20 63 6f  |         with co|
00007310  6d 6d 61 6e 64 20 30 20  64 61 74 61 20 27 26 34  |mmand 0 data '&4|
00007320  37 27 20 28 68 65 78 29  20 77 6f 75 6c 64 20 70  |7' (hex) would p|
00007330  6c 61 79 20 61 20 6d 61  6a 6f 72 0a 20 20 20 20  |lay a major.    |
00007340  20 20 20 20 20 20 20 20  20 20 20 61 72 70 65 67  |           arpeg|
00007350  67 69 6f 20 6f 66 20 43  2d 32 2c 20 45 2d 32 2c  |gio of C-2, E-2,|
00007360  20 47 2d 32 2e 20 20 20  20 49 66 20 74 68 65 20  | G-2.    If the |
00007370  73 70 65 65 64 20 69 73  20 6c 65 73 73 20 74 68  |speed is less th|
00007380  61 6e 20 36 2c 0a 20 20  20 20 20 20 20 20 20 20  |an 6,.          |
00007390  20 20 20 20 20 74 68 65  20 61 72 70 65 67 67 69  |     the arpeggi|
000073a0  6f 20 77 69 6c 6c 20 62  65 20 63 75 74 20 73 68  |o will be cut sh|
000073b0  6f 72 74 2e 0a 20 31 20  28 62 6f 74 68 29 20 20  |ort.. 1 (both)  |
000073c0  20 50 69 74 63 68 20 73  6c 69 64 65 20 28 70 6f  | Pitch slide (po|
000073d0  72 74 61 6d 65 6e 74 6f  20 75 70 29 20 2d 0a 20  |rtamento up) -. |
000073e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 77 68  |              wh|
000073f0  69 6c 65 20 74 68 65 20  63 6f 6d 6d 61 6e 64 20  |ile the command |
00007400  69 73 20 70 6c 61 79 69  6e 67 2c 20 44 45 43 52  |is playing, DECR|
00007410  45 4d 45 4e 54 20 74 68  65 20 73 61 6d 70 6c 65  |EMENT the sample|
00007420  20 70 65 72 69 6f 64 20  62 79 0a 20 20 20 20 20  | period by.     |
00007430  20 20 20 20 20 20 20 20  20 20 3c 70 61 72 61 6d  |          <param|
00007440  65 74 65 72 3e 20 28 30  2d 31 35 20 75 73 75 61  |eter> (0-15 usua|
00007450  6c 6c 79 29 2e 20 54 68  69 73 20 68 61 73 20 74  |lly). This has t|
00007460  68 65 20 65 66 66 65 63  74 20 6f 66 20 49 4e 43  |he effect of INC|
00007470  52 45 41 53 49 4e 47 0a  20 20 20 20 20 20 20 20  |REASING.        |
00007480  20 20 20 20 20 20 20 74  68 65 20 70 69 74 63 68  |       the pitch|
00007490  20 73 6d 6f 6f 74 68 6c  79 20 77 69 74 68 6f 75  | smoothly withou|
000074a0  74 20 72 65 73 74 61 72  74 69 6e 67 20 74 68 65  |t restarting the|
000074b0  20 73 61 6d 70 6c 65 2e  20 4e 6f 74 65 20 74 68  | sample. Note th|
000074c0  61 74 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |at.             |
000074d0  20 20 74 68 65 20 70 69  74 63 68 20 67 61 69 6e  |  the pitch gain|
000074e0  65 64 20 62 79 20 61 20  66 69 78 65 64 20 63 68  |ed by a fixed ch|
000074f0  61 6e 67 65 20 74 6f 20  74 68 65 20 73 61 6d 70  |ange to the samp|
00007500  6c 65 20 70 65 72 69 6f  64 20 69 73 20 6e 6f 74  |le period is not|
00007510  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00007520  63 6f 6e 73 74 61 6e 74  20 6f 76 65 72 20 74 68  |constant over th|
00007530  65 20 33 20 6f 63 74 61  76 65 73 2e 0a 20 32 20  |e 3 octaves.. 2 |
00007540  28 62 6f 74 68 29 20 20  20 50 69 74 63 68 20 73  |(both)   Pitch s|
00007550  6c 69 64 65 20 28 70 6f  72 74 61 6d 65 6e 74 6f  |lide (portamento|
00007560  20 64 6f 77 6e 29 20 2d  0a 20 20 20 20 20 20 20  | down) -.       |
00007570  20 20 20 20 20 20 20 20  6c 69 6b 65 20 63 6f 6d  |        like com|
00007580  6d 61 6e 64 20 31 20 62  75 74 20 73 6c 69 64 65  |mand 1 but slide|
00007590  73 20 74 68 65 20 70 69  74 63 68 20 64 6f 77 6e  |s the pitch down|
000075a0  2e 0a 20 33 20 28 61 6d  69 67 61 20 6f 6e 6c 79  |.. 3 (amiga only|
000075b0  29 20 20 20 50 6f 72 74  61 6d 65 6e 74 6f 20 2d  |)   Portamento -|
000075c0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000075d0  53 6f 75 6e 64 73 20 73  69 6d 69 6c 61 72 20 74  |Sounds similar t|
000075e0  6f 20 63 6f 6d 6d 61 6e  64 73 20 31 20 26 20 32  |o commands 1 & 2|
000075f0  2c 20 62 75 74 20 62 65  68 61 76 65 73 20 64 69  |, but behaves di|
00007600  66 66 65 72 65 6e 74 6c  79 2e 0a 20 20 20 20 20  |fferently..     |
00007610  20 20 20 20 20 20 20 20  20 20 57 68 65 6e 20 79  |          When y|
00007620  6f 75 20 75 73 65 20 63  6f 6d 6d 61 6e 64 20 33  |ou use command 3|
00007630  20 77 69 74 68 20 61 20  6e 6f 74 65 20 73 70 65  | with a note spe|
00007640  63 69 66 69 65 64 2c 20  74 68 65 20 6e 6f 74 65  |cified, the note|
00007650  20 69 73 20 6e 6f 74 0a  20 20 20 20 20 20 20 20  | is not.        |
00007660  20 20 20 20 20 20 20 70  6c 61 79 65 64 2c 20 62  |       played, b|
00007670  75 74 20 74 68 65 20 70  69 74 63 68 20 6f 66 20  |ut the pitch of |
00007680  74 68 65 20 6e 6f 74 65  20 69 73 20 73 65 74 20  |the note is set |
00007690  61 73 20 74 68 65 20 27  67 6f 61 6c 27 20 6f 66  |as the 'goal' of|
000076a0  20 74 68 65 0a 20 20 20  20 20 20 20 20 20 20 20  | the.           |
000076b0  20 20 20 20 70 6f 72 74  61 6d 65 6e 74 6f 2e 20  |    portamento. |
000076c0  54 68 65 6e 2c 20 77 68  65 6e 65 76 65 72 20 61  |Then, whenever a|
000076d0  20 63 6f 6d 6d 61 6e 64  20 33 20 63 6f 6d 65 73  | command 3 comes|
000076e0  20 75 70 2c 20 74 68 65  20 70 69 74 63 68 20 69  | up, the pitch i|
000076f0  73 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |s.              |
00007700  20 61 75 74 6f 6d 61 74  69 63 61 6c 6c 79 20 73  | automatically s|
00007710  6c 69 64 65 64 20 69 6e  20 74 68 65 20 61 70 70  |lided in the app|
00007720  72 6f 70 72 69 61 74 65  20 64 69 72 65 63 74 69  |ropriate directi|
00007730  6f 6e 20 62 79 20 74 68  65 20 76 61 6c 75 65 0a  |on by the value.|
00007740  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 6c  |               l|
00007750  61 73 74 20 67 69 76 65  6e 20 61 73 20 61 20 70  |ast given as a p|
00007760  61 72 61 6d 65 74 65 72  20 66 6f 72 20 63 6f 6d  |arameter for com|
00007770  6d 61 6e 64 20 33 2c 20  75 6e 74 69 6c 20 74 68  |mand 3, until th|
00007780  65 20 27 67 6f 61 6c 27  20 69 73 0a 20 20 20 20  |e 'goal' is.    |
00007790  20 20 20 20 20 20 20 20  20 20 20 6d 65 74 2c 20  |           met, |
000077a0  61 6e 64 20 66 75 72 74  68 65 72 20 63 6f 6d 6d  |and further comm|
000077b0  61 6e 64 20 33 27 73 20  77 69 6c 6c 20 68 61 76  |and 3's will hav|
000077c0  65 20 6e 6f 20 65 66 66  65 63 74 2e 0a 20 34 20  |e no effect.. 4 |
000077d0  28 61 6d 69 67 61 20 6f  6e 6c 79 29 20 20 56 69  |(amiga only)  Vi|
000077e0  62 72 61 74 6f 20 2d 0a  20 20 20 20 20 20 20 20  |brato -.        |
000077f0  20 20 20 20 20 20 20 54  68 69 73 20 63 61 75 73  |       This caus|
00007800  65 73 20 74 68 65 20 76  6f 6c 75 6d 65 20 74 6f  |es the volume to|
00007810  20 72 69 73 65 20 61 6e  64 20 66 61 6c 6c 20 69  | rise and fall i|
00007820  6e 20 61 20 77 61 72 62  6c 69 6e 67 20 65 66 66  |n a warbling eff|
00007830  65 63 74 2e 0a 20 20 20  20 20 20 20 20 20 20 20  |ect..           |
00007840  20 20 20 20 54 68 65 20  66 69 72 73 74 20 64 69  |    The first di|
00007850  67 69 74 20 67 69 76 65  73 20 74 68 65 20 73 70  |git gives the sp|
00007860  65 65 64 20 6f 66 20 74  68 65 20 76 6f 6c 75 6d  |eed of the volum|
00007870  65 20 63 68 61 6e 67 65  20 28 31 3d 73 6c 6f 77  |e change (1=slow|
00007880  2c 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |,.              |
00007890  20 26 46 3d 66 61 73 74  29 2c 20 61 6e 64 20 74  | &F=fast), and t|
000078a0  68 65 20 73 65 63 6f 6e  64 20 64 69 67 69 74 20  |he second digit |
000078b0  67 69 76 65 73 20 74 68  65 20 6d 61 67 6e 69 74  |gives the magnit|
000078c0  75 64 65 20 6f 66 20 74  68 65 0a 20 20 20 20 20  |ude of the.     |
000078d0  20 20 20 20 20 20 20 20  20 20 76 69 62 72 61 74  |          vibrat|
000078e0  6f 2e 20 54 68 65 20 76  69 62 72 61 74 6f 20 69  |o. The vibrato i|
000078f0  73 20 63 72 65 61 74 65  64 20 62 79 20 73 75 62  |s created by sub|
00007900  74 72 61 63 74 69 6e 67  20 61 20 73 69 6e 75 73  |tracting a sinus|
00007910  6f 69 64 61 6c 6c 79 0a  20 20 20 20 20 20 20 20  |oidally.        |
00007920  20 20 20 20 20 20 20 76  61 72 79 69 6e 67 20 61  |       varying a|
00007930  6d 6f 75 6e 74 20 66 72  6f 6d 20 74 68 65 20 76  |mount from the v|
00007940  6f 6c 75 6d 65 20 6f 66  20 74 68 65 20 63 68 61  |olume of the cha|
00007950  6e 6e 65 6c 2e 0a 20 35  2c 36 2c 37 20 28 61 6d  |nnel.. 5,6,7 (am|
00007960  69 67 61 29 20 20 43 6f  6d 62 69 6e 61 74 69 6f  |iga)  Combinatio|
00007970  6e 73 20 6f 66 20 74 68  65 20 76 6f 6c 75 6d 65  |ns of the volume|
00007980  20 61 6e 64 20 70 69 74  63 68 20 73 6c 69 64 65  | and pitch slide|
00007990  73 20 28 4e 6f 74 20 69  6d 70 6c 65 6d 65 6e 74  |s (Not implement|
000079a0  65 64 29 0a 20 39 20 28  61 6d 69 67 61 20 6f 6e  |ed). 9 (amiga on|
000079b0  6c 79 29 20 53 65 74 20  73 61 6d 70 6c 65 20 6f  |ly) Set sample o|
000079c0  66 66 73 65 74 20 28 4e  6f 74 20 69 6d 70 6c 65  |ffset (Not imple|
000079d0  6d 65 6e 74 65 64 29 2e  0a 20 41 20 28 61 6d 69  |mented).. A (ami|
000079e0  67 61 29 20 20 20 20 20  56 6f 6c 75 6d 65 20 73  |ga)     Volume s|
000079f0  6c 69 64 65 20 2d 0a 20  20 20 20 20 20 20 20 20  |lide -.         |
00007a00  20 20 20 20 20 20 49 66  20 74 68 65 20 66 69 72  |      If the fir|
00007a10  73 74 20 6e 69 62 62 6c  65 20 69 73 20 6e 6f 6e  |st nibble is non|
00007a20  2d 7a 65 72 6f 2c 20 61  64 64 20 74 68 69 73 20  |-zero, add this |
00007a30  76 61 6c 75 65 20 74 6f  20 74 68 65 20 63 75 72  |value to the cur|
00007a40  72 65 6e 74 0a 20 20 20  20 20 20 20 20 20 20 20  |rent.           |
00007a50  20 20 20 20 76 6f 6c 75  6d 65 20 65 76 65 72 79  |    volume every|
00007a60  20 76 73 79 6e 63 2c 20  65 6c 73 65 20 73 75 62  | vsync, else sub|
00007a70  74 72 61 63 74 20 74 68  65 20 73 65 63 6f 6e 64  |tract the second|
00007a80  20 6e 69 62 62 6c 65 20  69 6e 20 61 0a 20 20 20  | nibble in a.   |
00007a90  20 20 20 20 20 20 20 20  20 20 20 20 73 69 6d 69  |            simi|
00007aa0  6c 61 72 20 66 61 73 68  69 6f 6e 2e 0a 20 47 2c  |lar fashion.. G,|
00007ab0  20 48 20 28 54 72 61 63  6b 65 72 29 20 56 6f 6c  | H (Tracker) Vol|
00007ac0  75 6d 65 20 73 6c 69 64  65 20 75 70 2c 20 64 6f  |ume slide up, do|
00007ad0  77 6e 20 2d 0a 20 20 20  20 20 20 20 20 20 20 20  |wn -.           |
00007ae0  20 20 20 20 54 68 65 73  65 20 63 6f 6d 6d 61 6e  |    These comman|
00007af0  64 73 20 61 72 65 20 74  68 65 20 73 61 6d 65 20  |ds are the same |
00007b00  61 73 20 74 68 65 20 41  20 63 6f 6d 6d 61 6e 64  |as the A command|
00007b10  20 6f 6e 20 74 68 65 20  61 6d 69 67 61 2c 20 62  | on the amiga, b|
00007b20  75 74 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |ut.             |
00007b30  20 20 74 61 6b 65 20 61  20 62 79 74 65 20 70 61  |  take a byte pa|
00007b40  72 61 6d 65 74 65 72 2e  0a 20 42 20 28 61 6d 69  |rameter.. B (ami|
00007b50  67 61 29 2c 20 4a 20 28  54 72 61 63 6b 65 72 29  |ga), J (Tracker)|
00007b60  20 20 50 6f 73 69 74 69  6f 6e 20 6a 75 6d 70 20  |  Position jump |
00007b70  2d 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |-.              |
00007b80  20 57 68 65 6e 20 74 68  69 73 20 63 6f 6d 6d 61  | When this comma|
00007b90  6e 64 20 69 73 20 6d 65  74 2c 20 6a 75 6d 70 20  |nd is met, jump |
00007ba0  74 6f 20 70 6f 73 69 74  69 6f 6e 20 3c 70 61 72  |to position <par|
00007bb0  61 6d 65 74 65 72 3e 20  69 6e 20 0a 20 20 20 20  |ameter> in .    |
00007bc0  20 20 20 20 20 20 20 20  20 20 20 73 6f 6e 67 2e  |           song.|
00007bd0  0a 20 42 20 28 54 72 61  63 6b 65 72 29 20 42 72  |. B (Tracker) Br|
00007be0  65 61 6b 20 70 61 74 74  65 72 6e 20 2d 0a 20 20  |eak pattern -.  |
00007bf0  20 20 20 20 20 20 20 20  20 20 20 20 20 3d 61 6d  |             =am|
00007c00  69 67 61 20 63 6f 6d 6d  61 6e 64 20 44 0a 20 43  |iga command D. C|
00007c10  20 28 61 6d 69 67 61 29  2c 20 56 20 28 54 72 61  | (amiga), V (Tra|
00007c20  63 6b 65 72 29 20 20 53  65 74 20 76 6f 6c 75 6d  |cker)  Set volum|
00007c30  65 20 2d 0a 20 20 20 20  20 20 20 20 20 20 20 20  |e -.            |
00007c40  20 20 20 41 6c 74 65 72  73 20 74 68 65 20 63 75  |   Alters the cu|
00007c50  72 72 65 6e 74 20 76 6f  6c 75 6d 65 20 6f 66 20  |rrent volume of |
00007c60  74 68 65 20 63 68 61 6e  6e 65 6c 20 74 6f 20 74  |the channel to t|
00007c70  68 65 20 76 61 6c 75 65  20 73 70 65 63 2d 0a 20  |he value spec-. |
00007c80  20 20 20 20 20 20 20 20  20 20 20 20 20 20 69 66  |              if|
00007c90  69 65 64 20 28 30 2d 36  34 20 61 6d 69 67 61 2c  |ied (0-64 amiga,|
00007ca0  20 30 2d 32 35 35 20 61  72 63 29 2e 20 56 6f 6c  | 0-255 arc). Vol|
00007cb0  75 6d 65 20 30 20 6d 65  61 6e 73 20 6d 75 74 65  |ume 0 means mute|
00007cc0  20 73 6f 75 6e 64 2e 0a  20 44 20 28 61 6d 69 67  | sound.. D (amig|
00007cd0  61 29 2c 20 42 20 28 54  72 61 63 6b 65 72 29 20  |a), B (Tracker) |
00007ce0  20 42 72 65 61 6b 20 70  61 74 74 65 72 6e 20 2d  | Break pattern -|
00007cf0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00007d00  57 68 65 6e 20 74 68 69  73 20 63 6f 6d 6d 61 6e  |When this comman|
00007d10  64 20 69 73 20 65 6e 63  6f 75 6e 74 65 72 65 64  |d is encountered|
00007d20  2c 20 74 68 65 20 70 61  74 74 65 72 6e 20 69 73  |, the pattern is|
00007d30  20 65 6e 64 65 64 2c 20  61 6e 64 0a 20 20 20 20  | ended, and.    |
00007d40  20 20 20 20 20 20 20 20  20 20 20 74 68 65 20 6e  |           the n|
00007d50  65 78 74 20 70 61 74 74  65 72 6e 20 6a 75 6d 70  |ext pattern jump|
00007d60  65 64 20 74 6f 2e 0a 20  45 20 28 61 6d 69 67 61  |ed to.. E (amiga|
00007d70  29 20 20 20 56 61 72 69  6f 75 73 20 63 6f 6d 6d  |)   Various comm|
00007d80  61 6e 64 73 20 28 69 65  2e 20 68 2f 77 20 66 69  |ands (ie. h/w fi|
00007d90  6c 74 65 72 20 63 6f 6d  6d 61 6e 64 73 29 20 5b  |lter commands) [|
00007da0  4e 6f 74 20 69 6d 70 6c  65 6d 65 6e 74 65 64 5d  |Not implemented]|
00007db0  2e 0a 20 45 20 28 54 72  61 63 6b 65 72 29 20 53  |.. E (Tracker) S|
00007dc0  65 74 20 73 74 65 72 65  6f 20 2d 0a 20 20 20 20  |et stereo -.    |
00007dd0  20 20 20 20 20 20 20 20  20 20 20 53 65 74 20 74  |           Set t|
00007de0  68 65 20 73 74 65 72 65  6f 20 70 6f 73 69 74 69  |he stereo positi|
00007df0  6f 6e 20 28 31 2d 37 29  20 6f 66 20 74 68 65 20  |on (1-7) of the |
00007e00  63 75 72 72 65 6e 74 20  73 6f 75 6e 64 20 63 68  |current sound ch|
00007e10  61 6e 6e 65 6c 0a 20 20  20 20 20 20 20 20 20 20  |annel.          |
00007e20  20 20 20 20 20 28 31 2d  38 29 2e 0a 20 46 20 28  |     (1-8).. F (|
00007e30  61 6d 69 67 61 29 2c 20  53 20 28 54 72 61 63 6b  |amiga), S (Track|
00007e40  65 72 29 20 20 53 65 74  20 73 70 65 65 64 20 2d  |er)  Set speed -|
00007e50  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00007e60  53 65 74 73 20 74 68 65  20 73 70 65 65 64 20 28  |Sets the speed (|
00007e70  6e 75 6d 62 65 72 20 6f  66 20 76 73 79 6e 63 73  |number of vsyncs|
00007e80  20 62 65 74 77 65 65 6e  20 65 76 65 6e 74 73 29  | between events)|
00007e90  20 74 6f 20 3c 70 61 72  61 6d 2e 3e 2e 0a 20 20  | to <param.>..  |
00007ea0  20 20 0a 0a 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |  ..============|
00007eb0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00007ef0  3d 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |=.              |
00007f00  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00007f10  20 0a 45 72 72 6f 72 73  0a 2d 2d 2d 2d 2d 2d 20  | .Errors.------ |
00007f20  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00007f50  20 20 20 0a 0a 54 68 65  20 65 72 72 6f 72 20 6e  |   ..The error n|
00007f60  75 6d 62 65 72 73 20 61  6e 64 20 6d 65 73 73 61  |umbers and messa|
00007f70  67 65 73 20 77 68 69 63  68 20 74 68 65 20 74 72  |ges which the tr|
00007f80  61 63 6b 65 72 6d 6f 64  75 6c 65 20 6d 61 79 20  |ackermodule may |
00007f90  67 65 6e 65 72 61 74 65  3a 0a 0a 4e 6f 20 74 75  |generate:..No tu|
00007fa0  6e 65 20 6c 6f 61 64 65  64 20 20 20 20 20 20 20  |ne loaded       |
00007fb0  20 28 26 34 33 32 30 30  29 20 2d 20 61 6e 20 6f  | (&43200) - an o|
00007fc0  70 65 72 61 74 69 6f 6e  20 77 61 73 20 61 74 74  |peration was att|
00007fd0  65 6d 70 74 65 64 20 77  68 69 63 68 20 72 65 71  |empted which req|
00007fe0  75 69 72 65 73 20 61 0a  20 20 20 20 20 20 20 20  |uires a.        |
00007ff0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008000  20 20 20 20 20 20 20 20  20 74 75 6e 65 20 74 6f  |         tune to|
00008010  20 62 65 20 6c 6f 61 64  65 64 20 69 6e 74 6f 20  | be loaded into |
00008020  6d 65 6d 6f 72 79 20 62  65 66 6f 72 65 68 61 6e  |memory beforehan|
00008030  64 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |d.              |
00008040  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008050  20 20 20 75 73 69 6e 67  20 2a 50 6c 61 79 4d 6f  |   using *PlayMo|
00008060  64 20 6f 72 20 53 57 49  20 54 72 61 63 6b 65 72  |d or SWI Tracker|
00008070  5f 4c 6f 61 64 2e 0a 0a  53 65 71 75 65 6e 63 65  |_Load...Sequence|
00008080  20 70 6f 73 69 74 69 6f  6e 20 6f 75 74 20 6f 66  | position out of|
00008090  20 72 61 6e 67 65 20 2d  20 54 68 65 20 73 65 71  | range - The seq|
000080a0  75 65 6e 63 65 20 70 6f  73 69 74 69 6f 6e 20 67  |uence position g|
000080b0  69 76 65 6e 20 77 69 74  68 20 2a 50 6c 61 79 50  |iven with *PlayP|
000080c0  6f 73 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |os.             |
000080d0  20 20 20 20 20 20 20 20  20 28 26 34 33 32 30 31  |         (&43201|
000080e0  29 20 20 20 6f 72 20 53  57 49 20 54 72 61 63 6b  |)   or SWI Track|
000080f0  65 72 5f 53 65 74 50 6f  73 20 77 61 73 20 68 69  |er_SetPos was hi|
00008100  67 68 65 72 20 74 68 61  6e 20 74 68 65 0a 20 20  |gher than the.  |
00008110  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008120  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 61  |               a|
00008130  63 74 75 61 6c 20 6e 75  6d 62 65 72 20 6f 66 20  |ctual number of |
00008140  70 61 74 74 65 72 6e 73  20 69 6e 20 74 68 65 20  |patterns in the |
00008150  73 6f 6e 67 2e 0a 0a 4e  6f 20 72 6f 6f 6d 20 66  |song...No room f|
00008160  6f 72 20 6d 6f 64 75 6c  65 20 20 20 20 28 26 34  |or module    (&4|
00008170  33 32 30 32 29 20 2d 20  54 68 65 20 74 72 61 63  |3202) - The trac|
00008180  6b 65 72 6d 6f 64 75 6c  65 20 63 6f 75 6c 64 20  |kermodule could |
00008190  6e 6f 74 20 63 6c 61 69  6d 20 65 6e 6f 75 67 68  |not claim enough|
000081a0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000081b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000081c0  20 20 52 4d 41 20 77 6f  72 6b 73 70 61 63 65 20  |  RMA workspace |
000081d0  74 6f 20 6c 6f 61 64 20  74 68 65 20 6d 6f 64 75  |to load the modu|
000081e0  6c 65 2e 20 54 6f 20 67  65 74 0a 20 20 20 20 20  |le. To get.     |
000081f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008200  20 20 20 20 20 20 20 20  20 20 20 20 6d 6f 72 65  |            more|
00008210  20 6d 65 6d 6f 72 79 2c  20 71 75 69 74 20 62 61  | memory, quit ba|
00008220  73 69 63 20 74 6f 20 74  68 65 20 73 75 70 65 72  |sic to the super|
00008230  76 69 73 6f 72 0a 20 20  20 20 20 20 20 20 20 20  |visor.          |
00008240  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008250  20 20 20 20 20 20 20 70  72 6f 6d 70 74 2c 20 61  |       prompt, a|
00008260  6e 64 20 72 65 74 72 79  2e 20 49 66 20 79 6f 75  |nd retry. If you|
00008270  20 61 72 65 20 75 73 69  6e 67 20 74 68 65 0a 20  | are using the. |
00008280  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000082a0  64 65 73 6b 74 6f 70 20  69 6e 73 74 65 61 64 2c  |desktop instead,|
000082b0  20 72 65 6d 6f 76 65 20  61 6e 20 61 70 70 6c 69  | remove an appli|
000082c0  63 61 74 69 6f 6e 20 61  6e 64 0a 20 20 20 20 20  |cation and.     |
000082d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000082e0  20 20 20 20 20 20 20 20  20 20 20 20 72 65 74 72  |            retr|
000082f0  79 2e 0a 0a 43 68 61 6e  6e 65 6c 20 6e 75 6d 62  |y...Channel numb|
00008300  65 72 20 6f 75 74 20 6f  66 20 72 61 6e 67 65 20  |er out of range |
00008310  20 20 20 2d 20 54 68 65  20 73 6f 75 6e 64 20 63  |   - The sound c|
00008320  68 61 6e 6e 65 6c 20 6e  75 6d 62 65 72 20 77 61  |hannel number wa|
00008330  73 20 6e 6f 74 20 61 20  76 61 6c 75 65 0a 20 20  |s not a value.  |
00008340  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008350  20 20 20 20 28 26 34 33  32 30 33 29 20 20 20 62  |    (&43203)   b|
00008360  65 74 77 65 65 6e 20 31  20 61 6e 64 20 74 68 65  |etween 1 and the|
00008370  20 6e 75 6d 62 65 72 20  6f 66 20 73 6f 75 6e 64  | number of sound|
00008380  20 63 68 61 6e 6e 65 6c  73 0a 20 20 20 20 20 20  | channels.      |
00008390  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000083a0  20 20 20 20 20 20 20 20  20 20 20 75 73 65 64 20  |           used |
000083b0  66 6f 72 20 74 68 61 74  20 70 61 72 74 69 63 75  |for that particu|
000083c0  6c 61 72 20 74 75 6e 65  2e 0a 0a 53 61 6d 70 6c  |lar tune...Sampl|
000083d0  65 20 6e 75 6d 62 65 72  20 6f 75 74 20 6f 66 20  |e number out of |
000083e0  72 61 6e 67 65 20 20 20  20 20 2d 20 54 68 65 20  |range     - The |
000083f0  73 61 6d 70 6c 65 20 6e  75 6d 62 65 72 20 77 61  |sample number wa|
00008400  73 20 6e 6f 74 20 77 69  74 68 69 6e 20 74 68 65  |s not within the|
00008410  20 72 61 6e 67 65 0a 20  20 20 20 20 20 20 20 20  | range.         |
00008420  20 20 20 20 20 20 20 20  20 20 20 20 20 28 26 34  |             (&4|
00008430  33 32 30 34 29 20 20 20  6f 66 20 31 2d 33 36 2e  |3204)   of 1-36.|
00008440  0a 0a 4e 6f 74 65 20 6e  75 6d 62 65 72 20 6f 75  |..Note number ou|
00008450  74 20 6f 66 20 72 61 6e  67 65 20 20 20 20 20 20  |t of range      |
00008460  20 2d 20 54 68 65 20 6e  6f 74 65 20 6e 75 6d 62  | - The note numb|
00008470  65 72 20 77 61 73 20 6e  6f 74 20 77 69 74 68 69  |er was not withi|
00008480  6e 20 74 68 65 20 72 61  6e 67 65 20 6f 66 0a 20  |n the range of. |
00008490  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000084a0  20 20 20 20 20 28 26 34  33 32 30 35 29 20 20 20  |     (&43205)   |
000084b0  31 2d 33 36 2e 0a 0a 56  6f 6c 75 6d 65 20 6f 75  |1-36...Volume ou|
000084c0  74 20 6f 66 20 72 61 6e  67 65 20 20 20 28 26 34  |t of range   (&4|
000084d0  33 32 30 36 29 20 2d 20  54 68 65 20 76 6f 6c 75  |3206) - The volu|
000084e0  6d 65 20 77 61 73 20 6e  6f 74 20 77 69 74 68 69  |me was not withi|
000084f0  6e 20 74 68 65 20 72 61  6e 67 65 20 6f 66 20 30  |n the range of 0|
00008500  2d 32 35 35 0a 0a 4d 6f  64 75 6c 65 20 61 6c 72  |-255..Module alr|
00008510  65 61 64 79 20 6c 6f 63  6b 65 64 20 28 26 34 33  |eady locked (&43|
00008520  32 30 37 29 20 2d 20 54  72 61 63 6b 65 72 5f 4c  |207) - Tracker_L|
00008530  6f 63 6b 20 77 61 73 20  63 61 6c 6c 65 64 20 77  |ock was called w|
00008540  68 65 6e 20 74 68 65 20  6d 6f 64 75 6c 65 0a 20  |hen the module. |
00008550  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00008570  77 61 73 20 61 6c 72 65  61 64 79 20 6c 6f 63 6b  |was already lock|
00008580  65 64 2e 20 54 68 65 20  6d 6f 64 75 6c 65 20 63  |ed. The module c|
00008590  61 6e 20 6f 6e 6c 79 20  62 65 0a 20 20 20 20 20  |an only be.     |
000085a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000085b0  20 20 20 20 20 20 20 20  20 20 20 20 75 6e 6c 6f  |            unlo|
000085c0  63 6b 65 64 20 77 68 65  6e 20 74 68 65 20 61 70  |cked when the ap|
000085d0  70 6c 69 63 61 74 69 6f  6e 20 69 6e 20 63 6f 6e  |plication in con|
000085e0  74 72 6f 6c 20 6f 66 0a  20 20 20 20 20 20 20 20  |trol of.        |
000085f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008600  20 20 20 20 20 20 20 20  20 74 68 65 20 6d 6f 64  |         the mod|
00008610  75 6c 65 20 69 73 73 75  65 73 20 61 20 54 72 61  |ule issues a Tra|
00008620  63 6b 65 72 5f 55 6e 6c  6f 63 6b 20 53 57 49 2e  |cker_Unlock SWI.|
00008630  0a 0a 55 6e 6c 6f 63 6b  20 66 61 69 6c 65 64 20  |..Unlock failed |
00008640  20 20 20 20 20 20 20 20  28 26 34 33 32 30 38 29  |        (&43208)|
00008650  20 2d 20 54 72 61 63 6b  65 72 5f 55 6e 6c 6f 63  | - Tracker_Unloc|
00008660  6b 20 77 61 73 20 63 61  6c 6c 65 64 20 62 75 74  |k was called but|
00008670  20 65 69 74 68 65 72 0a  20 20 20 20 20 20 20 20  | either.        |
00008680  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008690  20 20 20 20 20 20 20 20  20 74 68 65 20 77 72 6f  |         the wro|
000086a0  6e 67 20 6c 6f 63 6b 69  6e 67 20 63 6f 64 65 20  |ng locking code |
000086b0  77 61 73 20 73 70 65 63  69 66 69 65 64 2c 20 6f  |was specified, o|
000086c0  72 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |r.              |
000086d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000086e0  20 20 20 74 68 65 20 6d  6f 64 75 6c 65 20 77 61  |   the module wa|
000086f0  73 20 6e 6f 74 20 6c 6f  63 6b 65 64 20 61 74 20  |s not locked at |
00008700  74 68 65 20 74 69 6d 65  2e 0a 0a 54 72 61 63 6b  |the time...Track|
00008710  65 72 4d 6f 64 75 6c 65  20 69 6e 20 75 73 65 20  |erModule in use |
00008720  20 28 26 34 33 32 30 39  29 20 2d 20 41 6e 20 61  | (&43209) - An a|
00008730  74 74 65 6d 70 74 20 77  61 73 20 6d 61 64 65 20  |ttempt was made |
00008740  74 6f 20 65 78 65 63 75  74 65 20 6f 6e 65 20 6f  |to execute one o|
00008750  66 20 74 68 65 0a 20 20  20 20 20 20 20 20 20 20  |f the.          |
00008760  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008770  20 20 20 20 20 20 20 72  65 73 74 72 69 63 74 65  |       restricte|
00008780  64 20 63 6f 6d 6d 61 6e  64 73 20 6f 72 20 53 57  |d commands or SW|
00008790  49 27 73 20 77 68 69 6c  65 20 74 68 65 0a 20 20  |I's while the.  |
000087a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000087b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 6d  |               m|
000087c0  6f 64 75 6c 65 20 77 61  73 20 6c 6f 63 6b 65 64  |odule was locked|
000087d0  20 28 73 65 65 20 54 72  61 63 6b 65 72 5f 4c 6f  | (see Tracker_Lo|
000087e0  63 6b 29 0a 0a 53 70 65  65 64 20 6e 6f 74 20 69  |ck)..Speed not i|
000087f0  6d 70 6c 65 6d 65 6e 74  65 64 20 28 26 34 33 32  |mplemented (&432|
00008800  30 41 29 20 2d 20 54 72  61 63 6b 65 72 5f 53 70  |0A) - Tracker_Sp|
00008810  65 65 64 20 77 61 73 20  63 61 6c 6c 65 64 20 77  |eed was called w|
00008820  69 74 68 20 52 30 20 6f  75 74 73 69 64 65 0a 20  |ith R0 outside. |
00008830  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00008850  74 68 65 20 72 61 6e 67  65 20 6f 66 20 76 61 6c  |the range of val|
00008860  75 65 73 20 63 75 72 72  65 6e 74 6c 79 20 61 63  |ues currently ac|
00008870  63 65 70 74 65 64 2e 0a  0a 42 61 64 20 73 61 6d  |cepted...Bad sam|
00008880  70 6c 65 20 6c 6f 6f 70  69 6e 67 20 20 20 20 28  |ple looping    (|
00008890  26 34 33 32 30 42 29 20  2d 20 56 61 6c 75 65 73  |&4320B) - Values|
000088a0  20 6f 66 20 72 65 70 65  61 74 20 6f 66 66 73 65  | of repeat offse|
000088b0  74 2f 72 65 70 65 61 74  20 6c 65 6e 67 74 68 20  |t/repeat length |
000088c0  77 6f 75 6c 64 0a 20 20  20 20 20 20 20 20 20 20  |would.          |
000088d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000088e0  20 20 20 20 20 20 20 63  61 75 73 65 20 73 61 6d  |       cause sam|
000088f0  70 6c 65 20 74 6f 20 6c  6f 6f 70 20 6f 75 74 73  |ple to loop outs|
00008900  69 64 65 20 69 74 73 20  6c 69 6d 69 74 2e 0a 0a  |ide its limit...|
00008910  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00008950  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 0a 0a 0a  |=============...|
00008960  54 68 69 73 20 6d 6f 64  75 6c 65 20 77 61 73 20  |This module was |
00008970  77 72 69 74 74 65 6e 20  66 6f 72 20 65 6e 74 68  |written for enth|
00008980  75 73 69 61 73 74 73 20  77 68 6f 20 77 69 73 68  |usiasts who wish|
00008990  20 74 6f 20 65 6e 6a 6f  79 20 74 68 65 20 62 65  | to enjoy the be|
000089a0  6e 65 66 69 74 73 20 6f  66 20 74 68 65 0a 41 72  |nefits of the.Ar|
000089b0  63 68 69 6d 65 64 65 73  20 73 6f 75 6e 64 20 73  |chimedes sound s|
000089c0  79 73 74 65 6d 20 69 6e  20 61 20 6d 75 6c 74 69  |ystem in a multi|
000089d0  2d 74 61 73 6b 69 6e 67  20 65 6e 76 69 72 6f 6e  |-tasking environ|
000089e0  6d 65 6e 74 2e 0a 0a 56  65 72 73 69 6f 6e 73 20  |ment...Versions |
000089f0  30 2e 30 30 20 74 6f 20  31 2e 78 78 20 6f 66 20  |0.00 to 1.xx of |
00008a00  74 68 65 20 6f 72 69 67  69 6e 61 6c 20 6d 6f 64  |the original mod|
00008a10  75 6c 65 20 77 65 72 65  20 77 72 69 74 74 65 6e  |ule were written|
00008a20  20 62 79 20 48 75 67 6f  20 46 69 65 6e 6e 65 73  | by Hugo Fiennes|
00008a30  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00008a40  20 20 20 20 20 20 20 61  6c 6c 6f 77 69 6e 67 20  |       allowing |
00008a50  74 68 65 20 70 6c 61 79  69 6e 67 20 6f 66 20 61  |the playing of a|
00008a60  6e 79 20 73 6f 75 6e 64  74 72 61 63 6b 65 72 20  |ny soundtracker |
00008a70  74 75 6e 65 73 2e 0a 56  65 72 73 69 6f 6e 73 20  |tunes..Versions |
00008a80  32 2e 30 30 20 74 6f 20  32 2e 78 78 20 77 65 72  |2.00 to 2.xx wer|
00008a90  65 20 77 72 69 74 74 65  6e 20 62 79 20 46 61 62  |e written by Fab|
00008aa0  72 69 63 65 20 4d 65 72  63 69 65 72 20 61 6e 64  |rice Mercier and|
00008ab0  20 48 75 67 6f 2c 0a 20  20 20 20 20 20 20 20 20  | Hugo,.         |
00008ac0  20 20 20 20 20 20 20 20  20 20 20 20 20 70 6c 61  |             pla|
00008ad0  79 69 6e 67 20 61 6e 79  20 74 72 61 63 6b 65 72  |ying any tracker|
00008ae0  20 74 75 6e 65 73 20 28  77 69 74 68 20 63 68 61  | tunes (with cha|
00008af0  6e 67 65 73 2f 69 6d 70  72 6f 76 65 6d 65 6e 74  |nges/improvement|
00008b00  73 29 2e 0a 56 65 72 73  69 6f 6e 73 20 33 2e 30  |s)..Versions 3.0|
00008b10  30 20 74 6f 20 34 2e 30  36 20 77 65 72 65 20 77  |0 to 4.06 were w|
00008b20  72 69 74 74 65 6e 20 62  79 20 4d 61 74 74 68 65  |ritten by Matthe|
00008b30  77 20 46 61 72 72 6f 77  20 74 6f 20 61 6c 6c 6f  |w Farrow to allo|
00008b40  77 20 74 68 65 20 70 6c  61 79 69 6e 67 20 6f 66  |w the playing of|
00008b50  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00008b60  20 20 20 20 20 20 20 73  6f 75 6e 64 74 72 61 63  |       soundtrac|
00008b70  6b 65 72 20 6f 72 20 74  72 61 63 6b 65 72 20 74  |ker or tracker t|
00008b80  75 6e 65 73 2c 20 77 69  74 68 20 74 68 65 20 53  |unes, with the S|
00008b90  57 49 20 65 78 74 65 6e  73 69 6f 6e 0a 20 20 20  |WI extension.   |
00008ba0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008bb0  20 20 20 66 72 6f 6d 20  76 65 72 73 69 6f 6e 73  |   from versions|
00008bc0  20 34 2e 30 30 20 6f 6e  77 61 72 64 73 2e 0a 0a  | 4.00 onwards...|
00008bd0  59 6f 75 20 63 61 6e 20  63 6f 6e 74 61 63 74 20  |You can contact |
00008be0  48 75 67 6f 20 69 6e 20  74 68 65 20 66 6f 6c 6c  |Hugo in the foll|
00008bf0  6f 77 69 6e 67 20 77 61  79 73 3a 0a 56 6f 69 63  |owing ways:.Voic|
00008c00  65 3a 20 55 4b 20 28 30  37 34 39 29 20 37 32 32  |e: UK (0749) 722|
00008c10  33 34 20 28 61 73 6b 20  66 6f 72 20 48 75 67 6f  |34 (ask for Hugo|
00008c20  29 0a 56 6f 64 61 46 6f  6e 65 3a 20 28 30 38 33  |).VodaFone: (083|
00008c30  31 29 20 34 34 34 31 39  32 0a 54 68 65 20 57 6f  |1) 444192.The Wo|
00008c40  72 6c 64 20 6f 66 20 43  72 79 74 6f 6e 20 28 62  |rld of Cryton (b|
00008c50  62 73 29 20 3a 20 55 4b  20 28 30 37 34 39 29 20  |bs) : UK (0749) |
00008c60  36 37 39 37 39 34 20 28  33 30 30 2d 32 34 30 30  |679794 (300-2400|
00008c70  20 2d 20 31 20 6c 69 6e  65 29 0a 20 20 20 20 20  | - 1 line).     |
00008c80  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008c90  20 20 20 20 20 3a 20 55  4b 20 28 30 37 34 39 29  |     : UK (0749)|
00008ca0  20 36 37 30 30 33 30 20  28 33 30 30 2d 48 53 54  | 670030 (300-HST|
00008cb0  2f 56 33 32 20 2d 20 32  20 6c 69 6e 65 73 29 0a  |/V32 - 2 lines).|
00008cc0  4d 61 69 6c 3a 20 50 72  65 73 74 65 6c 20 30 34  |Mail: Prestel 04|
00008cd0  35 38 34 37 36 30 38 2c  20 43 49 58 20 61 6c 74  |5847608, CIX alt|
00008ce0  6d 61 6e 0a 42 75 72 63  6f 74 74 20 4d 61 6e 6f  |man.Burcott Mano|
00008cf0  72 2c 20 57 65 6c 6c 73  2c 20 53 6f 6d 65 72 73  |r, Wells, Somers|
00008d00  65 74 2c 20 42 41 35 20  31 4e 48 2c 20 55 4b 0a  |et, BA5 1NH, UK.|
00008d10  0a 4d 61 74 74 20 46 61  72 72 6f 77 3a 0a 4d 61  |.Matt Farrow:.Ma|
00008d20  69 6c 3a 20 41 72 63 61  64 65 20 62 62 73 20 5b  |il: Arcade bbs [|
00008d30  30 38 31 2d 36 35 34 20  32 32 31 32 5d 20 61 73  |081-654 2212] as|
00008d40  20 27 4d 61 74 74 68 65  77 20 46 61 72 72 6f 77  | 'Matthew Farrow|
00008d50  27 20 28 23 34 38 33 29  0a 20 20 20 20 20 20 20  |' (#483).       |
00008d60  20 20 20 20 20 20 20 20  20 20 5b 30 38 31 2d 36  |          [081-6|
00008d70  35 34 20 34 34 31 32 5d  0a 0a 34 35 20 41 6c 6c  |54 4412]..45 All|
00008d80  65 79 6e 20 50 61 72 6b  2c 20 44 75 6c 77 69 63  |eyn Park, Dulwic|
00008d90  68 2c 20 4c 6f 6e 64 6f  6e 20 53 45 32 31 20 38  |h, London SE21 8|
00008da0  41 54 0a 0a 0a 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |AT...===========|
00008db0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
00008dc0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00008de0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
00008df0  3d 3d 0a 0a 55 70 64 61  74 65 73 0a 2d 2d 2d 2d  |==..Updates.----|
00008e00  2d 2d 2d 0a 56 65 72 73  69 6f 6e 20 34 2e 30 30  |---.Version 4.00|
00008e10  20 28 66 72 6f 6d 20 33  2e 30 34 29 0a 20 20 20  | (from 3.04).   |
00008e20  2d 20 53 57 49 20 69 6e  74 65 72 66 61 63 65 20  |- SWI interface |
00008e30  61 64 64 65 64 2e 0a 20  20 20 2d 20 56 6f 6c 75  |added..   - Volu|
00008e40  6d 65 20 74 72 61 6e 73  6c 61 74 69 6f 6e 73 20  |me translations |
00008e50  66 6f 72 20 73 6f 75 6e  64 74 72 61 63 6b 65 72  |for soundtracker|
00008e60  20 6d 6f 64 75 6c 65 73  20 70 65 72 66 6f 72 6d  | modules perform|
00008e70  65 64 20 63 6f 72 72 65  63 74 6c 79 20 6e 6f 77  |ed correctly now|
00008e80  20 28 3f 29 0a 20 20 20  2d 20 4c 6f 63 6b 69 6e  | (?).   - Lockin|
00008e90  67 20 73 79 73 74 65 6d  20 69 6e 74 72 6f 64 75  |g system introdu|
00008ea0  63 65 64 0a 20 20 20 2d  20 4e 65 78 74 20 70 61  |ced.   - Next pa|
00008eb0  74 74 65 72 6e 20 6c 69  6e 65 20 70 6c 61 79 65  |ttern line playe|
00008ec0  64 20 6a 75 73 74 20 61  66 74 65 72 20 70 61 74  |d just after pat|
00008ed0  74 65 72 6e 20 70 6f 73  69 74 69 6f 6e 20 69 6e  |tern position in|
00008ee0  63 72 65 6d 65 6e 74 65  64 2c 20 6e 6f 74 0a 20  |cremented, not. |
00008ef0  20 20 20 20 6a 75 73 74  20 62 65 66 6f 72 65 20  |    just before |
00008f00  28 73 6f 20 74 68 65 20  70 6f 73 69 74 69 6f 6e  |(so the position|
00008f10  20 64 6f 65 73 6e 27 74  20 61 70 70 65 61 72 20  | doesn't appear |
00008f20  74 6f 20 62 65 20 61 68  65 61 64 20 6f 66 20 74  |to be ahead of t|
00008f30  68 65 20 6d 75 73 69 63  29 2e 0a 20 20 20 2d 20  |he music)..   - |
00008f40  52 65 6d 6f 76 61 6c 20  6f 66 20 6d 6f 72 65 20  |Removal of more |
00008f50  6d 69 6e 6f 72 20 62 75  67 73 2e 2e 0a 0a 56 65  |minor bugs....Ve|
00008f60  72 73 69 6f 6e 20 34 2e  30 31 0a 20 20 20 2d 20  |rsion 4.01.   - |
00008f70  44 6f 65 73 6e 27 74 20  73 6c 6f 77 20 65 76 65  |Doesn't slow eve|
00008f80  72 79 74 68 69 6e 67 20  64 6f 77 6e 20 73 6f 20  |rything down so |
00008f90  6d 75 63 68 20 77 68 65  6e 20 70 61 75 73 65 64  |much when paused|
00008fa0  0a 20 20 20 2d 20 46 69  78 65 64 20 62 75 67 20  |.   - Fixed bug |
00008fb0  69 6e 20 54 72 61 63 6b  65 72 5f 50 6c 61 79 4e  |in Tracker_PlayN|
00008fc0  6f 74 65 20 28 63 6f 6e  63 65 72 6e 69 6e 67 20  |ote (concerning |
00008fd0  63 68 61 6e 6e 65 6c 20  6e 75 6d 62 65 72 29 0a  |channel number).|
00008fe0  20 20 20 2d 20 43 6f 72  72 65 63 74 65 64 20 64  |   - Corrected d|
00008ff0  6f 63 75 6d 65 6e 74 61  74 69 6f 6e 20 6f 6e 20  |ocumentation on |
00009000  54 72 61 63 6b 65 72 5f  52 65 61 64 53 61 6d 70  |Tracker_ReadSamp|
00009010  6c 65 54 61 62 6c 65 0a  0a 56 65 72 73 69 6f 6e  |leTable..Version|
00009020  20 34 2e 30 32 0a 20 20  20 2d 20 41 64 64 65 64  | 4.02.   - Added|
00009030  20 6e 65 77 20 53 57 49  27 73 20 27 54 72 61 63  | new SWI's 'Trac|
00009040  6b 65 72 5f 4d 75 74 65  43 68 61 6e 6e 65 6c 27  |ker_MuteChannel'|
00009050  20 61 6e 64 20 27 54 72  61 63 6b 65 72 5f 52 65  | and 'Tracker_Re|
00009060  73 74 6f 72 65 43 68 61  6e 6e 65 6c 27 0a 20 20  |storeChannel'.  |
00009070  20 2d 20 41 72 70 65 67  67 69 6f 20 63 6f 6d 6d  | - Arpeggio comm|
00009080  61 6e 64 20 61 6c 74 65  72 65 64 20 74 6f 20 63  |and altered to c|
00009090  6f 6e 66 6f 72 6d 20 77  69 74 68 20 61 20 73 6f  |onform with a so|
000090a0  75 6e 64 74 72 61 63 6b  65 72 2d 64 65 72 69 76  |undtracker-deriv|
000090b0  61 74 69 76 65 0a 20 20  20 20 20 20 20 20 66 6f  |ative.        fo|
000090c0  72 6d 61 74 3b 20 49 20  74 68 69 6e 6b 20 69 74  |rmat; I think it|
000090d0  27 73 20 74 68 65 20 73  61 6d 65 20 61 73 20 74  |'s the same as t|
000090e0  68 65 20 73 6f 75 6e 64  74 72 61 63 6b 65 72 20  |he soundtracker |
000090f0  66 6f 72 6d 61 74 20 70  72 6f 70 65 72 2c 20 62  |format proper, b|
00009100  75 74 0a 20 20 20 20 20  20 20 20 49 20 63 61 6e  |ut.        I can|
00009110  27 74 20 66 69 6e 64 20  61 6e 79 20 64 6f 63 75  |'t find any docu|
00009120  6d 65 6e 74 61 74 69 6f  6e 20 74 6f 20 63 68 65  |mentation to che|
00009130  63 6b 20 74 68 69 73 21  0a 20 20 20 2d 20 46 69  |ck this!.   - Fi|
00009140  78 65 64 20 62 75 67 20  77 68 65 72 65 20 69 66  |xed bug where if|
00009150  20 79 6f 75 20 64 69 64  20 61 20 54 72 61 63 6b  | you did a Track|
00009160  65 72 5f 50 6c 61 79 4e  6f 74 65 20 77 68 69 6c  |er_PlayNote whil|
00009170  65 20 74 68 65 20 74 75  6e 65 20 77 61 73 20 70  |e the tune was p|
00009180  61 75 73 65 64 2c 0a 20  20 20 20 20 20 20 20 69  |aused,.        i|
00009190  74 20 73 6f 6d 65 74 69  6d 65 73 20 64 69 64 6e  |t sometimes didn|
000091a0  27 74 20 63 6c 65 61 72  20 74 68 65 20 73 6f 75  |'t clear the sou|
000091b0  6e 64 20 62 75 66 66 65  72 73 20 61 66 74 65 72  |nd buffers after|
000091c0  77 61 72 64 73 20 28 62  75 7a 7a 69 6e 67 20 65  |wards (buzzing e|
000091d0  74 63 2e 29 0a 0a 56 65  72 73 69 6f 6e 20 34 2e  |tc.)..Version 4.|
000091e0  30 33 0a 20 20 20 2d 20  49 20 68 61 76 65 20 66  |03.   - I have f|
000091f0  69 78 65 64 20 74 68 65  20 54 72 61 63 6b 65 72  |ixed the Tracker|
00009200  5f 50 6c 61 79 4e 6f 74  65 20 62 75 67 20 66 72  |_PlayNote bug fr|
00009210  6f 6d 20 56 34 2e 30 31  20 6e 6f 77 2c 20 68 6f  |om V4.01 now, ho|
00009220  6e 65 73 74 21 0a 20 20  20 2d 20 46 69 78 65 64  |nest!.   - Fixed|
00009230  20 70 72 6f 62 6c 65 6d  20 69 6e 74 72 6f 64 75  | problem introdu|
00009240  63 65 64 20 69 6e 20 56  34 2e 30 32 20 77 68 65  |ced in V4.02 whe|
00009250  72 65 20 64 6f 69 6e 67  20 54 72 61 63 6b 65 72  |re doing Tracker|
00009260  5f 50 6c 61 79 4e 6f 74  65 20 77 68 69 6c 65 20  |_PlayNote while |
00009270  61 0a 20 20 20 20 20 20  20 20 74 75 6e 65 20 77  |a.        tune w|
00009280  61 73 20 70 6c 61 79 69  6e 67 20 73 6f 6d 65 74  |as playing somet|
00009290  69 6d 65 73 20 63 72 61  73 68 65 64 20 28 69 66  |imes crashed (if|
000092a0  20 74 68 65 20 73 61 6d  70 6c 65 20 77 61 73 20  | the sample was |
000092b0  62 6c 61 6e 6b 29 0a 20  20 20 2d 20 53 68 6f 75  |blank).   - Shou|
000092c0  6c 64 20 63 72 61 73 68  20 6c 65 73 73 20 6f 66  |ld crash less of|
000092d0  74 65 6e 20 77 68 65 6e  20 6c 6f 61 64 69 6e 67  |ten when loading|
000092e0  20 61 20 6e 65 77 20 74  75 6e 65 20 28 6e 6f 20  | a new tune (no |
000092f0  70 72 6f 6d 69 73 65 73  21 29 0a 0a 56 65 72 73  |promises!)..Vers|
00009300  69 6f 6e 20 34 2e 30 34  0a 20 20 20 2d 20 41 64  |ion 4.04.   - Ad|
00009310  64 65 64 20 2a 50 6c 61  79 53 70 65 65 64 20 61  |ded *PlaySpeed a|
00009320  6e 64 20 6f 70 74 69 6f  6e 20 74 6f 20 63 68 61  |nd option to cha|
00009330  6e 67 65 20 73 61 6d 70  6c 65 20 72 61 74 65 20  |nge sample rate |
00009340  28 66 61 73 74 65 72 20  38 2d 63 68 61 6e 6e 65  |(faster 8-channe|
00009350  6c 0a 20 20 20 20 20 20  20 20 74 75 6e 65 73 29  |l.        tunes)|
00009360  0a 20 20 20 2d 20 50 72  6f 76 69 73 69 6f 6e 20  |.   - Provision |
00009370  66 6f 72 20 56 49 44 43  20 65 6e 68 61 6e 63 65  |for VIDC enhance|
00009380  72 20 6f 77 6e 65 72 73  20 28 74 75 6e 65 73 20  |r owners (tunes |
00009390  61 72 65 20 6e 6f 72 6d  61 6c 6c 79 20 61 20 70  |are normally a p|
000093a0  65 72 66 65 63 74 20 66  69 66 74 68 0a 20 20 20  |erfect fifth.   |
000093b0  20 20 20 20 20 74 6f 6f  20 68 69 67 68 29 20 69  |     too high) i|
000093c0  6e 20 74 68 65 20 66 6f  72 6d 20 6f 66 20 2a 50  |n the form of *P|
000093d0  6c 61 79 53 70 65 65 64  20 3c 32 7c 33 3e 0a 20  |laySpeed <2|3>. |
000093e0  20 20 2d 20 41 64 64 65  64 20 54 72 61 63 6b 65  |  - Added Tracke|
000093f0  72 5f 53 70 65 65 64 20  53 57 49 20 28 73 61 6d  |r_Speed SWI (sam|
00009400  65 20 61 73 20 2a 50 6c  61 79 53 70 65 65 64 29  |e as *PlaySpeed)|
00009410  0a 20 20 20 2d 20 4d 6f  64 75 6c 65 20 6e 6f 77  |.   - Module now|
00009420  20 63 6c 61 69 6d 73 20  6d 65 6d 6f 72 79 20 69  | claims memory i|
00009430  6e 20 52 4d 41 20 61 6e  64 20 62 75 69 6c 64 73  |n RMA and builds|
00009440  20 74 61 62 6c 65 73 20  61 73 20 69 74 20 6e 65  | tables as it ne|
00009450  65 64 73 20 74 68 65 6d  2c 0a 20 20 20 20 20 20  |eds them,.      |
00009460  20 20 73 61 76 69 6e 67  20 61 62 6f 75 74 20 31  |  saving about 1|
00009470  32 4b 20 6f 66 20 64 69  73 63 20 73 70 61 63 65  |2K of disc space|
00009480  2e 0a 20 20 20 2d 20 41  6c 74 65 72 65 64 20 2a  |..   - Altered *|
00009490  50 6c 61 79 53 61 6d 70  6c 65 73 20 63 6f 6d 6d  |PlaySamples comm|
000094a0  61 6e 64 20 74 6f 20 70  72 69 6e 74 20 27 2d 27  |and to print '-'|
000094b0  20 66 6f 72 20 73 61 6d  70 6c 65 20 6e 61 6d 65  | for sample name|
000094c0  20 69 66 20 62 6c 61 6e  6b 20 28 75 73 65 64 0a  | if blank (used.|
000094d0  20 20 20 20 20 20 20 20  74 6f 20 69 67 6e 6f 72  |        to ignor|
000094e0  65 20 6e 6f 6e 2d 7a 65  72 6f 20 73 61 6d 70 6c  |e non-zero sampl|
000094f0  65 73 20 77 69 74 68 20  62 6c 61 6e 6b 20 6e 61  |es with blank na|
00009500  6d 65 73 29 0a 20 20 20  2d 20 4d 61 69 6e 20 69  |mes).   - Main i|
00009510  6e 74 65 72 72 75 70 74  20 70 75 74 20 6f 6e 20  |nterrupt put on |
00009520  54 69 63 6b 65 72 56 2c  20 73 6f 20 74 68 69 73  |TickerV, so this|
00009530  20 73 68 6f 75 6c 64 20  65 6e 64 20 70 72 6f 62  | should end prob|
00009540  6c 65 6d 73 20 61 6e 79  20 6d 75 6c 74 69 73 79  |lems any multisy|
00009550  6e 63 0a 20 20 20 20 20  20 20 20 6d 6f 6e 69 74  |nc.        monit|
00009560  6f 72 20 6f 77 6e 65 72  73 20 6d 61 79 20 68 61  |or owners may ha|
00009570  76 65 20 68 61 64 20 77  69 74 68 20 74 75 6e 65  |ve had with tune|
00009580  73 20 67 6f 69 6e 67 20  74 6f 6f 20 66 61 73 74  |s going too fast|
00009590  20 65 74 63 2e 0a 0a 56  65 72 73 69 6f 6e 20 34  | etc...Version 4|
000095a0  2e 30 35 0a 20 20 20 2d  20 46 69 78 65 64 20 54  |.05.   - Fixed T|
000095b0  72 61 63 6b 65 72 5f 52  65 61 64 53 61 6d 70 6c  |racker_ReadSampl|
000095c0  65 54 61 62 6c 65 20 28  77 68 65 6e 20 52 30 20  |eTable (when R0 |
000095d0  77 61 73 20 6f 75 74 20  6f 66 20 72 61 6e 67 65  |was out of range|
000095e0  20 5b 69 65 2e 20 3e 31  35 2f 3e 33 31 5d 20 52  | [ie. >15/>31] R|
000095f0  31 0a 20 20 20 20 20 20  20 20 70 6f 69 6e 74 65  |1.        pointe|
00009600  64 20 74 6f 20 61 6e 20  75 6e 64 65 66 69 6e 65  |d to an undefine|
00009610  64 20 73 74 72 69 6e 67  29 20 73 6f 20 74 68 61  |d string) so tha|
00009620  74 20 52 31 20 61 6e 64  20 52 36 20 77 69 6c 6c  |t R1 and R6 will|
00009630  20 70 6f 69 6e 74 20 74  6f 20 61 0a 20 20 20 20  | point to a.    |
00009640  20 20 20 20 7a 65 72 6f  20 69 66 20 74 68 65 20  |    zero if the |
00009650  73 61 6d 70 6c 65 20 6e  75 6d 62 65 72 20 69 73  |sample number is|
00009660  20 6f 75 74 20 6f 66 20  72 61 6e 67 65 2e 0a 20  | out of range.. |
00009670  20 20 2d 20 43 68 61 6e  67 65 64 20 63 6f 6d 6d  |  - Changed comm|
00009680  61 6e 64 20 6f 72 64 65  72 20 73 6f 20 74 68 61  |and order so tha|
00009690  74 20 27 2a 50 6c 61 79  73 2e 27 20 77 69 6c 6c  |t '*Plays.' will|
000096a0  20 64 6f 20 2a 50 6c 61  79 53 74 61 74 75 73 20  | do *PlayStatus |
000096b0  72 61 74 68 65 72 20 74  68 61 6e 0a 20 20 20 20  |rather than.    |
000096c0  20 20 20 20 2a 50 6c 61  79 53 61 6d 70 6c 65 73  |    *PlaySamples|
000096d0  2e 0a 20 20 20 2d 20 4d  6f 64 75 6c 65 20 6e 6f  |..   - Module no|
000096e0  77 20 69 6e 73 74 61 6c  6c 73 20 69 74 73 65 6c  |w installs itsel|
000096f0  66 20 61 73 20 61 20 73  6f 75 6e 64 20 63 68 61  |f as a sound cha|
00009700  6e 6e 65 6c 20 68 61 6e  64 6c 65 72 20 28 6e 6f  |nnel handler (no|
00009710  20 6d 6f 72 65 20 6f 66  20 74 68 65 0a 20 20 20  | more of the.   |
00009720  20 20 20 20 20 27 54 72  61 63 6b 65 72 56 6f 78  |     'TrackerVox|
00009730  27 20 76 6f 69 63 65 29  2e 0a 20 20 20 20 20 45  |' voice)..     E|
00009740  66 66 65 63 74 73 20 6f  66 20 74 68 69 73 20 72  |ffects of this r|
00009750  65 63 6f 64 69 6e 67 20  61 72 65 3a 2d 0a 20 20  |ecoding are:-.  |
00009760  20 20 20 20 20 20 2a 20  20 49 74 27 73 20 6d 75  |      *  It's mu|
00009770  63 68 20 74 72 69 63 6b  69 65 72 20 66 6f 72 20  |ch trickier for |
00009780  70 72 6f 67 72 61 6d 73  20 74 6f 20 73 61 62 6f  |programs to sabo|
00009790  74 61 67 65 20 61 6e 79  20 63 75 72 72 65 6e 74  |tage any current|
000097a0  20 74 75 6e 65 73 2c 20  61 73 0a 20 20 20 20 20  | tunes, as.     |
000097b0  20 20 20 20 20 20 61 73  73 69 67 6e 69 6e 67 20  |      assigning |
000097c0  73 6f 75 6e 64 20 76 6f  69 63 65 73 20 68 61 73  |sound voices has|
000097d0  20 6e 6f 20 65 66 66 65  63 74 20 28 75 6e 6c 65  | no effect (unle|
000097e0  73 73 20 74 68 65 20 74  75 6e 65 20 69 73 20 73  |ss the tune is s|
000097f0  74 6f 70 70 65 64 29 2e  0a 20 20 20 20 20 20 20  |topped)..       |
00009800  20 2a 20 20 42 65 66 6f  72 65 2c 20 73 61 6d 70  | *  Before, samp|
00009810  6c 65 73 20 70 6c 61 79  65 64 20 73 69 6d 75 6c  |les played simul|
00009820  74 61 6e 65 6f 75 73 6c  79 20 6f 6e 20 64 69 66  |taneously on dif|
00009830  66 65 72 65 6e 74 20 63  68 61 6e 6e 65 6c 73 20  |ferent channels |
00009840  77 65 72 65 0a 20 20 20  20 20 20 20 20 20 20 20  |were.           |
00009850  73 6f 6d 65 74 69 6d 65  73 20 70 6c 61 79 65 64  |sometimes played|
00009860  20 73 6c 69 67 68 74 6c  79 20 6f 75 74 20 6f 66  | slightly out of|
00009870  20 70 68 61 73 65 20 28  73 6f 75 6e 64 65 64 20  | phase (sounded |
00009880  71 75 69 65 74 65 72 2f  77 65 69 72 64 29 2e 0a  |quieter/weird)..|
00009890  20 20 20 20 20 20 20 20  20 20 20 54 68 69 73 20  |           This |
000098a0  73 6f 6d 65 74 69 6d 65  73 20 73 74 69 6c 6c 20  |sometimes still |
000098b0  68 61 70 70 65 6e 73 2c  20 62 75 74 20 6c 65 73  |happens, but les|
000098c0  73 20 6f 66 74 65 6e 2e  0a 20 20 20 20 20 20 20  |s often..       |
000098d0  20 2a 20 20 52 65 2d 63  6f 6e 66 69 67 75 72 69  | *  Re-configuri|
000098e0  6e 67 20 74 68 65 20 73  61 6d 70 6c 65 20 72 61  |ng the sample ra|
000098f0  74 65 20 77 69 6c 6c 20  6e 6f 74 20 77 6f 72 6b  |te will not work|
00009900  20 77 68 69 6c 65 20 61  20 74 75 6e 65 20 69 73  | while a tune is|
00009910  0a 20 20 20 20 20 20 20  20 20 20 20 70 6c 61 79  |.           play|
00009920  69 6e 67 2c 20 73 6f 20  74 68 61 74 20 73 68 6f  |ing, so that sho|
00009930  75 6c 64 20 62 65 20 6f  6e 65 20 6c 65 73 73 20  |uld be one less |
00009940  74 68 69 6e 67 20 74 6f  20 67 6f 20 77 72 6f 6e  |thing to go wron|
00009950  67 2e 0a 20 20 20 2d 20  53 6c 69 67 68 74 6c 79  |g..   - Slightly|
00009960  20 63 68 61 6e 67 65 64  20 2a 50 6c 61 79 73 61  | changed *Playsa|
00009970  6d 70 6c 65 73 20 63 6f  6d 6d 61 6e 64 20 74 6f  |mples command to|
00009980  20 69 6e 63 6c 75 64 65  20 73 61 6d 70 6c 65 20  | include sample |
00009990  6e 75 6d 62 65 72 2e 0a  20 20 20 2d 20 46 69 78  |number..   - Fix|
000099a0  65 64 20 70 72 6f 62 6c  65 6d 20 77 69 74 68 20  |ed problem with |
000099b0  2a 50 6c 61 79 73 74 61  74 75 73 20 61 6e 64 20  |*Playstatus and |
000099c0  6e 6f 6e 2d 74 65 72 6d  69 6e 61 74 65 64 20 74  |non-terminated t|
000099d0  75 6e 65 20 6e 61 6d 65  73 2e 0a 20 20 20 2d 20  |une names..   - |
000099e0  41 6c 74 65 72 65 64 20  54 72 61 63 6b 65 72 5f  |Altered Tracker_|
000099f0  53 74 65 72 65 6f 20 74  6f 20 72 65 74 75 72 6e  |Stereo to return|
00009a00  20 63 75 72 72 65 6e 74  20 73 65 74 74 69 6e 67  | current setting|
00009a10  73 20 69 66 20 52 30 3d  2d 31 20 6f 6e 20 65 6e  |s if R0=-1 on en|
00009a20  74 72 79 2e 0a 20 20 20  2d 20 41 64 64 65 64 20  |try..   - Added |
00009a30  2a 50 6c 61 79 56 6f 6c  75 6d 65 2f 54 72 61 63  |*PlayVolume/Trac|
00009a40  6b 65 72 5f 56 6f 6c 75  6d 65 20 74 6f 20 63 6f  |ker_Volume to co|
00009a50  6e 74 72 6f 6c 20 6f 76  65 72 61 6c 6c 20 76 6f  |ntrol overall vo|
00009a60  6c 75 6d 65 2e 0a 20 20  20 76 65 72 73 69 6f 6e  |lume..   version|
00009a70  20 28 42 29 0a 20 20 20  2d 20 49 66 20 2a 50 6c  | (B).   - If *Pl|
00009a80  61 79 53 74 65 72 65 6f  20 34 20 77 61 73 20 73  |ayStereo 4 was s|
00009a90  65 6c 65 63 74 65 64 2c  20 73 74 65 72 65 6f 20  |elected, stereo |
00009aa0  73 65 74 74 69 6e 67 73  20 77 65 72 65 20 62 65  |settings were be|
00009ab0  69 6e 67 20 63 6f 72 72  75 70 74 65 64 20 77 68  |ing corrupted wh|
00009ac0  65 6e 0a 20 20 20 20 20  20 20 20 74 68 65 20 74  |en.        the t|
00009ad0  75 6e 65 20 77 61 73 20  73 74 6f 70 70 65 64 2e  |une was stopped.|
00009ae0  0a 20 20 20 2d 20 54 72  61 63 6b 65 72 20 27 45  |.   - Tracker 'E|
00009af0  27 20 73 74 65 72 65 6f  20 63 6f 6d 6d 61 6e 64  |' stereo command|
00009b00  73 20 63 61 75 73 65 64  20 61 20 63 72 61 73 68  |s caused a crash|
00009b10  20 69 66 20 2a 50 6c 61  79 53 74 65 72 65 6f 20  | if *PlayStereo |
00009b20  34 20 77 61 73 20 65 6e  61 62 6c 65 64 2e 0a 0a  |4 was enabled...|
00009b30  56 65 72 73 69 6f 6e 20  34 2e 30 36 20 20 20 20  |Version 4.06    |
00009b40  20 20 4d 61 6a 6f 72 20  75 70 64 61 74 65 0a 20  |  Major update. |
00009b50  20 20 49 20 66 69 6e 61  6c 6c 79 20 67 6f 74 20  |  I finally got |
00009b60  73 6f 6d 65 20 64 65 63  65 6e 74 20 61 6d 69 67  |some decent amig|
00009b70  61 20 73 6f 75 6e 64 74  72 61 63 6b 65 72 20 64  |a soundtracker d|
00009b80  6f 63 75 6d 65 6e 74 61  74 69 6f 6e 2e 0a 20 20  |ocumentation..  |
00009b90  20 54 68 65 6e 20 49 20  64 69 73 63 6f 76 65 72  | Then I discover|
00009ba0  65 64 20 68 6f 77 20 6d  75 63 68 20 49 20 68 61  |ed how much I ha|
00009bb0  64 20 77 72 6f 6e 67 2e  2e 20 6d 61 6a 6f 72 20  |d wrong.. major |
00009bc0  75 70 64 61 74 65 20 6e  65 65 64 65 64 21 0a 20  |update needed!. |
00009bd0  20 20 0a 20 20 20 2d 20  53 6f 75 6e 64 74 72 61  |  .   - Soundtra|
00009be0  63 6b 65 72 20 74 75 6e  65 73 20 77 65 72 65 20  |cker tunes were |
00009bf0  62 65 69 6e 67 20 63 6f  6e 76 65 72 74 65 64 20  |being converted |
00009c00  77 72 6f 6e 67 6c 79 2e  2e 0a 20 20 20 20 20 20  |wrongly...      |
00009c10  20 20 2a 20 20 52 65 70  65 61 74 20 6f 66 66 73  |  *  Repeat offs|
00009c20  65 74 20 6e 6f 77 20 6d  61 64 65 20 74 77 69 63  |et now made twic|
00009c30  65 20 61 73 20 62 69 67  2e 0a 20 20 20 20 20 20  |e as big..      |
00009c40  20 20 2a 20 20 56 6f 6c  75 6d 65 73 20 61 62 6f  |  *  Volumes abo|
00009c50  76 65 20 74 68 65 20 73  70 65 63 69 66 69 65 64  |ve the specified|
00009c60  20 6d 61 78 69 6d 75 6d  20 28 36 34 29 20 77 65  | maximum (64) we|
00009c70  72 65 20 63 6f 6e 76 65  72 74 65 64 20 73 74 72  |re converted str|
00009c80  61 6e 67 65 6c 79 2e 0a  20 20 20 20 20 20 20 20  |angely..        |
00009c90  20 20 20 4e 6f 77 20 6f  75 74 2d 6f 66 2d 72 61  |   Now out-of-ra|
00009ca0  6e 67 65 20 76 6f 6c 75  6d 65 73 20 61 72 65 20  |nge volumes are |
00009cb0  73 65 74 20 74 6f 20 36  34 2e 0a 20 20 20 2d 20  |set to 64..   - |
00009cc0  41 63 63 75 72 61 63 79  20 6f 66 20 74 68 65 20  |Accuracy of the |
00009cd0  73 6f 75 6e 64 20 72 6f  75 74 69 6e 65 73 20 69  |sound routines i|
00009ce0  6d 70 72 6f 76 65 64 20  74 6f 20 63 6f 70 65 20  |mproved to cope |
00009cf0  77 69 74 68 20 76 65 72  79 20 73 6d 61 6c 6c 20  |with very small |
00009d00  6c 6f 6f 70 69 6e 67 0a  20 20 20 20 20 20 20 20  |looping.        |
00009d10  73 61 6d 70 6c 65 73 20  77 68 69 63 68 20 77 65  |samples which we|
00009d20  72 65 20 73 65 65 6d 69  6e 67 6c 79 20 70 69 74  |re seemingly pit|
00009d30  63 68 65 64 20 77 72 6f  6e 67 6c 79 20 61 73 20  |ched wrongly as |
00009d40  61 20 72 65 73 75 6c 74  20 6f 66 20 34 2d 62 79  |a result of 4-by|
00009d50  74 65 0a 20 20 20 20 20  20 20 20 61 63 63 75 72  |te.        accur|
00009d60  61 63 79 2e 20 41 63 63  75 72 61 63 79 20 6e 6f  |acy. Accuracy no|
00009d70  77 20 31 20 62 79 74 65  2e 20 54 68 69 73 20 6d  |w 1 byte. This m|
00009d80  61 79 20 73 6c 6f 77 20  74 68 69 6e 67 73 20 64  |ay slow things d|
00009d90  6f 77 6e 20 61 20 74 69  6e 79 20 62 69 74 2e 0a  |own a tiny bit..|
00009da0  20 20 20 2d 20 41 6c 74  65 72 65 64 20 74 68 65  |   - Altered the|
00009db0  20 76 6f 6c 75 6d 65 20  73 79 73 74 65 6d 20 73  | volume system s|
00009dc0  6f 20 74 68 61 74 20 73  6f 75 6e 64 74 72 61 63  |o that soundtrac|
00009dd0  6b 65 72 20 76 6f 6c 75  6d 65 73 20 61 72 65 20  |ker volumes are |
00009de0  61 73 20 61 63 63 75 72  61 74 65 0a 20 20 20 20  |as accurate.    |
00009df0  20 20 20 20 61 73 20 70  6f 73 73 69 62 6c 65 20  |    as possible |
00009e00  28 69 65 2e 20 76 6f 6c  75 6d 65 20 73 6c 69 64  |(ie. volume slid|
00009e10  65 73 20 6e 6f 77 20 73  6c 69 64 65 20 64 6f 77  |es now slide dow|
00009e20  6e 20 74 68 65 20 73 6f  75 6e 64 74 72 61 63 6b  |n the soundtrack|
00009e30  65 72 20 28 30 2d 36 34  29 0a 20 20 20 20 20 20  |er (0-64).      |
00009e40  20 20 76 6f 6c 75 6d 65  73 20 72 61 74 68 65 72  |  volumes rather|
00009e50  20 74 68 61 6e 20 74 68  65 20 61 72 63 20 6c 6f  | than the arc lo|
00009e60  67 20 76 6f 6c 75 6d 65  73 20 28 30 2d 32 35 35  |g volumes (0-255|
00009e70  29 2c 20 62 75 74 20 73  74 69 6c 6c 20 6b 65 65  |), but still kee|
00009e80  70 69 6e 67 0a 20 20 20  20 20 20 20 20 74 68 65  |ping.        the|
00009e90  20 73 61 6d 65 20 73 79  73 74 65 6d 20 66 6f 72  | same system for|
00009ea0  20 74 72 61 63 6b 65 72  20 74 75 6e 65 73 2e 20  | tracker tunes. |
00009eb0  54 68 65 72 65 66 6f 72  65 2c 20 69 66 20 79 6f  |Therefore, if yo|
00009ec0  75 20 77 61 6e 74 20 74  68 65 20 6d 6f 73 74 0a  |u want the most.|
00009ed0  20 20 20 20 20 20 20 20  61 63 63 75 72 61 74 65  |        accurate|
00009ee0  20 70 6c 61 79 62 61 63  6b 20 6f 66 20 61 20 73  | playback of a s|
00009ef0  6f 75 6e 64 74 72 61 63  6b 65 72 20 74 75 6e 65  |oundtracker tune|
00009f00  2c 20 65 6e 73 75 72 65  20 69 74 20 69 73 20 69  |, ensure it is i|
00009f10  6e 20 69 74 73 0a 20 20  20 20 20 20 20 20 6f 72  |n its.        or|
00009f20  69 67 69 6e 61 6c 20 66  6f 72 6d 61 74 2e 0a 20  |iginal format.. |
00009f30  20 20 2d 20 46 69 6e 61  6c 6c 79 20 69 6d 70 6c  |  - Finally impl|
00009f40  65 6d 65 6e 74 65 64 20  63 6f 6d 6d 61 6e 64 73  |emented commands|
00009f50  20 33 20 28 70 6f 72 74  61 6d 65 6e 74 6f 29 20  | 3 (portamento) |
00009f60  61 6e 64 20 34 20 28 76  69 62 72 61 74 6f 29 2e  |and 4 (vibrato).|
00009f70  20 49 66 20 79 6f 75 20  68 61 76 65 0a 20 20 20  | If you have.   |
00009f80  20 20 20 20 20 63 6f 6e  76 65 72 74 65 64 20 6f  |     converted o|
00009f90  72 69 67 69 6e 61 6c 20  73 6f 75 6e 64 74 72 61  |riginal soundtra|
00009fa0  63 6b 65 72 20 74 75 6e  65 73 20 69 6e 74 6f 20  |cker tunes into |
00009fb0  74 72 61 63 6b 65 72 20  66 6f 72 6d 61 74 2c 20  |tracker format, |
00009fc0  63 6f 6d 6d 61 6e 64 20  34 0a 20 20 20 20 20 20  |command 4.      |
00009fd0  20 20 77 69 6c 6c 20 68  61 76 65 20 6e 6f 20 65  |  will have no e|
00009fe0  66 66 65 63 74 20 64 75  65 20 74 6f 20 74 68 65  |ffect due to the|
00009ff0  20 64 69 66 66 65 72 65  6e 74 20 76 6f 6c 75 6d  | different volum|
0000a000  65 20 66 6f 72 6d 61 74  73 2e 20 54 68 65 20 76  |e formats. The v|
0000a010  69 62 72 61 74 6f 0a 20  20 20 20 20 20 20 20 65  |ibrato.        e|
0000a020  66 66 65 63 74 20 6d 61  79 20 6e 6f 74 20 62 65  |ffect may not be|
0000a030  20 65 78 61 63 74 6c 79  20 74 68 65 20 73 61 6d  | exactly the sam|
0000a040  65 20 61 73 20 6f 6e 20  74 68 65 20 61 6d 69 67  |e as on the amig|
0000a050  61 2c 20 62 75 74 20 69  74 27 73 20 63 6c 6f 73  |a, but it's clos|
0000a060  65 0a 20 20 20 20 20 20  20 20 65 6e 6f 75 67 68  |e.        enough|
0000a070  2e 0a 20 20 20 2d 20 57  68 65 6e 20 73 6f 75 6e  |..   - When soun|
0000a080  64 74 72 61 63 6b 65 72  20 74 75 6e 65 73 20 61  |dtracker tunes a|
0000a090  72 65 20 53 57 49 20 27  4d 65 6d 6f 72 79 4c 6f  |re SWI 'MemoryLo|
0000a0a0  61 64 27 65 64 2c 20 74  68 65 79 20 61 72 65 20  |ad'ed, they are |
0000a0b0  63 6f 6e 76 65 72 74 65  64 20 62 61 63 6b 0a 20  |converted back. |
0000a0c0  20 20 20 20 20 20 20 74  6f 20 74 68 65 20 6f 72  |       to the or|
0000a0d0  69 67 69 6e 61 6c 20 66  6f 72 6d 61 74 20 77 68  |iginal format wh|
0000a0e0  65 6e 20 2a 50 6c 61 79  53 74 6f 70 20 65 74 63  |en *PlayStop etc|
0000a0f0  2e 20 69 73 20 70 65 72  66 6f 72 6d 65 64 20 28  |. is performed (|
0000a100  74 6f 20 61 6c 6c 6f 77  0a 20 20 20 20 20 20 20  |to allow.       |
0000a110  20 65 64 69 74 6f 72 73  20 74 6f 20 73 61 76 65  | editors to save|
0000a120  20 61 73 20 73 6f 75 6e  64 74 72 61 63 6b 65 72  | as soundtracker|
0000a130  20 66 6f 72 6d 61 74 29  2e 20 4e 42 20 54 72 61  | format). NB Tra|
0000a140  63 6b 65 72 2d 73 70 65  63 69 66 69 63 20 63 6f  |cker-specific co|
0000a150  6d 6d 61 6e 64 73 0a 20  20 20 20 20 20 20 20 61  |mmands.        a|
0000a160  6e 64 20 6f 75 74 20 6f  66 20 72 61 6e 67 65 20  |nd out of range |
0000a170  69 6e 73 74 72 75 6d 65  6e 74 73 20 65 74 63 2e  |instruments etc.|
0000a180  20 61 72 65 20 69 67 6e  6f 72 65 64 2f 6d 69 73  | are ignored/mis|
0000a190  2d 63 6f 6e 76 65 72 74  65 64 2e 0a 20 20 20 2d  |-converted..   -|
0000a1a0  20 54 72 61 63 6b 65 72  5f 57 72 69 74 65 53 61  | Tracker_WriteSa|
0000a1b0  6d 70 6c 65 54 61 62 6c  65 20 69 6e 74 72 6f 64  |mpleTable introd|
0000a1c0  75 63 65 64 20 74 6f 20  61 6c 6c 6f 77 20 74 72  |uced to allow tr|
0000a1d0  61 6e 73 70 61 72 65 6e  74 20 61 63 63 65 73 73  |ansparent access|
0000a1e0  20 6f 66 20 74 68 65 0a  20 20 20 20 20 20 20 20  | of the.        |
0000a1f0  73 61 6d 70 6c 65 20 64  61 74 61 20 61 6e 64 20  |sample data and |
0000a200  69 6e 64 65 70 65 6e 64  65 6e 63 65 20 28 61 6c  |independence (al|
0000a210  6d 6f 73 74 29 20 6f 66  20 74 68 65 20 54 72 61  |most) of the Tra|
0000a220  63 6b 65 72 20 66 6f 72  6d 61 74 2e 0a 20 20 20  |cker format..   |
0000a230  2d 20 2a 2a 20 50 6c 65  61 73 65 20 4e 6f 74 65  |- ** Please Note|
0000a240  20 2a 2a 20 20 20 56 6f  6c 75 6d 65 73 20 72 65  | **   Volumes re|
0000a250  74 75 72 6e 65 64 20 62  79 20 54 72 61 63 6b 65  |turned by Tracke|
0000a260  72 5f 52 65 61 64 53 61  6d 70 6c 65 54 61 62 6c  |r_ReadSampleTabl|
0000a270  65 20 77 68 69 6c 65 0a  20 20 20 20 20 20 20 20  |e while.        |
0000a280  73 6f 75 6e 64 74 72 61  63 6b 65 72 20 74 75 6e  |soundtracker tun|
0000a290  65 73 20 61 72 65 20 6c  6f 61 64 65 64 20 61 72  |es are loaded ar|
0000a2a0  65 20 6e 6f 77 20 69 6e  20 74 68 65 20 72 61 6e  |e now in the ran|
0000a2b0  67 65 20 30 2d 36 34 2e  20 54 68 65 73 65 20 63  |ge 0-64. These c|
0000a2c0  61 6e 0a 20 20 20 20 20  20 20 20 62 65 20 63 6f  |an.        be co|
0000a2d0  6e 76 65 72 74 65 64 20  69 6e 74 6f 20 74 72 61  |nverted into tra|
0000a2e0  63 6b 65 72 20 76 6f 6c  75 6d 65 73 20 75 73 69  |cker volumes usi|
0000a2f0  6e 67 20 74 68 65 20 6e  65 77 0a 20 20 20 20 20  |ng the new.     |
0000a300  20 20 20 54 72 61 63 6b  65 72 5f 54 72 61 6e 73  |   Tracker_Trans|
0000a310  6c 61 74 65 56 6f 6c 75  6d 65 20 53 57 49 2e 20  |lateVolume SWI. |
0000a320  2a 50 6c 61 79 53 61 6d  70 6c 65 73 20 63 6f 6e  |*PlaySamples con|
0000a330  76 65 72 74 73 20 74 68  65 20 76 6f 6c 75 6d 65  |verts the volume|
0000a340  73 20 66 69 72 73 74 2e  0a 20 20 20 2d 20 53 57  |s first..   - SW|
0000a350  49 20 54 72 61 63 6b 65  72 5f 55 70 64 61 74 65  |I Tracker_Update|
0000a360  44 61 74 61 20 69 6e 74  72 6f 64 75 63 65 64 20  |Data introduced |
0000a370  74 6f 20 68 65 6c 70 20  65 64 69 74 6f 72 73 20  |to help editors |
0000a380  69 6e 74 65 72 66 61 63  65 20 77 69 74 68 20 74  |interface with t|
0000a390  68 65 0a 20 20 20 20 20  20 20 20 54 72 61 63 6b  |he.        Track|
0000a3a0  65 72 6d 6f 64 75 6c 65  2e 0a 20 20 20 2d 20 53  |ermodule..   - S|
0000a3b0  61 6d 70 6c 65 20 64 61  74 61 20 69 6e 66 6f 72  |ample data infor|
0000a3c0  6d 61 74 69 6f 6e 20 6e  6f 77 20 72 65 61 64 20  |mation now read |
0000a3d0  64 69 72 65 63 74 6c 79  20 69 6e 20 74 68 65 20  |directly in the |
0000a3e0  6d 61 69 6e 20 72 6f 75  74 69 6e 65 73 20 72 61  |main routines ra|
0000a3f0  74 68 65 72 0a 20 20 20  20 20 20 20 20 74 68 61  |ther.        tha|
0000a400  6e 20 63 6f 70 69 65 64  20 77 68 65 6e 20 74 68  |n copied when th|
0000a410  65 20 6d 6f 64 75 6c 65  20 69 73 20 6c 6f 61 64  |e module is load|
0000a420  65 64 2c 20 74 6f 20 65  6e 61 62 6c 65 20 65 64  |ed, to enable ed|
0000a430  69 74 6f 72 73 20 74 6f  20 61 6c 74 65 72 20 74  |itors to alter t|
0000a440  68 65 0a 20 20 20 20 20  20 20 20 6d 6f 64 75 6c  |he.        modul|
0000a450  65 20 77 68 69 6c 65 20  70 6c 61 79 69 6e 67 2e  |e while playing.|
0000a460  0a 20 20 20 2d 20 4f 6e  20 72 65 73 65 74 2c 20  |.   - On reset, |
0000a470  74 75 6e 65 20 63 6f 6e  74 69 6e 75 65 73 20 70  |tune continues p|
0000a480  6c 61 79 69 6e 67 20 72  61 74 68 65 72 20 74 68  |laying rather th|
0000a490  61 6e 20 62 65 69 6e 67  20 6b 69 6c 6c 65 64 20  |an being killed |
0000a4a0  61 73 20 62 65 66 6f 72  65 2e 0a 20 20 20 2d 20  |as before..   - |
0000a4b0  57 68 65 6e 20 74 75 6e  65 20 69 73 20 73 74 6f  |When tune is sto|
0000a4c0  70 70 65 64 2c 20 74 68  65 20 73 6f 75 6e 64 20  |pped, the sound |
0000a4d0  73 79 73 74 65 6d 20 69  73 20 72 65 73 74 6f 72  |system is restor|
0000a4e0  65 64 20 6d 6f 72 65 20  65 66 66 65 63 74 69 76  |ed more effectiv|
0000a4f0  65 6c 79 20 28 69 65 2e  0a 20 20 20 20 20 20 20  |ely (ie..       |
0000a500  20 72 65 73 65 74 74 69  6e 67 20 74 68 65 20 73  | resetting the s|
0000a510  61 6d 70 6c 65 20 72 61  74 65 20 77 69 74 68 20  |ample rate with |
0000a520  38 20 76 6f 69 63 65 73  20 61 63 74 69 76 65 20  |8 voices active |
0000a530  70 72 65 76 69 6f 75 73  6c 79 20 6e 6f 77 20 77  |previously now w|
0000a540  6f 72 6b 73 20 2d 0a 20  20 20 20 20 20 20 20 65  |orks -.        e|
0000a550  67 2e 20 77 68 65 6e 20  69 6e 74 65 72 72 75 70  |g. when interrup|
0000a560  74 69 6e 67 20 21 4d 61  65 73 74 72 6f 29 2e 0a  |ting !Maestro)..|
0000a570
Music/!S_Tracker/!Help
00000000  21 53 2f 54 72 61 63 6b  65 72 20 28 53 6f 75 6e  |!S/Tracker (Soun|
00000010  64 74 72 61 63 6b 65 72  2f 54 72 61 63 6b 65 72  |dtracker/Tracker|
00000020  20 6d 6f 64 75 6c 65 20  6d 75 73 69 63 20 70 6c  | module music pl|
00000030  61 79 65 72 29 0a 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |ayer).----------|
00000040  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000060  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 0a 0a 56 65 72  |-----------..Ver|
00000070  73 69 6f 6e 20 34 2e 30  30 20 28 32 33 20 4d 61  |sion 4.00 (23 Ma|
00000080  79 20 31 39 39 31 29 0a  0a 4f 72 69 67 69 6e 61  |y 1991)..Origina|
00000090  6c 6c 79 20 77 72 69 74  74 65 6e 20 62 79 20 48  |lly written by H|
000000a0  75 67 6f 20 46 69 65 6e  6e 65 73 20 61 6e 64 20  |ugo Fiennes and |
000000b0  46 61 62 72 69 63 65 20  4d 65 72 63 69 65 72 20  |Fabrice Mercier |
000000c0  5b 28 63 29 20 54 68 65  20 53 65 72 69 61 6c 20  |[(c) The Serial |
000000d0  50 6f 72 74 5d 0a 53 57  49 20 69 6e 74 65 72 66  |Port].SWI interf|
000000e0  61 63 65 20 61 6e 64 20  6f 74 68 65 72 20 62 69  |ace and other bi|
000000f0  74 73 20 61 64 64 65 64  20 62 79 20 4d 61 74 74  |ts added by Matt|
00000100  20 46 61 72 72 6f 77 0a  0a 0a 59 6f 75 20 61 72  | Farrow...You ar|
00000110  65 20 61 6c 6c 6f 77 65  64 20 74 6f 20 75 73 65  |e allowed to use|
00000120  20 74 68 69 73 20 6d 6f  64 75 6c 65 20 77 69 74  | this module wit|
00000130  68 20 61 6e 79 20 64 65  6d 6f 73 20 6f 72 20 70  |h any demos or p|
00000140  2e 64 2e 20 73 74 75 66  66 20 79 6f 75 20 77 72  |.d. stuff you wr|
00000150  69 74 65 2c 0a 62 75 74  20 70 65 72 6d 69 73 73  |ite,.but permiss|
00000160  69 6f 6e 20 69 73 20 72  65 71 75 69 72 65 64 20  |ion is required |
00000170  62 65 66 6f 72 65 20 79  6f 75 20 63 61 6e 20 75  |before you can u|
00000180  73 65 20 69 74 20 69 6e  20 61 6e 79 20 63 6f 6d  |se it in any com|
00000190  6d 65 72 63 69 61 6c 20  73 6f 66 74 77 61 72 65  |mercial software|
000001a0  2e 0a 0a 54 68 65 20 21  53 2f 54 72 61 63 6b 65  |...The !S/Tracke|
000001b0  72 20 61 70 70 6c 69 63  61 74 69 6f 6e 20 6d 61  |r application ma|
000001c0  79 20 62 65 20 66 72 65  65 6c 79 20 63 6f 70 69  |y be freely copi|
000001d0  65 64 20 69 66 20 6e 6f  74 68 69 6e 67 20 6d 6f  |ed if nothing mo|
000001e0  72 65 20 74 68 61 6e 20  74 68 65 0a 63 6f 73 74  |re than the.cost|
000001f0  20 6f 66 20 61 20 64 69  73 63 20 61 6e 64 20 61  | of a disc and a|
00000200  20 73 6d 61 6c 6c 20 61  6d 6f 75 6e 74 20 66 6f  | small amount fo|
00000210  72 20 74 68 65 20 74 72  6f 75 62 6c 65 20 69 73  |r the trouble is|
00000220  20 63 68 61 72 67 65 64  2c 20 62 75 74 20 69 74  | charged, but it|
00000230  20 6d 75 73 74 20 62 65  0a 64 69 73 74 72 69 62  | must be.distrib|
00000240  75 74 65 64 20 77 69 74  68 20 61 6c 6c 20 74 68  |uted with all th|
00000250  65 20 66 69 6c 65 73 20  63 6f 6d 70 6c 65 74 65  |e files complete|
00000260  20 61 6e 64 20 75 6e 63  68 61 6e 67 65 64 2e 0a  | and unchanged..|
00000270  0a 0a 44 4f 43 55 4d 45  4e 54 41 54 49 4f 4e 20  |..DOCUMENTATION |
00000280  4f 46 20 2a 20 43 4f 4d  4d 41 4e 44 53 20 41 4e  |OF * COMMANDS AN|
00000290  44 20 53 57 49 27 73 0a  2d 2d 2d 2d 2d 2d 2d 2d  |D SWI's.--------|
000002a0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
000002b0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 0a 0a 2a  |-------------..*|
000002c0  50 6c 61 79 4d 6f 64 20  20 20 20 20 2d 20 4c 6f  |PlayMod     - Lo|
000002d0  61 64 73 20 69 6e 74 6f  20 6d 65 6d 6f 72 79 20  |ads into memory |
000002e0  61 6e 64 20 73 74 61 72  74 73 20 74 6f 20 70 6c  |and starts to pl|
000002f0  61 79 20 74 68 65 20 73  70 65 63 69 66 69 65 64  |ay the specified|
00000300  20 54 72 61 63 6b 65 72  20 6f 72 0a 20 20 20 20  | Tracker or.    |
00000310  20 20 20 20 20 20 20 20  20 20 20 53 6f 75 6e 64  |           Sound|
00000320  74 72 61 63 6b 65 72 20  6d 6f 64 75 6c 65 2c 20  |tracker module, |
00000330  64 65 74 65 72 6d 69 6e  69 6e 67 20 61 75 74 6f  |determining auto|
00000340  6d 61 74 69 63 61 6c 6c  79 20 77 68 69 63 68 20  |matically which |
00000350  66 6f 72 6d 61 74 20 69  74 0a 20 20 20 20 20 20  |format it.      |
00000360  20 20 20 20 20 20 20 20  20 69 73 2e 0a 0a 20 20  |         is...  |
00000370  20 20 20 20 20 20 20 20  20 20 20 20 20 53 79 6e  |             Syn|
00000380  74 61 78 3a 20 2a 50 6c  61 79 4d 6f 64 20 3c 66  |tax: *PlayMod <f|
00000390  69 6c 65 6e 61 6d 65 3e  0a 20 20 20 20 20 20 20  |ilename>.       |
000003a0  20 20 0a 0a 0a 0a 2a 50  6c 61 79 50 61 75 73 65  |  ....*PlayPause|
000003b0  20 20 20 2d 20 57 69 6c  6c 20 70 61 75 73 65 20  |   - Will pause |
000003c0  74 68 65 20 63 75 72 72  65 6e 74 6c 79 20 70 6c  |the currently pl|
000003d0  61 79 69 6e 67 20 74 75  6e 65 20 28 6b 69 6c 6c  |aying tune (kill|
000003e0  73 20 61 6c 6c 20 73 6f  75 6e 64 20 69 6d 6d 65  |s all sound imme|
000003f0  64 2d 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |d-.             |
00000400  20 20 69 61 74 65 6c 79  29 20 62 75 74 20 72 65  |  iately) but re|
00000410  74 61 69 6e 73 20 74 68  65 20 73 6f 75 6e 64 74  |tains the soundt|
00000420  72 61 63 6b 65 72 2f 74  72 61 63 6b 65 72 20 6d  |racker/tracker m|
00000430  6f 64 75 6c 65 20 69 6e  20 6d 65 6d 6f 72 79 2e  |odule in memory.|
00000440  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00000450  54 68 65 20 74 75 6e 65  20 63 61 6e 20 62 65 20  |The tune can be |
00000460  72 65 73 74 61 72 74 65  64 20 77 69 74 68 20 61  |restarted with a|
00000470  20 2a 50 6c 61 79 53 74  61 72 74 20 63 6f 6d 6d  | *PlayStart comm|
00000480  61 6e 64 2e 0a 0a 20 20  20 20 20 20 20 20 20 20  |and...          |
00000490  20 20 20 20 20 53 79 6e  74 61 78 3a 20 2a 50 6c  |     Syntax: *Pl|
000004a0  61 79 50 61 75 73 65 0a  0a 0a 0a 0a 2a 50 6c 61  |ayPause.....*Pla|
000004b0  79 53 74 61 72 74 20 20  20 2d 20 57 69 6c 6c 20  |yStart   - Will |
000004c0  72 65 73 75 6d 65 20 70  6c 61 79 69 6e 67 20 61  |resume playing a|
000004d0  20 74 75 6e 65 20 61 66  74 65 72 20 61 20 2a 50  | tune after a *P|
000004e0  6c 61 79 50 61 75 73 65  20 63 6f 6d 6d 61 6e 64  |layPause command|
000004f0  2e 0a 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |...             |
00000500  20 20 53 79 6e 74 61 78  3a 20 2a 50 6c 61 79 53  |  Syntax: *PlayS|
00000510  74 61 72 74 0a 0a 20 0a  0a 0a 2a 50 6c 61 79 50  |tart.. ...*PlayP|
00000520  6f 73 20 20 20 20 20 2d  20 57 69 6c 6c 20 73 65  |os     - Will se|
00000530  74 20 74 68 65 20 63 75  72 72 65 6e 74 20 70 6f  |t the current po|
00000540  73 69 74 69 6f 6e 20 69  6e 20 74 68 65 20 73 65  |sition in the se|
00000550  71 75 65 6e 63 65 20 74  61 62 6c 65 2c 20 6f 72  |quence table, or|
00000560  20 69 66 20 6e 6f 0a 20  20 20 20 20 20 20 20 20  | if no.         |
00000570  20 20 20 20 20 20 70 61  72 61 6d 65 74 65 72 20  |      parameter |
00000580  69 73 20 67 69 76 65 6e  2c 20 77 69 6c 6c 20 73  |is given, will s|
00000590  69 6d 70 6c 79 20 72 65  74 75 72 6e 20 74 68 65  |imply return the|
000005a0  20 63 75 72 72 65 6e 74  20 70 6f 73 69 74 69 6f  | current positio|
000005b0  6e 2e 0a 0a 20 20 20 20  20 20 20 20 20 20 20 20  |n...            |
000005c0  20 20 20 53 79 6e 74 61  78 3a 20 2a 50 6c 61 79  |   Syntax: *Play|
000005d0  50 6f 73 20 5b 3c 30 2d  31 32 37 3e 5d 0a 0a 20  |Pos [<0-127>].. |
000005e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 0a  |               .|
000005f0  0a 0a 2a 50 6c 61 79 53  61 6d 70 6c 65 73 20 2d  |..*PlaySamples -|
00000600  20 57 69 6c 6c 20 6c 69  73 74 20 61 6c 6c 20 74  | Will list all t|
00000610  68 65 20 73 61 6d 70 6c  65 73 20 61 73 73 6f 63  |he samples assoc|
00000620  69 61 74 65 64 20 77 69  74 68 20 74 68 65 20 63  |iated with the c|
00000630  75 72 72 65 6e 74 6c 79  0a 20 20 20 20 20 20 20  |urrently.       |
00000640  20 20 20 20 20 20 20 20  69 6e 73 74 61 6c 6c 65  |        installe|
00000650  64 20 6d 75 73 69 63 20  6d 6f 64 75 6c 65 2e 20  |d music module. |
00000660  0a 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |..              |
00000670  20 53 79 6e 74 61 78 3a  20 2a 50 6c 61 79 53 61  | Syntax: *PlaySa|
00000680  6d 70 6c 65 73 0a 0a 0a  0a 0a 2a 50 6c 61 79 53  |mples.....*PlayS|
00000690  74 61 74 75 73 20 20 2d  20 57 69 6c 6c 20 70 72  |tatus  - Will pr|
000006a0  69 6e 74 20 69 6e 66 6f  72 6d 61 74 69 6f 6e 20  |int information |
000006b0  61 62 6f 75 74 20 74 68  65 20 63 75 72 72 65 6e  |about the curren|
000006c0  74 20 74 75 6e 65 20 6d  6f 64 75 6c 65 20 6c 6f  |t tune module lo|
000006d0  61 64 65 64 0a 20 20 20  20 20 20 20 20 20 20 20  |aded.           |
000006e0  20 20 20 20 0a 20 20 20  20 20 20 20 20 20 20 20  |    .           |
000006f0  20 20 20 20 53 79 6e 74  61 78 3a 20 2a 50 6c 61  |    Syntax: *Pla|
00000700  79 53 74 61 74 75 73 0a  0a 0a 0a 0a 2a 50 6c 61  |yStatus.....*Pla|
00000710  79 53 74 65 72 65 6f 20  20 2d 20 43 6f 6e 74 72  |yStereo  - Contr|
00000720  6f 6c 73 20 74 68 65 20  73 74 65 72 65 6f 20 73  |ols the stereo s|
00000730  65 74 74 69 6e 67 73 20  77 68 69 6c 65 20 74 68  |ettings while th|
00000740  65 20 6f 6c 64 65 72 20  66 6f 72 6d 61 74 20 73  |e older format s|
00000750  6f 75 6e 64 2d 0a 20 20  20 20 20 20 20 20 20 20  |ound-.          |
00000760  20 20 20 20 20 74 72 61  63 6b 65 72 20 6d 6f 64  |     tracker mod|
00000770  75 6c 65 73 20 61 72 65  20 70 6c 61 79 69 6e 67  |ules are playing|
00000780  20 28 74 68 65 20 73 74  65 72 65 6f 20 69 73 20  | (the stereo is |
00000790  66 69 78 65 64 20 6f 6e  20 61 6e 20 41 6d 69 67  |fixed on an Amig|
000007a0  61 29 2c 0a 20 20 20 20  20 20 20 20 20 20 20 20  |a),.            |
000007b0  20 20 20 61 6e 64 20 77  69 6c 6c 20 73 77 69 74  |   and will swit|
000007c0  63 68 20 62 65 74 77 65  65 6e 20 66 69 76 65 20  |ch between five |
000007d0  70 6f 73 73 69 62 6c 65  20 73 65 74 74 69 6e 67  |possible setting|
000007e0  73 20 74 6f 20 63 61 74  65 72 20 66 6f 72 0a 20  |s to cater for. |
000007f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 6d 6f  |              mo|
00000800  73 74 20 63 6f 6e 66 69  67 75 72 61 74 69 6f 6e  |st configuration|
00000810  73 3a 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |s:.             |
00000820  20 20 20 20 20 20 30 20  2d 20 53 6c 69 67 68 74  |      0 - Slight|
00000830  6c 79 20 6f 66 66 2d 63  65 6e 74 72 65 20 6c 65  |ly off-centre le|
00000840  66 74 20 61 6e 64 20 72  69 67 68 74 20 28 6e 6f  |ft and right (no|
00000850  72 6d 61 6c 29 0a 20 20  20 20 20 20 20 20 20 20  |rmal).          |
00000860  20 20 20 20 20 20 20 20  20 31 20 2d 20 46 75 6c  |         1 - Ful|
00000870  6c 79 20 6c 65 66 74 20  61 6e 64 20 72 69 67 68  |ly left and righ|
00000880  74 20 28 61 6d 69 67 61  2d 73 74 79 6c 65 29 0a  |t (amiga-style).|
00000890  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000008a0  20 20 20 32 20 2d 20 46  75 6c 6c 79 20 6c 65 66  |   2 - Fully lef|
000008b0  74 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |t.              |
000008c0  20 20 20 20 20 33 20 2d  20 46 75 6c 6c 79 20 72  |     3 - Fully r|
000008d0  69 67 68 74 0a 20 20 20  20 20 20 20 20 20 20 20  |ight.           |
000008e0  20 20 20 20 20 20 20 20  34 20 2d 20 44 6f 6e 27  |        4 - Don'|
000008f0  74 20 61 6c 74 65 72 20  73 74 65 72 65 6f 20 73  |t alter stereo s|
00000900  65 74 74 69 6e 67 73 0a  20 20 20 20 20 20 20 20  |ettings.        |
00000910  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000920  20 20 28 6e 6f 72 6d 61  6c 6c 79 20 61 6c 74 65  |  (normally alte|
00000930  72 73 20 73 65 74 74 69  6e 67 73 20 77 68 65 6e  |rs settings when|
00000940  20 61 20 74 75 6e 65 20  69 73 20 6c 6f 61 64 65  | a tune is loade|
00000950  64 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |d               |
00000960  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000970  61 6e 64 20 77 68 65 6e  20 69 74 20 70 6c 61 79  |and when it play|
00000980  73 20 61 20 74 72 61 63  6b 65 72 20 73 74 65 72  |s a tracker ster|
00000990  65 6f 20 63 6f 6d 6d 61  6e 64 20 2d 20 73 65 65  |eo command - see|
000009a0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000009b0  20 20 20 20 20 20 20 20  20 20 20 20 53 57 49 20  |            SWI |
000009c0  54 72 61 63 6b 65 72 5f  53 74 65 72 65 6f 29 0a  |Tracker_Stereo).|
000009d0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000009e0  53 79 6e 74 61 78 3a 20  2a 50 6c 61 79 53 74 65  |Syntax: *PlaySte|
000009f0  72 65 6f 20 3c 30 7c 31  7c 32 7c 33 3e 0a 0a 0a  |reo <0|1|2|3>...|
00000a00  0a 0a 2a 50 6c 61 79 53  74 6f 70 20 20 20 20 2d  |..*PlayStop    -|
00000a10  20 57 69 6c 6c 20 73 74  6f 70 20 61 6e 64 20 6b  | Will stop and k|
00000a20  69 6c 6c 20 74 68 65 20  63 75 72 72 65 6e 74 6c  |ill the currentl|
00000a30  79 20 70 6c 61 79 69 6e  67 20 74 75 6e 65 20 6d  |y playing tune m|
00000a40  6f 64 75 6c 65 2c 0a 20  20 20 20 20 20 20 20 20  |odule,.         |
00000a50  20 20 20 20 20 20 72 65  6d 6f 76 69 6e 67 20 69  |      removing i|
00000a60  74 20 66 72 6f 6d 20 6d  65 6d 6f 72 79 2e 0a 0a  |t from memory...|
00000a70  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 53  |               S|
00000a80  79 6e 74 61 78 3a 20 2a  50 6c 61 79 53 74 6f 70  |yntax: *PlayStop|
00000a90  0a 0a 0a 0a 0a 0a 0a 0a  0a 53 57 49 20 43 4f 4d  |.........SWI COM|
00000aa0  4d 41 4e 44 53 0a 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |MANDS.----------|
00000ab0  2d 2d 0a 53 65 76 65 72  61 6c 20 53 57 49 20 63  |--.Several SWI c|
00000ac0  6f 6d 6d 61 6e 64 73 20  68 61 76 65 20 62 65 65  |ommands have bee|
00000ad0  6e 20 61 64 64 65 64 20  74 6f 20 74 68 65 20 6d  |n added to the m|
00000ae0  6f 64 75 6c 65 20 69 6e  20 6f 72 64 65 72 20 74  |odule in order t|
00000af0  6f 20 73 69 6d 70 6c 69  66 79 20 74 68 65 0a 74  |o simplify the.t|
00000b00  61 73 6b 20 6f 66 20 61  64 64 69 6e 67 20 73 6f  |ask of adding so|
00000b10  75 6e 64 74 72 61 63 6b  65 72 2f 74 72 61 63 6b  |undtracker/track|
00000b20  65 72 20 6d 75 73 69 63  20 74 6f 20 79 6f 75 72  |er music to your|
00000b30  20 64 65 6d 6f 73 20 65  74 63 2e 20 28 65 73 70  | demos etc. (esp|
00000b40  65 63 69 61 6c 6c 79 0a  6d 75 6c 74 69 2d 74 61  |ecially.multi-ta|
00000b50  73 6b 69 6e 67 20 73 69  74 75 61 74 69 6f 6e 73  |sking situations|
00000b60  29 2e 20 54 68 65 73 65  20 70 72 6f 76 69 64 65  |). These provide|
00000b70  20 61 6c 6c 20 6f 66 20  74 68 65 20 66 61 63 69  | all of the faci|
00000b80  6c 69 74 69 65 73 20 6f  66 66 65 72 65 64 20 62  |lities offered b|
00000b90  79 0a 74 68 65 20 76 61  72 69 6f 75 73 20 2a 20  |y.the various * |
00000ba0  63 6f 6d 6d 61 6e 64 73  2c 20 62 75 74 20 61 6c  |commands, but al|
00000bb0  73 6f 20 61 6c 6c 6f 77  20 61 20 6d 6f 72 65 20  |so allow a more |
00000bc0  64 65 74 61 69 6c 65 64  20 63 6f 6e 74 72 6f 6c  |detailed control|
00000bd0  20 6f 66 20 73 6f 6d 65  20 6f 66 20 74 68 65 0a  | of some of the.|
00000be0  6d 6f 64 75 6c 65 27 73  20 66 65 61 74 75 72 65  |module's feature|
00000bf0  73 2e 0a 41 6c 6c 20 74  68 65 20 53 57 49 27 73  |s..All the SWI's|
00000c00  20 72 65 6d 61 69 6e 20  69 6e 20 53 56 43 20 6d  | remain in SVC m|
00000c10  6f 64 65 2c 20 61 6e 64  20 64 6f 20 6e 6f 74 20  |ode, and do not |
00000c20  61 6c 74 65 72 20 74 68  65 20 69 6e 74 65 72 72  |alter the interr|
00000c30  75 70 74 20 73 74 61 74  75 73 2e 0a 49 20 74 68  |upt status..I th|
00000c40  69 6e 6b 20 6d 6f 73 74  20 61 72 65 20 72 65 2d  |ink most are re-|
00000c50  65 6e 74 72 61 6e 74 2c  20 65 78 63 65 70 74 20  |entrant, except |
00000c60  74 68 6f 73 65 20 77 68  69 63 68 20 75 73 65 20  |those which use |
00000c70  73 79 73 74 65 6d 20 53  57 49 27 73 20 28 6c 6f  |system SWI's (lo|
00000c80  61 64 2c 20 70 6c 61 79  2c 0a 73 74 6f 70 20 65  |ad, play,.stop e|
00000c90  74 63 2e 29 2c 20 73 6f  20 61 76 6f 69 64 20 63  |tc.), so avoid c|
00000ca0  61 6c 6c 69 6e 67 20 74  68 65 6d 20 66 72 6f 6d  |alling them from|
00000cb0  20 69 6e 74 65 72 72 75  70 74 73 20 69 66 20 79  | interrupts if y|
00000cc0  6f 75 20 63 61 6e 20 61  76 6f 69 64 20 69 74 2e  |ou can avoid it.|
00000cd0  0a 0a 54 68 65 20 53 57  49 20 63 68 75 6e 6b 20  |..The SWI chunk |
00000ce0  6e 75 6d 62 65 72 20 67  69 76 65 6e 20 68 65 72  |number given her|
00000cf0  65 20 28 26 34 33 32 30  30 29 20 69 73 20 61 6e  |e (&43200) is an|
00000d00  20 6f 66 66 69 63 69 61  6c 6c 79 20 72 65 63 6f  | officially reco|
00000d10  67 6e 69 73 65 64 20 63  68 75 6e 6b 0a 6e 75 6d  |gnised chunk.num|
00000d20  62 65 72 20 69 73 73 75  65 64 20 62 79 20 41 63  |ber issued by Ac|
00000d30  6f 72 6e 2e 0a 0a 0a 2d  2d 2d 2d 2d 2d 2d 2d 2d  |orn....---------|
00000d40  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000d80  2d 2d 2d 2d 0a 54 72 61  63 6b 65 72 5f 56 65 72  |----.Tracker_Ver|
00000d90  73 69 6f 6e 20 20 20 20  20 20 20 20 28 53 57 49  |sion        (SWI|
00000da0  20 26 34 33 32 30 30 29  0a 2d 2d 2d 2d 2d 2d 2d  | &43200).-------|
00000db0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000df0  2d 2d 2d 2d 2d 2d 0a 0a  4f 6e 20 45 6e 74 72 79  |------..On Entry|
00000e00  3a 20 20 2d 0a 0a 4f 6e  20 45 78 69 74 20 3a 20  |:  -..On Exit : |
00000e10  20 52 30 20 3d 20 76 65  72 73 69 6f 6e 20 6e 75  | R0 = version nu|
00000e20  6d 62 65 72 2a 31 30 30  20 20 28 69 65 2e 20 66  |mber*100  (ie. f|
00000e30  6f 72 20 56 31 2e 32 33  20 3d 20 31 32 33 29 0a  |or V1.23 = 123).|
00000e40  0a 55 73 65 20 74 68 69  73 20 63 61 6c 6c 20 74  |.Use this call t|
00000e50  6f 20 65 6e 73 75 72 65  20 74 68 61 74 20 74 68  |o ensure that th|
00000e60  65 20 74 72 61 63 6b 65  72 6d 6f 64 75 6c 65 20  |e trackermodule |
00000e70  69 6e 73 74 61 6c 6c 65  64 20 69 73 20 61 20 72  |installed is a r|
00000e80  65 63 65 6e 74 20 65 6e  6f 75 67 68 0a 76 65 72  |ecent enough.ver|
00000e90  73 69 6f 6e 20 74 6f 20  73 75 70 70 6f 72 74 20  |sion to support |
00000ea0  74 68 65 20 53 57 49 27  73 20 79 6f 75 20 77 69  |the SWI's you wi|
00000eb0  73 68 20 74 6f 20 75 73  65 2e 20 56 65 72 73 69  |sh to use. Versi|
00000ec0  6f 6e 73 20 34 2e 30 30  20 6f 6e 77 61 72 64 73  |ons 4.00 onwards|
00000ed0  20 69 6e 63 6f 72 70 6f  72 2d 0a 61 74 65 20 74  | incorpor-.ate t|
00000ee0  68 65 20 53 57 49 27 73  2e 0a 0a 0a 0a 0a 2d 2d  |he SWI's......--|
00000ef0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000f30  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 0a 54 72 61 63  |-----------.Trac|
00000f40  6b 65 72 5f 4c 6f 61 64  20 20 20 20 20 20 20 20  |ker_Load        |
00000f50  20 20 20 28 53 57 49 20  26 34 33 32 30 31 29 0a  |   (SWI &43201).|
00000f60  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000fa0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 0a 0a 4f  |-------------..O|
00000fb0  6e 20 45 6e 74 72 79 3a  20 20 52 30 20 3d 20 70  |n Entry:  R0 = p|
00000fc0  6f 69 6e 74 65 72 20 74  6f 20 66 69 6c 65 6e 61  |ointer to filena|
00000fd0  6d 65 20 6f 66 20 73 6f  75 6e 64 74 72 61 63 6b  |me of soundtrack|
00000fe0  65 72 2f 74 72 61 63 6b  65 72 20 6d 6f 64 75 6c  |er/tracker modul|
00000ff0  65 0a 0a 4f 6e 20 45 78  69 74 20 3a 20 20 52 30  |e..On Exit :  R0|
00001000  20 70 72 65 73 65 72 76  65 64 0a 0a 54 68 69 73  | preserved..This|
00001010  20 63 61 6c 6c 20 77 69  6c 6c 20 63 6c 61 69 6d  | call will claim|
00001020  20 6d 65 6d 6f 72 79 20  66 72 6f 6d 20 74 68 65  | memory from the|
00001030  20 52 4d 41 20 61 6e 64  20 6c 6f 61 64 20 74 68  | RMA and load th|
00001040  65 20 73 70 65 63 69 66  69 65 64 20 74 75 6e 65  |e specified tune|
00001050  20 6d 6f 64 75 6c 65 2c  0a 69 6e 69 74 69 61 6c  | module,.initial|
00001060  69 73 65 20 74 68 65 20  73 6f 75 6e 64 20 73 79  |ise the sound sy|
00001070  73 74 65 6d 2c 20 61 6e  64 20 73 65 74 20 74 68  |stem, and set th|
00001080  65 20 70 6c 61 79 72 6f  75 74 69 6e 65 20 69 6e  |e playroutine in|
00001090  20 70 61 75 73 65 20 6d  6f 64 65 2e 0a 59 6f 75  | pause mode..You|
000010a0  20 6d 75 73 74 20 74 68  65 6e 20 75 73 65 20 74  | must then use t|
000010b0  68 65 20 53 57 49 20 54  72 61 63 6b 65 72 5f 50  |he SWI Tracker_P|
000010c0  6c 61 79 20 74 6f 20 73  74 61 72 74 20 74 68 65  |lay to start the|
000010d0  20 74 75 6e 65 20 70 6c  61 79 69 6e 67 2e 0a 54  | tune playing..T|
000010e0  68 65 20 63 6f 6d 6d 61  6e 64 20 2a 50 6c 61 79  |he command *Play|
000010f0  4d 6f 64 20 63 61 6c 6c  73 20 74 68 69 73 20 72  |Mod calls this r|
00001100  6f 75 74 69 6e 65 2c 20  61 6e 64 20 74 68 65 6e  |outine, and then|
00001110  20 74 68 65 20 53 57 49  20 54 72 61 63 6b 65 72  | the SWI Tracker|
00001120  5f 50 6c 61 79 2e 0a 0a  41 6e 20 65 72 72 6f 72  |_Play...An error|
00001130  20 77 69 6c 6c 20 62 65  20 67 65 6e 65 72 61 74  | will be generat|
00001140  65 64 20 69 66 20 74 68  65 20 6d 6f 64 75 6c 65  |ed if the module|
00001150  20 63 61 6e 6e 6f 74 20  62 65 20 6c 6f 61 64 65  | cannot be loade|
00001160  64 20 6f 72 20 6e 6f 74  20 65 6e 6f 75 67 68 0a  |d or not enough.|
00001170  6d 65 6d 6f 72 79 20 63  61 6e 20 62 65 20 63 6c  |memory can be cl|
00001180  61 69 6d 65 64 2e 0a 0a  0a 0a 0a 2d 2d 2d 2d 2d  |aimed......-----|
00001190  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000011d0  2d 2d 2d 2d 2d 2d 2d 2d  0a 54 72 61 63 6b 65 72  |--------.Tracker|
000011e0  5f 4d 65 6d 6f 72 79 4c  6f 61 64 20 20 20 20 20  |_MemoryLoad     |
000011f0  28 53 57 49 20 26 34 33  32 30 32 29 0a 2d 2d 2d  |(SWI &43202).---|
00001200  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00001240  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 0a 0a 4f 6e 20 45  |----------..On E|
00001250  6e 74 72 79 3a 20 20 52  30 20 3d 20 70 6f 69 6e  |ntry:  R0 = poin|
00001260  74 65 72 20 74 6f 20 66  69 72 73 74 20 77 6f 72  |ter to first wor|
00001270  64 20 6f 66 20 73 6f 75  6e 64 74 72 61 63 6b 65  |d of soundtracke|
00001280  72 2f 74 72 61 63 6b 65  72 20 6d 6f 64 75 6c 65  |r/tracker module|
00001290  20 69 6e 0a 20 20 20 20  20 20 20 20 20 20 20 20  | in.            |
000012a0  20 20 20 20 6d 65 6d 6f  72 79 20 28 4e 42 20 6d  |    memory (NB m|
000012b0  75 73 74 20 62 65 20 77  6f 72 64 2d 61 6c 69 67  |ust be word-alig|
000012c0  6e 65 64 29 0a 20 20 20  20 20 20 20 20 20 20 20  |ned).           |
000012d0  52 31 20 3d 20 6c 65 6e  67 74 68 20 6f 66 20 6d  |R1 = length of m|
000012e0  6f 64 75 6c 65 20 69 6e  20 62 79 74 65 73 0a 0a  |odule in bytes..|
000012f0  4f 6e 20 45 78 69 74 20  3a 20 20 52 30 20 61 6e  |On Exit :  R0 an|
00001300  64 20 52 31 20 70 72 65  73 65 72 76 65 64 0a 0a  |d R1 preserved..|
00001310  54 68 69 73 20 63 61 6c  6c 20 63 61 6e 20 62 65  |This call can be|
00001320  20 75 73 65 64 20 62 79  20 61 20 6e 6f 6e 2d 6d  | used by a non-m|
00001330  75 6c 74 69 74 61 73 6b  69 6e 67 20 61 70 70 6c  |ultitasking appl|
00001340  69 63 61 74 69 6f 6e 20  74 6f 20 73 70 65 63 69  |ication to speci|
00001350  66 79 20 61 6e 20 61 72  65 61 0a 6f 66 20 6d 65  |fy an area.of me|
00001360  6d 6f 72 79 20 61 73 20  61 20 74 75 6e 65 20 6d  |mory as a tune m|
00001370  6f 64 75 6c 65 2c 20 61  6e 64 20 74 68 65 72 65  |odule, and there|
00001380  62 79 20 72 65 6d 6f 76  65 20 74 68 65 20 6e 65  |by remove the ne|
00001390  65 64 20 66 6f 72 20 61  20 73 65 70 65 72 61 74  |ed for a seperat|
000013a0  65 20 66 69 6c 65 0a 74  6f 20 68 6f 6c 64 20 61  |e file.to hold a|
000013b0  20 74 75 6e 65 2c 20 61  6e 64 20 74 68 65 72 65  | tune, and there|
000013c0  20 69 73 20 6e 6f 20 6e  65 65 64 20 74 6f 20 63  | is no need to c|
000013d0  6c 61 69 6d 20 61 20 6c  61 72 67 65 20 61 6d 6f  |laim a large amo|
000013e0  75 6e 74 20 6f 66 20 52  4d 41 20 73 70 61 63 65  |unt of RMA space|
000013f0  2e 0a 4f 6e 63 65 20 74  68 69 73 20 53 57 49 20  |..Once this SWI |
00001400  69 73 20 63 61 6c 6c 65  64 2c 20 74 68 65 20 6d  |is called, the m|
00001410  6f 64 75 6c 65 20 77 69  6c 6c 20 62 65 20 74 72  |odule will be tr|
00001420  65 61 74 65 64 20 61 73  20 69 66 20 69 74 20 77  |eated as if it w|
00001430  61 73 20 6c 6f 61 64 65  64 20 69 6e 0a 74 68 65  |as loaded in.the|
00001440  20 6d 6f 64 75 6c 65 27  73 20 6f 77 6e 20 77 6f  | module's own wo|
00001450  72 6b 73 70 61 63 65 2e  0a 20 49 6d 70 6f 72 74  |rkspace.. Import|
00001460  61 6e 74 3a 20 59 6f 75  20 6d 75 73 74 20 74 65  |ant: You must te|
00001470  6c 6c 20 74 68 65 20 74  72 61 63 6b 65 72 6d 6f  |ll the trackermo|
00001480  64 75 6c 65 20 74 6f 20  66 6f 72 67 65 74 20 74  |dule to forget t|
00001490  68 65 20 6d 6f 64 75 6c  65 20 69 66 20 74 68 65  |he module if the|
000014a0  0a 6d 65 6d 6f 72 79 20  77 69 6c 6c 20 62 65 20  |.memory will be |
000014b0  6f 76 65 72 77 72 69 74  74 65 6e 2c 20 6f 74 68  |overwritten, oth|
000014c0  65 72 77 69 73 65 20 74  68 65 20 6d 6f 64 75 6c  |erwise the modul|
000014d0  65 20 6d 61 79 20 63 72  61 73 68 2e 0a 28 2a 50  |e may crash..(*P|
000014e0  6c 61 79 53 74 6f 70 20  6f 72 20 54 72 61 63 6b  |layStop or Track|
000014f0  65 72 5f 53 74 6f 70 20  53 57 49 29 0a 0a 4e 42  |er_Stop SWI)..NB|
00001500  20 54 68 69 73 20 63 61  6c 6c 20 77 69 6c 6c 20  | This call will |
00001510  6e 6f 74 20 77 6f 72 6b  20 66 6f 72 20 70 72 6f  |not work for pro|
00001520  67 72 61 6d 73 20 72 75  6e 6e 69 6e 67 20 75 6e  |grams running un|
00001530  64 65 72 20 74 68 65 20  64 65 73 6b 74 6f 70 20  |der the desktop |
00001540  69 66 20 74 68 65 0a 20  20 20 6d 6f 64 75 6c 65  |if the.   module|
00001550  20 69 73 20 6c 6f 61 64  65 64 20 69 6e 20 75 73  | is loaded in us|
00001560  65 72 20 6d 65 6d 6f 72  79 2e 0a 0a 20 20 20 57  |er memory...   W|
00001570  68 65 6e 20 61 20 73 6f  75 6e 64 74 72 61 63 6b  |hen a soundtrack|
00001580  65 72 20 6d 6f 64 75 6c  65 20 69 73 20 6c 6f 61  |er module is loa|
00001590  64 65 64 2c 20 69 74 20  69 73 20 70 61 72 74 69  |ded, it is parti|
000015a0  61 6c 6c 79 20 63 6f 6e  76 65 72 74 65 64 20 74  |ally converted t|
000015b0  6f 20 61 6e 0a 20 20 20  69 6e 74 65 72 6d 65 64  |o an.   intermed|
000015c0  69 61 74 65 20 66 6f 72  6d 61 74 20 62 65 74 77  |iate format betw|
000015d0  65 65 6e 20 73 6f 75 6e  64 74 72 61 63 6b 65 72  |een soundtracker|
000015e0  20 61 6e 64 20 74 72 61  63 6b 65 72 20 74 6f 20  | and tracker to |
000015f0  73 69 6d 70 6c 69 66 79  20 74 68 65 20 74 61 73  |simplify the tas|
00001600  6b 0a 20 20 20 66 6f 72  20 74 68 65 20 70 6c 61  |k.   for the pla|
00001610  79 72 6f 75 74 69 6e 65  2e 20 4f 6e 63 65 20 74  |yroutine. Once t|
00001620  68 65 20 6d 6f 64 75 6c  65 20 69 73 20 6c 6f 61  |he module is loa|
00001630  64 65 64 20 28 62 79 20  61 6e 79 20 6d 65 74 68  |ded (by any meth|
00001640  6f 64 29 20 69 74 20 69  73 0a 20 20 20 70 65 72  |od) it is.   per|
00001650  6d 61 6e 65 6e 74 6c 79  20 63 6f 72 72 75 70 74  |manently corrupt|
00001660  65 64 2c 20 61 6e 64 20  73 68 6f 75 6c 64 20 6e  |ed, and should n|
00001670  6f 74 20 62 65 20 72 65  2d 73 61 76 65 64 2e 20  |ot be re-saved. |
00001680  54 72 61 63 6b 65 72 20  6d 6f 64 75 6c 65 73 20  |Tracker modules |
00001690  77 69 6c 6c 20 62 65 0a  20 20 20 75 6e 63 68 61  |will be.   uncha|
000016a0  6e 67 65 64 2c 20 68 6f  77 65 76 65 72 2c 20 61  |nged, however, a|
000016b0  6e 64 20 73 6f 75 6e 64  74 72 61 63 6b 65 72 20  |nd soundtracker |
000016c0  6d 6f 64 75 6c 65 73 20  73 68 6f 75 6c 64 20 62  |modules should b|
000016d0  65 20 63 6f 6e 76 65 72  74 65 64 20 66 75 6c 6c  |e converted full|
000016e0  79 0a 20 20 20 69 6e 74  6f 20 74 68 69 73 20 66  |y.   into this f|
000016f0  6f 72 6d 61 74 20 62 65  66 6f 72 65 20 62 65 69  |ormat before bei|
00001700  6e 67 20 6c 6f 61 64 65  64 20 74 6f 20 61 76 6f  |ng loaded to avo|
00001710  69 64 20 74 68 69 73 20  70 72 6f 62 6c 65 6d 2e  |id this problem.|
00001720  0a 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |..              |
00001730  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00001760  0a 0a 0a 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |...-------------|
00001770  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000017b0  0a 54 72 61 63 6b 65 72  5f 50 6c 61 79 20 20 20  |.Tracker_Play   |
000017c0  20 20 20 20 20 20 20 20  28 53 57 49 20 26 34 33  |        (SWI &43|
000017d0  32 30 33 29 0a 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |203).-----------|
000017e0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00001820  2d 2d 0a 0a 4f 6e 20 45  6e 74 72 79 3a 20 20 2d  |--..On Entry:  -|
00001830  0a 0a 4f 6e 20 45 78 69  74 20 3a 20 20 2d 0a 0a  |..On Exit :  -..|
00001840  54 68 69 73 20 63 61 6c  6c 20 77 69 6c 6c 20 72  |This call will r|
00001850  65 73 74 61 72 74 20 61  20 74 75 6e 65 20 61 66  |estart a tune af|
00001860  74 65 72 20 69 74 20 68  61 73 20 62 65 65 6e 20  |ter it has been |
00001870  70 61 75 73 65 64 20 6f  72 20 6c 6f 61 64 65 64  |paused or loaded|
00001880  20 77 69 74 68 20 74 68  65 0a 54 72 61 63 6b 65  | with the.Tracke|
00001890  72 5f 4c 6f 61 64 20 53  57 49 2e 0a 0a 0a 0a 0a  |r_Load SWI......|
000018a0  0a 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
000018b0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000018e0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 0a 54  |--------------.T|
000018f0  72 61 63 6b 65 72 5f 53  74 6f 70 20 20 20 20 20  |racker_Stop     |
00001900  20 20 20 20 20 20 28 53  57 49 20 26 34 33 32 30  |      (SWI &4320|
00001910  34 29 0a 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |4).-------------|
00001920  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00001960  0a 0a 4f 6e 20 45 6e 74  72 79 3a 20 20 2d 0a 0a  |..On Entry:  -..|
00001970  4f 6e 20 45 78 69 74 20  3a 20 20 2d 0a 0a 54 68  |On Exit :  -..Th|
00001980  69 73 20 70 65 72 66 6f  72 6d 73 20 74 68 65 20  |is performs the |
00001990  73 61 6d 65 20 61 63 74  69 6f 6e 73 20 61 73 20  |same actions as |
000019a0  2a 50 6c 61 79 53 74 6f  70 0a 55 73 69 6e 67 20  |*PlayStop.Using |
000019b0  2a 50 6c 61 79 53 74 6f  70 20 6f 72 20 74 68 69  |*PlayStop or thi|
000019c0  73 20 53 57 49 20 69 73  20 74 68 65 20 6f 6e 6c  |s SWI is the onl|
000019d0  79 20 77 61 79 20 74 6f  20 67 65 74 20 74 68 65  |y way to get the|
000019e0  20 74 72 61 63 6b 65 72  6d 6f 64 75 6c 65 20 74  | trackermodule t|
000019f0  6f 0a 72 65 6c 65 61 73  65 20 74 68 65 20 6d 65  |o.release the me|
00001a00  6d 6f 72 79 20 74 61 6b  65 6e 20 75 70 20 62 79  |mory taken up by|
00001a10  20 74 68 65 20 74 75 6e  65 20 6d 6f 64 75 6c 65  | the tune module|
00001a20  2c 20 6f 72 20 74 6f 20  66 6f 72 63 65 20 69 74  |, or to force it|
00001a30  20 74 6f 20 66 6f 72 67  65 74 20 74 68 65 0a 61  | to forget the.a|
00001a40  64 64 72 65 73 73 20 6f  66 20 61 20 6d 6f 64 75  |ddress of a modu|
00001a50  6c 65 20 69 66 20 69 74  20 68 61 73 20 62 65 65  |le if it has bee|
00001a60  6e 20 6c 6f 61 64 65 64  20 77 69 74 68 20 74 68  |n loaded with th|
00001a70  65 20 27 54 72 61 63 6b  65 72 5f 4d 65 6d 6f 72  |e 'Tracker_Memor|
00001a80  79 4c 6f 61 64 27 20 53  57 49 2e 0a 0a 0a 0a 0a  |yLoad' SWI......|
00001a90  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00001ad0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 0a 54 72  |-------------.Tr|
00001ae0  61 63 6b 65 72 5f 50 61  75 73 65 20 20 20 20 20  |acker_Pause     |
00001af0  20 20 20 20 20 28 53 57  49 20 26 34 33 32 30 35  |     (SWI &43205|
00001b00  29 0a 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |).--------------|
00001b10  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00001b40  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 0a  |---------------.|
00001b50  0a 4f 6e 20 45 6e 74 72  79 3a 20 20 2d 0a 0a 4f  |.On Entry:  -..O|
00001b60  6e 20 45 78 69 74 20 3a  20 20 2d 0a 0a 54 68 69  |n Exit :  -..Thi|
00001b70  73 20 70 65 72 66 6f 72  6d 73 20 74 68 65 20 73  |s performs the s|
00001b80  61 6d 65 20 61 63 74 69  6f 6e 73 20 61 73 20 2a  |ame actions as *|
00001b90  50 6c 61 79 50 61 75 73  65 0a 0a 0a 0a 0a 0a 2d  |PlayPause......-|
00001ba0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00001be0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 0a 54 72 61  |------------.Tra|
00001bf0  63 6b 65 72 5f 53 74 65  72 65 6f 20 20 20 20 20  |cker_Stereo     |
00001c00  20 20 20 20 28 53 57 49  20 26 34 33 32 30 36 29  |    (SWI &43206)|
00001c10  0a 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
00001c20  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00001c50  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 0a 0a  |--------------..|
00001c60  4f 6e 20 45 6e 74 72 79  3a 20 20 52 30 20 3d 20  |On Entry:  R0 = |
00001c70  53 74 65 72 65 6f 20 73  65 74 74 69 6e 67 20 28  |Stereo setting (|
00001c80  30 2d 34 29 0a 0a 4f 6e  20 45 78 69 74 20 3a 20  |0-4)..On Exit : |
00001c90  20 52 30 20 70 72 65 73  65 72 76 65 64 0a 0a 54  | R0 preserved..T|
00001ca0  68 69 73 20 70 65 72 66  6f 72 6d 73 20 74 68 65  |his performs the|
00001cb0  20 73 61 6d 65 20 61 63  74 69 6f 6e 73 20 61 73  | same actions as|
00001cc0  20 2a 50 6c 61 79 53 74  65 72 65 6f 2c 20 77 69  | *PlayStereo, wi|
00001cd0  74 68 20 52 30 20 70 61  73 73 65 64 20 61 73 20  |th R0 passed as |
00001ce0  61 20 70 61 72 61 6d 65  74 65 72 2e 0a 49 66 20  |a parameter..If |
00001cf0  52 30 20 69 73 20 73 65  74 20 74 6f 20 34 20 6f  |R0 is set to 4 o|
00001d00  6e 20 65 6e 74 72 79 2c  20 74 68 65 6e 20 74 68  |n entry, then th|
00001d10  65 20 73 74 65 72 65 6f  20 73 65 74 74 69 6e 67  |e stereo setting|
00001d20  73 20 77 69 6c 6c 20 62  65 20 75 6e 61 6c 74 65  |s will be unalte|
00001d30  72 65 64 0a 77 68 65 6e  65 76 65 72 20 61 20 6d  |red.whenever a m|
00001d40  6f 64 75 6c 65 20 69 73  20 6c 6f 61 64 65 64 20  |odule is loaded |
00001d50  6f 72 20 6b 69 6c 6c 65  64 2c 20 61 6e 64 20 64  |or killed, and d|
00001d60  69 73 61 62 6c 65 73 20  61 6e 79 20 73 74 65 72  |isables any ster|
00001d70  65 6f 20 63 6f 6d 6d 61  6e 64 73 20 69 6e 0a 74  |eo commands in.t|
00001d80  72 61 63 6b 65 72 20 6d  6f 64 75 6c 65 73 2e 20  |racker modules. |
00001d90  54 68 69 73 20 69 73 20  74 6f 20 61 6c 6c 6f 77  |This is to allow|
00001da0  20 69 6e 74 65 72 66 61  63 69 6e 67 20 70 72 6f  | interfacing pro|
00001db0  67 72 61 6d 73 20 74 6f  20 70 72 6f 76 69 64 65  |grams to provide|
00001dc0  20 74 68 65 69 72 20 6f  77 6e 0a 73 74 65 72 65  | their own.stere|
00001dd0  6f 20 6f 70 74 69 6f 6e  73 2c 20 6f 72 20 74 6f  |o options, or to|
00001de0  20 61 6c 6c 6f 77 20 61  64 6a 75 73 74 6d 65 6e  | allow adjustmen|
00001df0  74 20 74 6f 20 74 68 65  20 73 74 65 72 65 6f 20  |t to the stereo |
00001e00  70 6f 73 69 74 69 6f 6e  73 20 77 68 69 6c 65 20  |positions while |
00001e10  74 72 61 63 6b 65 72 0a  74 75 6e 65 73 20 61 72  |tracker.tunes ar|
00001e20  65 20 70 6c 61 79 69 6e  67 20 28 77 68 69 63 68  |e playing (which|
00001e30  20 68 61 76 65 20 64 65  66 61 75 6c 74 20 73 74  | have default st|
00001e40  65 72 65 6f 20 73 65 74  74 69 6e 67 73 20 73 74  |ereo settings st|
00001e50  6f 72 65 64 20 61 73 20  70 61 72 74 20 6f 66 20  |ored as part of |
00001e60  74 68 65 0a 74 75 6e 65  29 2e 0a 0a 0a 0a 0a 2d  |the.tune)......-|
00001e70  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00001eb0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 0a 54 72 61  |------------.Tra|
00001ec0  63 6b 65 72 5f 53 65 74  50 6f 73 20 20 20 20 20  |cker_SetPos     |
00001ed0  20 20 20 20 28 53 57 49  20 26 34 33 32 30 37 29  |    (SWI &43207)|
00001ee0  0a 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
00001ef0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00001f20  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 0a 0a  |--------------..|
00001f30  4f 6e 20 45 6e 74 72 79  3a 20 20 52 30 20 3d 20  |On Entry:  R0 = |
00001f40  4e 65 77 20 73 65 71 75  65 6e 63 65 20 70 6f 73  |New sequence pos|
00001f50  69 74 69 6f 6e 20 28 30  2d 31 32 37 20 6d 61 78  |ition (0-127 max|
00001f60  29 0a 20 20 20 20 20 20  20 20 20 20 20 52 31 20  |).           R1 |
00001f70  3d 20 45 76 65 6e 74 20  28 30 2d 36 33 20 6d 61  |= Event (0-63 ma|
00001f80  78 29 0a 0a 4f 6e 20 45  78 69 74 20 3a 20 20 52  |x)..On Exit :  R|
00001f90  30 20 70 72 65 73 65 72  76 65 64 0a 0a 54 68 69  |0 preserved..Thi|
00001fa0  73 20 70 65 72 66 6f 72  6d 73 20 74 68 65 20 73  |s performs the s|
00001fb0  61 6d 65 20 61 63 74 69  6f 6e 73 20 61 73 20 2a  |ame actions as *|
00001fc0  50 6c 61 79 50 6f 73 2c  20 65 78 63 65 70 74 20  |PlayPos, except |
00001fd0  74 68 61 74 20 74 68 65  20 65 76 65 6e 74 20 77  |that the event w|
00001fe0  69 74 68 20 74 68 65 0a  70 61 74 74 65 72 6e 20  |ith the.pattern |
00001ff0  63 61 6e 20 62 65 20 73  70 65 63 69 66 69 65 64  |can be specified|
00002000  20 28 30 2d 36 33 20 6e  6f 72 6d 61 6c 6c 79 29  | (0-63 normally)|
00002010  2e 20 49 66 20 61 6e 20  65 76 65 6e 74 20 6e 75  |. If an event nu|
00002020  6d 62 65 72 20 68 69 67  68 65 72 20 74 68 61 6e  |mber higher than|
00002030  20 74 68 65 0a 6e 75 6d  62 65 72 20 6f 66 20 65  | the.number of e|
00002040  76 65 6e 74 73 20 69 6e  20 74 68 65 20 63 75 72  |vents in the cur|
00002050  72 65 6e 74 20 70 61 74  74 65 72 6e 20 69 73 20  |rent pattern is |
00002060  73 70 65 63 69 66 69 65  64 2c 20 74 68 65 20 70  |specified, the p|
00002070  61 74 74 65 72 6e 20 77  69 6c 6c 20 62 65 67 69  |attern will begi|
00002080  6e 0a 61 74 20 65 76 65  6e 74 20 30 2e 0a 0a 49  |n.at event 0...I|
00002090  66 20 74 68 65 72 65 20  69 73 20 6e 6f 20 74 75  |f there is no tu|
000020a0  6e 65 20 63 75 72 72 65  6e 74 6c 79 20 6c 6f 61  |ne currently loa|
000020b0  64 65 64 2c 20 61 6e 20  65 72 72 6f 72 20 69 73  |ded, an error is|
000020c0  20 67 65 6e 65 72 61 74  65 64 2e 0a 0a 0a 0a 0a  | generated......|
000020d0  0a 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
000020e0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00002110  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 0a 54  |--------------.T|
00002120  72 61 63 6b 65 72 5f 52  65 61 64 50 6f 73 20 20  |racker_ReadPos  |
00002130  20 20 20 20 20 20 28 53  57 49 20 26 34 33 32 30  |      (SWI &4320|
00002140  38 29 0a 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |8).-------------|
00002150  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00002190  0a 0a 4f 6e 20 45 6e 74  72 79 3a 20 20 2d 0a 0a  |..On Entry:  -..|
000021a0  4f 6e 20 45 78 69 74 20  3a 20 20 52 30 20 3d 20  |On Exit :  R0 = |
000021b0  43 75 72 72 65 6e 74 20  70 6f 73 69 74 69 6f 6e  |Current position|
000021c0  20 69 6e 20 73 65 71 75  65 6e 63 65 20 74 61 62  | in sequence tab|
000021d0  6c 65 20 28 30 2d 31 32  37 20 6d 61 78 29 0a 20  |le (0-127 max). |
000021e0  20 20 20 20 20 20 20 20  20 20 52 31 20 3d 20 43  |          R1 = C|
000021f0  75 72 72 65 6e 74 20 70  6f 73 69 74 69 6f 6e 20  |urrent position |
00002200  69 6e 20 70 61 74 74 65  72 6e 20 28 30 2d 36 33  |in pattern (0-63|
00002210  20 6d 61 78 29 0a 20 20  20 20 20 20 20 20 20 20  | max).          |
00002220  20 52 32 20 3d 20 4d 61  78 69 6d 75 6d 20 70 6f  | R2 = Maximum po|
00002230  73 69 74 69 6f 6e 20 69  6e 20 73 65 71 75 65 6e  |sition in sequen|
00002240  63 65 20 74 61 62 6c 65  0a 0a 54 68 69 73 20 70  |ce table..This p|
00002250  65 72 66 6f 72 6d 73 20  74 68 65 20 73 61 6d 65  |erforms the same|
00002260  20 61 63 74 69 6f 6e 73  20 61 73 20 2a 50 6c 61  | actions as *Pla|
00002270  79 50 6f 73 20 77 69 74  68 20 6e 6f 20 70 61 72  |yPos with no par|
00002280  61 6d 65 74 65 72 73 2c  20 62 75 74 20 61 6c 73  |ameters, but als|
00002290  6f 0a 72 65 74 75 72 6e  73 20 74 68 65 20 63 75  |o.returns the cu|
000022a0  72 72 65 6e 74 20 70 6f  73 69 74 69 6f 6e 20 69  |rrent position i|
000022b0  6e 20 74 68 65 20 63 75  72 72 65 6e 74 20 70 61  |n the current pa|
000022c0  74 74 65 72 6e 20 28 69  6e 20 63 61 73 65 20 73  |ttern (in case s|
000022d0  6f 6d 65 20 61 70 70 6c  69 63 2d 0a 61 74 69 6f  |ome applic-.atio|
000022e0  6e 73 20 6e 65 65 64 20  74 6f 20 73 79 6e 63 68  |ns need to synch|
000022f0  72 6f 6e 69 7a 65 20 65  76 65 6e 74 73 20 77 69  |ronize events wi|
00002300  74 68 20 74 68 65 20 74  75 6e 65 20 62 65 69 6e  |th the tune bein|
00002310  67 20 70 6c 61 79 65 64  29 2e 0a 0a 0a 0a 0a 0a  |g played).......|
00002320  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00002360  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 0a 54 72  |-------------.Tr|
00002370  61 63 6b 65 72 5f 50 6c  61 79 4e 6f 74 65 20 20  |acker_PlayNote  |
00002380  20 20 20 20 20 28 53 57  49 20 26 34 33 32 30 39  |     (SWI &43209|
00002390  29 0a 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |).--------------|
000023a0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000023d0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 0a  |---------------.|
000023e0  0a 4f 6e 20 45 6e 74 72  79 3a 20 20 52 30 20 3d  |.On Entry:  R0 =|
000023f0  20 53 6f 75 6e 64 20 63  68 61 6e 6e 65 6c 20 74  | Sound channel t|
00002400  6f 20 73 6f 75 6e 64 20  6e 6f 74 65 20 6f 6e 20  |o sound note on |
00002410  28 31 2d 38 20 6d 61 78  29 0a 20 20 20 20 20 20  |(1-8 max).      |
00002420  20 20 20 20 20 52 31 20  3d 20 54 72 61 63 6b 65  |     R1 = Tracke|
00002430  72 20 66 6f 72 6d 61 74  20 6e 6f 74 65 20 6e 75  |r format note nu|
00002440  6d 62 65 72 20 28 31 2d  33 36 29 0a 20 20 20 20  |mber (1-36).    |
00002450  20 20 20 20 20 20 20 52  32 20 3d 20 53 61 6d 70  |       R2 = Samp|
00002460  6c 65 20 74 6f 20 70 6c  61 79 20 28 31 2d 33 36  |le to play (1-36|
00002470  29 0a 20 20 20 20 20 20  20 20 20 20 20 52 33 20  |).           R3 |
00002480  3d 20 56 6f 6c 75 6d 65  20 28 30 2d 32 35 35 29  |= Volume (0-255)|
00002490  0a 0a 4f 6e 20 45 78 69  74 20 3a 20 20 52 30 2d  |..On Exit :  R0-|
000024a0  52 33 20 70 72 65 73 65  72 76 65 64 0a 20 20 20  |R3 preserved.   |
000024b0  20 20 20 20 20 20 20 20  49 66 20 74 75 6e 65 20  |        If tune |
000024c0  6e 6f 74 20 70 61 75 73  65 64 20 74 68 65 6e 20  |not paused then |
000024d0  43 20 66 6c 61 67 20 73  65 74 20 6f 74 68 65 72  |C flag set other|
000024e0  77 69 73 65 20 43 20 66  6c 61 67 20 63 6c 65 61  |wise C flag clea|
000024f0  72 65 64 2e 0a 0a 49 66  20 74 68 65 72 65 20 69  |red...If there i|
00002500  73 20 6e 6f 20 74 75 6e  65 20 6c 6f 61 64 65 64  |s no tune loaded|
00002510  2c 20 61 6e 20 65 72 72  6f 72 20 77 69 6c 6c 20  |, an error will |
00002520  62 65 20 67 65 6e 65 72  61 74 65 64 2e 0a 0a 49  |be generated...I|
00002530  74 20 70 6c 61 79 73 20  6f 6e 65 20 6f 66 20 74  |t plays one of t|
00002540  68 65 20 73 61 6d 70 6c  65 73 20 77 68 69 63 68  |he samples which|
00002550  20 61 72 65 20 70 61 72  74 20 6f 66 20 74 68 65  | are part of the|
00002560  20 70 61 75 73 65 64 20  74 75 6e 65 20 61 74 20  | paused tune at |
00002570  61 20 67 69 76 65 6e 0a  70 69 74 63 68 20 28 31  |a given.pitch (1|
00002580  3d 6c 6f 77 2c 20 33 36  3d 68 69 67 68 29 20 61  |=low, 36=high) a|
00002590  6e 64 20 76 6f 6c 75 6d  65 20 28 30 3d 73 69 6c  |nd volume (0=sil|
000025a0  65 6e 74 2c 20 32 35 35  3d 6c 6f 75 64 29 2e 20  |ent, 255=loud). |
000025b0  49 66 20 61 6e 79 20 6f  66 20 74 68 65 20 76 61  |If any of the va|
000025c0  6c 75 65 73 0a 61 72 65  20 6f 75 74 20 6f 66 20  |lues.are out of |
000025d0  72 61 6e 67 65 2c 20 61  6e 20 65 72 72 6f 72 20  |range, an error |
000025e0  77 69 6c 6c 20 62 65 20  72 65 70 6f 72 74 65 64  |will be reported|
000025f0  2e 0a 54 68 65 20 6e 75  6d 62 65 72 20 6f 66 20  |..The number of |
00002600  73 6f 75 6e 64 20 63 68  61 6e 6e 65 6c 73 20 74  |sound channels t|
00002610  68 61 74 20 63 61 6e 20  62 65 20 75 73 65 64 20  |hat can be used |
00002620  64 65 70 65 6e 64 73 20  6f 6e 20 74 68 65 20 6d  |depends on the m|
00002630  6f 64 75 6c 65 20 6c 6f  61 64 65 64 0a 28 73 6f  |odule loaded.(so|
00002640  75 6e 64 74 72 61 63 6b  65 72 20 6d 6f 64 75 6c  |undtracker modul|
00002650  65 73 20 77 69 6c 6c 20  61 6c 77 61 79 73 20 75  |es will always u|
00002660  73 65 20 34 20 76 6f 69  63 65 73 2c 20 77 68 65  |se 4 voices, whe|
00002670  72 65 61 73 20 54 72 61  63 6b 65 72 20 6d 6f 64  |reas Tracker mod|
00002680  75 6c 65 73 20 63 61 6e  0a 75 73 65 20 75 70 20  |ules can.use up |
00002690  74 6f 20 38 29 2e 0a 55  73 65 20 74 68 65 20 54  |to 8)..Use the T|
000026a0  72 61 63 6b 65 72 5f 54  75 6e 65 49 6e 66 6f 20  |racker_TuneInfo |
000026b0  53 57 49 20 74 6f 20 66  69 6e 64 20 6f 75 74 20  |SWI to find out |
000026c0  74 68 65 20 6d 61 78 69  6d 75 6d 20 6e 75 6d 62  |the maximum numb|
000026d0  65 72 20 6f 66 20 76 6f  69 63 65 73 20 69 66 20  |er of voices if |
000026e0  79 6f 75 0a 69 6e 74 65  6e 64 20 74 6f 20 70 6c  |you.intend to pl|
000026f0  61 79 20 6d 6f 72 65 20  74 68 61 6e 20 6f 6e 65  |ay more than one|
00002700  20 6e 6f 74 65 20 61 74  20 61 20 74 69 6d 65 2e  | note at a time.|
00002710  0a 4e 42 20 54 68 69 73  20 63 61 6c 6c 20 73 68  |.NB This call sh|
00002720  6f 75 6c 64 20 62 65 20  61 76 6f 69 64 65 64 20  |ould be avoided |
00002730  69 66 20 70 6f 73 73 69  62 6c 65 2c 20 75 6e 6c  |if possible, unl|
00002740  65 73 73 20 74 68 65 20  70 75 72 70 6f 73 65 20  |ess the purpose |
00002750  69 73 20 74 6f 20 68 65  61 72 0a 20 20 20 65 61  |is to hear.   ea|
00002760  63 68 20 73 61 6d 70 6c  65 20 73 65 70 65 72 61  |ch sample sepera|
00002770  74 65 6c 79 2e 0a 0a 0a  0a 0a 0a 2d 2d 2d 2d 2d  |tely.......-----|
00002780  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000027c0  2d 2d 2d 2d 2d 2d 2d 2d  0a 54 72 61 63 6b 65 72  |--------.Tracker|
000027d0  5f 54 75 6e 65 49 6e 66  6f 20 20 20 20 20 20 20  |_TuneInfo       |
000027e0  28 53 57 49 20 26 34 33  32 30 41 29 0a 2d 2d 2d  |(SWI &4320A).---|
000027f0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00002830  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 0a 0a 4f 6e 20 45  |----------..On E|
00002840  6e 74 72 79 3a 20 20 2d  0a 0a 4f 6e 20 45 78 69  |ntry:  -..On Exi|
00002850  74 20 3a 20 20 52 30 20  3d 20 53 65 71 75 65 6e  |t :  R0 = Sequen|
00002860  63 65 20 74 61 62 6c 65  20 6c 65 6e 67 74 68 20  |ce table length |
00002870  28 31 2d 31 32 38 29 0a  20 20 20 20 20 20 20 20  |(1-128).        |
00002880  20 20 20 52 31 20 3d 20  4e 75 6d 62 65 72 20 6f  |   R1 = Number o|
00002890  66 20 76 6f 69 63 65 73  20 28 31 2d 38 29 0a 20  |f voices (1-8). |
000028a0  20 20 20 20 20 20 20 20  20 20 52 32 20 3d 20 43  |          R2 = C|
000028b0  75 72 72 65 6e 74 20 73  70 65 65 64 20 28 31 2d  |urrent speed (1-|
000028c0  31 35 29 0a 20 20 20 20  20 20 20 20 20 20 20 52  |15).           R|
000028d0  33 20 3d 20 50 6f 69 6e  74 65 72 20 74 6f 20 74  |3 = Pointer to t|
000028e0  75 6e 65 20 6e 61 6d 65  20 28 74 65 72 6d 69 6e  |une name (termin|
000028f0  61 74 65 64 20 62 79 20  30 2c 20 6d 61 78 20 6c  |ated by 0, max l|
00002900  65 6e 67 74 68 20 33 32  20 63 68 61 72 73 29 0a  |ength 32 chars).|
00002910  20 20 20 20 20 20 20 20  20 20 20 52 34 20 3d 20  |           R4 = |
00002920  50 6f 69 6e 74 65 72 20  74 6f 20 61 75 74 68 6f  |Pointer to autho|
00002930  72 27 73 20 6e 61 6d 65  20 28 30 20 74 65 72 6d  |r's name (0 term|
00002940  69 6e 61 74 65 64 2c 20  6d 61 78 20 6c 65 6e 67  |inated, max leng|
00002950  74 68 20 33 32 20 63 68  61 72 73 29 0a 20 20 20  |th 32 chars).   |
00002960  20 20 20 20 20 20 20 20  20 20 20 20 20 6f 72 20  |             or |
00002970  7a 65 72 6f 20 69 66 20  73 6f 75 6e 64 74 72 61  |zero if soundtra|
00002980  63 6b 65 72 20 66 6f 72  6d 61 74 20 6d 6f 64 75  |cker format modu|
00002990  6c 65 20 28 6e 6f 74 20  61 70 70 6c 69 63 61 62  |le (not applicab|
000029a0  6c 65 29 0a 20 20 20 20  20 20 20 20 20 20 20 52  |le).           R|
000029b0  35 20 3d 20 41 64 64 72  65 73 73 20 6f 66 20 63  |5 = Address of c|
000029c0  75 72 72 65 6e 74 6c 79  20 6c 6f 61 64 65 64 20  |urrently loaded |
000029d0  74 75 6e 65 20 6d 6f 64  75 6c 65 0a 0a 20 20 20  |tune module..   |
000029e0  20 20 20 20 20 20 20 20  49 66 20 74 68 65 20 74  |        If the t|
000029f0  75 6e 65 20 69 73 20 70  61 75 73 65 64 2c 20 74  |une is paused, t|
00002a00  68 65 20 43 20 66 6c 61  67 20 69 73 20 73 65 74  |he C flag is set|
00002a10  2c 20 6f 74 68 65 72 77  69 73 65 20 74 68 65 20  |, otherwise the |
00002a20  43 20 66 6c 61 67 20 69  73 0a 20 20 20 20 20 20  |C flag is.      |
00002a30  20 20 20 20 20 63 6c 65  61 72 65 64 2e 0a 0a 20  |     cleared... |
00002a40  20 20 20 20 20 20 20 20  20 20 49 66 20 74 68 65  |          If the|
00002a50  72 65 20 69 73 20 6e 6f  20 74 75 6e 65 20 6c 6f  |re is no tune lo|
00002a60  61 64 65 64 2c 20 52 30  20 69 73 20 73 65 74 20  |aded, R0 is set |
00002a70  74 6f 20 7a 65 72 6f 2c  20 61 6e 64 20 52 31 2d  |to zero, and R1-|
00002a80  52 35 20 61 72 65 0a 20  20 20 20 20 20 20 20 20  |R5 are.         |
00002a90  20 20 70 72 65 73 65 72  76 65 64 2e 0a 20 20 20  |  preserved..   |
00002aa0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00002ae0  0a 0a 54 68 69 73 20 63  61 6c 6c 20 70 72 6f 76  |..This call prov|
00002af0  69 64 65 73 20 6d 69 73  63 65 6c 6c 61 6e 65 6f  |ides miscellaneo|
00002b00  75 73 20 69 6e 66 6f 72  6d 61 74 69 6f 6e 20 61  |us information a|
00002b10  62 6f 75 74 20 74 68 65  20 74 75 6e 65 20 63 75  |bout the tune cu|
00002b20  72 72 65 6e 74 6c 79 20  6c 6f 61 64 65 64 2e 0a  |rrently loaded..|
00002b30  0a 59 6f 75 20 73 68 6f  75 6c 64 20 6e 6f 74 20  |.You should not |
00002b40  6e 65 65 64 20 74 6f 20  64 69 72 65 63 74 6c 79  |need to directly|
00002b50  20 61 63 63 65 73 73 20  74 68 65 20 74 75 6e 65  | access the tune|
00002b60  20 6d 6f 64 75 6c 65 20  28 75 73 69 6e 67 20 74  | module (using t|
00002b70  68 65 20 61 64 64 72 65  73 73 0a 70 61 73 73 65  |he address.passe|
00002b80  64 20 69 6e 20 52 35 29  2c 20 62 65 63 61 75 73  |d in R5), becaus|
00002b90  65 20 61 6c 6c 20 69 6e  66 6f 72 6d 61 74 69 6f  |e all informatio|
00002ba0  6e 20 69 73 20 61 76 61  69 6c 61 62 6c 65 20 76  |n is available v|
00002bb0  69 61 20 74 68 65 20 76  61 72 69 6f 75 73 20 53  |ia the various S|
00002bc0  57 49 27 73 2c 0a 61 6e  64 20 73 6f 75 6e 64 74  |WI's,.and soundt|
00002bd0  72 61 63 6b 65 72 20 66  6f 72 6d 61 74 20 6d 6f  |racker format mo|
00002be0  64 75 6c 65 73 20 77 69  6c 6c 20 68 61 76 65 20  |dules will have |
00002bf0  62 65 65 6e 20 63 6f 6e  76 65 72 74 65 64 20 70  |been converted p|
00002c00  61 72 74 69 61 6c 6c 79  20 74 6f 20 54 72 61 63  |artially to Trac|
00002c10  6b 65 72 0a 66 6f 72 6d  61 74 20 77 68 65 6e 20  |ker.format when |
00002c20  6c 6f 61 64 65 64 20 28  61 6e 64 20 74 68 65 72  |loaded (and ther|
00002c30  65 66 6f 72 65 20 69 6e  20 61 6e 20 75 6e 6b 6e  |efore in an unkn|
00002c40  6f 77 6e 20 66 6f 72 6d  61 74 29 2e 20 54 68 69  |own format). Thi|
00002c50  73 20 69 6e 66 6f 72 6d  61 74 69 6f 6e 20 69 73  |s information is|
00002c60  0a 70 72 6f 76 69 64 65  64 20 69 66 2c 20 66 6f  |.provided if, fo|
00002c70  72 20 65 78 61 6d 70 6c  65 2c 20 6d 75 6c 74 69  |r example, multi|
00002c80  2d 74 61 73 6b 69 6e 67  20 70 6c 61 79 65 72 73  |-tasking players|
00002c90  2f 65 64 69 74 6f 72 73  20 6e 65 65 64 20 74 6f  |/editors need to|
00002ca0  20 6b 6e 6f 77 20 69 66  20 74 68 65 0a 74 75 6e  | know if the.tun|
00002cb0  65 20 63 75 72 72 65 6e  74 6c 79 20 70 6c 61 79  |e currently play|
00002cc0  69 6e 67 20 69 73 20 72  75 6e 6e 69 6e 67 20 66  |ing is running f|
00002cd0  72 6f 6d 20 6f 72 64 69  6e 61 72 79 20 52 4d 41  |rom ordinary RMA|
00002ce0  2c 20 6f 72 20 74 68 65  20 70 6c 61 79 65 72 27  |, or the player'|
00002cf0  73 2f 65 64 69 74 6f 72  27 73 0a 6f 77 6e 20 77  |s/editor's.own w|
00002d00  6f 72 6b 73 70 61 63 65  2e 0a 0a 0a 20 20 20 20  |orkspace....    |
00002d10  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 0a  |               .|
00002d20  0a 0a 0a 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |...-------------|
00002d30  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00002d70  0a 54 72 61 63 6b 65 72  5f 53 6f 75 6e 64 49 6e  |.Tracker_SoundIn|
00002d80  66 6f 20 20 20 20 20 20  28 53 57 49 20 26 34 33  |fo      (SWI &43|
00002d90  32 30 42 29 0a 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |20B).-----------|
00002da0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00002de0  2d 2d 0a 0a 4f 6e 20 45  6e 74 72 79 3a 20 20 52  |--..On Entry:  R|
00002df0  30 20 3d 20 50 6f 69 6e  74 65 72 20 74 6f 20 77  |0 = Pointer to w|
00002e00  6f 72 64 2d 61 6c 69 67  6e 65 64 20 32 35 36 20  |ord-aligned 256 |
00002e10  62 79 74 65 20 62 6c 6f  63 6b 20 74 6f 20 68 6f  |byte block to ho|
00002e20  6c 64 20 73 6f 75 6e 64  20 64 61 74 61 0a 0a 4f  |ld sound data..O|
00002e30  6e 20 45 78 69 74 20 3a  20 20 52 30 20 70 72 65  |n Exit :  R0 pre|
00002e40  73 65 72 76 65 64 0a 20  20 20 20 20 20 20 20 20  |served.         |
00002e50  20 20 20 20 20 0a 20 20  20 20 20 20 20 20 20 20  |     .          |
00002e60  20 69 66 20 74 68 65 20  74 75 6e 65 20 69 73 20  | if the tune is |
00002e70  70 61 75 73 65 64 2c 20  74 68 65 20 43 20 66 6c  |paused, the C fl|
00002e80  61 67 20 77 69 6c 6c 20  62 65 20 73 65 74 2c 20  |ag will be set, |
00002e90  6f 74 68 65 72 77 69 73  65 20 74 68 65 20 43 0a  |otherwise the C.|
00002ea0  20 20 20 20 20 20 20 20  20 20 20 66 6c 61 67 20  |           flag |
00002eb0  77 69 6c 6c 20 62 65 20  63 6c 65 61 72 65 64 2e  |will be cleared.|
00002ec0  0a 0a 49 66 20 74 68 65  72 65 20 69 73 20 6e 6f  |..If there is no|
00002ed0  20 74 75 6e 65 20 6c 6f  61 64 65 64 20 61 6e 20  | tune loaded an |
00002ee0  65 72 72 6f 72 20 77 69  6c 6c 20 62 65 20 67 65  |error will be ge|
00002ef0  6e 65 72 61 74 65 64 2e  0a 0a 54 68 69 73 20 63  |nerated...This c|
00002f00  61 6c 6c 20 69 73 20 6f  6e 6c 79 20 70 72 6f 76  |all is only prov|
00002f10  69 64 65 64 20 66 6f 72  20 61 64 76 61 6e 63 65  |ided for advance|
00002f20  64 20 75 73 65 73 20 6f  66 20 74 68 65 20 74 72  |d uses of the tr|
00002f30  61 63 6b 65 72 6d 6f 64  75 6c 65 2c 20 61 6e 64  |ackermodule, and|
00002f40  0a 69 6e 76 6f 6c 76 65  73 20 69 6e 66 6f 72 6d  |.involves inform|
00002f50  61 74 69 6f 6e 20 6f 66  20 61 20 68 69 67 68 6c  |ation of a highl|
00002f60  79 20 74 65 63 68 6e 69  63 61 6c 20 6e 61 74 75  |y technical natu|
00002f70  72 65 2e 20 49 74 20 69  73 20 61 64 76 69 73 65  |re. It is advise|
00002f80  64 20 74 68 61 74 20 79  6f 75 0a 64 6f 20 6e 6f  |d that you.do no|
00002f90  74 20 75 73 65 20 74 68  69 73 20 63 61 6c 6c 20  |t use this call |
00002fa0  69 66 20 79 6f 75 20 63  61 6e 20 61 76 6f 69 64  |if you can avoid|
00002fb0  20 69 74 2e 0a 0a 54 68  65 20 63 61 6c 6c 20 77  | it...The call w|
00002fc0  69 6c 6c 20 74 72 61 6e  73 66 65 72 20 74 68 65  |ill transfer the|
00002fd0  20 63 75 72 72 65 6e 74  20 63 6f 6e 74 65 6e 74  | current content|
00002fe0  73 20 6f 66 20 74 68 65  20 73 6f 75 6e 64 20 76  |s of the sound v|
00002ff0  6f 69 63 65 20 69 6e 66  6f 20 74 61 62 6c 65 0a  |oice info table.|
00003000  74 6f 20 74 68 65 20 6c  6f 63 61 74 69 6f 6e 20  |to the location |
00003010  70 6f 69 6e 74 65 64 20  74 6f 20 62 79 20 52 30  |pointed to by R0|
00003020  2e 20 32 35 36 20 62 79  74 65 73 20 28 36 34 20  |. 256 bytes (64 |
00003030  77 6f 72 64 73 29 20 77  69 6c 6c 20 62 65 20 74  |words) will be t|
00003040  72 61 6e 73 66 65 72 72  65 64 0a 69 6e 20 74 6f  |ransferred.in to|
00003050  74 61 6c 20 28 38 20 77  6f 72 64 73 20 70 65 72  |tal (8 words per|
00003060  20 73 6f 75 6e 64 20 63  68 61 6e 6e 65 6c 29 2c  | sound channel),|
00003070  20 72 65 67 61 72 64 6c  65 73 73 20 6f 66 20 74  | regardless of t|
00003080  68 65 20 6e 75 6d 62 65  72 20 6f 66 20 76 6f 69  |he number of voi|
00003090  63 65 73 0a 61 63 74 75  61 6c 6c 79 20 61 63 74  |ces.actually act|
000030a0  69 76 65 2e 0a 0a 57 68  65 6e 20 61 20 6e 6f 74  |ive...When a not|
000030b0  65 20 69 73 20 70 6c 61  79 65 64 20 61 6e 64 20  |e is played and |
000030c0  74 68 65 6e 20 65 6e 64  73 2c 20 77 6f 72 64 20  |then ends, word |
000030d0  36 20 6f 66 20 74 68 65  20 61 70 70 72 6f 70 72  |6 of the appropr|
000030e0  69 61 74 65 20 63 68 61  6e 6e 65 6c 20 69 73 0a  |iate channel is.|
000030f0  7a 65 72 6f 65 64 2e 20  54 68 65 20 73 6f 75 6e  |zeroed. The soun|
00003100  64 20 72 6f 75 74 69 6e  65 73 20 77 69 6c 6c 20  |d routines will |
00003110  6f 6e 6c 79 20 74 72 79  20 61 6e 64 20 70 6c 61  |only try and pla|
00003120  79 20 74 68 65 20 73 61  6d 70 6c 65 20 69 66 20  |y the sample if |
00003130  74 68 69 73 20 77 6f 72  64 20 69 73 0a 6e 6f 6e  |this word is.non|
00003140  2d 7a 65 72 6f 2e 0a 0a  57 68 65 6e 20 61 20 74  |-zero...When a t|
00003150  75 6e 65 20 69 73 20 70  61 75 73 65 64 2c 20 74  |une is paused, t|
00003160  68 65 20 62 6c 6f 63 6b  20 69 73 20 73 61 76 65  |he block is save|
00003170  64 20 61 6e 64 20 6f 76  65 72 77 72 69 74 74 65  |d and overwritte|
00003180  6e 20 77 69 74 68 20 7a  65 72 6f 73 2e 20 57 68  |n with zeros. Wh|
00003190  65 6e 0a 74 68 65 20 74  75 6e 65 20 69 73 20 72  |en.the tune is r|
000031a0  65 73 74 61 72 74 65 64  2c 20 74 68 65 20 6f 6c  |estarted, the ol|
000031b0  64 20 63 6f 6e 74 65 6e  74 73 20 61 72 65 20 72  |d contents are r|
000031c0  65 73 74 6f 72 65 64 2c  20 73 6f 20 74 68 61 74  |estored, so that|
000031d0  20 74 68 65 20 73 61 6d  70 6c 65 73 0a 77 69 6c  | the samples.wil|
000031e0  6c 20 63 6f 6e 74 69 6e  75 65 20 74 6f 20 70 6c  |l continue to pl|
000031f0  61 79 20 66 72 6f 6d 20  74 68 65 20 73 61 6d 65  |ay from the same|
00003200  20 70 6f 69 6e 74 2e 0a  0a 20 54 68 65 20 66 6f  | point... The fo|
00003210  72 6d 61 74 20 6f 66 20  74 68 65 20 74 61 62 6c  |rmat of the tabl|
00003220  65 20 69 73 20 61 73 20  66 6f 6c 6c 6f 77 73 3a  |e is as follows:|
00003230  2d 0a 0a 57 6f 72 64 20  20 4f 66 66 73 65 74 20  |-..Word  Offset |
00003240  20 20 20 20 20 20 53 6f  75 6e 64 20 63 68 61 6e  |      Sound chan|
00003250  6e 65 6c 20 31 2e 2e 2e  0a 30 20 20 20 20 20 2b  |nel 1....0     +|
00003260  30 20 20 20 20 20 20 54  68 65 20 63 75 72 72 65  |0      The curre|
00003270  6e 74 20 70 69 74 63 68  20 61 63 63 75 6d 75 6c  |nt pitch accumul|
00003280  61 74 6f 72 2e 20 28 73  68 69 66 74 20 72 69 67  |ator. (shift rig|
00003290  68 74 20 31 36 20 62 69  74 73 20 74 6f 20 67 65  |ht 16 bits to ge|
000032a0  74 20 74 68 65 0a 20 20  20 20 20 20 20 20 20 20  |t the.          |
000032b0  20 20 20 20 61 63 74 75  61 6c 20 62 79 74 65 20  |    actual byte |
000032c0  6f 66 66 73 65 74 20 69  6e 74 6f 20 74 68 65 20  |offset into the |
000032d0  73 61 6d 70 6c 65 20 62  65 69 6e 67 20 70 6c 61  |sample being pla|
000032e0  79 65 64 29 2e 0a 0a 31  20 20 20 20 20 2b 34 20  |yed)...1     +4 |
000032f0  20 20 20 20 20 54 68 65  20 63 75 72 72 65 6e 74  |     The current|
00003300  20 70 69 74 63 68 20 69  6e 63 72 65 6d 65 6e 74  | pitch increment|
00003310  20 28 61 64 64 65 64 20  74 6f 20 61 63 63 75 6d  | (added to accum|
00003320  75 6c 61 74 6f 72 20 61  66 74 65 72 20 65 76 65  |ulator after eve|
00003330  72 79 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |ry.             |
00003340  20 62 79 74 65 20 66 69  6c 6c 65 64 29 2e 20 54  | byte filled). T|
00003350  68 69 73 20 69 73 20 6f  62 74 61 69 6e 65 64 20  |his is obtained |
00003360  75 73 69 6e 67 20 69 6e  74 65 72 6e 61 6c 20 74  |using internal t|
00003370  61 62 6c 65 73 20 67 69  76 65 6e 20 74 68 65 0a  |ables given the.|
00003380  20 20 20 20 20 20 20 20  20 20 20 20 20 20 73 61  |              sa|
00003390  6d 70 6c 65 20 70 65 72  69 6f 64 20 28 77 6f 72  |mple period (wor|
000033a0  64 20 37 29 0a 0a 32 20  20 20 20 20 2b 38 20 20  |d 7)..2     +8  |
000033b0  20 20 20 20 54 68 65 20  73 61 6d 70 6c 65 20 6c  |    The sample l|
000033c0  6f 6f 70 20 6f 66 66 73  65 74 20 28 67 69 76 65  |oop offset (give|
000033d0  6e 20 69 6e 20 62 79 74  65 73 29 2e 20 57 68 65  |n in bytes). Whe|
000033e0  6e 20 74 68 65 20 72 6f  75 74 69 6e 65 0a 20 20  |n the routine.  |
000033f0  20 20 20 20 20 20 20 20  20 20 20 20 72 65 61 63  |            reac|
00003400  68 65 73 20 74 68 65 20  65 6e 64 20 6f 66 20 61  |hes the end of a|
00003410  20 73 61 6d 70 6c 65 20  6f 72 20 74 68 65 20 73  | sample or the s|
00003420  61 6d 70 6c 65 20 6c 65  6e 67 74 68 2c 20 74 68  |ample length, th|
00003430  65 20 61 63 63 75 6d 75  6c 2d 0a 20 20 20 20 20  |e accumul-.     |
00003440  20 20 20 20 20 20 20 20  20 61 74 6f 72 20 69 73  |         ator is|
00003450  20 6c 6f 61 64 65 64 20  77 69 74 68 20 74 68 69  | loaded with thi|
00003460  73 20 76 61 6c 75 65 20  73 68 69 66 74 65 64 20  |s value shifted |
00003470  6c 65 66 74 20 31 36 20  62 69 74 73 20 28 69 65  |left 16 bits (ie|
00003480  2e 20 74 6f 0a 20 20 20  20 20 20 20 20 20 20 20  |. to.           |
00003490  20 20 20 67 69 76 65 20  61 20 62 79 74 65 20 6f  |   give a byte o|
000034a0  66 66 73 65 74 29 2e 20  49 66 20 74 68 69 73 20  |ffset). If this |
000034b0  69 73 20 61 20 7a 65 72  6f 20 76 61 6c 75 65 2c  |is a zero value,|
000034c0  20 74 68 65 20 73 61 6d  70 6c 65 20 77 69 6c 6c  | the sample will|
000034d0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 73  |.              s|
000034e0  74 6f 70 20 69 6e 73 74  65 61 64 20 6f 66 20 6c  |top instead of l|
000034f0  6f 6f 70 69 6e 67 2e 0a  0a 33 20 20 20 20 20 2b  |ooping...3     +|
00003500  31 32 20 20 20 20 20 54  68 65 20 73 61 6d 70 6c  |12     The sampl|
00003510  65 20 6c 65 6e 67 74 68  20 2f 20 72 65 70 65 61  |e length / repea|
00003520  74 20 6c 65 6e 67 74 68  20 28 69 6e 20 62 79 74  |t length (in byt|
00003530  65 73 29 2e 20 54 68 65  20 72 6f 75 74 69 6e 65  |es). The routine|
00003540  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 63  |.              c|
00003550  68 65 63 6b 73 20 65 76  65 72 79 20 34 20 62 79  |hecks every 4 by|
00003560  74 65 73 20 66 69 6c 6c  65 64 20 74 6f 20 73 65  |tes filled to se|
00003570  65 20 69 66 20 74 68 65  20 63 75 72 72 65 6e 74  |e if the current|
00003580  20 61 63 63 75 6d 75 6c  61 74 6f 72 0a 20 20 20  | accumulator.   |
00003590  20 20 20 20 20 20 20 20  20 20 20 65 78 63 65 65  |           excee|
000035a0  64 73 20 74 68 69 73 20  76 61 6c 75 65 20 77 68  |ds this value wh|
000035b0  65 6e 20 73 68 69 66 74  65 64 20 72 69 67 68 74  |en shifted right|
000035c0  20 31 36 20 62 69 74 73  2e 20 28 53 65 65 20 61  | 16 bits. (See a|
000035d0  62 6f 76 65 29 0a 0a 34  20 20 20 20 20 2b 31 36  |bove)..4     +16|
000035e0  20 20 20 20 20 54 68 65  20 73 61 6d 70 6c 65 20  |     The sample |
000035f0  6e 75 6d 62 65 72 20 28  31 2d 33 36 29 2e 0a 0a  |number (1-36)...|
00003600  35 20 20 20 20 20 2b 32  30 20 20 20 20 20 54 68  |5     +20     Th|
00003610  65 20 63 75 72 72 65 6e  74 20 76 6f 6c 75 6d 65  |e current volume|
00003620  20 28 30 2d 32 35 35 29  2e 20 54 68 69 73 20 76  | (0-255). This v|
00003630  61 6c 75 65 20 69 73 20  73 75 62 74 72 61 63 74  |alue is subtract|
00003640  65 64 20 66 72 6f 6d 20  65 76 65 72 79 0a 20 20  |ed from every.  |
00003650  20 20 20 20 20 20 20 20  20 20 20 20 62 79 74 65  |            byte|
00003660  20 66 69 6c 6c 65 64 2c  20 74 68 65 72 65 66 6f  | filled, therefo|
00003670  72 65 20 30 20 3d 20 6d  61 78 69 6d 75 6d 20 76  |re 0 = maximum v|
00003680  6f 6c 75 6d 65 20 61 6e  64 20 32 35 35 20 3d 20  |olume and 255 = |
00003690  73 69 6c 65 6e 74 2e 0a  20 20 20 20 20 20 20 20  |silent..        |
000036a0  20 20 20 20 20 20 4e 42  20 54 68 69 73 20 69 73  |      NB This is|
000036b0  20 74 68 65 20 72 65 76  65 72 73 65 20 6f 66 20  | the reverse of |
000036c0  74 68 65 20 6e 6f 72 6d  61 6c 20 76 6f 6c 75 6d  |the normal volum|
000036d0  65 20 63 6f 6d 6d 61 6e  64 2e 0a 0a 36 20 20 20  |e command...6   |
000036e0  20 20 2b 32 34 20 20 20  20 20 54 68 69 73 20 69  |  +24     This i|
000036f0  73 20 74 68 65 20 74 72  61 63 6b 65 72 20 66 6f  |s the tracker fo|
00003700  72 6d 61 74 20 6e 6f 74  65 20 6e 75 6d 62 65 72  |rmat note number|
00003710  20 6f 66 20 74 68 65 20  73 61 6d 70 6c 65 20 62  | of the sample b|
00003720  65 69 6e 67 0a 20 20 20  20 20 20 20 20 20 20 20  |eing.           |
00003730  20 20 20 70 6c 61 79 65  64 20 28 31 2d 33 36 2c  |   played (1-36,|
00003740  20 31 3d 43 20 6f 63 74  61 76 65 20 31 20 33 36  | 1=C octave 1 36|
00003750  3d 42 20 6f 63 74 61 76  65 20 33 29 2e 20 54 68  |=B octave 3). Th|
00003760  65 20 61 72 70 65 67 67  69 6f 20 63 6f 6d 6d 61  |e arpeggio comma|
00003770  6e 64 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |nd.             |
00003780  20 6d 61 6b 65 73 20 75  73 65 20 6f 66 20 74 68  | makes use of th|
00003790  69 73 20 77 6f 72 64 2e  20 49 66 20 74 68 69 73  |is word. If this|
000037a0  20 77 6f 72 64 20 69 73  20 7a 65 72 6f 2c 20 6e  | word is zero, n|
000037b0  6f 20 73 6f 75 6e 64 20  77 69 6c 6c 20 62 65 0a  |o sound will be.|
000037c0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 70 6c  |              pl|
000037d0  61 79 65 64 2e 0a 0a 37  20 20 20 20 20 2b 32 38  |ayed...7     +28|
000037e0  20 20 20 20 20 54 68 69  73 20 69 73 20 61 20 63  |     This is a c|
000037f0  6f 70 79 20 6f 66 20 74  68 65 20 73 61 6d 70 6c  |opy of the sampl|
00003800  65 20 70 65 72 69 6f 64  20 28 66 72 6f 6d 20 77  |e period (from w|
00003810  68 69 63 68 20 74 68 65  20 70 69 74 63 68 0a 20  |hich the pitch. |
00003820  20 20 20 20 20 20 20 20  20 20 20 20 20 69 6e 63  |             inc|
00003830  72 65 6d 65 6e 74 20 76  61 6c 75 65 20 69 73 20  |rement value is |
00003840  63 61 6c 63 75 6c 61 74  65 64 29 2c 20 61 6e 64  |calculated), and|
00003850  20 69 73 20 75 73 65 64  20 62 79 20 74 68 65 20  | is used by the |
00003860  70 6f 72 74 61 6d 65 6e  74 6f 0a 20 20 20 20 20  |portamento.     |
00003870  20 20 20 20 20 20 20 20  20 63 6f 6d 6d 61 6e 64  |         command|
00003880  73 2e 20 54 68 65 20 72  61 6e 67 65 20 6f 66 20  |s. The range of |
00003890  74 68 65 20 73 61 6d 70  6c 65 20 70 65 72 69 6f  |the sample perio|
000038a0  64 20 69 73 20 66 72 6f  6d 20 31 20 74 6f 20 68  |d is from 1 to h|
000038b0  65 78 20 26 34 30 30 0a  20 20 20 20 20 20 20 20  |ex &400.        |
000038c0  20 20 20 20 20 20 28 61  6c 74 68 6f 75 67 68 20  |      (although |
000038d0  74 68 65 20 70 6f 72 74  61 6d 65 6e 74 6f 20 63  |the portamento c|
000038e0  6f 6d 6d 61 6e 64 73 20  68 61 76 65 20 73 6d 61  |ommands have sma|
000038f0  6c 6c 65 72 20 6c 69 6d  69 74 73 20 69 6e 0a 20  |ller limits in. |
00003900  20 20 20 20 20 20 20 20  20 20 20 20 20 70 72 61  |             pra|
00003910  63 74 69 63 65 29 2e 0a  0a 38 20 20 20 20 20 2b  |ctice)...8     +|
00003920  33 32 20 20 20 20 20 57  6f 72 64 20 30 20 6f 66  |32     Word 0 of|
00003930  20 73 6f 75 6e 64 20 63  68 61 6e 6e 65 6c 20 32  | sound channel 2|
00003940  2e 2e 2e 0a 0a 39 20 20  20 20 20 2b 33 36 20 20  |.....9     +36  |
00003950  20 20 20 57 6f 72 64 20  31 20 6f 66 20 73 6f 75  |   Word 1 of sou|
00003960  6e 64 20 63 68 61 6e 6e  65 6c 20 32 2e 2e 2e 20  |nd channel 2... |
00003970  20 65 74 63 2e 20 0a 20  20 20 20 20 0a 20 20 20  | etc. .     .   |
00003980  20 2d 3e 20 77 6f 72 64  20 38 20 6f 66 20 73 6f  | -> word 8 of so|
00003990  75 6e 64 20 63 68 61 6e  6e 65 6c 20 38 0a 0a 0a  |und channel 8...|
000039a0  0a 0a 0a 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |...-------------|
000039b0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000039f0  0a 54 72 61 63 6b 65 72  5f 52 65 61 64 53 61 6d  |.Tracker_ReadSam|
00003a00  70 6c 65 54 61 62 6c 65  20 20 20 28 53 57 49 20  |pleTable   (SWI |
00003a10  26 34 33 32 30 43 29 0a  2d 2d 2d 2d 2d 2d 2d 2d  |&4320C).--------|
00003a20  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003a60  2d 2d 2d 2d 2d 0a 0a 4f  6e 20 45 6e 74 72 79 3a  |-----..On Entry:|
00003a70  20 20 52 30 20 3d 20 53  61 6d 70 6c 65 20 6e 75  |  R0 = Sample nu|
00003a80  6d 62 65 72 20 28 31 2d  33 36 29 0a 0a 4f 6e 20  |mber (1-36)..On |
00003a90  45 78 69 74 20 3a 20 20  52 30 20 70 72 65 73 65  |Exit :  R0 prese|
00003aa0  72 76 65 64 0a 20 20 20  20 20 20 20 20 20 20 20  |rved.           |
00003ab0  52 31 20 3d 20 50 6f 69  6e 74 65 72 20 74 6f 20  |R1 = Pointer to |
00003ac0  73 61 6d 70 6c 65 20 6e  61 6d 65 20 28 30 2d 74  |sample name (0-t|
00003ad0  65 72 6d 69 6e 61 74 65  64 2c 20 6d 61 78 20 6c  |erminated, max l|
00003ae0  65 6e 67 74 68 20 32 32  20 63 68 61 72 73 29 0a  |ength 22 chars).|
00003af0  20 20 20 20 20 20 20 20  20 20 20 52 32 20 3d 20  |           R2 = |
00003b00  53 61 6d 70 6c 65 20 6c  65 6e 67 74 68 20 28 62  |Sample length (b|
00003b10  79 74 65 73 29 0a 20 20  20 20 20 20 20 20 20 20  |ytes).          |
00003b20  20 52 33 20 3d 20 53 61  6d 70 6c 65 20 76 6f 6c  | R3 = Sample vol|
00003b30  75 6d 65 20 28 30 2d 32  35 35 2c 20 32 35 35 3d  |ume (0-255, 255=|
00003b40  6d 61 78 69 6d 75 6d 20  76 6f 6c 75 6d 65 2c 20  |maximum volume, |
00003b50  30 3d 73 69 6c 65 6e 74  29 0a 20 20 20 20 20 20  |0=silent).      |
00003b60  20 20 20 20 20 52 34 20  3d 20 52 65 70 65 61 74  |     R4 = Repeat|
00003b70  20 6f 66 66 73 65 74 20  28 62 79 74 65 73 29 0a  | offset (bytes).|
00003b80  20 20 20 20 20 20 20 20  20 20 20 52 35 20 3d 20  |           R5 = |
00003b90  52 65 70 65 61 74 20 6c  65 6e 67 74 68 20 28 62  |Repeat length (b|
00003ba0  79 74 65 73 29 0a 20 20  20 20 20 20 20 20 20 20  |ytes).          |
00003bb0  20 52 36 20 3d 20 41 64  64 72 65 73 73 20 6f 66  | R6 = Address of|
00003bc0  20 72 61 77 20 73 61 6d  70 6c 65 20 64 61 74 61  | raw sample data|
00003bd0  0a 0a 54 68 69 73 20 63  61 6c 6c 20 72 65 74 75  |..This call retu|
00003be0  72 6e 73 20 61 6c 6c 20  72 65 6c 65 76 61 6e 74  |rns all relevant|
00003bf0  20 69 6e 66 6f 72 6d 61  74 69 6f 6e 20 61 62 6f  | information abo|
00003c00  75 74 20 74 68 65 20 73  70 65 63 69 66 69 65 64  |ut the specified|
00003c10  20 73 61 6d 70 6c 65 2e  20 0a 0a 49 66 20 74 68  | sample. ..If th|
00003c20  65 72 65 20 69 73 20 6e  6f 20 74 75 6e 65 20 6c  |ere is no tune l|
00003c30  6f 61 64 65 64 2c 20 61  6e 20 65 72 72 6f 72 20  |oaded, an error |
00003c40  77 69 6c 6c 20 62 65 20  67 65 6e 65 72 61 74 65  |will be generate|
00003c50  64 2e 0a 0a 0a 0a 0a 2d  2d 2d 2d 2d 2d 2d 2d 2d  |d......---------|
00003c60  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003ca0  2d 2d 2d 2d 0a 54 72 61  63 6b 65 72 5f 4c 6f 63  |----.Tracker_Loc|
00003cb0  6b 20 20 20 20 20 20 20  20 20 20 20 20 20 20 28  |k              (|
00003cc0  53 57 49 20 26 34 33 32  30 44 29 0a 2d 2d 2d 2d  |SWI &4320D).----|
00003cd0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003d10  2d 2d 2d 2d 2d 2d 2d 2d  2d 0a 0a 4f 6e 20 45 6e  |---------..On En|
00003d20  74 72 79 3a 20 20 52 30  20 3d 20 6c 6f 63 6b 69  |try:  R0 = locki|
00003d30  6e 67 20 63 6f 64 65 20  28 70 61 73 73 65 64 20  |ng code (passed |
00003d40  69 6e 20 52 34 20 74 6f  20 53 57 49 27 73 29 0a  |in R4 to SWI's).|
00003d50  0a 4f 6e 20 45 78 69 74  20 3a 20 20 2d 20 20 20  |.On Exit :  -   |
00003d60  20 20 0a 0a 0a 20 54 68  69 73 20 53 57 49 20 61  |  ... This SWI a|
00003d70  6e 64 20 74 68 65 20 63  6f 72 72 65 73 70 6f 6e  |nd the correspon|
00003d80  64 69 6e 67 20 54 72 61  63 6b 65 72 5f 55 6e 6c  |ding Tracker_Unl|
00003d90  6f 63 6b 20 53 57 49 20  61 72 65 20 70 72 6f 76  |ock SWI are prov|
00003da0  69 64 65 64 20 74 6f 0a  70 72 65 76 65 6e 74 20  |ided to.prevent |
00003db0  75 73 65 72 20 69 6e 74  65 72 76 65 6e 74 69 6f  |user interventio|
00003dc0  6e 20 77 69 74 68 20 61  6e 79 20 6f 66 20 74 68  |n with any of th|
00003dd0  65 20 66 65 61 74 75 72  65 73 20 6f 66 20 74 68  |e features of th|
00003de0  65 20 6d 6f 64 75 6c 65  20 77 68 65 6e 20 74 68  |e module when th|
00003df0  69 73 0a 77 6f 75 6c 64  20 62 65 20 75 6e 64 65  |is.would be unde|
00003e00  73 69 72 61 62 6c 65 20  66 6f 72 20 61 6e 79 20  |sirable for any |
00003e10  6d 75 6c 74 69 2d 74 61  73 6b 69 6e 67 20 61 70  |multi-tasking ap|
00003e20  70 6c 69 63 61 74 69 6f  6e 73 20 75 73 69 6e 67  |plications using|
00003e30  20 74 68 65 20 6d 6f 64  75 6c 65 20 0a 28 66 6f  | the module .(fo|
00003e40  72 20 65 78 61 6d 70 6c  65 20 69 73 73 75 69 6e  |r example issuin|
00003e50  67 20 61 20 2a 50 6c 61  79 53 74 6f 70 20 63 6f  |g a *PlayStop co|
00003e60  6d 6d 61 6e 64 29 2e 20  42 79 20 63 61 6c 6c 69  |mmand). By calli|
00003e70  6e 67 20 74 68 69 73 20  53 57 49 2c 20 61 6e 20  |ng this SWI, an |
00003e80  61 70 70 6c 69 63 2d 0a  61 74 69 6f 6e 20 63 61  |applic-.ation ca|
00003e90  6e 20 67 61 69 6e 20 63  6f 6d 70 6c 65 74 65 20  |n gain complete |
00003ea0  63 6f 6e 74 72 6f 6c 20  6f 66 20 74 68 65 20 6d  |control of the m|
00003eb0  6f 64 75 6c 65 2c 20 62  75 74 20 61 73 20 61 20  |odule, but as a |
00003ec0  72 65 73 75 6c 74 2c 20  74 68 69 73 20 66 65 61  |result, this fea|
00003ed0  74 75 72 65 0a 6d 75 73  74 20 62 65 20 75 73 65  |ture.must be use|
00003ee0  64 20 63 61 72 65 66 75  6c 6c 79 2c 20 62 65 63  |d carefully, bec|
00003ef0  61 75 73 65 20 74 68 65  20 6d 6f 64 75 6c 65 20  |ause the module |
00003f00  63 61 6e 6e 6f 74 20 74  68 65 6e 20 62 65 20 75  |cannot then be u|
00003f10  6e 6c 6f 63 6b 65 64 20  75 6e 6c 65 73 73 0a 74  |nlocked unless.t|
00003f20  68 65 20 63 6f 64 65 20  73 70 65 63 69 66 69 65  |he code specifie|
00003f30  64 20 69 6e 20 74 68 65  20 6c 6f 63 6b 20 53 57  |d in the lock SW|
00003f40  49 20 69 73 20 6b 6e 6f  77 6e 20 28 61 6e 64 20  |I is known (and |
00003f50  69 66 20 6e 6f 74 2c 20  74 68 65 20 6d 6f 64 75  |if not, the modu|
00003f60  6c 65 20 6d 75 73 74 20  62 65 0a 72 65 2d 69 6e  |le must be.re-in|
00003f70  69 74 69 61 6c 69 73 65  64 29 2e 0a 20 57 68 65  |itialised).. Whe|
00003f80  6e 20 74 68 65 20 6d 6f  64 75 6c 65 20 69 73 20  |n the module is |
00003f90  6c 6f 63 6b 65 64 2c 20  63 61 6c 6c 69 6e 67 20  |locked, calling |
00003fa0  61 6e 79 20 63 6f 6d 6d  61 6e 64 73 20 6f 72 20  |any commands or |
00003fb0  53 57 49 27 73 20 77 68  69 63 68 20 61 6c 74 65  |SWI's which alte|
00003fc0  72 0a 61 6e 79 74 68 69  6e 67 20 28 73 75 63 68  |r.anything (such|
00003fd0  20 61 73 20 63 68 61 6e  67 69 6e 67 20 74 68 65  | as changing the|
00003fe0  20 63 75 72 72 65 6e 74  20 70 6c 61 79 20 70 6f  | current play po|
00003ff0  73 69 74 69 6f 6e 2c 20  6c 6f 61 64 69 6e 67 20  |sition, loading |
00004000  6f 72 20 6b 69 6c 6c 69  6e 67 0a 74 75 6e 65 73  |or killing.tunes|
00004010  2c 20 70 6c 61 79 69 6e  67 20 6e 6f 74 65 73 29  |, playing notes)|
00004020  20 77 69 6c 6c 20 63 61  75 73 65 20 61 6e 20 65  | will cause an e|
00004030  72 72 6f 72 2c 20 62 75  74 20 53 57 49 27 73 20  |rror, but SWI's |
00004040  72 65 74 75 72 6e 69 6e  67 20 69 6e 66 6f 72 6d  |returning inform|
00004050  61 74 69 6f 6e 0a 77 69  6c 6c 20 66 75 6e 63 74  |ation.will funct|
00004060  69 6f 6e 20 61 73 20 6e  6f 72 6d 61 6c 2e 20 46  |ion as normal. F|
00004070  6f 72 20 74 68 65 20 61  70 70 6c 69 63 61 74 69  |or the applicati|
00004080  6f 6e 20 77 68 69 63 68  20 69 73 20 72 65 73 70  |on which is resp|
00004090  6f 6e 73 69 62 6c 65 20  66 6f 72 20 74 68 65 0a  |onsible for the.|
000040a0  6c 6f 63 6b 69 6e 67 20  74 6f 20 62 65 20 61 62  |locking to be ab|
000040b0  6c 65 20 74 6f 20 75 73  65 20 74 68 65 20 61 66  |le to use the af|
000040c0  66 65 63 74 65 64 20 53  57 49 27 73 2c 20 52 34  |fected SWI's, R4|
000040d0  20 6d 75 73 74 20 62 65  20 73 65 74 20 74 6f 20  | must be set to |
000040e0  74 68 65 20 6c 6f 63 6b  69 6e 67 0a 63 6f 64 65  |the locking.code|
000040f0  20 28 70 61 73 73 65 64  20 69 6e 20 52 30 29 20  | (passed in R0) |
00004100  62 65 66 6f 72 65 20 61  6e 79 20 6f 66 20 74 68  |before any of th|
00004110  65 20 61 66 66 65 63 74  65 64 20 53 57 49 27 73  |e affected SWI's|
00004120  20 69 73 20 63 61 6c 6c  65 64 20 28 6e 6f 20 63  | is called (no c|
00004130  6f 6d 6d 61 6e 64 73 0a  77 69 6c 6c 20 77 6f 72  |ommands.will wor|
00004140  6b 20 65 76 65 6e 20 69  66 20 74 68 65 20 6c 6f  |k even if the lo|
00004150  63 6b 69 6e 67 20 63 6f  64 65 20 69 73 20 6b 6e  |cking code is kn|
00004160  6f 77 6e 29 2e 0a 20 49  66 20 74 68 65 20 74 72  |own).. If the tr|
00004170  61 63 6b 65 72 6d 6f 64  75 6c 65 20 69 73 20 61  |ackermodule is a|
00004180  6c 72 65 61 64 79 20 27  6c 6f 63 6b 65 64 27 20  |lready 'locked' |
00004190  77 68 65 6e 20 74 68 69  73 20 53 57 49 20 69 73  |when this SWI is|
000041a0  20 63 61 6c 6c 65 64 2c  20 61 6e 20 65 72 72 6f  | called, an erro|
000041b0  72 0a 77 69 6c 6c 20 62  65 20 67 65 6e 65 72 61  |r.will be genera|
000041c0  74 65 64 2e 0a 20 49 74  20 69 73 20 61 64 76 69  |ted.. It is advi|
000041d0  73 61 62 6c 65 20 74 6f  20 61 76 6f 69 64 20 75  |sable to avoid u|
000041e0  73 69 6e 67 20 74 68 69  73 20 63 61 6c 6c 20 75  |sing this call u|
000041f0  6e 6c 65 73 73 20 61 62  73 6f 6c 75 74 65 6c 79  |nless absolutely|
00004200  20 6e 65 63 63 65 73 73  61 72 79 2e 0a 20 20 20  | neccessary..   |
00004210  20 20 20 20 20 20 20 20  0a 0a 54 68 65 20 72 65  |        ..The re|
00004220  73 74 72 69 63 74 65 64  20 63 6f 6d 6d 61 6e 64  |stricted command|
00004230  73 20 61 72 65 3a 0a 2a  50 6c 61 79 4d 6f 64 2c  |s are:.*PlayMod,|
00004240  20 2a 50 6c 61 79 50 61  75 73 65 2c 20 2a 50 6c  | *PlayPause, *Pl|
00004250  61 79 53 74 61 72 74 2c  20 2a 50 6c 61 79 50 6f  |ayStart, *PlayPo|
00004260  73 2c 20 2a 50 6c 61 79  53 74 65 72 65 6f 2c 20  |s, *PlayStereo, |
00004270  2a 50 6c 61 79 53 74 6f  70 2e 0a 0a 54 68 65 20  |*PlayStop...The |
00004280  72 65 73 74 72 69 63 74  65 64 20 53 57 49 27 73  |restricted SWI's|
00004290  20 61 72 65 3a 20 20 20  20 20 20 20 20 20 20 20  | are:           |
000042a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000042b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 0a  |               .|
000042c0  54 72 61 63 6b 65 72 5f  4c 6f 61 64 2c 20 54 72  |Tracker_Load, Tr|
000042d0  61 63 6b 65 72 5f 4d 65  6d 6f 72 79 4c 6f 61 64  |acker_MemoryLoad|
000042e0  2c 20 54 72 61 63 6b 65  72 5f 50 6c 61 79 2c 20  |, Tracker_Play, |
000042f0  54 72 61 63 6b 65 72 5f  53 74 6f 70 2c 20 54 72  |Tracker_Stop, Tr|
00004300  61 63 6b 65 72 5f 53 74  65 72 65 6f 2c 0a 54 72  |acker_Stereo,.Tr|
00004310  61 63 6b 65 72 5f 53 65  74 50 6f 73 2c 20 54 72  |acker_SetPos, Tr|
00004320  61 63 6b 65 72 5f 50 6c  61 79 4e 6f 74 65 2e 0a  |acker_PlayNote..|
00004330  0a 0a 20 20 20 20 20 20  20 20 20 20 20 0a 0a 2d  |..           ..-|
00004340  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00004380  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 0a 54 72 61  |------------.Tra|
00004390  63 6b 65 72 5f 55 6e 6c  6f 63 6b 20 20 20 20 20  |cker_Unlock     |
000043a0  20 20 20 20 20 20 20 28  53 57 49 20 26 34 33 32  |       (SWI &432|
000043b0  30 45 29 0a 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |0E).------------|
000043c0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00004400  2d 0a 0a 4f 6e 20 45 6e  74 72 79 3a 20 20 52 30  |-..On Entry:  R0|
00004410  20 3d 20 6c 6f 63 6b 69  6e 67 20 63 6f 64 65 20  | = locking code |
00004420  28 73 70 65 63 69 66 69  65 64 20 69 6e 20 54 72  |(specified in Tr|
00004430  61 63 6b 65 72 5f 4c 6f  63 6b 29 0a 0a 4f 6e 20  |acker_Lock)..On |
00004440  45 78 69 74 20 3a 20 20  2d 0a 0a 0a 20 54 68 69  |Exit :  -... Thi|
00004450  73 20 53 57 49 20 73 68  6f 75 6c 64 20 62 65 20  |s SWI should be |
00004460  63 61 6c 6c 65 64 20 74  6f 20 75 6e 6c 6f 63 6b  |called to unlock|
00004470  20 74 68 65 20 6d 6f 64  75 6c 65 20 61 66 74 65  | the module afte|
00004480  72 20 69 74 20 68 61 73  20 62 65 65 6e 20 6c 6f  |r it has been lo|
00004490  63 6b 65 64 20 77 69 74  68 0a 27 54 72 61 63 6b  |cked with.'Track|
000044a0  65 72 5f 4c 6f 63 6b 27  2e 20 49 66 20 74 68 65  |er_Lock'. If the|
000044b0  20 76 61 6c 75 65 20 70  61 73 73 65 64 20 69 6e  | value passed in|
000044c0  20 52 30 20 69 73 20 64  69 66 66 65 72 65 6e 74  | R0 is different|
000044d0  20 74 6f 20 74 68 65 20  6c 6f 63 6b 69 6e 67 20  | to the locking |
000044e0  63 6f 64 65 0a 67 69 76  65 6e 20 69 6e 20 74 68  |code.given in th|
000044f0  65 20 6c 6f 63 6b 20 53  57 49 2c 20 6f 72 20 74  |e lock SWI, or t|
00004500  68 65 20 6d 6f 64 75 6c  65 20 68 61 73 20 6e 6f  |he module has no|
00004510  74 20 62 65 65 6e 20 6c  6f 63 6b 65 64 2c 20 61  |t been locked, a|
00004520  6e 20 65 72 72 6f 72 20  69 73 0a 67 65 6e 65 72  |n error is.gener|
00004530  61 74 65 64 2e 0a 0a 0a  0a 0a 0a 3d 3d 3d 3d 3d  |ated.......=====|
00004540  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00004580  3d 3d 3d 3d 3d 3d 3d 3d  0a 0a 4e 6f 74 65 20 74  |========..Note t|
00004590  72 61 6e 73 6c 61 74 69  6f 6e 20 74 61 62 6c 65  |ranslation table|
000045a0  0a 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
000045b0  2d 2d 2d 2d 2d 2d 2d 0a  0a 54 68 65 20 74 72 61  |-------..The tra|
000045c0  63 6b 65 72 20 66 6f 72  6d 61 74 20 6e 6f 74 65  |cker format note|
000045d0  20 6e 75 6d 62 65 72 73  20 61 6e 64 20 74 68 65  | numbers and the|
000045e0  20 6e 6f 74 65 73 20 74  68 65 79 20 72 65 66 65  | notes they refe|
000045f0  72 20 74 6f 20 61 72 65  20 61 73 20 66 6f 6c 6c  |r to are as foll|
00004600  6f 77 73 3a 0a 0a 6e 6f  2e 20 20 6e 6f 74 65 20  |ows:..no.  note |
00004610  20 20 73 61 6d 70 6c 65  20 70 65 72 69 6f 64 0a  |  sample period.|
00004620  2d 2d 2d 20 20 2d 2d 2d  2d 20 20 20 2d 2d 2d 2d  |---  ----   ----|
00004630  2d 2d 2d 2d 2d 2d 2d 2d  2d 0a 31 20 20 20 20 43  |---------.1    C|
00004640  20 2d 31 20 20 20 26 33  35 38 0a 32 20 20 20 20  | -1   &358.2    |
00004650  43 23 2d 31 20 20 20 26  33 32 38 0a 33 20 20 20  |C#-1   &328.3   |
00004660  20 44 20 2d 31 20 20 20  26 32 46 41 0a 34 20 20  | D -1   &2FA.4  |
00004670  20 20 44 23 2d 31 20 20  20 26 32 44 30 0a 35 20  |  D#-1   &2D0.5 |
00004680  20 20 20 45 20 2d 31 20  20 20 26 32 41 36 0a 36  |   E -1   &2A6.6|
00004690  20 20 20 20 46 20 2d 31  20 20 20 26 32 38 30 0a  |    F -1   &280.|
000046a0  37 20 20 20 20 46 23 2d  31 20 20 20 26 32 35 43  |7    F#-1   &25C|
000046b0  0a 38 20 20 20 20 47 20  2d 31 20 20 20 26 32 33  |.8    G -1   &23|
000046c0  41 0a 39 20 20 20 20 47  23 2d 31 20 20 20 26 32  |A.9    G#-1   &2|
000046d0  31 41 0a 31 30 20 20 20  41 20 2d 31 20 20 20 26  |1A.10   A -1   &|
000046e0  31 46 43 0a 31 31 20 20  20 41 23 2d 31 20 20 20  |1FC.11   A#-1   |
000046f0  26 31 45 30 0a 31 32 20  20 20 42 20 2d 31 20 20  |&1E0.12   B -1  |
00004700  20 26 31 43 35 0a 31 33  20 20 20 43 20 2d 32 20  | &1C5.13   C -2 |
00004710  20 20 26 31 41 43 0a 31  34 20 20 20 43 23 2d 32  |  &1AC.14   C#-2|
00004720  20 20 20 26 31 39 34 0a  31 35 20 20 20 44 20 2d  |   &194.15   D -|
00004730  32 20 20 20 26 31 37 44  0a 31 36 20 20 20 44 23  |2   &17D.16   D#|
00004740  2d 32 20 20 20 26 31 36  38 0a 31 37 20 20 20 45  |-2   &168.17   E|
00004750  20 2d 32 20 20 20 26 31  35 33 0a 31 38 20 20 20  | -2   &153.18   |
00004760  46 20 2d 32 20 20 20 26  31 34 30 0a 31 39 20 20  |F -2   &140.19  |
00004770  20 46 23 2d 32 20 20 20  26 31 32 45 0a 32 30 20  | F#-2   &12E.20 |
00004780  20 20 47 20 2d 32 20 20  20 26 31 31 44 0a 32 31  |  G -2   &11D.21|
00004790  20 20 20 47 23 2d 32 20  20 20 26 31 30 44 0a 32  |   G#-2   &10D.2|
000047a0  32 20 20 20 41 20 2d 32  20 20 20 20 26 46 45 0a  |2   A -2    &FE.|
000047b0  32 33 20 20 20 41 23 2d  32 20 20 20 20 26 46 30  |23   A#-2    &F0|
000047c0  0a 32 34 20 20 20 42 20  2d 32 20 20 20 20 26 45  |.24   B -2    &E|
000047d0  32 0a 32 35 20 20 20 43  20 2d 33 20 20 20 20 26  |2.25   C -3    &|
000047e0  44 36 0a 32 36 20 20 20  43 23 2d 33 20 20 20 20  |D6.26   C#-3    |
000047f0  26 43 41 0a 32 37 20 20  20 44 20 2d 33 20 20 20  |&CA.27   D -3   |
00004800  20 26 42 45 0a 32 38 20  20 20 44 23 2d 33 20 20  | &BE.28   D#-3  |
00004810  20 20 26 42 34 0a 32 39  20 20 20 45 20 2d 33 20  |  &B4.29   E -3 |
00004820  20 20 20 26 41 41 0a 33  30 20 20 20 46 20 2d 33  |   &AA.30   F -3|
00004830  20 20 20 20 26 41 30 0a  33 31 20 20 20 46 23 2d  |    &A0.31   F#-|
00004840  33 20 20 20 20 26 39 37  0a 33 32 20 20 20 47 20  |3    &97.32   G |
00004850  2d 33 20 20 20 20 26 38  46 0a 33 33 20 20 20 47  |-3    &8F.33   G|
00004860  23 2d 33 20 20 20 20 26  38 37 0a 33 34 20 20 20  |#-3    &87.34   |
00004870  41 20 2d 33 20 20 20 20  26 37 46 0a 33 35 20 20  |A -3    &7F.35  |
00004880  20 41 23 2d 33 20 20 20  20 26 37 38 0a 33 36 20  | A#-3    &78.36 |
00004890  20 20 42 20 2d 33 20 20  20 20 26 37 31 0a 0a 0a  |  B -3    &71...|
000048a0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
000048e0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 0a 20 20  |=============.  |
000048f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004900  20 20 20 20 20 20 20 20  20 20 20 20 20 0a 45 72  |             .Er|
00004910  72 6f 72 73 0a 2d 2d 2d  2d 2d 2d 20 20 20 20 20  |rors.------     |
00004920  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00004940  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 0a  |               .|
00004950  0a 54 68 65 20 65 72 72  6f 72 20 6e 75 6d 62 65  |.The error numbe|
00004960  72 73 20 61 6e 64 20 6d  65 73 73 61 67 65 73 20  |rs and messages |
00004970  77 68 69 63 68 20 74 68  65 20 74 72 61 63 6b 65  |which the tracke|
00004980  72 6d 6f 64 75 6c 65 20  6d 61 79 20 67 65 6e 65  |rmodule may gene|
00004990  72 61 74 65 3a 0a 0a 4e  6f 20 74 75 6e 65 20 6c  |rate:..No tune l|
000049a0  6f 61 64 65 64 20 20 20  20 20 20 20 20 28 26 34  |oaded        (&4|
000049b0  33 32 30 30 29 20 2d 20  61 6e 20 6f 70 65 72 61  |3200) - an opera|
000049c0  74 69 6f 6e 20 77 61 73  20 61 74 74 65 6d 70 74  |tion was attempt|
000049d0  65 64 20 77 68 69 63 68  20 72 65 71 75 69 72 65  |ed which require|
000049e0  73 20 61 0a 20 20 20 20  20 20 20 20 20 20 20 20  |s a.            |
000049f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004a00  20 20 20 20 20 74 75 6e  65 20 74 6f 20 62 65 20  |     tune to be |
00004a10  6c 6f 61 64 65 64 20 69  6e 74 6f 20 6d 65 6d 6f  |loaded into memo|
00004a20  72 79 20 62 65 66 6f 72  65 68 61 6e 64 0a 20 20  |ry beforehand.  |
00004a30  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004a40  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 75  |               u|
00004a50  73 69 6e 67 20 2a 50 6c  61 79 4d 6f 64 20 6f 72  |sing *PlayMod or|
00004a60  20 53 57 49 20 54 72 61  63 6b 65 72 5f 4c 6f 61  | SWI Tracker_Loa|
00004a70  64 2e 0a 0a 53 65 71 75  65 6e 63 65 20 70 6f 73  |d...Sequence pos|
00004a80  69 74 69 6f 6e 20 6f 75  74 20 6f 66 20 72 61 6e  |ition out of ran|
00004a90  67 65 20 2d 20 54 68 65  20 73 65 71 75 65 6e 63  |ge - The sequenc|
00004aa0  65 20 70 6f 73 69 74 69  6f 6e 20 67 69 76 65 6e  |e position given|
00004ab0  20 77 69 74 68 20 2a 50  6c 61 79 50 6f 73 0a 20  | with *PlayPos. |
00004ac0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004ad0  20 20 20 20 20 28 26 34  33 32 30 31 29 20 20 20  |     (&43201)   |
00004ae0  6f 72 20 53 57 49 20 54  72 61 63 6b 65 72 5f 53  |or SWI Tracker_S|
00004af0  65 74 50 6f 73 20 77 61  73 20 68 69 67 68 65 72  |etPos was higher|
00004b00  20 74 68 61 6e 20 74 68  65 0a 20 20 20 20 20 20  | than the.      |
00004b10  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004b20  20 20 20 20 20 20 20 20  20 20 20 61 63 74 75 61  |           actua|
00004b30  6c 20 6e 75 6d 62 65 72  20 6f 66 20 70 61 74 74  |l number of patt|
00004b40  65 72 6e 73 20 69 6e 20  74 68 65 20 73 6f 6e 67  |erns in the song|
00004b50  2e 0a 0a 4e 6f 20 72 6f  6f 6d 20 66 6f 72 20 6d  |...No room for m|
00004b60  6f 64 75 6c 65 20 20 20  20 28 26 34 33 32 30 32  |odule    (&43202|
00004b70  29 20 2d 20 54 68 65 20  74 72 61 63 6b 65 72 6d  |) - The trackerm|
00004b80  6f 64 75 6c 65 20 63 6f  75 6c 64 20 6e 6f 74 20  |odule could not |
00004b90  63 6c 61 69 6d 20 65 6e  6f 75 67 68 0a 20 20 20  |claim enough.   |
00004ba0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004bb0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 52 4d  |              RM|
00004bc0  41 20 77 6f 72 6b 73 70  61 63 65 20 74 6f 20 6c  |A workspace to l|
00004bd0  6f 61 64 20 74 68 65 20  6d 6f 64 75 6c 65 2e 20  |oad the module. |
00004be0  54 6f 20 67 65 74 0a 20  20 20 20 20 20 20 20 20  |To get.         |
00004bf0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004c00  20 20 20 20 20 20 20 20  6d 6f 72 65 20 6d 65 6d  |        more mem|
00004c10  6f 72 79 2c 20 71 75 69  74 20 62 61 73 69 63 20  |ory, quit basic |
00004c20  74 6f 20 74 68 65 20 73  75 70 65 72 76 69 73 6f  |to the superviso|
00004c30  72 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |r.              |
00004c40  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004c50  20 20 20 70 72 6f 6d 70  74 2c 20 61 6e 64 20 72  |   prompt, and r|
00004c60  65 74 72 79 2e 20 49 66  20 79 6f 75 20 61 72 65  |etry. If you are|
00004c70  20 75 73 69 6e 67 20 74  68 65 0a 20 20 20 20 20  | using the.     |
00004c80  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004c90  20 20 20 20 20 20 20 20  20 20 20 20 64 65 73 6b  |            desk|
00004ca0  74 6f 70 20 69 6e 73 74  65 61 64 2c 20 72 65 6d  |top instead, rem|
00004cb0  6f 76 65 20 61 6e 20 61  70 70 6c 69 63 61 74 69  |ove an applicati|
00004cc0  6f 6e 20 61 6e 64 0a 20  20 20 20 20 20 20 20 20  |on and.         |
00004cd0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004ce0  20 20 20 20 20 20 20 20  72 65 74 72 79 2e 0a 0a  |        retry...|
00004cf0  43 68 61 6e 6e 65 6c 20  6e 75 6d 62 65 72 20 6f  |Channel number o|
00004d00  75 74 20 6f 66 20 72 61  6e 67 65 20 20 20 20 2d  |ut of range    -|
00004d10  20 54 68 65 20 73 6f 75  6e 64 20 63 68 61 6e 6e  | The sound chann|
00004d20  65 6c 20 6e 75 6d 62 65  72 20 77 61 73 20 6e 6f  |el number was no|
00004d30  74 20 61 20 76 61 6c 75  65 0a 20 20 20 20 20 20  |t a value.      |
00004d40  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004d50  28 26 34 33 32 30 33 29  20 20 20 62 65 74 77 65  |(&43203)   betwe|
00004d60  65 6e 20 31 20 61 6e 64  20 74 68 65 20 6e 75 6d  |en 1 and the num|
00004d70  62 65 72 20 6f 66 20 73  6f 75 6e 64 20 63 68 61  |ber of sound cha|
00004d80  6e 6e 65 6c 73 0a 20 20  20 20 20 20 20 20 20 20  |nnels.          |
00004d90  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004da0  20 20 20 20 20 20 20 75  73 65 64 20 66 6f 72 20  |       used for |
00004db0  74 68 61 74 20 70 61 72  74 69 63 75 6c 61 72 20  |that particular |
00004dc0  74 75 6e 65 2e 0a 0a 4e  6f 74 65 20 6e 75 6d 62  |tune...Note numb|
00004dd0  65 72 20 6f 75 74 20 6f  66 20 72 61 6e 67 65 20  |er out of range |
00004de0  20 20 20 20 20 20 2d 20  54 68 65 20 6e 6f 74 65  |      - The note|
00004df0  20 6e 75 6d 62 65 72 20  77 61 73 20 6e 6f 74 20  | number was not |
00004e00  77 69 74 68 69 6e 20 74  68 65 20 72 61 6e 67 65  |within the range|
00004e10  20 6f 66 0a 20 20 20 20  20 20 20 20 20 20 20 20  | of.            |
00004e20  20 20 20 20 20 20 20 20  20 20 28 26 34 33 32 30  |          (&4320|
00004e30  35 29 20 20 20 31 2d 33  36 2e 0a 0a 53 61 6d 70  |5)   1-36...Samp|
00004e40  6c 65 20 6e 75 6d 62 65  72 20 6f 75 74 20 6f 66  |le number out of|
00004e50  20 72 61 6e 67 65 20 20  20 20 20 2d 20 54 68 65  | range     - The|
00004e60  20 73 61 6d 70 6c 65 20  6e 75 6d 62 65 72 20 77  | sample number w|
00004e70  61 73 20 6e 6f 74 20 77  69 74 68 69 6e 20 74 68  |as not within th|
00004e80  65 20 72 61 6e 67 65 0a  20 20 20 20 20 20 20 20  |e range.        |
00004e90  20 20 20 20 20 20 20 20  20 20 20 20 20 20 28 26  |              (&|
00004ea0  34 33 32 30 34 29 20 20  20 6f 66 20 31 2d 33 36  |43204)   of 1-36|
00004eb0  2e 0a 0a 56 6f 6c 75 6d  65 20 6f 75 74 20 6f 66  |...Volume out of|
00004ec0  20 72 61 6e 67 65 20 20  20 28 26 34 33 32 30 36  | range   (&43206|
00004ed0  29 20 2d 20 54 68 65 20  76 6f 6c 75 6d 65 20 77  |) - The volume w|
00004ee0  61 73 20 6e 6f 74 20 77  69 74 68 69 6e 20 74 68  |as not within th|
00004ef0  65 20 72 61 6e 67 65 20  6f 66 20 30 2d 32 35 35  |e range of 0-255|
00004f00  0a 0a 4d 6f 64 75 6c 65  20 61 6c 72 65 61 64 79  |..Module already|
00004f10  20 6c 6f 63 6b 65 64 20  28 26 34 33 32 30 37 29  | locked (&43207)|
00004f20  20 2d 20 54 72 61 63 6b  65 72 5f 4c 6f 63 6b 20  | - Tracker_Lock |
00004f30  77 61 73 20 63 61 6c 6c  65 64 20 77 68 65 6e 20  |was called when |
00004f40  74 68 65 20 6d 6f 64 75  6c 65 0a 20 20 20 20 20  |the module.     |
00004f50  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004f60  20 20 20 20 20 20 20 20  20 20 20 20 77 61 73 20  |            was |
00004f70  61 6c 72 65 61 64 79 20  6c 6f 63 6b 65 64 2e 20  |already locked. |
00004f80  54 68 65 20 6d 6f 64 75  6c 65 20 63 61 6e 20 6f  |The module can o|
00004f90  6e 6c 79 20 62 65 0a 20  20 20 20 20 20 20 20 20  |nly be.         |
00004fa0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004fb0  20 20 20 20 20 20 20 20  75 6e 6c 6f 63 6b 65 64  |        unlocked|
00004fc0  20 77 68 65 6e 20 74 68  65 20 61 70 70 6c 69 63  | when the applic|
00004fd0  61 74 69 6f 6e 20 69 6e  20 63 6f 6e 74 72 6f 6c  |ation in control|
00004fe0  20 6f 66 0a 20 20 20 20  20 20 20 20 20 20 20 20  | of.            |
00004ff0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00005000  20 20 20 20 20 74 68 65  20 6d 6f 64 75 6c 65 20  |     the module |
00005010  69 73 73 75 65 73 20 61  20 54 72 61 63 6b 65 72  |issues a Tracker|
00005020  5f 55 6e 6c 6f 63 6b 20  53 57 49 2e 0a 0a 55 6e  |_Unlock SWI...Un|
00005030  6c 6f 63 6b 20 66 61 69  6c 65 64 20 20 20 20 20  |lock failed     |
00005040  20 20 20 20 28 26 34 33  32 30 38 29 20 2d 20 54  |    (&43208) - T|
00005050  72 61 63 6b 65 72 5f 55  6e 6c 6f 63 6b 20 77 61  |racker_Unlock wa|
00005060  73 20 63 61 6c 6c 65 64  20 62 75 74 20 65 69 74  |s called but eit|
00005070  68 65 72 0a 20 20 20 20  20 20 20 20 20 20 20 20  |her.            |
00005080  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00005090  20 20 20 20 20 74 68 65  20 77 72 6f 6e 67 20 6c  |     the wrong l|
000050a0  6f 63 6b 69 6e 67 20 63  6f 64 65 20 77 61 73 20  |ocking code was |
000050b0  73 70 65 63 69 66 69 65  64 2c 20 6f 72 0a 20 20  |specified, or.  |
000050c0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000050d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 74  |               t|
000050e0  68 65 20 6d 6f 64 75 6c  65 20 77 61 73 20 6e 6f  |he module was no|
000050f0  74 20 6c 6f 63 6b 65 64  20 61 74 20 74 68 65 20  |t locked at the |
00005100  74 69 6d 65 2e 0a 0a 54  72 61 63 6b 65 72 4d 6f  |time...TrackerMo|
00005110  64 75 6c 65 20 69 6e 20  75 73 65 20 20 28 26 34  |dule in use  (&4|
00005120  33 32 30 39 29 20 2d 20  41 6e 20 61 74 74 65 6d  |3209) - An attem|
00005130  70 74 20 77 61 73 20 6d  61 64 65 20 74 6f 20 65  |pt was made to e|
00005140  78 65 63 75 74 65 20 6f  6e 65 20 6f 66 20 74 68  |xecute one of th|
00005150  65 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |e.              |
00005160  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00005170  20 20 20 72 65 73 74 72  69 63 74 65 64 20 63 6f  |   restricted co|
00005180  6d 6d 61 6e 64 73 20 6f  72 20 53 57 49 27 73 20  |mmands or SWI's |
00005190  77 68 69 6c 65 20 74 68  65 0a 20 20 20 20 20 20  |while the.      |
000051a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000051b0  20 20 20 20 20 20 20 20  20 20 20 6d 6f 64 75 6c  |           modul|
000051c0  65 20 77 61 73 20 6c 6f  63 6b 65 64 20 28 73 65  |e was locked (se|
000051d0  65 20 54 72 61 63 6b 65  72 5f 4c 6f 63 6b 29 0a  |e Tracker_Lock).|
000051e0  0a 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |.===============|
000051f0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00005220  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 0a 0a  |==============..|
00005230  0a 54 68 69 73 20 6d 6f  64 75 6c 65 20 77 61 73  |.This module was|
00005240  20 77 72 69 74 74 65 6e  20 66 6f 72 20 65 6e 74  | written for ent|
00005250  68 75 73 69 61 73 74 73  20 77 68 6f 20 77 69 73  |husiasts who wis|
00005260  68 20 74 6f 20 65 6e 6a  6f 79 20 74 68 65 20 62  |h to enjoy the b|
00005270  65 6e 65 66 69 74 73 20  6f 66 20 74 68 65 0a 41  |enefits of the.A|
00005280  72 63 68 69 6d 65 64 65  73 20 73 6f 75 6e 64 20  |rchimedes sound |
00005290  73 79 73 74 65 6d 20 69  6e 20 61 20 6d 75 6c 74  |system in a mult|
000052a0  69 2d 74 61 73 6b 69 6e  67 20 65 6e 76 69 72 6f  |i-tasking enviro|
000052b0  6e 6d 65 6e 74 2e 0a 46  65 65 6c 20 66 72 65 65  |nment..Feel free|
000052c0  20 74 6f 20 75 73 65 20  74 68 69 73 20 6d 6f 64  | to use this mod|
000052d0  75 6c 65 20 69 6e 20 61  6e 79 20 70 2e 64 2e 20  |ule in any p.d. |
000052e0  64 65 6d 6f 73 20 6f 72  20 70 72 6f 67 72 61 6d  |demos or program|
000052f0  73 20 65 74 63 2e 2c 20  62 75 74 20 66 6f 72 20  |s etc., but for |
00005300  61 6e 79 0a 63 6f 6d 6d  65 72 63 69 61 6c 20 75  |any.commercial u|
00005310  73 65 2c 20 70 6c 65 61  73 65 20 61 73 6b 20 48  |se, please ask H|
00005320  75 67 6f 20 46 69 65 6e  6e 65 73 20 66 6f 72 20  |ugo Fiennes for |
00005330  70 65 72 6d 69 73 73 69  6f 6e 2e 20 28 41 6e 64  |permission. (And|
00005340  20 75 70 6c 6f 61 64 20  61 6e 79 20 64 65 6d 6f  | upload any demo|
00005350  73 0a 74 6f 20 68 69 73  20 62 6f 61 72 64 20 5b  |s.to his board [|
00005360  73 65 65 20 62 65 6c 6f  77 5d 29 0a 0a 56 65 72  |see below])..Ver|
00005370  73 69 6f 6e 73 20 30 2e  30 30 20 74 6f 20 31 2e  |sions 0.00 to 1.|
00005380  78 78 20 6f 66 20 74 68  65 20 6f 72 69 67 69 6e  |xx of the origin|
00005390  61 6c 20 6d 6f 64 75 6c  65 20 77 65 72 65 20 77  |al module were w|
000053a0  72 69 74 74 65 6e 20 62  79 20 48 75 67 6f 20 46  |ritten by Hugo F|
000053b0  69 65 6e 6e 65 73 0a 20  20 20 20 20 20 20 20 20  |iennes.         |
000053c0  20 20 20 20 20 20 20 20  20 20 20 20 20 61 6c 6c  |             all|
000053d0  6f 77 69 6e 67 20 74 68  65 20 70 6c 61 79 69 6e  |owing the playin|
000053e0  67 20 6f 66 20 61 6e 79  20 73 6f 75 6e 64 74 72  |g of any soundtr|
000053f0  61 63 6b 65 72 20 74 75  6e 65 73 2e 0a 56 65 72  |acker tunes..Ver|
00005400  73 69 6f 6e 73 20 32 2e  30 30 20 74 6f 20 32 2e  |sions 2.00 to 2.|
00005410  78 78 20 77 65 72 65 20  77 72 69 74 74 65 6e 20  |xx were written |
00005420  62 79 20 46 61 62 72 69  63 65 20 4d 65 72 63 69  |by Fabrice Merci|
00005430  65 72 20 61 6e 64 20 48  75 67 6f 2c 0a 20 20 20  |er and Hugo,.   |
00005440  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00005450  20 20 20 70 6c 61 79 69  6e 67 20 61 6e 79 20 74  |   playing any t|
00005460  72 61 63 6b 65 72 20 74  75 6e 65 73 20 28 77 69  |racker tunes (wi|
00005470  74 68 20 63 68 61 6e 67  65 73 2f 69 6d 70 72 6f  |th changes/impro|
00005480  76 65 6d 65 6e 74 73 29  2e 0a 56 65 72 73 69 6f  |vements)..Versio|
00005490  6e 73 20 33 2e 30 30 20  74 6f 20 34 2e 30 30 20  |ns 3.00 to 4.00 |
000054a0  77 65 72 65 20 77 72 69  74 74 65 6e 20 28 77 65  |were written (we|
000054b0  6c 6c 2c 20 65 78 74 65  6e 64 65 64 29 20 62 79  |ll, extended) by|
000054c0  20 4d 61 74 74 68 65 77  20 46 61 72 72 6f 77 0a  | Matthew Farrow.|
000054d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000054e0  20 20 20 20 20 20 74 6f  20 61 6c 6c 6f 77 20 74  |      to allow t|
000054f0  68 65 20 70 6c 61 79 69  6e 67 20 6f 66 20 73 6f  |he playing of so|
00005500  75 6e 64 74 72 61 63 6b  65 72 20 6f 72 20 74 72  |undtracker or tr|
00005510  61 63 6b 65 72 20 74 75  6e 65 73 2c 0a 20 20 20  |acker tunes,.   |
00005520  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00005530  20 20 20 77 69 74 68 20  74 68 65 20 53 57 49 20  |   with the SWI |
00005540  65 78 74 65 6e 73 69 6f  6e 20 66 72 6f 6d 20 76  |extension from v|
00005550  65 72 73 69 6f 6e 73 20  34 2e 30 30 20 6f 6e 77  |ersions 4.00 onw|
00005560  61 72 64 73 2e 0a 0a 59  6f 75 20 63 61 6e 20 63  |ards...You can c|
00005570  6f 6e 74 61 63 74 20 48  75 67 6f 20 69 6e 20 74  |ontact Hugo in t|
00005580  68 65 20 66 6f 6c 6c 6f  77 69 6e 67 20 77 61 79  |he following way|
00005590  73 3a 0a 56 6f 69 63 65  3a 20 55 4b 20 28 30 37  |s:.Voice: UK (07|
000055a0  34 39 29 20 37 32 32 33  34 20 28 61 73 6b 20 66  |49) 72234 (ask f|
000055b0  6f 72 20 48 75 67 6f 29  0a 56 6f 64 61 46 6f 6e  |or Hugo).VodaFon|
000055c0  65 3a 20 28 30 38 33 31  29 20 34 34 34 31 39 32  |e: (0831) 444192|
000055d0  0a 54 68 65 20 57 6f 72  6c 64 20 6f 66 20 43 72  |.The World of Cr|
000055e0  79 74 6f 6e 20 28 62 62  73 29 20 3a 20 55 4b 20  |yton (bbs) : UK |
000055f0  28 30 37 34 39 29 20 36  37 39 37 39 34 20 28 33  |(0749) 679794 (3|
00005600  30 30 2d 32 34 30 30 20  2d 20 31 20 6c 69 6e 65  |00-2400 - 1 line|
00005610  29 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |).              |
00005620  20 20 20 20 20 20 20 20  20 20 20 20 3a 20 55 4b  |            : UK|
00005630  20 28 30 37 34 39 29 20  36 37 30 30 33 30 20 28  | (0749) 670030 (|
00005640  33 30 30 2d 48 53 54 2f  56 33 32 20 2d 20 32 20  |300-HST/V32 - 2 |
00005650  6c 69 6e 65 73 29 0a 4d  61 69 6c 3a 20 50 72 65  |lines).Mail: Pre|
00005660  73 74 65 6c 20 30 34 35  38 34 37 36 30 38 2c 20  |stel 045847608, |
00005670  43 49 58 20 61 6c 74 6d  61 6e 0a 42 75 72 63 6f  |CIX altman.Burco|
00005680  74 74 20 4d 61 6e 6f 72  2c 20 57 65 6c 6c 73 2c  |tt Manor, Wells,|
00005690  20 53 6f 6d 65 72 73 65  74 2c 20 42 41 35 20 31  | Somerset, BA5 1|
000056a0  4e 48 2c 20 55 4b 0a 0a  4d 61 74 74 20 46 61 72  |NH, UK..Matt Far|
000056b0  72 6f 77 3a 0a 4d 61 69  6c 3a 20 50 72 65 73 74  |row:.Mail: Prest|
000056c0  65 6c 20 38 31 36 37 30  36 37 35 38 2c 20 41 72  |el 816706758, Ar|
000056d0  63 61 64 65 20 62 62 73  20 28 30 38 31 2d 36 35  |cade bbs (081-65|
000056e0  34 20 32 32 31 32 29 20  61 73 20 27 4d 61 74 74  |4 2212) as 'Matt|
000056f0  68 65 77 20 46 61 72 72  6f 77 27 0a 34 35 20 41  |hew Farrow'.45 A|
00005700  6c 6c 65 79 6e 20 50 61  72 6b 2c 20 44 75 6c 77  |lleyn Park, Dulw|
00005710  69 63 68 2c 20 4c 6f 6e  64 6f 6e 20 53 45 32 31  |ich, London SE21|
00005720  20 38 41 54 0a 0a 0a 3d  3d 3d 3d 3d 3d 3d 3d 3d  | 8AT...=========|
00005730  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00005770  3d 3d 3d 3d 0a 0a 55 70  64 61 74 65 73 0a 2d 2d  |====..Updates.--|
00005780  2d 2d 2d 2d 2d 0a 56 65  72 73 69 6f 6e 20 34 2e  |-----.Version 4.|
00005790  30 30 20 28 66 72 6f 6d  20 33 2e 30 34 29 0a 20  |00 (from 3.04). |
000057a0  20 20 2d 20 53 57 49 20  69 6e 74 65 72 66 61 63  |  - SWI interfac|
000057b0  65 20 61 64 64 65 64 2e  0a 20 20 20 2d 20 56 6f  |e added..   - Vo|
000057c0  6c 75 6d 65 20 74 72 61  6e 73 6c 61 74 69 6f 6e  |lume translation|
000057d0  73 20 66 6f 72 20 73 6f  75 6e 64 74 72 61 63 6b  |s for soundtrack|
000057e0  65 72 20 6d 6f 64 75 6c  65 73 20 70 65 72 66 6f  |er modules perfo|
000057f0  72 6d 65 64 20 63 6f 72  72 65 63 74 6c 79 20 6e  |rmed correctly n|
00005800  6f 77 20 28 3f 29 0a 20  20 20 2d 20 4c 6f 63 6b  |ow (?).   - Lock|
00005810  69 6e 67 20 73 79 73 74  65 6d 20 69 6e 74 72 6f  |ing system intro|
00005820  64 75 63 65 64 0a 20 20  20 2d 20 4e 65 78 74 20  |duced.   - Next |
00005830  70 61 74 74 65 72 6e 20  6c 69 6e 65 20 70 6c 61  |pattern line pla|
00005840  79 65 64 20 6a 75 73 74  20 61 66 74 65 72 20 70  |yed just after p|
00005850  61 74 74 65 72 6e 20 70  6f 73 69 74 69 6f 6e 20  |attern position |
00005860  69 6e 63 72 65 6d 65 6e  74 65 64 2c 20 6e 6f 74  |incremented, not|
00005870  0a 20 20 20 20 20 6a 75  73 74 20 62 65 66 6f 72  |.     just befor|
00005880  65 20 28 73 6f 20 74 68  65 20 70 6f 73 69 74 69  |e (so the positi|
00005890  6f 6e 20 64 6f 65 73 6e  27 74 20 61 70 70 65 61  |on doesn't appea|
000058a0  72 20 74 6f 20 62 65 20  61 68 65 61 64 20 6f 66  |r to be ahead of|
000058b0  20 74 68 65 20 6d 75 73  69 63 29 2e 0a 20 20 20  | the music)..   |
000058c0  2d 20 52 65 6d 6f 76 61  6c 20 6f 66 20 6d 6f 72  |- Removal of mor|
000058d0  65 20 6d 69 6e 6f 72 20  62 75 67 73 2e 2e        |e minor bugs..|
000058de