Short:        Amiga emulator for MorphOS
Author:       papiosaur2 hotmail fr (Papiosaur)
Type:         misc/emu
Version:      0.3 (01-10-2026)
Architecture: ppc-morphos
Requires:     MorphOS 3.20+, sdl2.library (gamepads), your own
              Kickstart 1.3 ROM
URL:          https://papio-software.com


OVERVIEW
========

Lorraine is a new Amiga emulator, written from scratch for MorphOS
and designed to run at full speed on PowerPC: 50 frames per second on a
PowerBook G4 and on a Mirari.

It emulates a PAL Amiga 500: 68000 processor, OCS chipset (copper,
blitter, sprites, interlace), Paula sound with the A500 filters, 512 KB
or 1 MB of chip memory plus 512 KB of slow memory, up to four floppy
drives, keyboard, mouse and joystick.

This is an early version: it boots from floppy disk images only.


INSTALLATION
============

 1. Unpack the archive anywhere.
 2. Copy your Kickstart 1.3 ROM file into the Roms drawer (any name).
    The ROM is NOT included: it is still copyrighted.
 3. Double-click Lorraine: the settings panel opens. Insert a disk
    in DF0: and click Start.


USAGE
=====

 Disk images: ADF and DMS. Disks are writable like real floppies:
 games and the Workbench save to the ADF file (tick "Write-protect
 disks" in the panel to keep them untouched). DMS images are read
 only.

 Drop an .adf file on the emulation window: it is inserted in DF0: and
 the Amiga restarts on it. Drop it on a drive line of the Lorraine
 panel to change the disk without restarting (disk 2 of a demo...).

 Press F12 to open the Lorraine panel (and get the MorphOS mouse
 pointer back); click the emulation window to return to the Amiga.
 Closing the emulation window stops the Amiga and returns to the panel;
 Quit (or the close gadget of the panel) leaves Lorraine. The
 panel controls the four drives (connect, insert, eject),
 fast loading, volume, drive sounds, stereo separation, Kickstart ROM
 and chip memory (applied at the next Reset), display area, monitor frame, Reset,
 Pause and full screen. Settings are saved in Lorraine.prefs.

 F12             settings panel, releases the mouse
 Alt+Return      window / full screen
 Controllers     chosen per port in the settings panel: mouse
                 (port 1), USB gamepad (automatic or by name),
                 numeric keypad (8 2 4 6, 0 = fire), keyboard
                 (cursor keys, Ctrl or right Alt = fire) or nothing.
                 Gamepads are read through SDL2: d-pad or left
                 stick to move, face and shoulder buttons fire. "Detect" refreshes
                 the list after plugging a gamepad.
 Mouse           captured by the Amiga while its window is active

 From a Shell:   Lorraine [rom] [disk.adf] [CHIP=1024]


CONTENTS
========

 Lorraine          the emulator
 Lorraine.readme   this file
 Roms/             put your Kickstart ROM files here
 Disks/            disk images (ADF, DMS): a few free demos to start,
                   add your own; the Insert requester opens here
 Papio-Software    opens https://papio-software.com
 Support           opens PayPal to support the development


STATUS
======

Tested on real hardware (Mirari T1042, PowerBook G4): Kickstart 1.3,
the demos Arte, State of the Art, Desert Dream (two drives), Enigma,
Mental Hangover and 9 Fingers, and the games Aaargh! and Toki.

Not yet available: hard disk, ADZ images, AGA chipset, 68020
and faster processors, save states.


HISTORY
=======

 0.3  - The settings panel opens at launch, Start button
      - Closing the emulation window returns to the panel, Quit button
      - Controllers per port: mouse, USB gamepads (SDL2), numeric
        keypad; gamepad names listed, Detect button
      - Display area "auto": zooms on the area the game really uses,
        with exact proportions or stretched to fill the window
      - Chip bus sharing: the 68000 waits for bitplane and blitter DMA
        like on a real A500 (5-6 bitplane games run at the right speed)
      - Blitter timing from the hardware manual (blits were twice
        too slow)
      - Disks drawer, the Insert requester opens there
      - Quieter drive motor sound
      - Fixed: Aaargh! stayed on a black screen (copper jump on read)
      - Fixed: Toki title picture drawn slanted (data fetch stop)
      - Fixed: mouse capture (clicks on window gadgets, pointer jumps)

 0.2  - Retro monitor frame around the picture (option)
      - Mouse captured by the emulation window, F12 opens the panel
      - Drop a disk on a drive line of the panel
      - The panel shows the disk dropped on the emulation window
      - Roms drawer and Kickstart ROM selector in the panel
      - ROM and chip memory changes applied at the next Reset
      - Message when the emulated Amiga crashes, with a hint
      - Fixed: stuck sprites drawing vertical lines (9 Fingers)

 0.1  - First release


DEMOS
=====

The Disks drawer holds freely distributable productions of the Amiga
demoscene, included with respect and credited to their authors. They
will be removed on request.

 State of the Art   Spaceballs (1992)
 9 Fingers          Spaceballs (1993)
 Desert Dream       Kefrens (1993)
 Enigma             Phenomena (1991)
 Hardwired          Crionics & The Silents (1991)
 Arte               Sanity (1993)
 Mental Hangover    Scoopex (1990)


TRADEMARKS
==========

Amiga is a trademark of its owner. Lorraine is not affiliated with,
nor endorsed by, Amiga Corporation, Cloanto or Commodore.


THANKS
======

- MorphOS Team for MorphOS
- BeWorld for SDL2
- Skateman, MartinW, Patricks Retro Corner and one Anonymous for their support