Skip to content

Latest commit

 

History

History
68 lines (59 loc) · 2.7 KB

README.md

File metadata and controls

68 lines (59 loc) · 2.7 KB

ams-68k-bin

AMS is the Advanced Mac Substitute, a trap-level emulator for Mac OS.

This repository contains various 68K executables needed to run Mac apps using AMS.

Applications

  • Welcome is a parody of the "Welcome to Macintosh" loading screen.
  • Tic-tac-toe is a Tic-tac-toe board with multiple Undo and saved games.
  • Black Knight's Chess is a playable chess board (including castling, pawn promotion, and en passant capture).
  • Organ Console is a demonstration of the Sound Driver's four-tone synthesizer.
  • Nyanochrome Cat is a black and white adaptation of Christopher Torres' Nyan Cat animation.
  • IAGO is a Reversi game released to the public domain by David Reed in 1984.

Modules

  • ams-core provides most of the OS:
    • low-level cursor support
    • interrupt handlers
    • Vertical Retrace Manager
    • OS Utilities
    • Memory Manager
    • Gestalt Manager
    • OS Event Manager
    • Toolbox Event Manager
  • ams-io implements the Device Manager and several device drivers:
    • Serial Driver
    • Sound Driver
  • ams-fs implements the File Manager and supported filesystems:
    • MFS
    • MacBinary and MacBinary+
    • Host bridge for read-only startup and writable Documents volumes
  • ams-rsrc implements the Resource Manager.
  • ams-pack contains the Package Manager (but no actual packages).
  • ams-seg contains the Segment Loader.
  • ams-qd provides QuickDraw, the Font Manager, and routines for fixed-point math and bit manipulation.
  • ams-ui includes various facilities to support a user interface:
    • Window Manager (including the standard documents and dialogs WDEF)
    • Control Manager (including the standard buttons CDEF)
    • Menu Manager (including the standard MDEF)
    • Dialog Manager
    • Scrap Manager
    • Icon Manager
    • List Manager
    • Standard File Package
    • International Utilities Package
    • Binary/Decimal Conversion Package
    • String Utilities
  • ams-snd is the Sound Manager.
  • ams-dsat is the System Error Handler.
  • ams-print is the Printing Manager (though only a stub).
  • umsp is the User-Mode Service Package, which emulates privileged instructions that access the Status Register.
  • vdb is a debugger.

Command-line programs

  • app launches a Mac application.
  • 'BNDL'-unpacking tools:
    • get-bndl-pwner extracts the application signature code.
    • get-bndl-icon retrieves the 'ICN#' data for a specific file type.
  • hello is not needed by AMS, nor vice versa. It's just a hand-coded 68K Hello World program, useful for testing that xv68k works.