RMT - RASTER MUSIC TRACKER

RASTER Music Tracker v1.00 beta by Radek Sterba, RASTER/C.P.U. 2002-2003
(unfinished documentation version 1.00.002 - not revised!!!)

Disclaimer:

RMT IS SOFTWARE WITHOUT WARRANTY OF ANY KIND. AUTHOR DOES NOT WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE, OR THE RESULTS OF USE, OF THE SOFTWARE OR WRITTEN MATERIALS IN TERMS OF CORRECTNESS, ACCURACY, RELIABILITY, CURRENTNESS, OR OTHERWISE. THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE SOFTWARE IS ASSUMED BY YOU.

Important:

Warning! This BETA version of RMT contains some bugs! There is especially problem with sound output in conjunction with POKEY chip emulation, therefore there catch of sounds appears sometimes or a part of sound data fails and POKEY emulation is inaccurate.

All edit modes

Hotkeys

 ESC Stop playing song, mute all sounds. If PROVE mode is active, it will be deactivated.
 F2 Play song from the begin. It will also initialize speed of beat.
 SHIFT  F2 Similar to F2, plus auto-follow of currently played possition.
 F3 Play song from currently edit possition.
 SHIFT  F3 Similar to F3, plus auto-follow of currently played possition.
 F4 Cyclic playing of currently edit set of tracks.
 SHIFT  F4 Similar to F4, plus auto-follow of currently played possition.
 F5 Go to TRACK EDIT.
 F6 Go to INSTRUMENT EDIT.
 F7 Go to INFO EDIT.
 F8 Go to SONG EDIT.
 F9 PROVE mode 1 - mono / 2 - stereo / turn off PROVE mode.
 F11 RESPECT VOLUME mode turn on / off.
 F12 Go to TRACK EDIT / INSTRUMENT EDIT.
 PAUSE Reinitialize of sound output.
 numblock / Move left to previous track (previous sound generator).
 numblock * Move right to following track (following sound generator).
 numblock - Decrease of actual volume (for newly entered notes).
 numblock + Increase of actual volume (for newly entered notes).
 SHIFT  tonekeys Play pressed note with actual instrument, volume and on selected sound generator.
 SHIFT  CONTROL  tonekeys Play pressed note with actual instrument and volume in stereo (left and right sound generator).
 SHIFT  SPACE Stop playing note on selected sound generator.
 SHIFT  CONTROL  SPACE Stop playing note in stereo (left and right sound generator).

TRACK EDIT

NNN TT VSS
NNNNotes from C-1 to C-6.
TTNumber of instrument $00 to $3F.
VVolume $0 to $F (It can be used without note and instrument also).
SSSpeed of beat $01 to $FF (speed column).

Hotkeys

 UP ,  DOWN ,  LEFT ,  RIGHT ,  TAB ,  SHIFT+TAB ,  PAGE UP ,  PAGE DOWN Cursor moving.
 SHIFT  UP ,  DOWN Actual octave up / down.
 SHIFT  LEFT ,  RIGHT ,  numblock 0-9 Select actual instrument.
 CONTROL  UP ,  DOWN Move up / down in song.
 CONTROL  LEFT ,  RIGHT ,  0-F ,  BACKSPACE Set up track number into song at actual possition.
 CONTROL  S Go to speed column.
 CONTROL  G Turn on / off "go to line" command in song at actual position.
 HOME Move cursor to begin of track / begin of "track loop".
 CONTROL  HOME Set up / clear begin of "track loop".
 END Move cursor to end of track.
 CONTROL  END Set up / clear end of track.
 ENTER Replay note at cursor possition.
 CONTROL  ENTER Replay all notes at currently edited line.
 INSERT ,  DELETE Insert / delete lines in track.
 CONTROL  INSERT ,  DELETE Insert / delete lines in song (with auto-change of all relevant "go to line" values).
 SPACE Erase actual track line.

