Feel free to distribute, use and change all files included in this archive.

If you are new to Atmas 2 or Atmas 4, please read carefully notes bellow:

ALPH_SRC.ARC - this file contains sources of Alpha intro (GMG/1998)
IMPL_SRC.ARC - this file contains sources of Implosion demo (GMG/1997)
ALPH_OBJ.ARC - this file contains binaries of Alpha intro
IMPL_OBJ.ARC - this file contains binaries of Implosion demo (GMG/1997)

*.SRC - is Atmas II source file
*.4   - is Atmas 4 source file
*.CMC - is Chaos Music Composer (mono) file
*.MPT - is Music ProTracker (mono and stereo) file
*.BIN - is simple binary file (without header)
*.DAT - is simple binary file (without header)
*.PAK - is simple packed binary file (without header)
*.OBJ - is binary file (with header)
*.    - is binary file (with header), sometimes executable (e.g.:bdep)
*.COM - pure executable

- we used Atmas II for alpha versions of effects, routines.
- final compiling and debugging was done in Atmas 4.
- we were using Bibo Dos 6.4RF (XF speed)
- all pictures were painted in MPE (Marco Pixel Editor) or MEGA (Mega color editor) - they can be found in our download area.

Some important remarks about Atmas 2 and 4:
----------------------------------------
- Both assemblers compile only directly into RAM. You can then run or save your work on the disk
- Atmas 4 is loaded under 'ROM' - you can use RAM from MEMLO to MEMTOP for your code and obj. (in monitor hit 'A' to manage your addresses)
- some shortcuts: from editor to monitor = ctrl+p, top of file = ctrl+e, end of file = ctrl+d ; compile source = ctrl+y ; read source = esc,rd1:filename.ext,esc,esc (hit esc, type 'r' as read or 'w' as write followed by device and number, then the filename, and finally hit 2x esc to perform operation).
- monitor: g=goto, m=memory dump, l=load binary (NOTE: A2 loads with headers, A4 loads files without headers), s=save binary, i=dir (only A2), d=disassembler; try to find out more.
- I recommend you to find more about Atmas 2 in other doc files.
- You may encounter file reading problems in Atmas 4. (A2 has no problems with d: device) That's because this assembler has not been written for disk drives. It is NEEDED to manually restore D: device in HATABS (in monitor hit 'g' - goto init d: device ; in Bibodos 6.4 it is $709). Then you return to editor (hit 'e'). If an error occurs (top right corner of editor screen displays error number), you must repeat initialization. (go to monitor, init, return to editor). After pressing RESET it is of course needed to init d: device too.
- there is almost no difference between *.4 and *.SRC. They seem to be identical except for few last bytes of file. A2 fills last sector of *.SRC file with some junk. A4 saves exactly the length of file. Therefore, If you'll load *.SRC file into A4, there would be junk bytes at the end of file - you'll have to cut'em off. And vice versa - if you'll want to load *.4 file into A2, it is needed to add some lines of junk to the end (e.g.: 10 lines of 'asc % -32xspace- %'). They will be automatically cut off by Atmas 2
- watch out not to overwrite your source code by binaries (or compiling in location where the source code is stored). (Location of A2 in memory is : $2800-4fff), you can manually change addresses where the source code will be stored. go to monitor and hit 'c' - change address;  $ac - holds high byte of beginning of copy buffer; $ad - end of copy buffer; $ae = high byte of beginning of source code; $af = end of source code in memory. after changing these values you have to hit 'g' - goto $334a. This will update Atmas II and you can now use new locations for storing your source code and compiled code in memory. This can be achieved in Atmas 4 more easily - by pressing 'a' in monitor.


... hope this file will help at least someone

enjoy...

This README was written by Marco/GMG
don't hesitate to contact me...
mchorvat@pcb.sk, mchorvat@hotmail.com

2.4.1999, Banska Bystrica, Slovakia, Europe