note: this soundtracker is based on the mastersoundtracker v1.0
by tip/prophets and mainly on soundtracker v2.2 by unknown/d.o.c
soundtracker v2.4 - a quick clarification.
------------------------------------------
last changes done on: 07-29-89.
update done by : mnemotron.
-------------------------------------------------------------------------
new features:
-------------
- built-in preset-editor
with - read path
- print plst
- load sample function
- print song option
- filter switch
- play-timer
the song.
---------
any piece of music written with soundtracker 2.4 is build up from patterns.
soundtracker holds a table with information about the sequence in which
these parts must be played. with 'position' you determine your position in
the table. with 'pattern' you define what pattern to play at that
position. 'length' defines the total size of the table. the full sequence
of patterns is the song.
the keys.
---------
the original (v1.8) version of the soundtracker had a german keymap.
version 2.4 supports a standard usa keymap and this ensures compatibility
with all amigas. the keyboard has been extended, try typing on the whole
key-rows. the keys on your amiga have been grouped to represent the layout
of a two- octave piano-keyboard. you can "shift" the keyboard one octave
up or down with the aid of the f1 and f2 keys, thus incrementing the range
of the keyboard to three octaves.
explanation of the options:
---------------------------
main menu:
----------
play - will play the song
stop - stops the song
edit - edit a pattern
record - edit pattern in real-time
clear - will kill the song in memory
use pset - will load a sample, which can be chosen by using the preset-
gadget
filter - will switch the power-led (and lowpassfilter on a500 and a2000) on
and off
disk op - switches to the disk-menu (see below)
print - will print the song to prt: (right button to abort)
pset-ed - switched to the presetlist-editor (see below)
the small gadgets titled from 1 to 4 represent the four audio channels of
your amiga computer. when lit, the audio channel is enabled.
disk menu:
----------
load song - loads a song
save song - crunches and saves a song
delete song - deletes a song from the disk
load module - loads a module
save module - saves a module
delete modules - deletes a modules from the disk
save sample - save the selected sample to disk
format disk - formats a disk
presetlist-editor:
------------------
insert - inserts a sample into the presetlist
delete - deletes a sample
read path - reads the specified path and inserts the samples into the list
print plst - lists the presetlist to prt: (right button to abort)
save plst - saves the presetlist to disk
use pset - loads a selected sample into the memory
press the right mousebutton to move faster up and down!
to read a sampledisk using 'read path' you have to enter the path you want to
read (in most cases 'df0:' to 'df3:'). harddisk users may enter a
volume-number which will be inserted before the samplename. click on
'volume' to change it. disks with a name like 'st-xx' will be automatically
identified!
while editing:
--------------
cursor-keys move cursor.
shift + cursor-keys move cursor fast.
alt + cursor-keys move cursor fastest.
f6 - set cursor to first line of pattern.
f7 - set cursor to 16th line of pattern.
f8 - set cursor to 32th line of pattern.
f9 - set cursor to 48th line of pattern.
f10 - set cursor to last line of pattern.
del - delete note under cursor.
shift + f3 - cut track of current pattern and copy into a buffer.
shift + f4 - copy track of current pattern into a buffer.
shift + f5 - copy buffer to track of current pattern.
alt + f3 - cut the whole pattern and copy into a buffer.
alt + f4 - copy pattern into a buffer.
alt + f5 - copy buffer to current pattern.
while using soundtracker v2.4, help will show you these commands once more.
a small word about the +/- gadgets: pressing the left and right
mousebutton will in-/decrease the value faster !!
sample zero function:
---------------------
while editing you're able to set the sample to the value zero (0!). press
both mousebuttons at the position of the samplegadgets (plus, minus = +,-).
now you can edit the pattern with the sample 0 to prevent difficulties
according to the volume.
instruments.
------------
you can use up to thirtyone different instruments in one music-piece. all
instruments are listed in the preset-list. the volume is always 64, but you
can change it to each value between 0 and 64. to change the other values of
each instrument you have to enter the preset-editor or use the gadgets in the
program (this is only for small changes. use the preset-ed otherwise!).
with the preseted you can change the whole preset-list. an instrument may
have a maximal length of 64k !!
notes:
------
c#1 0 3 c 2 3
/ |/ | \|
/ / | info
/ / command
/ inst#
note to
be played.
note: this is simply the note that is played with that particular
----- instrument.
inst#: this is the number of the instrument that is used to play that
------ note. when the instrument number is zero, the last selected
instrument will be used.
command: this number tells soundtracker what special functions shall be
-------- performed while playing the note.
these functions are as follows:
0 - normal play or arpeggio.
1 - portamento up.
2 - portamento down.
a - volume slide.
b - position jump.
c - set volume.
d - pattern break.
e - set filter on/off.
f - set speed.
info: this byte contains the additional information for the commands.
-----
arpeggio: arpeggio is used for simulating accords. this is done by rapidly
--------- changing the notes while playing an instrument. arepggios are
selected whenever the info byte has a non-zero value and no
other command is selected.
when arpeggios are used, soundtracker looks five times during
the play of one note, at the information contained in the info
byte. each nibble (4 bits) in this byte defines how many notes
soundtracker must add to the the note currently played. in each
of the five passes soundtracker does the following with the
information in the info byte:
0 - play the current note (immediately).
1 - add the first nibble to the current note.
2 - add the second nibble to the current note.
3 - play the current note.
4 - add the first nibble to the current note.
5 - add the second nibble to the current note.
portamento: portamento is used for 'sliding' the frequency of the sample.
----------- if portamento is in use, the information contained in the
the info byte will be added to (or subtracted from) the period
of the note playing in each of the five passes.
example: d#2 3208 slides down $08
--- 0208 slides down $08
--- 0108 slides up $08
--- 0210 slides down $10 (=16)
etc.
volume slide: this function uses the same parameters as portamento except
------------- for that it changes the volume.
position jump:
--------------
the position jump command will do the same like the pattern break
command, but the info byte gives the playroutine the no. of the
new position.
example: e-2 3b04 - break the pattern and jump to position 4
--- 0000
--- 0b06 - break the pattern and jump to position 6
volume: when command $0c (=12) is selected, the volume is set to the value
------- contained in the info byte. the volume will remain at this level
until the next sample is played. at this time, the volume is reset
to the default volume level of that sample.
example: c#1 1c22 - set volume to $22 (=34) and use instrument # 1 to
play the c#1 note.
d-2 0000 - use instrument # 1 to play the d-2 note.
(volume level remains at $22 (=34))
b-1 1000 - use instrument # 1 to play the b-1 note and
set volume to default value for that
instrument.
pattern break:
--------------
pattern break is used to create shorter patterns than 64 notes.
the note with the $0d command will be played and after that the
next pattern in the position-table will be played.
example: a#3 1d00 - at this point the pattern interrupts.
--- 0d00 - same.
c-1 0d30 - same.
filter: this soundtracker version allows you to turn the lo-pass filter
------- on/off.
example: g#2 1e01 - turns the filter and the power-led off.
--- 0000
e-1 1e00 - turns the filter and the power-led on.
warning to all amiga 1000 owners: don't play with the power-led because a500
and a2000 owners will not be happy when they hear your song.
speed: this function allows changing the speed during play.
------ you can only enter a speed from $01 to $0f.
setting the info byte to zero doesn't effect anything.
the normal speed is 6.
example: d-2 4f04 - set speed to 4
--- 0000
e-1 0f00 - nothing happens to speed.
--- 0fc3 - set speed to 3
g-2 2f06 - set normal speed
for your convenience the speed will now be set to 6 everytime you
load a song/module or clear the song.
the playroutine.
----------------
the playroutine on the soundtracker disk is for using your music in demos,
intros, games etc. it was written using the seka-assembler and the source of
the routine can directly be incorporated in your demo/intro source. when you
are finished writing your music using soundtracker v2.4, save it to disk.
use the function 'save module'. you will find a file in the
'modules'-directory, which contains all songdata and samples. load with seka
the source of the playroutine and enter the size of the saved module at the
label 'mt_data'. assemble. now load the saved module to 'mt_data'.
how to play a song:
-------------------
at the beginning of your program, call the 'mt_init' routine.
jump to the 'mt_music' routine each vertical blank.
to stop the song, jump to the 'mt_end' routine.
p.s. : all you workbench-fanatics can start the soundtracker from the
workbench without using utilities like xicon. simply use the provided icon
(or draw your own), but remember: don't forget to assign the st-xx: disks!
-----------------------------------------------------------------------------
last remark:
------------
some people encountered a problem with the keyboard while using the
soundtracker with an a2000 and harddisk. i changed the keyboard-routine, but
i can't test the change with a harddisk. a friend of mine owns a skyline
harddisk with a.l.f. and never came across this problem...
-----------------------------------------------------------------------------
|
