

                          ******* ADAMEm *******
                     The Portable Coleco ADAM Emulator
                                Version 0.2
                                
                    Copyright (C) 1996  Marcel de Kogel
                                          
	             Acorn Port by David McEwen 
	             Port Version : 0.23 (06/12/98)
	             
	             NEW IN THIS VERSION
	             -------------------

		     - Screen plotting fixes

		     Previous versions

	             - ZLib support
	             - Screen moe checking
	             - Smaller/faster code (again...)
	             
	             
	             
	             - Pre-Risc PC compatibility
	             - Smaller/faster executable
	             - *less* buggy
	             
Introduction
------------

This is a port of Marcel's very excellent ADAM emulator. This improves alot on ColEm
as it is more comprehensive. The ADAM was a complete computer, not just a console
like the Colecovision. This emulates both fairly comfortably. 

Key Mappings
============
ADAM keyboard:
F1-F6        -  Smart keys
F7           -  WILD CARD
F8           -  UNDO
Insert       -  INSERT
Delete       -  DELETE
Home         -  MOVE/COPY
End          -  STORE/GET
Page Up      -  CLEAR
Page Down    -  PRINT
Keypad 5     -  HOME
ColecoVision game controllers:
Cursor keys             - Joystick movement
Left Alt (Space in      - Primary firing button
Unix/X version)
Left Ctrl               - Secondary firing button
Left Shift              - Third firing button (port 1)
Z                       - Fourth firing button (port 1)
NumPad -                - Third firing button (port 2)
NumPad +                - Fourth firing button (port 2)
0-9, -, =               - Numpad 1
0-9, Del, Enter(right)  - Numpad 2
Special Keys:
F9                      - Toggle joystick/keyboard mode. In joystick
                          mode, the keyboard is used to emulate the
                          ColecoVision game controllers. In keyboard
                          mode, it is used to emulate the ADAM keyboard
Insert                  - Switch to joystick emulation mode 1 (Joystick
                          mode only). For a description of the available
                          joystick emulation modes, check the description
                          of the -joystick command line option
Home                    - Switch to joystick emulation mode 2 (Joystick
                          mode only)
Page Up                 - Switch to joystick emulation mode 3 (Joystick
                          mode only)
Delete                  - Swap joystick buttons (Joystick mode only)
End                     - Swap keyboard buttons (Joystick mode only)
Page Down               - Swap mouse buttons (Joystick mode only)
Both Ctrls + Both Alts  - Main reset lever
Both Ctrls + Both       - Cartridge reset lever
Shifts
F12                     - Quit emulator


You can use the frontend to configure the state of the emulator. The options in the 
window are basically aliases to command line options. The frontend is fairly basic,
this is mainly because it sends a command line to run the program - this means that
the number of options cannot be very large, due to command line constraints. In the
near future the front end and emulator shall be integrated ala !ColEm - so you can
have pause/resume by returning to the desktop. Also it will make it possible to 
create a multitasking version. The last thing is unlikely to happen any time soon
though - I know how to do it, but I just don't have time!!

The options you will find there are :

Resolution - Exactly the same as !ColEm

Ifreq - this should be 50 or 60, it is the refresh rate (ie either PAL or NTSC) 
	Default 50

CPUSpeed - should be 100%, but lower values may help speed it up. Default 100

Sync Emu - This forces the emulator to synchronize on every VDP interrupt - ie lock at 50
           or 60 fps. When not uses games disable this. The defult is on.
          
ColecoVision or ADAM - fairly obvious, default is ADAM

Disks/Tapes - select disks/tapes to use

Files of any type can be dragged to the disks/tapes boxes as I have not decided on a 
filetype - yet!! 


Current Limitations of Acorn Port
---------------------------------

1. No mouse support - will be put in soon...
2. No sound - you can log sound from command line and then convert to midi using Col2Mid


*FAQ*
----- 

Why are my Roms images not working ?
-------------------

Try downloading them again. If there is still no joy. Send the image to 
Marcel and see if he can find a reason. 

Where's the sound ?
-------------------

This is being worked on... This will arrive at some point I am sorting out 
how to do it nicely.

Do I need a special screen mode ?
---------------------------------

Nope the emulator runs happily in a 320 by 256 mode as the screen fits nicely. 
The full screen modes require  specially defined modes... a Mode Definition File 
is included. Currently it only runs in 256 colours, this will change soon, it is
just a peculiarity of the emulation code.

Will you get it to run in the desktop ?
---------------------------------------

This will be coming shortly, hopefully with sound!

When will you add Mouse support ?
---------------------------------

Ooopss... forgot... next release.


Will you be porting any other emulators ?
-----------------------------------------

Yes!!

OK... atm I have done 5 emulator ports :

ColEm
fMsx
ArcNes
Stella
MGear
Atari 800
and this...
but people are never happy :-(
Read my web page for latest developments...


Copyright and Disclaimer
------------------------

This emulator is copyright Marcel de Kogel 1996, and the Acorn-specific
components are copyright David McEwen 1998. You may not attempt to pass off
any part of this work as your own, although you may distribute it freely as
long as you supply the complete archive (that is, all the files supplied to
you).

This software is supplied "as is". I make no claims about the reliability or
suitability for any purpose of this emulator, and any use of it is undertaken
at your own risk. No responsibility is taken for any failure of the software,
or for any loss or damage caused directly or indirectly by the software.

Whilst I will endeavour to help you if you have problems with this emulator,
no such support is guaranteed.

In the above "This emulator" refers to everything supplied within this
archive, which is specifically the !AdamEm application and all the files
contained within it, and also the documentation files (including the one you
are reading now).



COMMENTS
--------

Any comments about the emulator as such should go to Marcel de Kogel : 
email : m.dekogel@student.utwente.nl
Website : http://www.komkon.org/~dekogel/adamem.html

Any comments about the Acorn specific parts and please no inane emails giving 
me ways of making money etc... just useful constructive stuff please
email : dem95c@cs.nott.ac.uk
Website : http://www.cs.nott.ac.uk/~dem95c


