Introduction
============
AppleCE is my first project to learn programming in Visual C++ (also eVC++). 
At the same time I always want to play my favorite Apple ][+ games (Yes I'm 
rather old) on my only PPC (EM500) but so far no one did it. So I take it as 
my project.

Just as I begin, the first problem I faced is lacking Apple ][ technical
information. Even in Google I don't find anything useful so I referred to
other Apple ][ emulators. Reverse engineered those information from their
source code, and wrote the emulator from scratch. Every line of code, even 
the compress/decompress routine is my own creation. So don't expect it to
be as sophisticated as AppleWin.

Installation
============
First of all, this emulator is only tested on EM500 and kDirect565 mode.
However other PPC including E115, E125 and iPaq seems to work fine.

Unzipped the proper version for your PPC into same directory anywhere you 
like. 4 files are included in the zip file: applece.exe, APPLE2.ROM, 
CHAR.ROM and applepanic.dsk. ApplePanic is one of my first game and I 
included here. If you don't like it, you can remove it.

This program requires GAPI and kDirect565 mode to run. You can get GAPI
at www.pocketpc.com

In addition to Disk Image (extension .dsk), Nibble-1 format (extension .nib
with file size 227k) is also supported. You can find almost any image you 
remember at ftp.apple.asimov.net. Disk image must be placed in "My Documents" 
directory (either in main memory or storage card). 

Features
========
- Apple ][+ emulation
- 16K Language Card
- 2 Disk ][ Drives supporting DSK, NIB (1) file format
- Virtual/external keyboard support
- Joystick support with optional auto-centering
- Custom key mapping with auto-repeat option
- Display in landscape or portrait
- Save disk image in compress format with keymapping
- CPU and memory save state option
- 20 frames per second
- 22kHz sound sampling
- Throttling control

Bugs
====
- Volume control doesn't work on EM500 (though works in emulation)
- Some games encounter slow disk access

History
=======
0.2b (21-Apr-01)
- Trial external (Stowaway/GoType) keyboard support and not all keys
  enabled
- Fixed bugs in 16K Language Card
- Fixed bugs in save state routine
- Added 'Color Enhanced' display mode to improve readability of text.
  For instance in Alternate Reality and Return of Heracles.

0.2a (15-Apr-01)
- Trial build for SH3 though totally untested, so be careful and let me know
  of any glitches.
- Redo GUI to reduce program size (150k down to 110k).
- Expanded keyboard size as requested.
- Add drive status indicator.
- Added useless splash screen for author's own fun.
- Added option for auto-repeating keystroke. Return of Hercules can now be
  played without using virtual keyboard.
- Changed key mapping logic, now key mapping file won't be loaded together 
  with disk image. You have to rename it with extension .apcf and load it 
  manually.
- Corrected color averaging calculation.
- Improved sound.
- New throttling logic. With throttling turned off, for some games you may 
  find it TOO FAST to be playable on your PPC.
- Support compressed save game together with key mapping and optionally CPU
  and memory state.

0.1b2 (1-Mar-01)
- Added monochrome (green & orange) monitor for die hard appler
- Fixed bug in reboot
- Fixed bug in joystick and works fine in most games (Karateka & LadyTut!)

0.1b (21-Feb-01)
- Support Portrait with Color Average or Pixel Dropping
- Support button mapping to joystick or key stroke
- Button mapping can be saved per disk image
- Allow disable throttling
- Fixed stupid bugs

0.1a (14-Feb-01)
- Apple ][+ emulation with 16K Language card
- 100% speed with 20Hz display refresh and 22.05kHz sound sampling
- Support text, low resolution and high resolution output

Acknowledge
===========
AppleWin by Michael O'Brien
An advanced Apple ][ emulator for Windows, which is too advance that the 
poor author cannot understand thoroughly.

Applelet by Steven E. Hugg
Most of my understanding in Apple ]['s operation comes from this unique 
emulator (though written in Java).

M6502 by Marat Fayzullin & Alex Krasivsky
M6502 is the CPU core module used in AppleCE.

Color Average by Mark Rejhon

Disclaimer
==========
This emulator is available as a freeware, no commercial use (really doubt) 
is allowed. The author do not whole any responsibility in any damage in 
any form and etc. Use it at your own risk! 

If this emulator offends any copyright, trademark or anyone's benefit, 
please inform me.

Erik Chong
bonelyfish@yahoo.com
