Home » Archimedes archive » Micro User » MU 1992-06.adf » PD » !FunkyDemo/!S_Tracker/!Help
!FunkyDemo/!S_Tracker/!Help
This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.
Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.
| Tape/disk: | Home » Archimedes archive » Micro User » MU 1992-06.adf » PD |
| Filename: | !FunkyDemo/!S_Tracker/!Help |
| Read OK: | ✔ |
| File size: | 58DE bytes |
| Load address: | 0000 |
| Exec address: | 0000 |
Duplicates
There is 1 duplicate copy of this file in the archive:
- Archimedes archive » Micro User » MU 1992-06.adf » PD » !FunkyDemo/!S_Tracker/!Help
- Archimedes archive » Micro User » MU 1991-10.adf » PD-Stuff » Music/!S_Tracker/!Help
File contents
!S/Tracker (Soundtracker/Tracker module music player)
-----------------------------------------------------
Version 4.00 (23 May 1991)
Originally written by Hugo Fiennes and Fabrice Mercier [(c) The Serial Port]
SWI interface and other bits added by Matt Farrow
You are allowed to use this module with any demos or p.d. stuff you write,
but permission is required before you can use it in any commercial software.
The !S/Tracker application may be freely copied if nothing more than the
cost of a disc and a small amount for the trouble is charged, but it must be
distributed with all the files complete and unchanged.
DOCUMENTATION OF * COMMANDS AND SWI's
-------------------------------------
*PlayMod - Loads into memory and starts to play the specified Tracker or
Soundtracker module, determining automatically which format it
is.
Syntax: *PlayMod <filename>
*PlayPause - Will pause the currently playing tune (kills all sound immed-
iately) but retains the soundtracker/tracker module in memory.
The tune can be restarted with a *PlayStart command.
Syntax: *PlayPause
*PlayStart - Will resume playing a tune after a *PlayPause command.
Syntax: *PlayStart
*PlayPos - Will set the current position in the sequence table, or if no
parameter is given, will simply return the current position.
Syntax: *PlayPos [<0-127>]
*PlaySamples - Will list all the samples associated with the currently
installed music module.
Syntax: *PlaySamples
*PlayStatus - Will print information about the current tune module loaded
Syntax: *PlayStatus
*PlayStereo - Controls the stereo settings while the older format sound-
tracker modules are playing (the stereo is fixed on an Amiga),
and will switch between five possible settings to cater for
most configurations:
0 - Slightly off-centre left and right (normal)
1 - Fully left and right (amiga-style)
2 - Fully left
3 - Fully right
4 - Don't alter stereo settings
(normally alters settings when a tune is loaded and when it plays a tracker stereo command - see
SWI Tracker_Stereo)
Syntax: *PlayStereo <0|1|2|3>
*PlayStop - Will stop and kill the currently playing tune module,
removing it from memory.
Syntax: *PlayStop
SWI COMMANDS
------------
Several SWI commands have been added to the module in order to simplify the
task of adding soundtracker/tracker music to your demos etc. (especially
multi-tasking situations). These provide all of the facilities offered by
the various * commands, but also allow a more detailed control of some of the
module's features.
All the SWI's remain in SVC mode, and do not alter the interrupt status.
I think most are re-entrant, except those which use system SWI's (load, play,
stop etc.), so avoid calling them from interrupts if you can avoid it.
The SWI chunk number given here (&43200) is an officially recognised chunk
number issued by Acorn.
-----------------------------------------------------------------------------
Tracker_Version (SWI &43200)
-----------------------------------------------------------------------------
On Entry: -
On Exit : R0 = version number*100 (ie. for V1.23 = 123)
Use this call to ensure that the trackermodule installed is a recent enough
version to support the SWI's you wish to use. Versions 4.00 onwards incorpor-
ate the SWI's.
-----------------------------------------------------------------------------
Tracker_Load (SWI &43201)
-----------------------------------------------------------------------------
On Entry: R0 = pointer to filename of soundtracker/tracker module
On Exit : R0 preserved
This call will claim memory from the RMA and load the specified tune module,
initialise the sound system, and set the playroutine in pause mode.
You must then use the SWI Tracker_Play to start the tune playing.
The command *PlayMod calls this routine, and then the SWI Tracker_Play.
An error will be generated if the module cannot be loaded or not enough
memory can be claimed.
-----------------------------------------------------------------------------
Tracker_MemoryLoad (SWI &43202)
-----------------------------------------------------------------------------
On Entry: R0 = pointer to first word of soundtracker/tracker module in
memory (NB must be word-aligned)
R1 = length of module in bytes
On Exit : R0 and R1 preserved
This call can be used by a non-multitasking application to specify an area
of memory as a tune module, and thereby remove the need for a seperate file
to hold a tune, and there is no need to claim a large amount of RMA space.
Once this SWI is called, the module will be treated as if it was loaded in
the module's own workspace.
Important: You must tell the trackermodule to forget the module if the
memory will be overwritten, otherwise the module may crash.
(*PlayStop or Tracker_Stop SWI)
NB This call will not work for programs running under the desktop if the
module is loaded in user memory.
When a soundtracker module is loaded, it is partially converted to an
intermediate format between soundtracker and tracker to simplify the task
for the playroutine. Once the module is loaded (by any method) it is
permanently corrupted, and should not be re-saved. Tracker modules will be
unchanged, however, and soundtracker modules should be converted fully
into this format before being loaded to avoid this problem.
-----------------------------------------------------------------------------
Tracker_Play (SWI &43203)
-----------------------------------------------------------------------------
On Entry: -
On Exit : -
This call will restart a tune after it has been paused or loaded with the
Tracker_Load SWI.
-----------------------------------------------------------------------------
Tracker_Stop (SWI &43204)
-----------------------------------------------------------------------------
On Entry: -
On Exit : -
This performs the same actions as *PlayStop
Using *PlayStop or this SWI is the only way to get the trackermodule to
release the memory taken up by the tune module, or to force it to forget the
address of a module if it has been loaded with the 'Tracker_MemoryLoad' SWI.
-----------------------------------------------------------------------------
Tracker_Pause (SWI &43205)
-----------------------------------------------------------------------------
On Entry: -
On Exit : -
This performs the same actions as *PlayPause
-----------------------------------------------------------------------------
Tracker_Stereo (SWI &43206)
-----------------------------------------------------------------------------
On Entry: R0 = Stereo setting (0-4)
On Exit : R0 preserved
This performs the same actions as *PlayStereo, with R0 passed as a parameter.
If R0 is set to 4 on entry, then the stereo settings will be unaltered
whenever a module is loaded or killed, and disables any stereo commands in
tracker modules. This is to allow interfacing programs to provide their own
stereo options, or to allow adjustment to the stereo positions while tracker
tunes are playing (which have default stereo settings stored as part of the
tune).
-----------------------------------------------------------------------------
Tracker_SetPos (SWI &43207)
-----------------------------------------------------------------------------
On Entry: R0 = New sequence position (0-127 max)
R1 = Event (0-63 max)
On Exit : R0 preserved
This performs the same actions as *PlayPos, except that the event with the
pattern can be specified (0-63 normally). If an event number higher than the
number of events in the current pattern is specified, the pattern will begin
at event 0.
If there is no tune currently loaded, an error is generated.
-----------------------------------------------------------------------------
Tracker_ReadPos (SWI &43208)
-----------------------------------------------------------------------------
On Entry: -
On Exit : R0 = Current position in sequence table (0-127 max)
R1 = Current position in pattern (0-63 max)
R2 = Maximum position in sequence table
This performs the same actions as *PlayPos with no parameters, but also
returns the current position in the current pattern (in case some applic-
ations need to synchronize events with the tune being played).
-----------------------------------------------------------------------------
Tracker_PlayNote (SWI &43209)
-----------------------------------------------------------------------------
On Entry: R0 = Sound channel to sound note on (1-8 max)
R1 = Tracker format note number (1-36)
R2 = Sample to play (1-36)
R3 = Volume (0-255)
On Exit : R0-R3 preserved
If tune not paused then C flag set otherwise C flag cleared.
If there is no tune loaded, an error will be generated.
It plays one of the samples which are part of the paused tune at a given
pitch (1=low, 36=high) and volume (0=silent, 255=loud). If any of the values
are out of range, an error will be reported.
The number of sound channels that can be used depends on the module loaded
(soundtracker modules will always use 4 voices, whereas Tracker modules can
use up to 8).
Use the Tracker_TuneInfo SWI to find out the maximum number of voices if you
intend to play more than one note at a time.
NB This call should be avoided if possible, unless the purpose is to hear
each sample seperately.
-----------------------------------------------------------------------------
Tracker_TuneInfo (SWI &4320A)
-----------------------------------------------------------------------------
On Entry: -
On Exit : R0 = Sequence table length (1-128)
R1 = Number of voices (1-8)
R2 = Current speed (1-15)
R3 = Pointer to tune name (terminated by 0, max length 32 chars)
R4 = Pointer to author's name (0 terminated, max length 32 chars)
or zero if soundtracker format module (not applicable)
R5 = Address of currently loaded tune module
If the tune is paused, the C flag is set, otherwise the C flag is
cleared.
If there is no tune loaded, R0 is set to zero, and R1-R5 are
preserved.
This call provides miscellaneous information about the tune currently loaded.
You should not need to directly access the tune module (using the address
passed in R5), because all information is available via the various SWI's,
and soundtracker format modules will have been converted partially to Tracker
format when loaded (and therefore in an unknown format). This information is
provided if, for example, multi-tasking players/editors need to know if the
tune currently playing is running from ordinary RMA, or the player's/editor's
own workspace.
-----------------------------------------------------------------------------
Tracker_SoundInfo (SWI &4320B)
-----------------------------------------------------------------------------
On Entry: R0 = Pointer to word-aligned 256 byte block to hold sound data
On Exit : R0 preserved
if the tune is paused, the C flag will be set, otherwise the C
flag will be cleared.
If there is no tune loaded an error will be generated.
This call is only provided for advanced uses of the trackermodule, and
involves information of a highly technical nature. It is advised that you
do not use this call if you can avoid it.
The call will transfer the current contents of the sound voice info table
to the location pointed to by R0. 256 bytes (64 words) will be transferred
in total (8 words per sound channel), regardless of the number of voices
actually active.
When a note is played and then ends, word 6 of the appropriate channel is
zeroed. The sound routines will only try and play the sample if this word is
non-zero.
When a tune is paused, the block is saved and overwritten with zeros. When
the tune is restarted, the old contents are restored, so that the samples
will continue to play from the same point.
The format of the table is as follows:-
Word Offset Sound channel 1...
0 +0 The current pitch accumulator. (shift right 16 bits to get the
actual byte offset into the sample being played).
1 +4 The current pitch increment (added to accumulator after every
byte filled). This is obtained using internal tables given the
sample period (word 7)
2 +8 The sample loop offset (given in bytes). When the routine
reaches the end of a sample or the sample length, the accumul-
ator is loaded with this value shifted left 16 bits (ie. to
give a byte offset). If this is a zero value, the sample will
stop instead of looping.
3 +12 The sample length / repeat length (in bytes). The routine
checks every 4 bytes filled to see if the current accumulator
exceeds this value when shifted right 16 bits. (See above)
4 +16 The sample number (1-36).
5 +20 The current volume (0-255). This value is subtracted from every
byte filled, therefore 0 = maximum volume and 255 = silent.
NB This is the reverse of the normal volume command.
6 +24 This is the tracker format note number of the sample being
played (1-36, 1=C octave 1 36=B octave 3). The arpeggio command
makes use of this word. If this word is zero, no sound will be
played.
7 +28 This is a copy of the sample period (from which the pitch
increment value is calculated), and is used by the portamento
commands. The range of the sample period is from 1 to hex &400
(although the portamento commands have smaller limits in
practice).
8 +32 Word 0 of sound channel 2...
9 +36 Word 1 of sound channel 2... etc.
-> word 8 of sound channel 8
-----------------------------------------------------------------------------
Tracker_ReadSampleTable (SWI &4320C)
-----------------------------------------------------------------------------
On Entry: R0 = Sample number (1-36)
On Exit : R0 preserved
R1 = Pointer to sample name (0-terminated, max length 22 chars)
R2 = Sample length (bytes)
R3 = Sample volume (0-255, 255=maximum volume, 0=silent)
R4 = Repeat offset (bytes)
R5 = Repeat length (bytes)
R6 = Address of raw sample data
This call returns all relevant information about the specified sample.
If there is no tune loaded, an error will be generated.
-----------------------------------------------------------------------------
Tracker_Lock (SWI &4320D)
-----------------------------------------------------------------------------
On Entry: R0 = locking code (passed in R4 to SWI's)
On Exit : -
This SWI and the corresponding Tracker_Unlock SWI are provided to
prevent user intervention with any of the features of the module when this
would be undesirable for any multi-tasking applications using the module
(for example issuing a *PlayStop command). By calling this SWI, an applic-
ation can gain complete control of the module, but as a result, this feature
must be used carefully, because the module cannot then be unlocked unless
the code specified in the lock SWI is known (and if not, the module must be
re-initialised).
When the module is locked, calling any commands or SWI's which alter
anything (such as changing the current play position, loading or killing
tunes, playing notes) will cause an error, but SWI's returning information
will function as normal. For the application which is responsible for the
locking to be able to use the affected SWI's, R4 must be set to the locking
code (passed in R0) before any of the affected SWI's is called (no commands
will work even if the locking code is known).
If the trackermodule is already 'locked' when this SWI is called, an error
will be generated.
It is advisable to avoid using this call unless absolutely neccessary.
The restricted commands are:
*PlayMod, *PlayPause, *PlayStart, *PlayPos, *PlayStereo, *PlayStop.
The restricted SWI's are:
Tracker_Load, Tracker_MemoryLoad, Tracker_Play, Tracker_Stop, Tracker_Stereo,
Tracker_SetPos, Tracker_PlayNote.
-----------------------------------------------------------------------------
Tracker_Unlock (SWI &4320E)
-----------------------------------------------------------------------------
On Entry: R0 = locking code (specified in Tracker_Lock)
On Exit : -
This SWI should be called to unlock the module after it has been locked with
'Tracker_Lock'. If the value passed in R0 is different to the locking code
given in the lock SWI, or the module has not been locked, an error is
generated.
=============================================================================
Note translation table
----------------------
The tracker format note numbers and the notes they refer to are as follows:
no. note sample period
--- ---- -------------
1 C -1 &358
2 C#-1 &328
3 D -1 &2FA
4 D#-1 &2D0
5 E -1 &2A6
6 F -1 &280
7 F#-1 &25C
8 G -1 &23A
9 G#-1 &21A
10 A -1 &1FC
11 A#-1 &1E0
12 B -1 &1C5
13 C -2 &1AC
14 C#-2 &194
15 D -2 &17D
16 D#-2 &168
17 E -2 &153
18 F -2 &140
19 F#-2 &12E
20 G -2 &11D
21 G#-2 &10D
22 A -2 &FE
23 A#-2 &F0
24 B -2 &E2
25 C -3 &D6
26 C#-3 &CA
27 D -3 &BE
28 D#-3 &B4
29 E -3 &AA
30 F -3 &A0
31 F#-3 &97
32 G -3 &8F
33 G#-3 &87
34 A -3 &7F
35 A#-3 &78
36 B -3 &71
=============================================================================
Errors
------
The error numbers and messages which the trackermodule may generate:
No tune loaded (&43200) - an operation was attempted which requires a
tune to be loaded into memory beforehand
using *PlayMod or SWI Tracker_Load.
Sequence position out of range - The sequence position given with *PlayPos
(&43201) or SWI Tracker_SetPos was higher than the
actual number of patterns in the song.
No room for module (&43202) - The trackermodule could not claim enough
RMA workspace to load the module. To get
more memory, quit basic to the supervisor
prompt, and retry. If you are using the
desktop instead, remove an application and
retry.
Channel number out of range - The sound channel number was not a value
(&43203) between 1 and the number of sound channels
used for that particular tune.
Note number out of range - The note number was not within the range of
(&43205) 1-36.
Sample number out of range - The sample number was not within the range
(&43204) of 1-36.
Volume out of range (&43206) - The volume was not within the range of 0-255
Module already locked (&43207) - Tracker_Lock was called when the module
was already locked. The module can only be
unlocked when the application in control of
the module issues a Tracker_Unlock SWI.
Unlock failed (&43208) - Tracker_Unlock was called but either
the wrong locking code was specified, or
the module was not locked at the time.
TrackerModule in use (&43209) - An attempt was made to execute one of the
restricted commands or SWI's while the
module was locked (see Tracker_Lock)
=============================================================================
This module was written for enthusiasts who wish to enjoy the benefits of the
Archimedes sound system in a multi-tasking environment.
Feel free to use this module in any p.d. demos or programs etc., but for any
commercial use, please ask Hugo Fiennes for permission. (And upload any demos
to his board [see below])
Versions 0.00 to 1.xx of the original module were written by Hugo Fiennes
allowing the playing of any soundtracker tunes.
Versions 2.00 to 2.xx were written by Fabrice Mercier and Hugo,
playing any tracker tunes (with changes/improvements).
Versions 3.00 to 4.00 were written (well, extended) by Matthew Farrow
to allow the playing of soundtracker or tracker tunes,
with the SWI extension from versions 4.00 onwards.
You can contact Hugo in the following ways:
Voice: UK (0749) 72234 (ask for Hugo)
VodaFone: (0831) 444192
The World of Cryton (bbs) : UK (0749) 679794 (300-2400 - 1 line)
: UK (0749) 670030 (300-HST/V32 - 2 lines)
Mail: Prestel 045847608, CIX altman
Burcott Manor, Wells, Somerset, BA5 1NH, UK
Matt Farrow:
Mail: Prestel 816706758, Arcade bbs (081-654 2212) as 'Matthew Farrow'
45 Alleyn Park, Dulwich, London SE21 8AT
=============================================================================
Updates
-------
Version 4.00 (from 3.04)
- SWI interface added.
- Volume translations for soundtracker modules performed correctly now (?)
- Locking system introduced
- Next pattern line played just after pattern position incremented, not
just before (so the position doesn't appear to be ahead of the music).
- Removal of more minor bugs.. 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
.