KEGS 1.38 - MorphOS Port by Papiosaur
=====================================

KEGS is an Apple IIgs emulator for MorphOS.

Original author: Kent Dickey
MorphOS port: 2025


FEATURES
--------

- Full Apple IIgs emulation (65816 CPU)
- Video via CyberGraphics (320x200, 640x200 Super Hi-Res)
- Sound via AHI (triple buffering, 48kHz stereo)
- Native joystick support via lowlevel.library
- Full keyboard with special keys
- Window resizing with aspect ratio preservation
- FPS display in title bar


INSTALLATION
------------

1. Copy the KEGS folder to your preferred location
2. Place your Apple IIgs ROM in the "data/" folder
   - File: APPLE2GS.ROM2 (ROM version 03, 256 KB)
3. Place your disk images in the "data/" folder
   - Supported formats: .2mg, .po, .dsk, .woz


USAGE
-----

Launch kegs_mos from a shell or by double-clicking.

Special keys:
  F4           - Configuration menu
  F1-F10       - Apple IIgs function keys
  Ctrl         - Control
  Left Alt     - Option (Open Apple)
  Left Amiga   - Command (Closed Apple)
  Arrow keys   - Movement

Joystick:
  Native MorphOS joystick is enabled by default (port 1).
  Red button   = Button 0 (fire)
  Blue button  = Button 1

Configuration (F4):
  - Disk Configuration: mount/unmount disk images
  - Joystick: choose between Keypad, Mouse or Native Joystick
  - Speed: emulation speed
  - Save changes: save configuration to disk


FILE STRUCTURE
--------------

kegs_mos          - MorphOS executable
config.kegs       - Configuration file
data/             - Folder for ROM and disk images
  APPLE2GS.ROM2   - Apple IIgs ROM (must be provided)
  *.2mg, *.dsk    - Disk images


SYSTEM REQUIREMENTS
-------------------

- MorphOS 3.19 or later
- Apple IIgs ROM (not included)


KNOWN ISSUES
------------

- Sound may have slight distortion during CPU spikes
- Some games use I/J/K/L keys


CHANGELOG
---------

Version 1.38 MorphOS (2026)
- Initial MorphOS port
- CyberGraphics video
- AHI sound with triple buffering
- Joystick support via lowlevel.library
- Native timer for precise synchronization


LICENSE
-------

KEGS is distributed under the GNU GPL v3 license.
See COPYING.txt for more details.

Website: https://kegs.sourceforge.net
Original author contact: kadickey@alumni.princeton.edu


CREDITS
-------

- Kent Dickey for the original KEGS
- Skateman for the MorphOS icon