file_id.diz
************************************************************************
RASTER MUSIC TRACKER - RMT
by Radek Sterba, Raster/C.P.U., 2002-2004
http://raster.atari.org
************************************************************************
RMT [Raster Music Tracker] MULTITIMBRAL INSTRUMENT - MIDI IMPLEMENTATION CHART
-------------------------------------------------------------------------------
Function | Recognized | Remarks
----------------------|----------------------|---------------------------------
Basic Default | 2-9 | 2-5 = L1-L4 , 6-9 = R1-R4
Channel Changed | x | (Channel 1 is reserved for edit)
----------------------|----------------------|---------------------------------
Mode Default | Mode 4 |
Messages | x |
Altered | x |
----------------------|----------------------|---------------------------------
Note | 36-96 | RMT notes from C-1 to C-6
Number : True voice | 36-96 |
----------------------|----------------------|---------------------------------
Velocity Note ON | o 9nH,v=1-127 | RMT volume = v / 8
Note OFF | x 9nH,v=0 8nH,v=xx |
----------------------|----------------------|---------------------------------
After Key's | x |
Touch Ch's | x |
----------------------|----------------------|---------------------------------
Pitch Bend | x |
----------------------|----------------------|---------------------------------
Control | x |
Change | x |
----------------------|----------------------|---------------------------------
Prog | o 0-63 | RMT instruments 00-3F
Change : True # | o 0-63 |
----------------------|----------------------|---------------------------------
System exclusive | x |
----------------------|----------------------|---------------------------------
Common : Song Pos. | x |
Song Sel. | x |
Tune | x |
----------------------|----------------------|---------------------------------
System : Clock | x |
Real Time: Commands | x |
----------------------|----------------------|---------------------------------
Aux : LocalON/OFF| x |
Messages : ResetAllCtr| o (121) | Silence + Reinit of RMT routine
: AllNotesOFF| o (123) | Note OFF
: ActiveSense| x |
: SystemReset| o | Silence + Reinit of RMT routine
-------------------------------------------------------------------------------
Mode 1: OMNI ON, POLY Mode 2: OMNI ON, MONO o: Yes
Mode 3: OMNI OFF, POLY Mode 4: OMNI OFF, MONO x: No
************************************************************************
RASTER MUSIC TRACKER - RMT
by Radek Sterba, Raster/C.P.U., 2002-2004
http://raster.atari.org
************************************************************************
About:
RASTER Music Tracker (RMT) is a cross-platform tool for making Atari XE/XL
music on PC (OS Win9x). RMT uses new Atari XE/XL music routines of my own
- I developed them for a very long time and I hope it will be small
revolution for all Atari musicians and fans.
Disclaimer:
THIS SOFTWARE IS PROVIDED "AS IS" 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.
Credits:
Bob!k/C.P.U.
JirkaS/C.P.U.
Main features:
* Mono 4 tracks / stereo 8 tracks.
* 254 tracks, each with its own length (256 beats max.) and with support for track loop.
* 64 instruments (stereo, instrument table up to 32 steps - 2 types and 2 modes with loop,
instrument envelope up to 32 steps with loop, portamento, filter, 16bit bass, volume slide,
volume minimum, vibrato, frequency shifting, etc.).Fully automatic management of AUDCTL
register (filters, 16bit basses) and/or manual AUDCTL settings.
* Support for "volume only" forced output.
* Note portamento up/down effect.
* Instrument envelope commands for note/frequency shifting and support for special
"like a C64 SID chip" filtering.
* Up to 256 lines for song (with "goto line" support).
* Beat speed 1 to 255 (1/50 to 255/50 sec).
* Instrument speed from 1 to 4 per screen (up to 1/200 sec).
* Main input/output song file format: RMT song files (*.rmt).
* Input/output instrument file format: RMT instrument files (*.rti).
* Export formats: RMT stripped song file (*.rmt), SAP file (*.sap),
XEX Atari executable MSX file (*.xex).
* Import formats: ProTracker modules (*.mod), Atari XE/XL Theta Music Composer songs (*.tmc)
* Support for speed/size optimizations of RMT assembler player routine
for concrete RMT module (very useful for background music in demos, games, etc.).
* MIDI IN support!
* MIDI multitimbral playing possibilities.
You can use the RMT like a Atari multitimbral MIDI instrument.
You have to send MIDI output from your MIDI sequencer or player
to RMT MIDI input by means of some virtual MIDI cable (for example
"MIDI Yoke" etc.). MIDI implementation chart is in midi.txt file.
Technical info:
Pokey sound emulation and Atari 6502 processor emulation aren't built-in
components of RMT. If the sound output is needed, the external dynamic DLL
libraries with the following functions are required.
If you run RMT without this way described DLLs (sa_pokey.dll, sa_c6502.dll),
RMT will work, but there won't be any Pokey sound output and Atari sound
routines won't be executed.
sa_pokey.dll
void Pokey_Initialise(int *argc, char *argv[]);
void Pokey_SoundInit(uint32 freq17, uint16 playback_freq, uint8 num_pokeys);
void Pokey_Process(uint8 * sndbuffer, const uint16 sndn);
UBYTE Pokey_GetByte(UWORD addr);
void Pokey_PutByte(UWORD addr, UBYTE byte);
void Pokey_About(char** name, char** author, char** description );
sa_c6502.dll
void C6502_Initialise(BYTE* memory );
int C6502_JSR(WORD* addr, BYTE* areg, BYTE* xreg, BYTE* yreg, int* maxcycles);
void C6502_About(char** name, char** author, char** description );
Greetings:
Fox/Taquart (Thanks for XASM)
Jaskier/Taquart (Thanks for TMC)
Tatqoo/Taquart
Sack/Cosine
X-ray/Grayscale
Greg/Grayscale
Bewu/Grayscale
PG (Thanks for ASMA - Atari SAP Music Archive - http://asma.atari.org)
All the active "Atariarea" Polish Atarians (http://atariarea.nostalgia.pl)
...and other 8bit Atarians all over the world! :-)
************************************************************************
RASTER MUSIC TRACKER - RMT
by Radek Sterba, Raster/C.P.U., 2002-2004
http://raster.atari.org
************************************************************************
Changes in RMT 1.15
-------------------
- Quadruple instrument speed allowed also for 8 tracks STEREO modules.
- .rmt (.txt,.rmw) filename can be used as the commandline parameter
for the automatic loading of this file after start of the RMT tracker.
(It's recommended to make association for "rmt" extension to run RMT tracker.)
- Show Play time counter (from 00.0 sec to 9:59 minutes).
(default is on, turn off by menu View - Play time counter)
- Menu Track:
* Info about using of actual track.
* Renumber all tracks (2 types of ordering).
* Clear all tracks unused in song.
- Menu Instrument:
* Renumber all instruments (3 types of ordering).
* Clear all unused instruments.
- Two tracks functions moved from Song menu to Track menu (Search and rebuild wise
loops in all tracks, Expand loops in all tracks).
- Size optimization function (menu Song - All size optimizations) perform also
clearing of all unused instruments and renumbering of all tracks and instruments now.
(So there can be a bit better result of size optimization thanks to removing unused
instruments and removing empty gaps after deleting of unused tracks and instruments.)
- Preserve last "From address" value in export of stripped RMT file dialog.
RMT routine changes
- Several improvements of RMT Atari assembler routine - it is 22 bytes shorter now
and faster about 50-150 CPU cycles.
- New speed/size optimalization options FEAT_VOLUMEMIN and FEAT_TABLEGO supported
and optimalization for FEAT_AUDCTLMANUALSET improved.
(Coders, you have to use new rmtplayr.a65 and rmt_feat.a65)
- New mono/stereo compile modes. There is variable STEREOMODE (instead of previous
variable STEREO8T) with the following values:
STEREOMODE equ M ;M=0 => compile RMTplayer for 4 tracks mono
;M=1 => compile RMTplayer for 8 tracks stereo
;M=2 => compile RMTplayer for 4 tracks stereo L1 R2 R3 L4
;M=3 => compile RMTplayer for 4 tracks stereo L1 L2 R3 R4
* Note: If RMTplayer routine compiled with STEREOMODE 2 or 3 is used on Atari computer
without STEREO upgrade, then standard 1 POKEY mono music will be played.
It exploit POKEY memory area mirroring - there isn't used any "stereo detection" method!
Bug fixes
- Bug in rmtplayr.a65 initialization part if nonzero "starting song line position"
was used. (This problem occured in some cases only.)
- Buffer overflow error with export of stripped RMT file for too high address.
- Other small corrections and bugfixes.
Changes in RMT 1.14
-------------------
- Menu Project: Import...
* Support for importing of classic ProTracker MOD format with 31 samples,
4 or 8 channels (also modules with 5, 6, 7 channels), as well as old
ProTracker 15 samples 4 channels MOD modules.
After import there is need of manual adjustment (tones tuning and distortions)
of all instruments at first!!! Volume envelopes and loops are prepared
in accordance with real samples in MOD module.
* Support for importing of Atari XE/XL TMC Theta Music Composer modules.
TMC instruments are imitated automatically by RMT instruments if it is possible.
There can be need of manually corrections!!!
(Disclaimer: Some TMC effects may be totally wrong, sorry.)
- Menu Track:
* Search and build wise loop.
* Expand loop.
- Menu Instrument:
* Info about using of actual instrument.
* Change all the instrument occurences.
- Menu Song:
* Song switch to 8 tracks / Song switch to mono 4 tracks.
* Tracks' order change in whole song.
* Search and rebuild wise loops in all tracks.
* Expand loops in all tracks.
* Size optimization.
- Menu View - Configuration:
* Continue on previous/next song track upon the first/last track line
(default is on).
- Insert/delete envelope columns in instrument edit mode
by Insert/Delete key (at the current cursor position).
- Insert/delete table items in instrument edit mode
by Insert/Delete key (at the current cursor position).
- Increase/decrease the whole envelope row of parameters in instrument edit mode
by Shift+Control+Up/Down key (while cursor is in envelope data area).
- Increase/decrease the whole instrument table in instrument edit mode
by Shift+Control+Up/Down key (while cursor is in table data area).
Accessories
- Atari RMT player RMT1PLAY.XEX (new version 1.01) is in "player" directory.
(There is possible to show/hide song info text by spacebar key.)
New songs
- Song "nopromis.rmt" (No promises, raster/c.p.u. 2003)
Song "aurora_s.rmt" (Hymn to aurora, Atari version by raster/c.p.u. 2003)
Song "turrican2_rev2s.rmt" (Turrican 2 noise 3, Atari version by raster/c.p.u. 2003)
in "songs" directory.
(SAP file "aurora_s.sap" and "turrican2_rev2s.sap" in "exports/sap" directory.)
- 5 songs from sack/cosine, 2003, www.cosine.org.uk
in "songs/sack_cosine" directory.
New instruments
- "drums/bassdrum.rti"
"drums/snaredrum.rti"
"drums/hithatclose.rti"
"drums/hithatopen.rti"
in "instruments" directory.
Bug fixes
- Main volume changes in instrument edit mode.
- Other small corrections and bugfixes.
Changes in RMT 1.13
-------------------
- MIDI multitimbral playing possibilities.
Now you can use the RMT like a Atari multitimbral MIDI instrument.
You have to send MIDI output from your MIDI sequencer or player
to RMT MIDI input by means of some virtual MIDI cable (for example
"MIDI Yoke" etc.). MIDI implementation chart is in midi.txt file.
- All tracks cleanup (menu Tracks - All tracks cleanup).
- All instruments cleanup (menu Instrument - All instruments cleanup).
- Block effect/tool "Expand/shrink lines" improved - negative values allowed
for bottom-up way alterations.
- Prepare duplicated song line (menu Song or Control+O).
- Prepare song line with unused empty tracks (menu Song or Control+P).
- Other small corrections.
Changes in RMT 1.12
-------------------
- Support for higher instrument speeds: triple speed for STEREO modules,
triple and quadruple speed for MONO modules.
- Support for NTSC 60Hz system speed (menu View - Configuration).
- Simpler and shorter XEX Atari executable msx export file (*.xex).
- New menu "Block" with all the block functions.
- New feature - block effects/tools (menu Block - Effect/tools or Ctrl+F
or toolbar button "FX").
Effects/tools:
* Fade in/out
* Echo
* Expand/shrink lines
* Volume humanize
- Midi event "note off" recording possibility (menu View - Configuration).
Bug fixes
- Correction of instrument tempo-related bug (in RMT assembler routine
and also in tracker). (Thanks to Memblers from Indiana for notice.)
- Higher instrument speeds timing in Atari msx corrected.
- Numeric block keys plus/minus locked away the shift key.
Changes in RMT 1.11
-------------------
- Maximal length of track increased to 256 beats.
- New Config dialog (menu View - Configuration):
* Track line highlight step.
* Some keyboard hotkeys options.
* MIDI IN support! (events: key on, program change)
* OK button save the configuration to rmt.ini configuration file.
- New input/output file format: TXT song files (*.txt).
(It's simple text format for easy making any convert tools.)
- Change of toolbar icon for PROVE MODE and new icon for MIDI on/off
- New TrackEdit block function:
Control+E ..exchange of block select data and the clipboard data.
- Show the AUDF, AUDC and AUDCTL Pokey registers
(default is off, turn on by menu View - Pokey chip registers)
- Light blue color of volume only values in the instrument envelope.
- Checking for right version of RMW working files (RMW work files haven't
portability through the different RMT tracker versions).
New songs
- Song "aspir332.rmt" (Aspiration 332, by Raster/C.P.U. 2003)
in "songs" directory.
Bug fixes
- Bug with bad beat count if standalone speed command has been in track.
- Other small corrections and bugfixes.
Changes in RMT 1.1
------------------
- Main RMT assembler routine changed to version 01:
- Backward compatibility:
* Support for loading of previous (version 00) RTI instruments.
(saving RTI instruments version 01 only)
* Support for loading of previous (version 00) RMT modules.
(saving RMT modules version 01 only)
- New RMT routine features:
* Support for manual AUDCTL settings (but also automatic management is preserved,
if you will use command 6 or "filter" switch).
* Support for VOLUME ONLY settings by command 7 with parameter value $80.
(Volume only forced outputs are indicated by light blue color of volume analyzer box,
see the easy example song file "examples/volumeonly.rmt".)
* Support for NOTES/FRQS TABLE length from 1 to 32.
* A lot of speed/size optimizations (RMT modules with easy instruments are smaller than before).
- Support for speed/size optimizations of RMT assembler routine for concrete RMT module.
(See the RMT player routine assembler source code and "Export song as.. RMT stripped
song file (*.rmt)" dialog and optimized routine example in "asm_src/optim" directory.)
- Hotkeys' changes:
Pause ... mute all sounds and reinit RMT routine only.
Shift+Pause ... mute all sounds, reinit RMT routine and sound output.
- If any instrument parameter is changed, then turn off this instrument on all
channels where it sounds.
- If save or export process is aborted or failed, destination file will be deleted.
Bug fixes
- RMT routine - instrument table speed bug (each first note/frq table item was shorter by 1/50 sec).
- Tab key while edit the instrument name (no CapsLock off).
- PageUp/Down for octave up/down in Prove mode.
- Instrument volume curve fault by mouse position after the instrument load.
- Mouse doubleclick to track/channels turn on/off.
- All the showed messages (message boxes) are owned by RMT application now.
Changes in RMT beta 1.02
------------------------
Since the RMT beta 1.02 version all the parts based on GPL sources are totally removed
from the RMT project (i.e. Pokey sound emulation and Atari 6502 processor emulation)
and these aren't a part of RMT henceforth.
Description of dynamic DLL functions for standalone Pokey and 6502 emulation
is specified in the readme file. If you run RMT without this way described DLLs
(sa_pokey.dll, sa_c6502.dll), RMT will work, but there won't be any Pokey sound output
and Atari sound routines won't be executed.
Improvements
- Use the hardware sound buffer if possible (instead of software sound buffer).
- Initialize the file load directory to program location.
- Block toolbar is showed by default.
- Much more summary informations in the About box.
- Text parameters editing was changed a bit. Because of ShiftKey is used for playing
the notes, You have to press the CapsLock key for switch to "normal" ShiftKey behaviour
(i.e. ShiftKey+Key for entering uppercase and other (!@#$%^&*()_+:"<>?|) characters).
CapsLock mode is turned off automatically when text editing is over by pressing the Tab key
or Enter key.
- CapsLock state indication in the status bar ("CAP").
- Reinit also RMT Atari sound routines when the Pause key is pressed.
- Functions for turn on/off the sound channels (tracks):
* Control+ 1-8 ...turn on/off the sound channel (track) 1-8.
* Control+ 9 ...turn on all the channels (tracks).
* Control+ 0 ...turn off all the channels (tracks).
* Control+ BackQuote ...turn on/off the active sound channel (track).
* Shift+ BackQuote ...negation of turned on/off sound channels (tracks).
* BackQuote ...solo play of active sound channel (track) / turn on all channels (tracks).
Note: Muted sound channels are indicated by gray color of track title and volume
analyzer scope.
- Status bar tool tips and short flying help messages completed.
- Other internal improvements.
TrackEdit
- Mouse control of turn on/off the channels (tracks) - it's indicated by mouse cursor design
change to "hand with title 'on/off'":
* LeftMouseButton ... turn on/off relevant channel (track).
* RightMouseButton ... solo play of relevant channel (track) / turn on all channels (tracks).
InstrumentEdit
- Drawing of envelope volume curve by mouse - it's indicated by mouse cursor design
change to "pen with title 'volume'":
* LeftMouseButton ... draw volume curve.
* RightMouseButton ... set volume to zero value.
Bug fixes
- Playing the block area.
- Inserting and deleting song lines from track edit when "go to line" is active.
- Other internal corrections.
Changes in RMT beta 1.01
------------------------
All modes
- Set the octave up-down hotkeys changed from Shift+up,down to Shift+page_up,page_down
(it works now in TrackEdit and InstrumentEdit only).
- Correction of bug with instrument copy/paste.
TrackEdit
- No more set number of the track by Control+0-9A-F keys.
- Hotkey changed: Control+I - insert new line into the song.
- Hotkey changed: Control+U - delete the current line from the song.
- Show title "EMPTY" for empty tracks.
- Shift+up,down,home,end - the block select functions.
- Control+A - select all data in the track (from the begin to the end of the track).
- Control+Insert,Control+C - copy block to clipboard.
- Shift+Insert,Control+V - paste data from clipboard.
- If the block is selected and paste function is used, then data from clipboard is placed into the block select area only.
- If the block is selected, then Delete key will delete data inside the block area.
- If the block is selected, then Control+X key will cut data inside the block area.
- New toolbar for block data modifications: menu View - Block toolbar. All this modify functions are available also by hotkeys.
- Block data modification hotkeys (the block must be selected at first):
* Shift+Control+A switch between block modify mode all / current instrument only.
* Shift+Control+page_up,page_down do transpose up,down notes in the block (by semitones).
* Shift+Control+left,right do change of instrument numbers in the block.
* Shift+Control+Num-,Num+ do change of volumes in the block.
Note transpositions, instrument changes and volume changes are indicated in window statusbar at the bottom.
- If the block is selected:
* Enter key will play the lines inside the block around.
* Home or End key set the cursor to the first or the last line in the block.
* Control+B will restore the block data changed by modification functions from the backup (backup is created when the block is getting start to select and destroyed when the block is deselected).
* Control+F4 will start cyclic playing of the part from the top to the bottom of selected block area.
Operation manual
- All this changes included to operation manual (see the rmt_en.htm, rmt_cz.htm).
RMT beta 1.00
-------------
- The first published version.
************************************************************************
RASTER MUSIC TRACKER - RMT
by Radek Sterba, Raster/C.P.U., 2002-2004
http://raster.atari.org
************************************************************************
Player speed/size optimizations
-------------------------------
Are you an Atari coder? Yes, then you can read below...
If you will export song as "RMT stripped song file (*.rmt)", you can specify
address for required memory location of this exported RMT module (RMT file
is standard Atari binary file with set of heading data). You can take also
a RMT FEATures definitions text and move it into rmt_feat.a65 source
code file by clipboard. (You have to replace a part between the "--BEGIN--"
and the "--END--" marks.)
If you do it and compile such modified player source, you obtain optimized
player routine for this concrete RMT module.
Optimized player routine contains only features used by this RMT module,
that's why it is more or less smaller and quicker. Of course, you can't
use it with any other RMT module and every time you change the RMT module,
it's very recommended to take RMT FEATures definitions text again
and recompile RMT player routine.
This technique is very useful for background music in your demos, games, etc.
Example:
You can see the example of this method in "asm_src/optim" directory.
Optimized player for "music.rmt" module only is smaller about 626 bytes (!)
and surely much faster than standard full-features providing player.
freedom.rmt
-----------
Freedom - from a chiptune by grim/digital. spent ages listening to this one (probably because it was used on the Fairlight version of Frontier - elite 2 which had 100+ options and took a while to set up from the trainer screen)
Mayonaise.rmt
-------------
Mayonaise by the Smashing Pumpkins (from the album Siamese Dream). just a great song iz all.
Monty.rmt
---------
Monty on the run high score theme. Originally by Rob Hubbard.
Parallax.rmt
------------
part (IMHO the best part) of the intro music by Martin Galway.
Because of the lack of drums you really need a bassline with a bit of a kick to it. This is where the 'horrible distortion' of the POKEY people keep trying to supress actually becomes an advantage.
PlasticPop.rmt
--------------
Originally by Danko/censor.
Told him I hated this song because it just buries itself into your brain and NOTHING will remove it. I *like* the song - I'd just like it more if I could walk down a quiet street 4 hours later and NOT be humming it :)