| Readme: | Short: Amiga emulator for MorphOS
Author: papiosaur2 hotmail fr (Papiosaur)
Type: misc/emu
Version: 0.5 (05.10.2026)
Architecture: ppc-morphos
Requires: MorphOS 3.20+, sdl2.library (gamepads), your own
Kickstart ROM (1.3 for the A500, 3.1 for the A1200)
URL: https://papio-software.com
OVERVIEW
========
Lorraine is a new Amiga emulator, developed 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 two PAL Amigas:
- Amiga 500: 68000 processor, OCS/ECS chipset (copper, blitter,
sprites, interlace), 512 KB or 1 MB of chip memory plus 512 KB of
slow memory;
- Amiga 1200: 68EC020 processor at 14 MHz with its instruction cache,
AGA chipset (256 colours, HAM8, 32 and 64-bit fetch, wide sprites),
2 MB of chip memory and 4 to 32 MB of Fast memory.
Both have Paula sound with the A500 filters, up to four floppy drives,
keyboard, mouse and joysticks.
It boots from floppy disk images, WHDLoad games straight from their
.lha archive, a hard disk file (HDF, A1200) or a MorphOS drawer seen as
an Amiga disk.
INSTALLATION
============
1. Unpack the archive anywhere.
2. Copy your Kickstart 1.3 ROM file into the Roms drawer (any name).
For the A1200, add a Kickstart 3.1 (A1200) ROM as well.
The ROMs are NOT included: they are still copyrighted.
3. Double-click Lorraine: the settings panel opens. Choose the model,
insert a disk in DF0: and click Start.
4. For WHDLoad games (optional), see WHDLOAD GAMES below.
USAGE
=====
Disk images: ADF, DMS and IPF (SPS/CAPS preservation images, with
their copy protections: Rob Northen Copylock, long tracks, weak
bits...), also inside ZIP archives. A ZIP holding several disks put
in DF0: spreads them over the drives: disk 1 in DF0:, disk 2 in
DF1:... up to DF3:, connecting the external drives it needs. Put in
another drive, it asks which disk to insert (or name it
archive.zip#2 for disk 2).
The DF0:...DF3: cycle in front of each drive swaps its disk with the
chosen drive: for games that only read DF0:, put disk 2 in DF0: and
disk 1 goes to DF1:.
ADF 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 and IPF images are read only.
Model: A500 or A1200. Lorraine reads the ROMs of the Roms drawer and
only offers those that suit the chosen model, with the chip and Fast
memory it can have (Fast: up to 8 MB on the A500, 32 MB on the A1200).
Applied at the next Reset.
Hard disk: an HDF file on the IDE interface of the A1200. Host folder:
any MorphOS drawer seen as an Amiga disk, bootable, on both models.
Both apply at the next Reset.
WHDLoad games: see WHDLOAD GAMES below.
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...).
Game library: the cycle above the left column of the panel shows
the Settings categories or the content of the Disks, Harddisk and
WHDLoad drawers. Double-click an entry to start it, the Amiga
restarts if it was running. Disks: floppy images and archives.
Harddisk: HDF files (A1200, Lorraine switches to it from an A500
until a floppy is started again) and drawers seen as bootable
partitions. WHDLoad: games as .lha archives or unpacked drawers.
The Filter field narrows the list as you type.
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
is sorted by category, like the MorphOS preferences: Machine (model,
ROM, memory), Display (display area, monitor frame), Disks (the four
drives, fast loading, write protection, hard disk, host folder), Sound
and Controllers. It reopens on the last category used. The retro
monitor frame shows the Amiga's lights: POWER, DF0 to DF3 (a disk
must be in the drive) and HD. Settings are saved in Lorraine.prefs.
F12 settings panel (releases the mouse) and back to the
emulation window
Alt+Return window / full screen
F11 next display area (monitor, full overscan, auto
exact, auto stretched)
Alt+F11 retro monitor frame on / off
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. The
list follows the gamepads you plug or unplug.
"Buttons..." gives each button of the gamepad its own
job: fire, second fire, a direction (B = up to jump,
for instance) or an Amiga key. The ticks under the
ports show what each Amiga port receives, emulation
running or not.
Mouse captured by the Amiga while its window is active
From a Shell: Lorraine [rom] [disk] [CHIP=1024] [MODEL=A1200]
[FAST=8192] [DF1=disk] [DF2=disk] [DF3=disk]
[FASTLOAD=1]
WHDLOAD GAMES
=============
No Workbench is needed: Lorraine builds a small boot disk for each
game, the Kickstart ROM does the rest.
Needed once, next to Lorraine:
- WHDLoad_usr.lha, the official archive from whdload.de (Lorraine
takes the WHDLoad program out of it by itself);
- a Kickstart 3.1 A1200 ROM (512 KB, 40.068 preferred) in Roms.
Only for the games whose slave asks for a Kickstart image (such as
kick34005.A500): the ROM of that version in Roms, and skick346.lha
(Aminet) next to Lorraine for the .RTB files. Lorraine tells you
when one of them is missing.
Why: many WHDLoad installs (mostly games that used AmigaDOS) run on a
Kickstart that WHDLoad loads into memory, not on the one of the
machine; the slave names the version it wants. WHDLoad needs that
ROM image and its .RTB file, a relocation table that lets it run
the ROM at another address (it holds no Commodore code). The .RTB
files come with SoftKicker, freely distributed on Aminet as
skick346.lha (search for "skick346" on aminet.net): Lorraine unpacks
it once and copies the right .RTB next to the ROM in the game
drawer. Games without a Kickstart image need none of this.
Put the game's archive (.lha, or .lzx) or its unpacked drawer (with
the .slave file) in the WHDLoad drawer, choose WHDLoad in the cycle
of the panel and double-click the game. You can also insert the
archive in DF0: or drop it on the emulation window.
The game stays in its archive: Lorraine reads it into memory at each
start (with xadmaster.library, part of MorphOS) and shows it to the
Amiga as a disk, nothing is unpacked. What the game writes (saves,
high scores) goes to WHDSaves/<game>, next to Lorraine. Deleting the
archive removes the game; its saves stay in WHDSaves until you delete
them too. The options of the game icon (tooltypes) are used.
Lorraine switches to an A1200 with Kickstart 3.1 and at least 8 MB of
Fast memory; your previous
settings come back when a floppy disk is inserted in DF0: again.
The WHDLoad information window is skipped unless "Show the WHDLoad
window" is ticked in the Disks page. To quit a game, use its WHDLoad
quit key (often F10), or close the emulation window.
Some games, mostly CD32 conversions, need libraries that are not in
the Kickstart ROM (lowlevel.library...): they are not supported yet.
CONTENTS
========
Lorraine the emulator
Lorraine.readme this file
History.txt what changed, release by release
Roms/ put your Kickstart ROM files here
Disks/ disk images (ADF, DMS, IPF, ZIP): a few free demos to start,
add your own; the Insert requester opens here
Harddisk/ HDF files and drawers used as hard disk partitions
WHDLoad/ WHDLoad games (.lha or .lzx archives, or drawers)
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
and 3.1, the demos Arte, State of the Art, Desert Dream (two drives),
Enigma, Mental Hangover and 9 Fingers.
Not yet available: hard disk on the A500, ADZ images, 68030 and faster
processors, save states.
HISTORY
=======
See History.txt.
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
|
Ambient (151)
Lorraine_0.5.lha
