README.md
Welcome to MyUAE
----------------

MyUAE is a port of E-UAE 0.8.27 for Palm OS 5.x
This port was done using the great ZDoomZ enviroment from yoyofr.
You need around 9 MB free dynamic memory. If your device doesn't
have so much dynamic memory, try UDMH to reuse some of your storage
memory as dynamic memory.

This port supports:
* sound
* a virtual keyboard (Treo's keyboard comes next)
* 4 virtual disk drives
* 2 save state per df0 adf name
* configurable input
* screenshots as BMP
* disk changes
* mouse and joystick
* on Tungsten: landscape left and right, portrait
* write access to disk files

It doesn't support:
* AGA
* higher processors than 68000
* hardfiles


Please report bugs to
metaview@web.de

Watch out for updates and other cool stuff at
www.metaviewsoft.de


Installation:
-------------

Create a directory on your expansion card: /PALM/Programs/MyUAE
There you place your .rom files, your .adf files and the MyUAE.zdk.
When you start MyUAE, it registers .rom, .adf and .zdk for Hotsync.
Therefore you could hotsync the files from the desktop. But I would
rather recommend a card reader.

Install MyUAE.prc either on the main memory of your PDA or in /PALM/Launcher
on your expansion card.

Don't forget to adjust your buttons and have a look onto the options page.


Frequently Asked Questions:
---------------------------

All about UAE:
http://www.rcdrummond.net/uae/
http://www.winuae.net/


History:
--------

0.1 initial release as PalmUAE
* only runs on Zodiac
* shows kickstart screen

0.2 2nd release as PalmUAE
* rom file and 4 adf files are selectable
* mouse support working
* "Lemmings" works

0.3 (4. April 2005)
* adf file selection fixed
* input configurable
* support for more Palm OS 5.x devices
* works on different resolution, no screen rotation yet
* renamed from PalmUAE to MyUAE, because there is already another PalmUAE (but MyUAE is better ;-)
* "North vs. South" and "Lotus" runs

0.4 (6. April 2005)
* mouse support enhanced
* much more robust (fixed a bug regarding non-32-bit aware Amiga apps, includes WB 1.3)
* screens with 320 pixel width are centered
* memory and speed (frameskip) configurable
* "Wings" runs
* fixed joystick handling
* keyboard enhanced
* less busy waiting, should save your batterie...

0.5 (10. April 2005)
* Save state support (2 states per game possible, name is given from the current diskname in df0)
* Landscape support (left and right hand mode), mouse and joystick are handled correctly but menu
and keyboard is still wrong (doesn't effect Zodiac)
* kind of sound support (it's too slow, needs rework)
* memory access beyond 24bit-range better handled
* reset and quit moved to a on-screen menu
* palette adjusted (much brighter screen)
* left + right mouse button can be pressed together

0.6 (15. April 2005)
* adjustable mouse scaling (in game)
* adjustable volume settings + mute (in game)
* better Sound support (not perfect, but ok in many games)
* a lot of really cool gfx + new icon added (many, many thanks to Ren� G�ke)
* alpha-blended keyboard works now in all 3 display modes (portrait, landscape right and left)
* screenshot feature
* help text for options page added
* Disk change support

0.7 (1. June 2005)
* status line: CD is replaced by a small clock (hhmm)
* status line: Battery level displayed (left most number)
* better handling of in-emulation menu
* in-emulation menu partly with icons (many thanks to Ren� G�ke)
* keyboard a bit nicer
* keyboard with US-layout (many thanks to Ren� G�ke)
* mouse and keyboard can be used together in portrait if keyboard is at the very bottom
* disk speed adjustable (100% or 800%)
* buffered read, faster disk access
* buffered write
* emulator size a bit smaller (below 4 MB), more stuff allocated on the fly
* kickrom in storage memory (512 k dynamic memory saved)
* load / save state with kind of progress bar
* save state compressed: faster
* save state without crashes (no big memory allocations anymore)
* option for autosave/autorestore (is the former Slot 1, the former Slot 2 becomes now Slot 1, Slot 2 is new)
* better way to switch to fullscreen

0.8 (3. June 2005)
* fixed a race condition in portrait mode which leads to a crash during exit
* status line adjusted in portrait mode
* Framskip up to 10 possible
* fastmem of 2 MB isn't possible (it's bogomem at the end) -> 1.5 is max

0.9 (22. July 2005)
* write access to disk files possible
* fixed a issue with mouse emulation on Tungsten landscape

0.91
* removed debug output
* number of drives selectable
* Cloanto kickstart support (put the keyfile as "rom.key" in the MyUAE folder)

ToDo:
-----

* better Sound support (how, but how? assembler copy?)
* Hardfile support
* using 5-way (or analog stick) as mouse replacement
* faster screenupdate (assembler, unrolled loop, left/right border)