Note column

 tonekeys Insert note and its playing. (If RESPECT VOLUME is active, previously existing volume value won't be replaced.)
 numblock 1-6 Change octave of note at cursor position and playing of this note.
 BACKSPACE Erase note and instrument value (volume and speed will not be cleared).

Instrument number column

 0-F Set up / change instrument numbers.
 BACKSPACE Erase note and instrument value (volume and speed will not be cleared).

Volume column

 0-F Set up / change volume.
 BACKSPACE Erase note, instrument value and volume (speed will not be cleared).

Speed column

 0-F Set up / change beat speed.
 BACKSPACE Erase beat speed.

INSTRUMENT EDIT

NAMEName of instrument, max. 32 chars.
TABLE LENLength of table, 1 to 8 steps.
TABLE GOJump to given table line after reach of table end.
TABLE SPDSpeed for each table step, $01 to $40 vbi.
TABLE TYPETable type. 0 = notes, 1 = frequences
TABLE MODETable mode. 0 = add note (or frequency) to base note, 1 = add note (or frequency) to last calculated note (or frequency). Notice: If resulting note by reason of note adding is out of C-1 to C-6 range (hex values $00 to $3D), then output volume will be zero. But frequency addings is no limited.
TABLE 00 - 078 parameters for table. It contains array of note (in halftones) or frequency addings according to TABLE TYPE value. For negative values there is used complementary numbers, for example -1 = $FF.
ENVELOPE LENLength of envelope $01 to $20.
ENVELOPE GOJump to given envelope column after reach of envelope end.
VSLIDEVolume slide when end of envelope reached for the first time. $00 = no volume slide, $FF = maximal volume slide.
VMINMinimal volume value reached by VSLIDE parameter.
EFFECT DELAYDelay before start of VIBRATO and FSHIFT effects by $01 to $FF vbi, $00 = no effects.
EFFECT VIBRATOEffect vibrato, 3 levels $01 to $03, $00 = no vibrato.
EFFECT FSHIFTEfect "frequency shifting" $00 to $FF for each vbi.
AUDCTL POLY9Turn on / off AUDCTL "poly9" bit.
AUDCTL 15KHZTurn on / off AUDCTL "15khz" bit.
VOLUME RVolume $0 to $F for right channels. It will be used for stereo songs in tracks R1 to R4.
VOLUME LVolume $0 to $F. It will be used on tracks L1 to L4.
DISTORTIONSound type $0 to $E, even values only.
COMMANDEnvelope command $0 to $7.
X, YTwo parameters from $0 to $F for special command. It can be used as a two separate parameters or as one hexa value $XY.
FILTERFilter. $0 = no active, $1 = acitve. It works with sound generator 1 or 2 only. It engage two generators: 1+3 or 2+4. It has higher priority than 16bit bass tones and non filtered voices, therefore it can occupy their sound generators or it can switch 16bit bass tones to 8bit and use its high byte for filtering. If resulting volume is zero, filtering won't be used (and no occupation of other generators arrive).
PORTAMENTOPortamento. $0 = no active, $1 = acitve. If active, then "portamento volatile frequency" is used instead of current frequency.

Sound type (DISTORTION parameter)

0Distortion 0. (AUDC $0v)
2Distortion 2. (AUDC $2v)
4Distortion 4. (AUDC $4v)
6Distortion 12 (AUDC $Cv) plus join of two sound generators for 16bit resolution bass tones. It works with generator 2 or 4 only, It engage two generators: 2+1 or 4+2. On other generators it works as a distortion 12 with bass table 1.
8Distortion 8. (AUDC $8v)
ADistortion 10, pure tones. (AUDC $Av)
CDistortion 12, bass tones - bass table 1. (AUDC $Cv)
EDistortion 12, bass tones - bass table 2. (AUDC $Cv)

Envelope command (COMMAND parameter)

0Play the base note shifted by $XY semitones. If resulting note by reason of note shifting is out of C-1 to C-6 range (hex values $00 to $3D), then output volume will be zero.
1Play the frequency $XY directly.
2Play the base note shifted by frequency $XY.
3Add $XY semitones to base note. Play base note (new value). If resulting note by reason of note shifting is out of C-1 to C-6 range (hex values $00 to $3D), then output volume will be zero.
4Add frequency $XY to FSHIFT register. Play base note.
5Set up portamento speed $X, step $Y (each $X vbi will be "volatile portamento frequency" shifted up or down by $Y value in a direction of actual frequency). If $XY=$00, then set current frequency directly to volatile portamento frequency.
6Add $XY value to FILTER_SHFRQ. (Whenever the new note in track is getting start, FILTER_SHFRQ is initialized to $01, so that default join filter generator frequency is higher by 1.)
7Set the base note to $XY value directly. Play base note (new value).

Hotkeys

 LEFT ,  RIGHT ,  UP ,  DOWN Cursor moving.
 TAB Cursor move to set up instrument parameters / envelope parameters.
 SHIFT  TAB Cursor move to set up name of instrument.
 0-F ,  CONTROL+LEFT ,  CONTROL+UP ,  CONTROL+RIGHT ,  CONTROL+DOWN ,  BACKSPACE Settings of parameter values (in a valid range only).
 SHIFT  UP ,  DOWN Actual octave up / down.
 SHIFT  LEFT ,  RIGHT ,  numblock 0-9 Select actual instrument.

Instrument parameters

 HOME Move cursor to begin of table / to begin of "table loop".
 CONTROL  HOME Set up begin of "table loop".
 END Move cursor to end of table.
 CONTROL  END Set up end of table.

Envelope parameters

 HOME Move cursor to begin of envelope / to begin of "envelope loop".
 CONTROL  HOME Set up begin of "envelope loop".
 END Move cursor to end of envelope.
 CONTROL  END Set up end of envelope / set up a maximal length of envelope.

INFO EDIT

NAMEName of song and author, max. 64 chars.
MUSIC SPEED: AA/MM/S
AAActual beat speed, $01 to $FF.
MMMain speed, $01 to $FF. Actual beat speed is initialized by main speed when whole song is getting start to play.
SSpeed of instruments, $1 = 1 times a vbi, $2 = 2 times a vbi.

Hotkeys

 LEFT ,  RIGHT ,  TAB Cursor moving.
 SHIFT  TAB Cursor move to set up name of song.
 0-F ,  CONTROL+LEFT ,  CONTROL+UP ,  CONTROL+RIGHT ,  CONTROL+DOWN Settings of parameter values (in valid range only).
 ENTER Exit from INFO EDIT.

SONG EDIT

 LEFT ,  RIGHT ,  UP ,  DOWN Cursor moving.
 0-F ,  CONTROL+LEFT ,  CONTROL+RIGHT ,  BACKSPACE Set up number of track or "go to line" value in song.
 G Turn on / off "go to line" command in song.
 INSERT ,  DELETE Insert / delete lines in song (with auto-change of all relevant "go to line" values).

PROVE mode 1 - mono / 2 - stereo

 tonekeys Play note only (without changing of any tracks).
 SPACE Stop playing note on selected sound generator.
 ESC Mute all sounds, deactivate PROVE mode.