Home » Personal collection » Acorn hard disk » apps » sound » !S.Tracker/STDocs4.07 » Compare

Compare !S.Tracker/STDocs4.07 with Music/!S_Tracker/!Help

File: Personal collection » Acorn hard disk » apps » sound » !S.Tracker/STDocs4.07
Compared with: Archimedes archive » Micro User » MU 1991-10.adf » PD-Stuff » Music/!S_Tracker/!Help
Similarity: 68% of bytes duplicated

68.2% 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.

!S.Tracker/STDocs4.07
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  37 20 28 32 34 20 4a 61  |sion 4.07 (24 Ja|
00000080  6e 20 31 39 39 31 29 0a  0a 4f 72 69 67 69 6e 61  |n 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 70  69 74 63 68 20 74 6f 20  |es the pitch to |
00007810  72 69 73 65 20 61 6e 64  20 66 61 6c 6c 20 69 6e  |rise and fall in|
00007820  20 61 20 77 61 72 62 6c  69 6e 67 20 65 66 66 65  | a warbling effe|
00007830  63 74 2e 0a 20 20 20 20  20 20 20 20 20 20 20 20  |ct..            |
00007840  20 20 20 54 68 65 20 66  69 72 73 74 20 64 69 67  |   The first dig|
00007850  69 74 20 67 69 76 65 73  20 74 68 65 20 73 70 65  |it gives the spe|
00007860  65 64 20 6f 66 20 74 68  65 20 70 69 74 63 68 20  |ed of the pitch |
00007870  63 68 61 6e 67 65 20 28  31 3d 73 6c 6f 77 2c 0a  |change (1=slow,.|
00007880  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 26  |               &|
00007890  46 3d 66 61 73 74 29 2c  20 61 6e 64 20 74 68 65  |F=fast), and the|
000078a0  20 73 65 63 6f 6e 64 20  64 69 67 69 74 20 67 69  | second digit gi|
000078b0  76 65 73 20 74 68 65 20  6d 61 67 6e 69 74 75 64  |ves the magnitud|
000078c0  65 20 6f 66 20 74 68 65  0a 20 20 20 20 20 20 20  |e of the.       |
000078d0  20 20 20 20 20 20 20 20  76 69 62 72 61 74 6f 2e  |        vibrato.|
000078e0  20 54 68 65 20 76 69 62  72 61 74 6f 20 69 73 20  | The vibrato is |
000078f0  63 72 65 61 74 65 64 20  62 79 20 61 6c 74 65 72  |created by alter|
00007900  69 6e 67 20 74 68 65 20  70 69 74 63 68 20 6f 66  |ing the pitch of|
00007910  20 74 68 65 0a 20 20 20  20 20 20 20 20 20 20 20  | the.           |
00007920  20 20 20 20 63 68 61 6e  6e 65 6c 20 62 79 20 61  |    channel by a|
00007930  20 73 69 6e 75 73 6f 69  64 61 6c 6c 79 20 76 61  | sinusoidally va|
00007940  72 79 69 6e 67 20 61 6d  6f 75 6e 74 20 28 2d 76  |rying amount (-v|
00007950  65 20 61 6e 64 20 2b 76  65 29 2e 0a 20 35 2c 36  |e and +ve).. 5,6|
00007960  2c 37 20 28 61 6d 69 67  61 29 20 20 43 6f 6d 62  |,7 (amiga)  Comb|
00007970  69 6e 61 74 69 6f 6e 73  20 6f 66 20 74 68 65 20  |inations of the |
00007980  76 6f 6c 75 6d 65 20 61  6e 64 20 70 69 74 63 68  |volume and pitch|
00007990  20 73 6c 69 64 65 73 20  28 4e 6f 74 20 69 6d 70  | slides (Not imp|
000079a0  6c 65 6d 65 6e 74 65 64  29 0a 20 39 20 28 61 6d  |lemented). 9 (am|
000079b0  69 67 61 20 6f 6e 6c 79  29 20 53 65 74 20 73 61  |iga only) Set sa|
000079c0  6d 70 6c 65 20 6f 66 66  73 65 74 20 28 4e 6f 74  |mple offset (Not|
000079d0  20 69 6d 70 6c 65 6d 65  6e 74 65 64 29 2e 0a 20  | implemented).. |
000079e0  41 20 28 61 6d 69 67 61  29 20 20 20 20 20 56 6f  |A (amiga)     Vo|
000079f0  6c 75 6d 65 20 73 6c 69  64 65 20 2d 0a 20 20 20  |lume slide -.   |
00007a00  20 20 20 20 20 20 20 20  20 20 20 20 49 66 20 74  |            If t|
00007a10  68 65 20 66 69 72 73 74  20 6e 69 62 62 6c 65 20  |he first nibble |
00007a20  69 73 20 6e 6f 6e 2d 7a  65 72 6f 2c 20 61 64 64  |is non-zero, add|
00007a30  20 74 68 69 73 20 76 61  6c 75 65 20 74 6f 20 74  | this value to t|
00007a40  68 65 20 63 75 72 72 65  6e 74 0a 20 20 20 20 20  |he current.     |
00007a50  20 20 20 20 20 20 20 20  20 20 76 6f 6c 75 6d 65  |          volume|
00007a60  20 65 76 65 72 79 20 76  73 79 6e 63 2c 20 65 6c  | every vsync, el|
00007a70  73 65 20 73 75 62 74 72  61 63 74 20 74 68 65 20  |se subtract the |
00007a80  73 65 63 6f 6e 64 20 6e  69 62 62 6c 65 20 69 6e  |second nibble in|
00007a90  20 61 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  | a.             |
00007aa0  20 20 73 69 6d 69 6c 61  72 20 66 61 73 68 69 6f  |  similar fashio|
00007ab0  6e 2e 0a 20 47 2c 20 48  20 28 54 72 61 63 6b 65  |n.. G, H (Tracke|
00007ac0  72 29 20 56 6f 6c 75 6d  65 20 73 6c 69 64 65 20  |r) Volume slide |
00007ad0  75 70 2c 20 64 6f 77 6e  20 2d 0a 20 20 20 20 20  |up, down -.     |
00007ae0  20 20 20 20 20 20 20 20  20 20 54 68 65 73 65 20  |          These |
00007af0  63 6f 6d 6d 61 6e 64 73  20 61 72 65 20 74 68 65  |commands are the|
00007b00  20 73 61 6d 65 20 61 73  20 74 68 65 20 41 20 63  | same as the A c|
00007b10  6f 6d 6d 61 6e 64 20 6f  6e 20 74 68 65 20 61 6d  |ommand on the am|
00007b20  69 67 61 2c 20 62 75 74  0a 20 20 20 20 20 20 20  |iga, but.       |
00007b30  20 20 20 20 20 20 20 20  74 61 6b 65 20 61 20 62  |        take a b|
00007b40  79 74 65 20 70 61 72 61  6d 65 74 65 72 2e 0a 20  |yte parameter.. |
00007b50  42 20 28 61 6d 69 67 61  29 2c 20 4a 20 28 54 72  |B (amiga), J (Tr|
00007b60  61 63 6b 65 72 29 20 20  50 6f 73 69 74 69 6f 6e  |acker)  Position|
00007b70  20 6a 75 6d 70 20 2d 0a  20 20 20 20 20 20 20 20  | jump -.        |
00007b80  20 20 20 20 20 20 20 57  68 65 6e 20 74 68 69 73  |       When this|
00007b90  20 63 6f 6d 6d 61 6e 64  20 69 73 20 6d 65 74 2c  | command is met,|
00007ba0  20 6a 75 6d 70 20 74 6f  20 70 6f 73 69 74 69 6f  | jump to positio|
00007bb0  6e 20 3c 70 61 72 61 6d  65 74 65 72 3e 20 69 6e  |n <parameter> in|
00007bc0  20 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  | .              |
00007bd0  20 73 6f 6e 67 2e 0a 20  42 20 28 54 72 61 63 6b  | song.. B (Track|
00007be0  65 72 29 20 42 72 65 61  6b 20 70 61 74 74 65 72  |er) Break patter|
00007bf0  6e 20 2d 0a 20 20 20 20  20 20 20 20 20 20 20 20  |n -.            |
00007c00  20 20 20 3d 61 6d 69 67  61 20 63 6f 6d 6d 61 6e  |   =amiga comman|
00007c10  64 20 44 0a 20 43 20 28  61 6d 69 67 61 29 2c 20  |d D. C (amiga), |
00007c20  56 20 28 54 72 61 63 6b  65 72 29 20 20 53 65 74  |V (Tracker)  Set|
00007c30  20 76 6f 6c 75 6d 65 20  2d 0a 20 20 20 20 20 20  | volume -.      |
00007c40  20 20 20 20 20 20 20 20  20 41 6c 74 65 72 73 20  |         Alters |
00007c50  74 68 65 20 63 75 72 72  65 6e 74 20 76 6f 6c 75  |the current volu|
00007c60  6d 65 20 6f 66 20 74 68  65 20 63 68 61 6e 6e 65  |me of the channe|
00007c70  6c 20 74 6f 20 74 68 65  20 76 61 6c 75 65 20 73  |l to the value s|
00007c80  70 65 63 2d 0a 20 20 20  20 20 20 20 20 20 20 20  |pec-.           |
00007c90  20 20 20 20 69 66 69 65  64 20 28 30 2d 36 34 20  |    ified (0-64 |
00007ca0  61 6d 69 67 61 2c 20 30  2d 32 35 35 20 61 72 63  |amiga, 0-255 arc|
00007cb0  29 2e 20 56 6f 6c 75 6d  65 20 30 20 6d 65 61 6e  |). Volume 0 mean|
00007cc0  73 20 6d 75 74 65 20 73  6f 75 6e 64 2e 0a 20 44  |s mute sound.. D|
00007cd0  20 28 61 6d 69 67 61 29  2c 20 42 20 28 54 72 61  | (amiga), B (Tra|
00007ce0  63 6b 65 72 29 20 20 42  72 65 61 6b 20 70 61 74  |cker)  Break pat|
00007cf0  74 65 72 6e 20 2d 0a 20  20 20 20 20 20 20 20 20  |tern -.         |
00007d00  20 20 20 20 20 20 57 68  65 6e 20 74 68 69 73 20  |      When this |
00007d10  63 6f 6d 6d 61 6e 64 20  69 73 20 65 6e 63 6f 75  |command is encou|
00007d20  6e 74 65 72 65 64 2c 20  74 68 65 20 70 61 74 74  |ntered, the patt|
00007d30  65 72 6e 20 69 73 20 65  6e 64 65 64 2c 20 61 6e  |ern is ended, an|
00007d40  64 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |d.              |
00007d50  20 74 68 65 20 6e 65 78  74 20 70 61 74 74 65 72  | the next patter|
00007d60  6e 20 6a 75 6d 70 65 64  20 74 6f 2e 0a 20 45 20  |n jumped to.. E |
00007d70  28 61 6d 69 67 61 29 20  20 20 56 61 72 69 6f 75  |(amiga)   Variou|
00007d80  73 20 63 6f 6d 6d 61 6e  64 73 20 28 69 65 2e 20  |s commands (ie. |
00007d90  68 2f 77 20 66 69 6c 74  65 72 20 63 6f 6d 6d 61  |h/w filter comma|
00007da0  6e 64 73 29 20 5b 4e 6f  74 20 69 6d 70 6c 65 6d  |nds) [Not implem|
00007db0  65 6e 74 65 64 5d 2e 0a  20 45 20 28 54 72 61 63  |ented].. E (Trac|
00007dc0  6b 65 72 29 20 53 65 74  20 73 74 65 72 65 6f 20  |ker) Set stereo |
00007dd0  2d 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |-.              |
00007de0  20 53 65 74 20 74 68 65  20 73 74 65 72 65 6f 20  | Set the stereo |
00007df0  70 6f 73 69 74 69 6f 6e  20 28 31 2d 37 29 20 6f  |position (1-7) o|
00007e00  66 20 74 68 65 20 63 75  72 72 65 6e 74 20 73 6f  |f the current so|
00007e10  75 6e 64 20 63 68 61 6e  6e 65 6c 0a 20 20 20 20  |und channel.    |
00007e20  20 20 20 20 20 20 20 20  20 20 20 28 31 2d 38 29  |           (1-8)|
00007e30  2e 0a 20 46 20 28 61 6d  69 67 61 29 2c 20 53 20  |.. F (amiga), S |
00007e40  28 54 72 61 63 6b 65 72  29 20 20 53 65 74 20 73  |(Tracker)  Set s|
00007e50  70 65 65 64 20 2d 0a 20  20 20 20 20 20 20 20 20  |peed -.         |
00007e60  20 20 20 20 20 20 53 65  74 73 20 74 68 65 20 73  |      Sets the s|
00007e70  70 65 65 64 20 28 6e 75  6d 62 65 72 20 6f 66 20  |peed (number of |
00007e80  76 73 79 6e 63 73 20 62  65 74 77 65 65 6e 20 65  |vsyncs between e|
00007e90  76 65 6e 74 73 29 20 74  6f 20 3c 70 61 72 61 6d  |vents) to <param|
00007ea0  2e 3e 2e 0a 20 20 20 20  0a 0a 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 3d 3d 3d 3d 3d 3d 0a  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 20 20 20 20 20 20 0a  45 72 72 6f 72 73 0a 2d  |       .Errors.-|
00007f20  2d 2d 2d 2d 2d 20 20 20  20 20 20 20 20 20 20 20  |-----           |
00007f30  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00007f50  20 20 20 20 20 20 20 20  20 0a 0a 54 68 65 20 65  |         ..The e|
00007f60  72 72 6f 72 20 6e 75 6d  62 65 72 73 20 61 6e 64  |rror numbers and|
00007f70  20 6d 65 73 73 61 67 65  73 20 77 68 69 63 68 20  | messages which |
00007f80  74 68 65 20 74 72 61 63  6b 65 72 6d 6f 64 75 6c  |the trackermodul|
00007f90  65 20 6d 61 79 20 67 65  6e 65 72 61 74 65 3a 0a  |e may generate:.|
00007fa0  0a 4e 6f 20 74 75 6e 65  20 6c 6f 61 64 65 64 20  |.No tune loaded |
00007fb0  20 20 20 20 20 20 20 28  26 34 33 32 30 30 29 20  |       (&43200) |
00007fc0  2d 20 61 6e 20 6f 70 65  72 61 74 69 6f 6e 20 77  |- an operation w|
00007fd0  61 73 20 61 74 74 65 6d  70 74 65 64 20 77 68 69  |as attempted whi|
00007fe0  63 68 20 72 65 71 75 69  72 65 73 20 61 0a 20 20  |ch requires 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 20 20 20 20 20 20 74  |               t|
00008010  75 6e 65 20 74 6f 20 62  65 20 6c 6f 61 64 65 64  |une to be loaded|
00008020  20 69 6e 74 6f 20 6d 65  6d 6f 72 79 20 62 65 66  | into memory bef|
00008030  6f 72 65 68 61 6e 64 0a  20 20 20 20 20 20 20 20  |orehand.        |
00008040  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008050  20 20 20 20 20 20 20 20  20 75 73 69 6e 67 20 2a  |         using *|
00008060  50 6c 61 79 4d 6f 64 20  6f 72 20 53 57 49 20 54  |PlayMod or SWI T|
00008070  72 61 63 6b 65 72 5f 4c  6f 61 64 2e 0a 0a 53 65  |racker_Load...Se|
00008080  71 75 65 6e 63 65 20 70  6f 73 69 74 69 6f 6e 20  |quence position |
00008090  6f 75 74 20 6f 66 20 72  61 6e 67 65 20 2d 20 54  |out of range - T|
000080a0  68 65 20 73 65 71 75 65  6e 63 65 20 70 6f 73 69  |he sequence posi|
000080b0  74 69 6f 6e 20 67 69 76  65 6e 20 77 69 74 68 20  |tion given with |
000080c0  2a 50 6c 61 79 50 6f 73  0a 20 20 20 20 20 20 20  |*PlayPos.       |
000080d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 28  |               (|
000080e0  26 34 33 32 30 31 29 20  20 20 6f 72 20 53 57 49  |&43201)   or SWI|
000080f0  20 54 72 61 63 6b 65 72  5f 53 65 74 50 6f 73 20  | Tracker_SetPos |
00008100  77 61 73 20 68 69 67 68  65 72 20 74 68 61 6e 20  |was higher than |
00008110  74 68 65 0a 20 20 20 20  20 20 20 20 20 20 20 20  |the.            |
00008120  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008130  20 20 20 20 20 61 63 74  75 61 6c 20 6e 75 6d 62  |     actual numb|
00008140  65 72 20 6f 66 20 70 61  74 74 65 72 6e 73 20 69  |er of patterns i|
00008150  6e 20 74 68 65 20 73 6f  6e 67 2e 0a 0a 4e 6f 20  |n the song...No |
00008160  72 6f 6f 6d 20 66 6f 72  20 6d 6f 64 75 6c 65 20  |room for module |
00008170  20 20 20 28 26 34 33 32  30 32 29 20 2d 20 54 68  |   (&43202) - Th|
00008180  65 20 74 72 61 63 6b 65  72 6d 6f 64 75 6c 65 20  |e trackermodule |
00008190  63 6f 75 6c 64 20 6e 6f  74 20 63 6c 61 69 6d 20  |could not claim |
000081a0  65 6e 6f 75 67 68 0a 20  20 20 20 20 20 20 20 20  |enough.         |
000081b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000081c0  20 20 20 20 20 20 20 20  52 4d 41 20 77 6f 72 6b  |        RMA work|
000081d0  73 70 61 63 65 20 74 6f  20 6c 6f 61 64 20 74 68  |space to load th|
000081e0  65 20 6d 6f 64 75 6c 65  2e 20 54 6f 20 67 65 74  |e module. To get|
000081f0  0a 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 20 20 20 20  |                |
00008210  20 20 6d 6f 72 65 20 6d  65 6d 6f 72 79 2c 20 71  |  more memory, q|
00008220  75 69 74 20 62 61 73 69  63 20 74 6f 20 74 68 65  |uit basic to the|
00008230  20 73 75 70 65 72 76 69  73 6f 72 0a 20 20 20 20  | supervisor.    |
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 20  20 20 20 20 20 70 72 6f  |             pro|
00008260  6d 70 74 2c 20 61 6e 64  20 72 65 74 72 79 2e 20  |mpt, and retry. |
00008270  49 66 20 79 6f 75 20 61  72 65 20 75 73 69 6e 67  |If you are using|
00008280  20 74 68 65 0a 20 20 20  20 20 20 20 20 20 20 20  | the.           |
00008290  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000082a0  20 20 20 20 20 20 64 65  73 6b 74 6f 70 20 69 6e  |      desktop in|
000082b0  73 74 65 61 64 2c 20 72  65 6d 6f 76 65 20 61 6e  |stead, remove an|
000082c0  20 61 70 70 6c 69 63 61  74 69 6f 6e 20 61 6e 64  | application and|
000082d0  0a 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 20 20 20 20  |                |
000082f0  20 20 72 65 74 72 79 2e  0a 0a 43 68 61 6e 6e 65  |  retry...Channe|
00008300  6c 20 6e 75 6d 62 65 72  20 6f 75 74 20 6f 66 20  |l number out of |
00008310  72 61 6e 67 65 20 20 20  20 2d 20 54 68 65 20 73  |range    - The s|
00008320  6f 75 6e 64 20 63 68 61  6e 6e 65 6c 20 6e 75 6d  |ound channel num|
00008330  62 65 72 20 77 61 73 20  6e 6f 74 20 61 20 76 61  |ber was not a va|
00008340  6c 75 65 0a 20 20 20 20  20 20 20 20 20 20 20 20  |lue.            |
00008350  20 20 20 20 20 20 20 20  20 20 28 26 34 33 32 30  |          (&4320|
00008360  33 29 20 20 20 62 65 74  77 65 65 6e 20 31 20 61  |3)   between 1 a|
00008370  6e 64 20 74 68 65 20 6e  75 6d 62 65 72 20 6f 66  |nd the number of|
00008380  20 73 6f 75 6e 64 20 63  68 61 6e 6e 65 6c 73 0a  | sound channels.|
00008390  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000083b0  20 75 73 65 64 20 66 6f  72 20 74 68 61 74 20 70  | used for that p|
000083c0  61 72 74 69 63 75 6c 61  72 20 74 75 6e 65 2e 0a  |articular tune..|
000083d0  0a 53 61 6d 70 6c 65 20  6e 75 6d 62 65 72 20 6f  |.Sample number o|
000083e0  75 74 20 6f 66 20 72 61  6e 67 65 20 20 20 20 20  |ut of range     |
000083f0  2d 20 54 68 65 20 73 61  6d 70 6c 65 20 6e 75 6d  |- The sample num|
00008400  62 65 72 20 77 61 73 20  6e 6f 74 20 77 69 74 68  |ber was not with|
00008410  69 6e 20 74 68 65 20 72  61 6e 67 65 0a 20 20 20  |in the range.   |
00008420  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008430  20 20 20 28 26 34 33 32  30 34 29 20 20 20 6f 66  |   (&43204)   of|
00008440  20 31 2d 33 36 2e 0a 0a  4e 6f 74 65 20 6e 75 6d  | 1-36...Note num|
00008450  62 65 72 20 6f 75 74 20  6f 66 20 72 61 6e 67 65  |ber out of range|
00008460  20 20 20 20 20 20 20 2d  20 54 68 65 20 6e 6f 74  |       - The not|
00008470  65 20 6e 75 6d 62 65 72  20 77 61 73 20 6e 6f 74  |e number was not|
00008480  20 77 69 74 68 69 6e 20  74 68 65 20 72 61 6e 67  | within the rang|
00008490  65 20 6f 66 0a 20 20 20  20 20 20 20 20 20 20 20  |e of.           |
000084a0  20 20 20 20 20 20 20 20  20 20 20 28 26 34 33 32  |           (&432|
000084b0  30 35 29 20 20 20 31 2d  33 36 2e 0a 0a 56 6f 6c  |05)   1-36...Vol|
000084c0  75 6d 65 20 6f 75 74 20  6f 66 20 72 61 6e 67 65  |ume out of range|
000084d0  20 20 20 28 26 34 33 32  30 36 29 20 2d 20 54 68  |   (&43206) - Th|
000084e0  65 20 76 6f 6c 75 6d 65  20 77 61 73 20 6e 6f 74  |e volume was not|
000084f0  20 77 69 74 68 69 6e 20  74 68 65 20 72 61 6e 67  | within the rang|
00008500  65 20 6f 66 20 30 2d 32  35 35 0a 0a 4d 6f 64 75  |e of 0-255..Modu|
00008510  6c 65 20 61 6c 72 65 61  64 79 20 6c 6f 63 6b 65  |le already locke|
00008520  64 20 28 26 34 33 32 30  37 29 20 2d 20 54 72 61  |d (&43207) - Tra|
00008530  63 6b 65 72 5f 4c 6f 63  6b 20 77 61 73 20 63 61  |cker_Lock was ca|
00008540  6c 6c 65 64 20 77 68 65  6e 20 74 68 65 20 6d 6f  |lled when the mo|
00008550  64 75 6c 65 0a 20 20 20  20 20 20 20 20 20 20 20  |dule.           |
00008560  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008570  20 20 20 20 20 20 77 61  73 20 61 6c 72 65 61 64  |      was alread|
00008580  79 20 6c 6f 63 6b 65 64  2e 20 54 68 65 20 6d 6f  |y locked. The mo|
00008590  64 75 6c 65 20 63 61 6e  20 6f 6e 6c 79 20 62 65  |dule can only be|
000085a0  0a 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 20 20 20 20  |                |
000085c0  20 20 75 6e 6c 6f 63 6b  65 64 20 77 68 65 6e 20  |  unlocked when |
000085d0  74 68 65 20 61 70 70 6c  69 63 61 74 69 6f 6e 20  |the application |
000085e0  69 6e 20 63 6f 6e 74 72  6f 6c 20 6f 66 0a 20 20  |in control 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 20 20 20 20 20 20 74  |               t|
00008610  68 65 20 6d 6f 64 75 6c  65 20 69 73 73 75 65 73  |he module issues|
00008620  20 61 20 54 72 61 63 6b  65 72 5f 55 6e 6c 6f 63  | a Tracker_Unloc|
00008630  6b 20 53 57 49 2e 0a 0a  55 6e 6c 6f 63 6b 20 66  |k SWI...Unlock f|
00008640  61 69 6c 65 64 20 20 20  20 20 20 20 20 20 28 26  |ailed         (&|
00008650  34 33 32 30 38 29 20 2d  20 54 72 61 63 6b 65 72  |43208) - Tracker|
00008660  5f 55 6e 6c 6f 63 6b 20  77 61 73 20 63 61 6c 6c  |_Unlock was call|
00008670  65 64 20 62 75 74 20 65  69 74 68 65 72 0a 20 20  |ed but 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 20 20 20 20 20 20 74  |               t|
000086a0  68 65 20 77 72 6f 6e 67  20 6c 6f 63 6b 69 6e 67  |he wrong locking|
000086b0  20 63 6f 64 65 20 77 61  73 20 73 70 65 63 69 66  | code was specif|
000086c0  69 65 64 2c 20 6f 72 0a  20 20 20 20 20 20 20 20  |ied, or.        |
000086d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000086e0  20 20 20 20 20 20 20 20  20 74 68 65 20 6d 6f 64  |         the mod|
000086f0  75 6c 65 20 77 61 73 20  6e 6f 74 20 6c 6f 63 6b  |ule was not lock|
00008700  65 64 20 61 74 20 74 68  65 20 74 69 6d 65 2e 0a  |ed at the time..|
00008710  0a 54 72 61 63 6b 65 72  4d 6f 64 75 6c 65 20 69  |.TrackerModule i|
00008720  6e 20 75 73 65 20 20 28  26 34 33 32 30 39 29 20  |n use  (&43209) |
00008730  2d 20 41 6e 20 61 74 74  65 6d 70 74 20 77 61 73  |- An attempt was|
00008740  20 6d 61 64 65 20 74 6f  20 65 78 65 63 75 74 65  | made to execute|
00008750  20 6f 6e 65 20 6f 66 20  74 68 65 0a 20 20 20 20  | one of 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 20  20 20 20 20 20 72 65 73  |             res|
00008780  74 72 69 63 74 65 64 20  63 6f 6d 6d 61 6e 64 73  |tricted commands|
00008790  20 6f 72 20 53 57 49 27  73 20 77 68 69 6c 65 20  | or SWI's while |
000087a0  74 68 65 0a 20 20 20 20  20 20 20 20 20 20 20 20  |the.            |
000087b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000087c0  20 20 20 20 20 6d 6f 64  75 6c 65 20 77 61 73 20  |     module was |
000087d0  6c 6f 63 6b 65 64 20 28  73 65 65 20 54 72 61 63  |locked (see Trac|
000087e0  6b 65 72 5f 4c 6f 63 6b  29 0a 0a 53 70 65 65 64  |ker_Lock)..Speed|
000087f0  20 6e 6f 74 20 69 6d 70  6c 65 6d 65 6e 74 65 64  | not implemented|
00008800  20 28 26 34 33 32 30 41  29 20 2d 20 54 72 61 63  | (&4320A) - Trac|
00008810  6b 65 72 5f 53 70 65 65  64 20 77 61 73 20 63 61  |ker_Speed was ca|
00008820  6c 6c 65 64 20 77 69 74  68 20 52 30 20 6f 75 74  |lled with R0 out|
00008830  73 69 64 65 0a 20 20 20  20 20 20 20 20 20 20 20  |side.           |
00008840  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008850  20 20 20 20 20 20 74 68  65 20 72 61 6e 67 65 20  |      the range |
00008860  6f 66 20 76 61 6c 75 65  73 20 63 75 72 72 65 6e  |of values curren|
00008870  74 6c 79 20 61 63 63 65  70 74 65 64 2e 0a 0a 42  |tly accepted...B|
00008880  61 64 20 73 61 6d 70 6c  65 20 6c 6f 6f 70 69 6e  |ad sample loopin|
00008890  67 20 20 20 20 28 26 34  33 32 30 42 29 20 2d 20  |g    (&4320B) - |
000088a0  56 61 6c 75 65 73 20 6f  66 20 72 65 70 65 61 74  |Values of repeat|
000088b0  20 6f 66 66 73 65 74 2f  72 65 70 65 61 74 20 6c  | offset/repeat l|
000088c0  65 6e 67 74 68 20 77 6f  75 6c 64 0a 20 20 20 20  |ength 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 20  20 20 20 20 20 63 61 75  |             cau|
000088f0  73 65 20 73 61 6d 70 6c  65 20 74 6f 20 6c 6f 6f  |se sample to loo|
00008900  70 20 6f 75 74 73 69 64  65 20 69 74 73 20 6c 69  |p outside its li|
00008910  6d 69 74 2e 0a 0a 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |mit...==========|
00008920  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00008960  3d 3d 3d 0a 0a 0a 54 68  69 73 20 6d 6f 64 75 6c  |===...This modul|
00008970  65 20 77 61 73 20 77 72  69 74 74 65 6e 20 66 6f  |e was written fo|
00008980  72 20 65 6e 74 68 75 73  69 61 73 74 73 20 77 68  |r enthusiasts wh|
00008990  6f 20 77 69 73 68 20 74  6f 20 65 6e 6a 6f 79 20  |o wish to enjoy |
000089a0  74 68 65 20 62 65 6e 65  66 69 74 73 20 6f 66 20  |the benefits of |
000089b0  74 68 65 0a 41 72 63 68  69 6d 65 64 65 73 20 73  |the.Archimedes s|
000089c0  6f 75 6e 64 20 73 79 73  74 65 6d 20 69 6e 20 61  |ound system in a|
000089d0  20 6d 75 6c 74 69 2d 74  61 73 6b 69 6e 67 20 65  | multi-tasking e|
000089e0  6e 76 69 72 6f 6e 6d 65  6e 74 2e 0a 0a 56 65 72  |nvironment...Ver|
000089f0  73 69 6f 6e 73 20 30 2e  30 30 20 74 6f 20 31 2e  |sions 0.00 to 1.|
00008a00  78 78 20 6f 66 20 74 68  65 20 6f 72 69 67 69 6e  |xx of the origin|
00008a10  61 6c 20 6d 6f 64 75 6c  65 20 77 65 72 65 20 77  |al module were w|
00008a20  72 69 74 74 65 6e 20 62  79 20 48 75 67 6f 20 46  |ritten by Hugo F|
00008a30  69 65 6e 6e 65 73 0a 20  20 20 20 20 20 20 20 20  |iennes.         |
00008a40  20 20 20 20 20 20 20 20  20 20 20 20 20 61 6c 6c  |             all|
00008a50  6f 77 69 6e 67 20 74 68  65 20 70 6c 61 79 69 6e  |owing the playin|
00008a60  67 20 6f 66 20 61 6e 79  20 73 6f 75 6e 64 74 72  |g of any soundtr|
00008a70  61 63 6b 65 72 20 74 75  6e 65 73 2e 0a 56 65 72  |acker tunes..Ver|
00008a80  73 69 6f 6e 73 20 32 2e  30 30 20 74 6f 20 32 2e  |sions 2.00 to 2.|
00008a90  78 78 20 77 65 72 65 20  77 72 69 74 74 65 6e 20  |xx were written |
00008aa0  62 79 20 46 61 62 72 69  63 65 20 4d 65 72 63 69  |by Fabrice Merci|
00008ab0  65 72 20 61 6e 64 20 48  75 67 6f 2c 0a 20 20 20  |er and Hugo,.   |
00008ac0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008ad0  20 20 20 70 6c 61 79 69  6e 67 20 61 6e 79 20 74  |   playing any t|
00008ae0  72 61 63 6b 65 72 20 74  75 6e 65 73 20 28 77 69  |racker tunes (wi|
00008af0  74 68 20 63 68 61 6e 67  65 73 2f 69 6d 70 72 6f  |th changes/impro|
00008b00  76 65 6d 65 6e 74 73 29  2e 0a 56 65 72 73 69 6f  |vements)..Versio|
00008b10  6e 73 20 33 2e 30 30 20  74 6f 20 34 2e 30 37 20  |ns 3.00 to 4.07 |
00008b20  77 65 72 65 20 77 72 69  74 74 65 6e 20 62 79 20  |were written by |
00008b30  4d 61 74 74 68 65 77 20  46 61 72 72 6f 77 20 74  |Matthew Farrow t|
00008b40  6f 20 61 6c 6c 6f 77 20  74 68 65 20 70 6c 61 79  |o allow the play|
00008b50  69 6e 67 20 6f 66 0a 20  20 20 20 20 20 20 20 20  |ing of.         |
00008b60  20 20 20 20 20 20 20 20  20 20 20 20 20 73 6f 75  |             sou|
00008b70  6e 64 74 72 61 63 6b 65  72 20 6f 72 20 74 72 61  |ndtracker or tra|
00008b80  63 6b 65 72 20 74 75 6e  65 73 2c 20 77 69 74 68  |cker tunes, with|
00008b90  20 74 68 65 20 53 57 49  20 65 78 74 65 6e 73 69  | the SWI extensi|
00008ba0  6f 6e 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |on.             |
00008bb0  20 20 20 20 20 20 20 20  20 66 72 6f 6d 20 76 65  |         from ve|
00008bc0  72 73 69 6f 6e 73 20 34  2e 30 30 20 6f 6e 77 61  |rsions 4.00 onwa|
00008bd0  72 64 73 2e 0a 0a 59 6f  75 20 63 61 6e 20 63 6f  |rds...You can co|
00008be0  6e 74 61 63 74 20 48 75  67 6f 20 69 6e 20 74 68  |ntact Hugo in th|
00008bf0  65 20 66 6f 6c 6c 6f 77  69 6e 67 20 77 61 79 73  |e following ways|
00008c00  3a 0a 56 6f 69 63 65 3a  20 55 4b 20 28 30 37 34  |:.Voice: UK (074|
00008c10  39 29 20 37 32 32 33 34  20 28 61 73 6b 20 66 6f  |9) 72234 (ask fo|
00008c20  72 20 48 75 67 6f 29 0a  56 6f 64 61 46 6f 6e 65  |r Hugo).VodaFone|
00008c30  3a 20 28 30 38 33 31 29  20 34 34 34 31 39 32 0a  |: (0831) 444192.|
00008c40  54 68 65 20 57 6f 72 6c  64 20 6f 66 20 43 72 79  |The World of Cry|
00008c50  74 6f 6e 20 28 62 62 73  29 20 3a 20 55 4b 20 28  |ton (bbs) : UK (|
00008c60  30 37 34 39 29 20 36 37  39 37 39 34 20 28 33 30  |0749) 679794 (30|
00008c70  30 2d 32 34 30 30 20 2d  20 31 20 6c 69 6e 65 29  |0-2400 - 1 line)|
00008c80  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00008c90  20 20 20 20 20 20 20 20  20 20 20 3a 20 55 4b 20  |           : UK |
00008ca0  28 30 37 34 39 29 20 36  37 30 30 33 30 20 28 33  |(0749) 670030 (3|
00008cb0  30 30 2d 48 53 54 2f 56  33 32 20 2d 20 32 20 6c  |00-HST/V32 - 2 l|
00008cc0  69 6e 65 73 29 0a 4d 61  69 6c 3a 20 50 72 65 73  |ines).Mail: Pres|
00008cd0  74 65 6c 20 30 34 35 38  34 37 36 30 38 2c 20 43  |tel 045847608, C|
00008ce0  49 58 20 61 6c 74 6d 61  6e 0a 42 75 72 63 6f 74  |IX altman.Burcot|
00008cf0  74 20 4d 61 6e 6f 72 2c  20 57 65 6c 6c 73 2c 20  |t Manor, Wells, |
00008d00  53 6f 6d 65 72 73 65 74  2c 20 42 41 35 20 31 4e  |Somerset, BA5 1N|
00008d10  48 2c 20 55 4b 0a 0a 4d  61 74 74 20 46 61 72 72  |H, UK..Matt Farr|
00008d20  6f 77 3a 0a 4d 61 69 6c  3a 20 41 72 63 61 64 65  |ow:.Mail: Arcade|
00008d30  20 62 62 73 20 5b 30 38  31 2d 36 35 34 20 32 32  | bbs [081-654 22|
00008d40  31 32 5d 20 61 73 20 27  4d 61 74 74 68 65 77 20  |12] as 'Matthew |
00008d50  46 61 72 72 6f 77 27 20  28 23 34 38 33 29 0a 20  |Farrow' (#483). |
00008d60  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00008d70  5b 30 38 31 2d 36 35 35  20 34 34 31 32 5d 0a 0a  |[081-655 4412]..|
00008d80  34 35 20 41 6c 6c 65 79  6e 20 50 61 72 6b 2c 20  |45 Alleyn Park, |
00008d90  44 75 6c 77 69 63 68 2c  20 4c 6f 6e 64 6f 6e 20  |Dulwich, London |
00008da0  53 45 32 31 20 38 41 54  0a 0a 0a 3d 3d 3d 3d 3d  |SE21 8AT...=====|
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 3d 3d 3d 3d 3d 3d  0a 0a 55 70 64 61 74 65  |========..Update|
00008e00  73 0a 2d 2d 2d 2d 2d 2d  2d 0a 56 65 72 73 69 6f  |s.-------.Versio|
00008e10  6e 20 34 2e 30 30 20 28  66 72 6f 6d 20 33 2e 30  |n 4.00 (from 3.0|
00008e20  34 29 0a 20 20 20 2d 20  53 57 49 20 69 6e 74 65  |4).   - SWI inte|
00008e30  72 66 61 63 65 20 61 64  64 65 64 2e 0a 20 20 20  |rface added..   |
00008e40  2d 20 56 6f 6c 75 6d 65  20 74 72 61 6e 73 6c 61  |- Volume transla|
00008e50  74 69 6f 6e 73 20 66 6f  72 20 73 6f 75 6e 64 74  |tions for soundt|
00008e60  72 61 63 6b 65 72 20 6d  6f 64 75 6c 65 73 20 70  |racker modules p|
00008e70  65 72 66 6f 72 6d 65 64  20 63 6f 72 72 65 63 74  |erformed correct|
00008e80  6c 79 20 6e 6f 77 20 28  3f 29 0a 20 20 20 2d 20  |ly now (?).   - |
00008e90  4c 6f 63 6b 69 6e 67 20  73 79 73 74 65 6d 20 69  |Locking system i|
00008ea0  6e 74 72 6f 64 75 63 65  64 0a 20 20 20 2d 20 4e  |ntroduced.   - N|
00008eb0  65 78 74 20 70 61 74 74  65 72 6e 20 6c 69 6e 65  |ext pattern line|
00008ec0  20 70 6c 61 79 65 64 20  6a 75 73 74 20 61 66 74  | played just aft|
00008ed0  65 72 20 70 61 74 74 65  72 6e 20 70 6f 73 69 74  |er pattern posit|
00008ee0  69 6f 6e 20 69 6e 63 72  65 6d 65 6e 74 65 64 2c  |ion incremented,|
00008ef0  20 6e 6f 74 0a 20 20 20  20 20 6a 75 73 74 20 62  | not.     just b|
00008f00  65 66 6f 72 65 20 28 73  6f 20 74 68 65 20 70 6f  |efore (so the po|
00008f10  73 69 74 69 6f 6e 20 64  6f 65 73 6e 27 74 20 61  |sition doesn't a|
00008f20  70 70 65 61 72 20 74 6f  20 62 65 20 61 68 65 61  |ppear to be ahea|
00008f30  64 20 6f 66 20 74 68 65  20 6d 75 73 69 63 29 2e  |d of the music).|
00008f40  0a 20 20 20 2d 20 52 65  6d 6f 76 61 6c 20 6f 66  |.   - Removal of|
00008f50  20 6d 6f 72 65 20 6d 69  6e 6f 72 20 62 75 67 73  | more minor bugs|
00008f60  2e 2e 0a 0a 56 65 72 73  69 6f 6e 20 34 2e 30 31  |....Version 4.01|
00008f70  0a 20 20 20 2d 20 44 6f  65 73 6e 27 74 20 73 6c  |.   - Doesn't sl|
00008f80  6f 77 20 65 76 65 72 79  74 68 69 6e 67 20 64 6f  |ow everything do|
00008f90  77 6e 20 73 6f 20 6d 75  63 68 20 77 68 65 6e 20  |wn so much when |
00008fa0  70 61 75 73 65 64 0a 20  20 20 2d 20 46 69 78 65  |paused.   - Fixe|
00008fb0  64 20 62 75 67 20 69 6e  20 54 72 61 63 6b 65 72  |d bug in Tracker|
00008fc0  5f 50 6c 61 79 4e 6f 74  65 20 28 63 6f 6e 63 65  |_PlayNote (conce|
00008fd0  72 6e 69 6e 67 20 63 68  61 6e 6e 65 6c 20 6e 75  |rning channel nu|
00008fe0  6d 62 65 72 29 0a 20 20  20 2d 20 43 6f 72 72 65  |mber).   - Corre|
00008ff0  63 74 65 64 20 64 6f 63  75 6d 65 6e 74 61 74 69  |cted documentati|
00009000  6f 6e 20 6f 6e 20 54 72  61 63 6b 65 72 5f 52 65  |on on Tracker_Re|
00009010  61 64 53 61 6d 70 6c 65  54 61 62 6c 65 0a 0a 56  |adSampleTable..V|
00009020  65 72 73 69 6f 6e 20 34  2e 30 32 0a 20 20 20 2d  |ersion 4.02.   -|
00009030  20 41 64 64 65 64 20 6e  65 77 20 53 57 49 27 73  | Added new SWI's|
00009040  20 27 54 72 61 63 6b 65  72 5f 4d 75 74 65 43 68  | 'Tracker_MuteCh|
00009050  61 6e 6e 65 6c 27 20 61  6e 64 20 27 54 72 61 63  |annel' and 'Trac|
00009060  6b 65 72 5f 52 65 73 74  6f 72 65 43 68 61 6e 6e  |ker_RestoreChann|
00009070  65 6c 27 0a 20 20 20 2d  20 41 72 70 65 67 67 69  |el'.   - Arpeggi|
00009080  6f 20 63 6f 6d 6d 61 6e  64 20 61 6c 74 65 72 65  |o command altere|
00009090  64 20 74 6f 20 63 6f 6e  66 6f 72 6d 20 77 69 74  |d to conform wit|
000090a0  68 20 61 20 73 6f 75 6e  64 74 72 61 63 6b 65 72  |h a soundtracker|
000090b0  2d 64 65 72 69 76 61 74  69 76 65 0a 20 20 20 20  |-derivative.    |
000090c0  20 20 20 20 66 6f 72 6d  61 74 3b 20 49 20 74 68  |    format; I th|
000090d0  69 6e 6b 20 69 74 27 73  20 74 68 65 20 73 61 6d  |ink it's the sam|
000090e0  65 20 61 73 20 74 68 65  20 73 6f 75 6e 64 74 72  |e as the soundtr|
000090f0  61 63 6b 65 72 20 66 6f  72 6d 61 74 20 70 72 6f  |acker format pro|
00009100  70 65 72 2c 20 62 75 74  0a 20 20 20 20 20 20 20  |per, but.       |
00009110  20 49 20 63 61 6e 27 74  20 66 69 6e 64 20 61 6e  | I can't find an|
00009120  79 20 64 6f 63 75 6d 65  6e 74 61 74 69 6f 6e 20  |y documentation |
00009130  74 6f 20 63 68 65 63 6b  20 74 68 69 73 21 0a 20  |to check this!. |
00009140  20 20 2d 20 46 69 78 65  64 20 62 75 67 20 77 68  |  - Fixed bug wh|
00009150  65 72 65 20 69 66 20 79  6f 75 20 64 69 64 20 61  |ere if you did a|
00009160  20 54 72 61 63 6b 65 72  5f 50 6c 61 79 4e 6f 74  | Tracker_PlayNot|
00009170  65 20 77 68 69 6c 65 20  74 68 65 20 74 75 6e 65  |e while the tune|
00009180  20 77 61 73 20 70 61 75  73 65 64 2c 0a 20 20 20  | was paused,.   |
00009190  20 20 20 20 20 69 74 20  73 6f 6d 65 74 69 6d 65  |     it sometime|
000091a0  73 20 64 69 64 6e 27 74  20 63 6c 65 61 72 20 74  |s didn't clear t|
000091b0  68 65 20 73 6f 75 6e 64  20 62 75 66 66 65 72 73  |he sound buffers|
000091c0  20 61 66 74 65 72 77 61  72 64 73 20 28 62 75 7a  | afterwards (buz|
000091d0  7a 69 6e 67 20 65 74 63  2e 29 0a 0a 56 65 72 73  |zing etc.)..Vers|
000091e0  69 6f 6e 20 34 2e 30 33  0a 20 20 20 2d 20 49 20  |ion 4.03.   - I |
000091f0  68 61 76 65 20 66 69 78  65 64 20 74 68 65 20 54  |have fixed the T|
00009200  72 61 63 6b 65 72 5f 50  6c 61 79 4e 6f 74 65 20  |racker_PlayNote |
00009210  62 75 67 20 66 72 6f 6d  20 56 34 2e 30 31 20 6e  |bug from V4.01 n|
00009220  6f 77 2c 20 68 6f 6e 65  73 74 21 0a 20 20 20 2d  |ow, honest!.   -|
00009230  20 46 69 78 65 64 20 70  72 6f 62 6c 65 6d 20 69  | Fixed problem i|
00009240  6e 74 72 6f 64 75 63 65  64 20 69 6e 20 56 34 2e  |ntroduced in V4.|
00009250  30 32 20 77 68 65 72 65  20 64 6f 69 6e 67 20 54  |02 where doing T|
00009260  72 61 63 6b 65 72 5f 50  6c 61 79 4e 6f 74 65 20  |racker_PlayNote |
00009270  77 68 69 6c 65 20 61 0a  20 20 20 20 20 20 20 20  |while a.        |
00009280  74 75 6e 65 20 77 61 73  20 70 6c 61 79 69 6e 67  |tune was playing|
00009290  20 73 6f 6d 65 74 69 6d  65 73 20 63 72 61 73 68  | sometimes crash|
000092a0  65 64 20 28 69 66 20 74  68 65 20 73 61 6d 70 6c  |ed (if the sampl|
000092b0  65 20 77 61 73 20 62 6c  61 6e 6b 29 0a 20 20 20  |e was blank).   |
000092c0  2d 20 53 68 6f 75 6c 64  20 63 72 61 73 68 20 6c  |- Should crash l|
000092d0  65 73 73 20 6f 66 74 65  6e 20 77 68 65 6e 20 6c  |ess often when l|
000092e0  6f 61 64 69 6e 67 20 61  20 6e 65 77 20 74 75 6e  |oading a new tun|
000092f0  65 20 28 6e 6f 20 70 72  6f 6d 69 73 65 73 21 29  |e (no promises!)|
00009300  0a 0a 56 65 72 73 69 6f  6e 20 34 2e 30 34 0a 20  |..Version 4.04. |
00009310  20 20 2d 20 41 64 64 65  64 20 2a 50 6c 61 79 53  |  - Added *PlayS|
00009320  70 65 65 64 20 61 6e 64  20 6f 70 74 69 6f 6e 20  |peed and option |
00009330  74 6f 20 63 68 61 6e 67  65 20 73 61 6d 70 6c 65  |to change sample|
00009340  20 72 61 74 65 20 28 66  61 73 74 65 72 20 38 2d  | rate (faster 8-|
00009350  63 68 61 6e 6e 65 6c 0a  20 20 20 20 20 20 20 20  |channel.        |
00009360  74 75 6e 65 73 29 0a 20  20 20 2d 20 50 72 6f 76  |tunes).   - Prov|
00009370  69 73 69 6f 6e 20 66 6f  72 20 56 49 44 43 20 65  |ision for VIDC e|
00009380  6e 68 61 6e 63 65 72 20  6f 77 6e 65 72 73 20 28  |nhancer owners (|
00009390  74 75 6e 65 73 20 61 72  65 20 6e 6f 72 6d 61 6c  |tunes are normal|
000093a0  6c 79 20 61 20 70 65 72  66 65 63 74 20 66 69 66  |ly a perfect fif|
000093b0  74 68 0a 20 20 20 20 20  20 20 20 74 6f 6f 20 68  |th.        too h|
000093c0  69 67 68 29 20 69 6e 20  74 68 65 20 66 6f 72 6d  |igh) in the form|
000093d0  20 6f 66 20 2a 50 6c 61  79 53 70 65 65 64 20 3c  | of *PlaySpeed <|
000093e0  32 7c 33 3e 0a 20 20 20  2d 20 41 64 64 65 64 20  |2|3>.   - Added |
000093f0  54 72 61 63 6b 65 72 5f  53 70 65 65 64 20 53 57  |Tracker_Speed SW|
00009400  49 20 28 73 61 6d 65 20  61 73 20 2a 50 6c 61 79  |I (same as *Play|
00009410  53 70 65 65 64 29 0a 20  20 20 2d 20 4d 6f 64 75  |Speed).   - Modu|
00009420  6c 65 20 6e 6f 77 20 63  6c 61 69 6d 73 20 6d 65  |le now claims me|
00009430  6d 6f 72 79 20 69 6e 20  52 4d 41 20 61 6e 64 20  |mory in RMA and |
00009440  62 75 69 6c 64 73 20 74  61 62 6c 65 73 20 61 73  |builds tables as|
00009450  20 69 74 20 6e 65 65 64  73 20 74 68 65 6d 2c 0a  | it needs them,.|
00009460  20 20 20 20 20 20 20 20  73 61 76 69 6e 67 20 61  |        saving a|
00009470  62 6f 75 74 20 31 32 4b  20 6f 66 20 64 69 73 63  |bout 12K of disc|
00009480  20 73 70 61 63 65 2e 0a  20 20 20 2d 20 41 6c 74  | space..   - Alt|
00009490  65 72 65 64 20 2a 50 6c  61 79 53 61 6d 70 6c 65  |ered *PlaySample|
000094a0  73 20 63 6f 6d 6d 61 6e  64 20 74 6f 20 70 72 69  |s command to pri|
000094b0  6e 74 20 27 2d 27 20 66  6f 72 20 73 61 6d 70 6c  |nt '-' for sampl|
000094c0  65 20 6e 61 6d 65 20 69  66 20 62 6c 61 6e 6b 20  |e name if blank |
000094d0  28 75 73 65 64 0a 20 20  20 20 20 20 20 20 74 6f  |(used.        to|
000094e0  20 69 67 6e 6f 72 65 20  6e 6f 6e 2d 7a 65 72 6f  | ignore non-zero|
000094f0  20 73 61 6d 70 6c 65 73  20 77 69 74 68 20 62 6c  | samples with bl|
00009500  61 6e 6b 20 6e 61 6d 65  73 29 0a 20 20 20 2d 20  |ank names).   - |
00009510  4d 61 69 6e 20 69 6e 74  65 72 72 75 70 74 20 70  |Main interrupt p|
00009520  75 74 20 6f 6e 20 54 69  63 6b 65 72 56 2c 20 73  |ut on TickerV, s|
00009530  6f 20 74 68 69 73 20 73  68 6f 75 6c 64 20 65 6e  |o this should en|
00009540  64 20 70 72 6f 62 6c 65  6d 73 20 61 6e 79 20 6d  |d problems any m|
00009550  75 6c 74 69 73 79 6e 63  0a 20 20 20 20 20 20 20  |ultisync.       |
00009560  20 6d 6f 6e 69 74 6f 72  20 6f 77 6e 65 72 73 20  | monitor owners |
00009570  6d 61 79 20 68 61 76 65  20 68 61 64 20 77 69 74  |may have had wit|
00009580  68 20 74 75 6e 65 73 20  67 6f 69 6e 67 20 74 6f  |h tunes going to|
00009590  6f 20 66 61 73 74 20 65  74 63 2e 0a 0a 56 65 72  |o fast etc...Ver|
000095a0  73 69 6f 6e 20 34 2e 30  35 0a 20 20 20 2d 20 46  |sion 4.05.   - F|
000095b0  69 78 65 64 20 54 72 61  63 6b 65 72 5f 52 65 61  |ixed Tracker_Rea|
000095c0  64 53 61 6d 70 6c 65 54  61 62 6c 65 20 28 77 68  |dSampleTable (wh|
000095d0  65 6e 20 52 30 20 77 61  73 20 6f 75 74 20 6f 66  |en R0 was out of|
000095e0  20 72 61 6e 67 65 20 5b  69 65 2e 20 3e 31 35 2f  | range [ie. >15/|
000095f0  3e 33 31 5d 20 52 31 0a  20 20 20 20 20 20 20 20  |>31] R1.        |
00009600  70 6f 69 6e 74 65 64 20  74 6f 20 61 6e 20 75 6e  |pointed to an un|
00009610  64 65 66 69 6e 65 64 20  73 74 72 69 6e 67 29 20  |defined string) |
00009620  73 6f 20 74 68 61 74 20  52 31 20 61 6e 64 20 52  |so that R1 and R|
00009630  36 20 77 69 6c 6c 20 70  6f 69 6e 74 20 74 6f 20  |6 will point to |
00009640  61 0a 20 20 20 20 20 20  20 20 7a 65 72 6f 20 69  |a.        zero i|
00009650  66 20 74 68 65 20 73 61  6d 70 6c 65 20 6e 75 6d  |f the sample num|
00009660  62 65 72 20 69 73 20 6f  75 74 20 6f 66 20 72 61  |ber is out of ra|
00009670  6e 67 65 2e 0a 20 20 20  2d 20 43 68 61 6e 67 65  |nge..   - Change|
00009680  64 20 63 6f 6d 6d 61 6e  64 20 6f 72 64 65 72 20  |d command order |
00009690  73 6f 20 74 68 61 74 20  27 2a 50 6c 61 79 73 2e  |so that '*Plays.|
000096a0  27 20 77 69 6c 6c 20 64  6f 20 2a 50 6c 61 79 53  |' will do *PlayS|
000096b0  74 61 74 75 73 20 72 61  74 68 65 72 20 74 68 61  |tatus rather tha|
000096c0  6e 0a 20 20 20 20 20 20  20 20 2a 50 6c 61 79 53  |n.        *PlayS|
000096d0  61 6d 70 6c 65 73 2e 0a  20 20 20 2d 20 4d 6f 64  |amples..   - Mod|
000096e0  75 6c 65 20 6e 6f 77 20  69 6e 73 74 61 6c 6c 73  |ule now installs|
000096f0  20 69 74 73 65 6c 66 20  61 73 20 61 20 73 6f 75  | itself as a sou|
00009700  6e 64 20 63 68 61 6e 6e  65 6c 20 68 61 6e 64 6c  |nd channel handl|
00009710  65 72 20 28 6e 6f 20 6d  6f 72 65 20 6f 66 20 74  |er (no more of t|
00009720  68 65 0a 20 20 20 20 20  20 20 20 27 54 72 61 63  |he.        'Trac|
00009730  6b 65 72 56 6f 78 27 20  76 6f 69 63 65 29 2e 0a  |kerVox' voice)..|
00009740  20 20 20 20 20 45 66 66  65 63 74 73 20 6f 66 20  |     Effects of |
00009750  74 68 69 73 20 72 65 63  6f 64 69 6e 67 20 61 72  |this recoding ar|
00009760  65 3a 2d 0a 20 20 20 20  20 20 20 20 2a 20 20 49  |e:-.        *  I|
00009770  74 27 73 20 6d 75 63 68  20 74 72 69 63 6b 69 65  |t's much trickie|
00009780  72 20 66 6f 72 20 70 72  6f 67 72 61 6d 73 20 74  |r for programs t|
00009790  6f 20 73 61 62 6f 74 61  67 65 20 61 6e 79 20 63  |o sabotage any c|
000097a0  75 72 72 65 6e 74 20 74  75 6e 65 73 2c 20 61 73  |urrent tunes, as|
000097b0  0a 20 20 20 20 20 20 20  20 20 20 20 61 73 73 69  |.           assi|
000097c0  67 6e 69 6e 67 20 73 6f  75 6e 64 20 76 6f 69 63  |gning sound voic|
000097d0  65 73 20 68 61 73 20 6e  6f 20 65 66 66 65 63 74  |es has no effect|
000097e0  20 28 75 6e 6c 65 73 73  20 74 68 65 20 74 75 6e  | (unless the tun|
000097f0  65 20 69 73 20 73 74 6f  70 70 65 64 29 2e 0a 20  |e is stopped).. |
00009800  20 20 20 20 20 20 20 2a  20 20 42 65 66 6f 72 65  |       *  Before|
00009810  2c 20 73 61 6d 70 6c 65  73 20 70 6c 61 79 65 64  |, samples played|
00009820  20 73 69 6d 75 6c 74 61  6e 65 6f 75 73 6c 79 20  | simultaneously |
00009830  6f 6e 20 64 69 66 66 65  72 65 6e 74 20 63 68 61  |on different cha|
00009840  6e 6e 65 6c 73 20 77 65  72 65 0a 20 20 20 20 20  |nnels were.     |
00009850  20 20 20 20 20 20 73 6f  6d 65 74 69 6d 65 73 20  |      sometimes |
00009860  70 6c 61 79 65 64 20 73  6c 69 67 68 74 6c 79 20  |played slightly |
00009870  6f 75 74 20 6f 66 20 70  68 61 73 65 20 28 73 6f  |out of phase (so|
00009880  75 6e 64 65 64 20 71 75  69 65 74 65 72 2f 77 65  |unded quieter/we|
00009890  69 72 64 29 2e 0a 20 20  20 20 20 20 20 20 20 20  |ird)..          |
000098a0  20 54 68 69 73 20 73 6f  6d 65 74 69 6d 65 73 20  | This sometimes |
000098b0  73 74 69 6c 6c 20 68 61  70 70 65 6e 73 2c 20 62  |still happens, b|
000098c0  75 74 20 6c 65 73 73 20  6f 66 74 65 6e 2e 0a 20  |ut less often.. |
000098d0  20 20 20 20 20 20 20 2a  20 20 52 65 2d 63 6f 6e  |       *  Re-con|
000098e0  66 69 67 75 72 69 6e 67  20 74 68 65 20 73 61 6d  |figuring the sam|
000098f0  70 6c 65 20 72 61 74 65  20 77 69 6c 6c 20 6e 6f  |ple rate will no|
00009900  74 20 77 6f 72 6b 20 77  68 69 6c 65 20 61 20 74  |t work while a t|
00009910  75 6e 65 20 69 73 0a 20  20 20 20 20 20 20 20 20  |une is.         |
00009920  20 20 70 6c 61 79 69 6e  67 2c 20 73 6f 20 74 68  |  playing, so th|
00009930  61 74 20 73 68 6f 75 6c  64 20 62 65 20 6f 6e 65  |at should be one|
00009940  20 6c 65 73 73 20 74 68  69 6e 67 20 74 6f 20 67  | less thing to g|
00009950  6f 20 77 72 6f 6e 67 2e  0a 20 20 20 2d 20 53 6c  |o wrong..   - Sl|
00009960  69 67 68 74 6c 79 20 63  68 61 6e 67 65 64 20 2a  |ightly changed *|
00009970  50 6c 61 79 73 61 6d 70  6c 65 73 20 63 6f 6d 6d  |Playsamples comm|
00009980  61 6e 64 20 74 6f 20 69  6e 63 6c 75 64 65 20 73  |and to include s|
00009990  61 6d 70 6c 65 20 6e 75  6d 62 65 72 2e 0a 20 20  |ample number..  |
000099a0  20 2d 20 46 69 78 65 64  20 70 72 6f 62 6c 65 6d  | - Fixed problem|
000099b0  20 77 69 74 68 20 2a 50  6c 61 79 73 74 61 74 75  | with *Playstatu|
000099c0  73 20 61 6e 64 20 6e 6f  6e 2d 74 65 72 6d 69 6e  |s and non-termin|
000099d0  61 74 65 64 20 74 75 6e  65 20 6e 61 6d 65 73 2e  |ated tune names.|
000099e0  0a 20 20 20 2d 20 41 6c  74 65 72 65 64 20 54 72  |.   - Altered Tr|
000099f0  61 63 6b 65 72 5f 53 74  65 72 65 6f 20 74 6f 20  |acker_Stereo to |
00009a00  72 65 74 75 72 6e 20 63  75 72 72 65 6e 74 20 73  |return current s|
00009a10  65 74 74 69 6e 67 73 20  69 66 20 52 30 3d 2d 31  |ettings if R0=-1|
00009a20  20 6f 6e 20 65 6e 74 72  79 2e 0a 20 20 20 2d 20  | on entry..   - |
00009a30  41 64 64 65 64 20 2a 50  6c 61 79 56 6f 6c 75 6d  |Added *PlayVolum|
00009a40  65 2f 54 72 61 63 6b 65  72 5f 56 6f 6c 75 6d 65  |e/Tracker_Volume|
00009a50  20 74 6f 20 63 6f 6e 74  72 6f 6c 20 6f 76 65 72  | to control over|
00009a60  61 6c 6c 20 76 6f 6c 75  6d 65 2e 0a 20 20 20 76  |all volume..   v|
00009a70  65 72 73 69 6f 6e 20 28  42 29 0a 20 20 20 2d 20  |ersion (B).   - |
00009a80  49 66 20 2a 50 6c 61 79  53 74 65 72 65 6f 20 34  |If *PlayStereo 4|
00009a90  20 77 61 73 20 73 65 6c  65 63 74 65 64 2c 20 73  | was selected, s|
00009aa0  74 65 72 65 6f 20 73 65  74 74 69 6e 67 73 20 77  |tereo settings w|
00009ab0  65 72 65 20 62 65 69 6e  67 20 63 6f 72 72 75 70  |ere being corrup|
00009ac0  74 65 64 20 77 68 65 6e  0a 20 20 20 20 20 20 20  |ted when.       |
00009ad0  20 74 68 65 20 74 75 6e  65 20 77 61 73 20 73 74  | the tune was st|
00009ae0  6f 70 70 65 64 2e 0a 20  20 20 2d 20 54 72 61 63  |opped..   - Trac|
00009af0  6b 65 72 20 27 45 27 20  73 74 65 72 65 6f 20 63  |ker 'E' stereo c|
00009b00  6f 6d 6d 61 6e 64 73 20  63 61 75 73 65 64 20 61  |ommands caused a|
00009b10  20 63 72 61 73 68 20 69  66 20 2a 50 6c 61 79 53  | crash if *PlayS|
00009b20  74 65 72 65 6f 20 34 20  77 61 73 20 65 6e 61 62  |tereo 4 was enab|
00009b30  6c 65 64 2e 0a 0a 56 65  72 73 69 6f 6e 20 34 2e  |led...Version 4.|
00009b40  30 36 20 20 20 20 20 20  4d 61 6a 6f 72 20 75 70  |06      Major up|
00009b50  64 61 74 65 0a 20 20 20  49 20 66 69 6e 61 6c 6c  |date.   I finall|
00009b60  79 20 67 6f 74 20 73 6f  6d 65 20 64 65 63 65 6e  |y got some decen|
00009b70  74 20 61 6d 69 67 61 20  73 6f 75 6e 64 74 72 61  |t amiga soundtra|
00009b80  63 6b 65 72 20 64 6f 63  75 6d 65 6e 74 61 74 69  |cker documentati|
00009b90  6f 6e 2e 0a 20 20 20 54  68 65 6e 20 49 20 64 69  |on..   Then I di|
00009ba0  73 63 6f 76 65 72 65 64  20 68 6f 77 20 6d 75 63  |scovered how muc|
00009bb0  68 20 49 20 68 61 64 20  77 72 6f 6e 67 2e 2e 20  |h I had wrong.. |
00009bc0  6d 61 6a 6f 72 20 75 70  64 61 74 65 20 6e 65 65  |major update nee|
00009bd0  64 65 64 21 0a 20 20 20  0a 20 20 20 2d 20 53 6f  |ded!.   .   - So|
00009be0  75 6e 64 74 72 61 63 6b  65 72 20 74 75 6e 65 73  |undtracker tunes|
00009bf0  20 77 65 72 65 20 62 65  69 6e 67 20 63 6f 6e 76  | were being conv|
00009c00  65 72 74 65 64 20 77 72  6f 6e 67 6c 79 2e 2e 0a  |erted wrongly...|
00009c10  20 20 20 20 20 20 20 20  2a 20 20 52 65 70 65 61  |        *  Repea|
00009c20  74 20 6f 66 66 73 65 74  20 6e 6f 77 20 6d 61 64  |t offset now mad|
00009c30  65 20 74 77 69 63 65 20  61 73 20 62 69 67 2e 0a  |e twice as big..|
00009c40  20 20 20 20 20 20 20 20  2a 20 20 56 6f 6c 75 6d  |        *  Volum|
00009c50  65 73 20 61 62 6f 76 65  20 74 68 65 20 73 70 65  |es above the spe|
00009c60  63 69 66 69 65 64 20 6d  61 78 69 6d 75 6d 20 28  |cified maximum (|
00009c70  36 34 29 20 77 65 72 65  20 63 6f 6e 76 65 72 74  |64) were convert|
00009c80  65 64 20 73 74 72 61 6e  67 65 6c 79 2e 0a 20 20  |ed strangely..  |
00009c90  20 20 20 20 20 20 20 20  20 4e 6f 77 20 6f 75 74  |         Now out|
00009ca0  2d 6f 66 2d 72 61 6e 67  65 20 76 6f 6c 75 6d 65  |-of-range volume|
00009cb0  73 20 61 72 65 20 73 65  74 20 74 6f 20 36 34 2e  |s are set to 64.|
00009cc0  0a 20 20 20 2d 20 41 63  63 75 72 61 63 79 20 6f  |.   - Accuracy o|
00009cd0  66 20 74 68 65 20 73 6f  75 6e 64 20 72 6f 75 74  |f the sound rout|
00009ce0  69 6e 65 73 20 69 6d 70  72 6f 76 65 64 20 74 6f  |ines improved to|
00009cf0  20 63 6f 70 65 20 77 69  74 68 20 76 65 72 79 20  | cope with very |
00009d00  73 6d 61 6c 6c 20 6c 6f  6f 70 69 6e 67 0a 20 20  |small looping.  |
00009d10  20 20 20 20 20 20 73 61  6d 70 6c 65 73 20 77 68  |      samples wh|
00009d20  69 63 68 20 77 65 72 65  20 73 65 65 6d 69 6e 67  |ich were seeming|
00009d30  6c 79 20 70 69 74 63 68  65 64 20 77 72 6f 6e 67  |ly pitched wrong|
00009d40  6c 79 20 61 73 20 61 20  72 65 73 75 6c 74 20 6f  |ly as a result o|
00009d50  66 20 34 2d 62 79 74 65  0a 20 20 20 20 20 20 20  |f 4-byte.       |
00009d60  20 61 63 63 75 72 61 63  79 2e 20 41 63 63 75 72  | accuracy. Accur|
00009d70  61 63 79 20 6e 6f 77 20  31 20 62 79 74 65 2e 20  |acy now 1 byte. |
00009d80  54 68 69 73 20 6d 61 79  20 73 6c 6f 77 20 74 68  |This may slow th|
00009d90  69 6e 67 73 20 64 6f 77  6e 20 61 20 74 69 6e 79  |ings down a tiny|
00009da0  20 62 69 74 2e 0a 20 20  20 2d 20 41 6c 74 65 72  | bit..   - Alter|
00009db0  65 64 20 74 68 65 20 76  6f 6c 75 6d 65 20 73 79  |ed the volume sy|
00009dc0  73 74 65 6d 20 73 6f 20  74 68 61 74 20 73 6f 75  |stem so that sou|
00009dd0  6e 64 74 72 61 63 6b 65  72 20 76 6f 6c 75 6d 65  |ndtracker volume|
00009de0  73 20 61 72 65 20 61 73  20 61 63 63 75 72 61 74  |s are as accurat|
00009df0  65 0a 20 20 20 20 20 20  20 20 61 73 20 70 6f 73  |e.        as pos|
00009e00  73 69 62 6c 65 20 28 69  65 2e 20 76 6f 6c 75 6d  |sible (ie. volum|
00009e10  65 20 73 6c 69 64 65 73  20 6e 6f 77 20 73 6c 69  |e slides now sli|
00009e20  64 65 20 64 6f 77 6e 20  74 68 65 20 73 6f 75 6e  |de down the soun|
00009e30  64 74 72 61 63 6b 65 72  20 28 30 2d 36 34 29 0a  |dtracker (0-64).|
00009e40  20 20 20 20 20 20 20 20  76 6f 6c 75 6d 65 73 20  |        volumes |
00009e50  72 61 74 68 65 72 20 74  68 61 6e 20 74 68 65 20  |rather than the |
00009e60  61 72 63 20 6c 6f 67 20  76 6f 6c 75 6d 65 73 20  |arc log volumes |
00009e70  28 30 2d 32 35 35 29 2c  20 62 75 74 20 73 74 69  |(0-255), but sti|
00009e80  6c 6c 20 6b 65 65 70 69  6e 67 0a 20 20 20 20 20  |ll keeping.     |
00009e90  20 20 20 74 68 65 20 73  61 6d 65 20 73 79 73 74  |   the same syst|
00009ea0  65 6d 20 66 6f 72 20 74  72 61 63 6b 65 72 20 74  |em for tracker t|
00009eb0  75 6e 65 73 2e 20 54 68  65 72 65 66 6f 72 65 2c  |unes. Therefore,|
00009ec0  20 69 66 20 79 6f 75 20  77 61 6e 74 20 74 68 65  | if you want the|
00009ed0  20 6d 6f 73 74 0a 20 20  20 20 20 20 20 20 61 63  | most.        ac|
00009ee0  63 75 72 61 74 65 20 70  6c 61 79 62 61 63 6b 20  |curate playback |
00009ef0  6f 66 20 61 20 73 6f 75  6e 64 74 72 61 63 6b 65  |of a soundtracke|
00009f00  72 20 74 75 6e 65 2c 20  65 6e 73 75 72 65 20 69  |r tune, ensure i|
00009f10  74 20 69 73 20 69 6e 20  69 74 73 0a 20 20 20 20  |t is in its.    |
00009f20  20 20 20 20 6f 72 69 67  69 6e 61 6c 20 66 6f 72  |    original for|
00009f30  6d 61 74 2e 0a 20 20 20  2d 20 46 69 6e 61 6c 6c  |mat..   - Finall|
00009f40  79 20 69 6d 70 6c 65 6d  65 6e 74 65 64 20 63 6f  |y implemented co|
00009f50  6d 6d 61 6e 64 73 20 33  20 28 70 6f 72 74 61 6d  |mmands 3 (portam|
00009f60  65 6e 74 6f 29 20 61 6e  64 20 34 20 28 76 69 62  |ento) and 4 (vib|
00009f70  72 61 74 6f 29 2e 20 49  66 20 79 6f 75 20 68 61  |rato). If you ha|
00009f80  76 65 0a 20 20 20 20 20  20 20 20 63 6f 6e 76 65  |ve.        conve|
00009f90  72 74 65 64 20 6f 72 69  67 69 6e 61 6c 20 73 6f  |rted original so|
00009fa0  75 6e 64 74 72 61 63 6b  65 72 20 74 75 6e 65 73  |undtracker tunes|
00009fb0  20 69 6e 74 6f 20 74 72  61 63 6b 65 72 20 66 6f  | into tracker fo|
00009fc0  72 6d 61 74 2c 20 63 6f  6d 6d 61 6e 64 20 34 0a  |rmat, command 4.|
00009fd0  20 20 20 20 20 20 20 20  77 69 6c 6c 20 68 61 76  |        will hav|
00009fe0  65 20 6e 6f 20 65 66 66  65 63 74 20 64 75 65 20  |e no effect due |
00009ff0  74 6f 20 74 68 65 20 64  69 66 66 65 72 65 6e 74  |to the different|
0000a000  20 76 6f 6c 75 6d 65 20  66 6f 72 6d 61 74 73 2e  | volume formats.|
0000a010  20 54 68 65 20 76 69 62  72 61 74 6f 0a 20 20 20  | The vibrato.   |
0000a020  20 20 20 20 20 65 66 66  65 63 74 20 6d 61 79 20  |     effect may |
0000a030  6e 6f 74 20 62 65 20 65  78 61 63 74 6c 79 20 74  |not be exactly t|
0000a040  68 65 20 73 61 6d 65 20  61 73 20 6f 6e 20 74 68  |he same as on th|
0000a050  65 20 61 6d 69 67 61 2c  20 62 75 74 20 69 74 27  |e amiga, but it'|
0000a060  73 20 63 6c 6f 73 65 0a  20 20 20 20 20 20 20 20  |s close.        |
0000a070  65 6e 6f 75 67 68 2e 0a  20 20 20 2d 20 57 68 65  |enough..   - Whe|
0000a080  6e 20 73 6f 75 6e 64 74  72 61 63 6b 65 72 20 74  |n soundtracker t|
0000a090  75 6e 65 73 20 61 72 65  20 53 57 49 20 27 4d 65  |unes are SWI 'Me|
0000a0a0  6d 6f 72 79 4c 6f 61 64  27 65 64 2c 20 74 68 65  |moryLoad'ed, the|
0000a0b0  79 20 61 72 65 20 63 6f  6e 76 65 72 74 65 64 20  |y are converted |
0000a0c0  62 61 63 6b 0a 20 20 20  20 20 20 20 20 74 6f 20  |back.        to |
0000a0d0  74 68 65 20 6f 72 69 67  69 6e 61 6c 20 66 6f 72  |the original for|
0000a0e0  6d 61 74 20 77 68 65 6e  20 2a 50 6c 61 79 53 74  |mat when *PlaySt|
0000a0f0  6f 70 20 65 74 63 2e 20  69 73 20 70 65 72 66 6f  |op etc. is perfo|
0000a100  72 6d 65 64 20 28 74 6f  20 61 6c 6c 6f 77 0a 20  |rmed (to allow. |
0000a110  20 20 20 20 20 20 20 65  64 69 74 6f 72 73 20 74  |       editors t|
0000a120  6f 20 73 61 76 65 20 61  73 20 73 6f 75 6e 64 74  |o save as soundt|
0000a130  72 61 63 6b 65 72 20 66  6f 72 6d 61 74 29 2e 20  |racker format). |
0000a140  4e 42 20 54 72 61 63 6b  65 72 2d 73 70 65 63 69  |NB Tracker-speci|
0000a150  66 69 63 20 63 6f 6d 6d  61 6e 64 73 0a 20 20 20  |fic commands.   |
0000a160  20 20 20 20 20 61 6e 64  20 6f 75 74 20 6f 66 20  |     and out of |
0000a170  72 61 6e 67 65 20 69 6e  73 74 72 75 6d 65 6e 74  |range instrument|
0000a180  73 20 65 74 63 2e 20 61  72 65 20 69 67 6e 6f 72  |s etc. are ignor|
0000a190  65 64 2f 6d 69 73 2d 63  6f 6e 76 65 72 74 65 64  |ed/mis-converted|
0000a1a0  2e 0a 20 20 20 2d 20 54  72 61 63 6b 65 72 5f 57  |..   - Tracker_W|
0000a1b0  72 69 74 65 53 61 6d 70  6c 65 54 61 62 6c 65 20  |riteSampleTable |
0000a1c0  69 6e 74 72 6f 64 75 63  65 64 20 74 6f 20 61 6c  |introduced to al|
0000a1d0  6c 6f 77 20 74 72 61 6e  73 70 61 72 65 6e 74 20  |low transparent |
0000a1e0  61 63 63 65 73 73 20 6f  66 20 74 68 65 0a 20 20  |access of the.  |
0000a1f0  20 20 20 20 20 20 73 61  6d 70 6c 65 20 64 61 74  |      sample dat|
0000a200  61 20 61 6e 64 20 69 6e  64 65 70 65 6e 64 65 6e  |a and independen|
0000a210  63 65 20 28 61 6c 6d 6f  73 74 29 20 6f 66 20 74  |ce (almost) of t|
0000a220  68 65 20 54 72 61 63 6b  65 72 20 66 6f 72 6d 61  |he Tracker forma|
0000a230  74 2e 0a 20 20 20 2d 20  2a 2a 20 50 6c 65 61 73  |t..   - ** Pleas|
0000a240  65 20 4e 6f 74 65 20 2a  2a 20 20 20 56 6f 6c 75  |e Note **   Volu|
0000a250  6d 65 73 20 72 65 74 75  72 6e 65 64 20 62 79 20  |mes returned by |
0000a260  54 72 61 63 6b 65 72 5f  52 65 61 64 53 61 6d 70  |Tracker_ReadSamp|
0000a270  6c 65 54 61 62 6c 65 20  77 68 69 6c 65 0a 20 20  |leTable while.  |
0000a280  20 20 20 20 20 20 73 6f  75 6e 64 74 72 61 63 6b  |      soundtrack|
0000a290  65 72 20 74 75 6e 65 73  20 61 72 65 20 6c 6f 61  |er tunes are loa|
0000a2a0  64 65 64 20 61 72 65 20  6e 6f 77 20 69 6e 20 74  |ded are now in t|
0000a2b0  68 65 20 72 61 6e 67 65  20 30 2d 36 34 2e 20 54  |he range 0-64. T|
0000a2c0  68 65 73 65 20 63 61 6e  0a 20 20 20 20 20 20 20  |hese can.       |
0000a2d0  20 62 65 20 63 6f 6e 76  65 72 74 65 64 20 69 6e  | be converted in|
0000a2e0  74 6f 20 74 72 61 63 6b  65 72 20 76 6f 6c 75 6d  |to tracker volum|
0000a2f0  65 73 20 75 73 69 6e 67  20 74 68 65 20 6e 65 77  |es using the new|
0000a300  0a 20 20 20 20 20 20 20  20 54 72 61 63 6b 65 72  |.        Tracker|
0000a310  5f 54 72 61 6e 73 6c 61  74 65 56 6f 6c 75 6d 65  |_TranslateVolume|
0000a320  20 53 57 49 2e 20 2a 50  6c 61 79 53 61 6d 70 6c  | SWI. *PlaySampl|
0000a330  65 73 20 63 6f 6e 76 65  72 74 73 20 74 68 65 20  |es converts the |
0000a340  76 6f 6c 75 6d 65 73 20  66 69 72 73 74 2e 0a 20  |volumes first.. |
0000a350  20 20 2d 20 53 57 49 20  54 72 61 63 6b 65 72 5f  |  - SWI Tracker_|
0000a360  55 70 64 61 74 65 44 61  74 61 20 69 6e 74 72 6f  |UpdateData intro|
0000a370  64 75 63 65 64 20 74 6f  20 68 65 6c 70 20 65 64  |duced to help ed|
0000a380  69 74 6f 72 73 20 69 6e  74 65 72 66 61 63 65 20  |itors interface |
0000a390  77 69 74 68 20 74 68 65  0a 20 20 20 20 20 20 20  |with the.       |
0000a3a0  20 54 72 61 63 6b 65 72  6d 6f 64 75 6c 65 2e 0a  | Trackermodule..|
0000a3b0  20 20 20 2d 20 53 61 6d  70 6c 65 20 64 61 74 61  |   - Sample data|
0000a3c0  20 69 6e 66 6f 72 6d 61  74 69 6f 6e 20 6e 6f 77  | information now|
0000a3d0  20 72 65 61 64 20 64 69  72 65 63 74 6c 79 20 69  | read directly i|
0000a3e0  6e 20 74 68 65 20 6d 61  69 6e 20 72 6f 75 74 69  |n the main routi|
0000a3f0  6e 65 73 20 72 61 74 68  65 72 0a 20 20 20 20 20  |nes rather.     |
0000a400  20 20 20 74 68 61 6e 20  63 6f 70 69 65 64 20 77  |   than copied w|
0000a410  68 65 6e 20 74 68 65 20  6d 6f 64 75 6c 65 20 69  |hen the module i|
0000a420  73 20 6c 6f 61 64 65 64  2c 20 74 6f 20 65 6e 61  |s loaded, to ena|
0000a430  62 6c 65 20 65 64 69 74  6f 72 73 20 74 6f 20 61  |ble editors to a|
0000a440  6c 74 65 72 20 74 68 65  0a 20 20 20 20 20 20 20  |lter the.       |
0000a450  20 6d 6f 64 75 6c 65 20  77 68 69 6c 65 20 70 6c  | module while pl|
0000a460  61 79 69 6e 67 2e 0a 20  20 20 2d 20 4f 6e 20 72  |aying..   - On r|
0000a470  65 73 65 74 2c 20 74 75  6e 65 20 63 6f 6e 74 69  |eset, tune conti|
0000a480  6e 75 65 73 20 70 6c 61  79 69 6e 67 20 72 61 74  |nues playing rat|
0000a490  68 65 72 20 74 68 61 6e  20 62 65 69 6e 67 20 6b  |her than being k|
0000a4a0  69 6c 6c 65 64 20 61 73  20 62 65 66 6f 72 65 2e  |illed as before.|
0000a4b0  0a 20 20 20 2d 20 57 68  65 6e 20 74 75 6e 65 20  |.   - When tune |
0000a4c0  69 73 20 73 74 6f 70 70  65 64 2c 20 74 68 65 20  |is stopped, the |
0000a4d0  73 6f 75 6e 64 20 73 79  73 74 65 6d 20 69 73 20  |sound system is |
0000a4e0  72 65 73 74 6f 72 65 64  20 6d 6f 72 65 20 65 66  |restored more ef|
0000a4f0  66 65 63 74 69 76 65 6c  79 20 28 69 65 2e 0a 20  |fectively (ie.. |
0000a500  20 20 20 20 20 20 20 72  65 73 65 74 74 69 6e 67  |       resetting|
0000a510  20 74 68 65 20 73 61 6d  70 6c 65 20 72 61 74 65  | the sample rate|
0000a520  20 77 69 74 68 20 38 20  76 6f 69 63 65 73 20 61  | with 8 voices a|
0000a530  63 74 69 76 65 20 70 72  65 76 69 6f 75 73 6c 79  |ctive previously|
0000a540  20 6e 6f 77 20 77 6f 72  6b 73 20 2d 0a 20 20 20  | now works -.   |
0000a550  20 20 20 20 20 65 67 2e  20 77 68 65 6e 20 69 6e  |     eg. when in|
0000a560  74 65 72 72 75 70 74 69  6e 67 20 21 4d 61 65 73  |terrupting !Maes|
0000a570  74 72 6f 29 2e 0a 0a 56  65 72 73 69 6f 6e 20 34  |tro)...Version 4|
0000a580  2e 30 37 0a 20 20 20 2d  20 43 68 61 6e 67 65 64  |.07.   - Changed|
0000a590  20 63 6f 6d 6d 61 6e 64  20 34 20 61 67 61 69 6e  | command 4 again|
0000a5a0  2e 2e 20 69 74 20 77 61  73 6e 27 74 20 62 75 67  |.. it wasn't bug|
0000a5b0  67 65 64 2c 20 49 20 6a  75 73 74 20 63 68 61 6e  |ged, I just chan|
0000a5c0  67 65 64 20 74 68 65 20  73 70 65 63 73 2e 0a 20  |ged the specs.. |
0000a5d0  20 20 20 20 20 20 20 49  74 20 73 65 65 6d 73 20  |       It seems |
0000a5e0  74 68 61 74 20 73 6f 6d  65 20 70 6c 61 79 65 72  |that some player|
0000a5f0  73 20 64 69 73 61 67 72  65 65 20 6f 6e 20 77 68  |s disagree on wh|
0000a600  61 74 20 63 6f 6d 6d 61  6e 64 20 34 20 73 68 6f  |at command 4 sho|
0000a610  75 6c 64 20 62 65 2c 20  61 6e 64 0a 20 20 20 20  |uld be, and.    |
0000a620  20 20 20 20 49 27 6d 20  6e 6f 77 20 69 6d 70 6c  |    I'm now impl|
0000a630  65 6d 65 6e 74 69 6e 67  20 69 74 20 61 73 20 76  |ementing it as v|
0000a640  61 72 79 69 6e 67 20 74  68 65 20 70 69 74 63 68  |arying the pitch|
0000a650  20 28 61 73 20 6d 75 63  68 20 6f 76 65 72 20 61  | (as much over a|
0000a660  73 20 62 65 6c 6f 77 0a  20 20 20 20 20 20 20 20  |s below.        |
0000a670  74 68 65 20 6f 72 69 67  69 6e 61 6c 20 70 69 74  |the original pit|
0000a680  63 68 29 2e 0a                                    |ch)..|
0000a685
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