© David Thomas, 2013-2022

17th April 2022

This is a port to C of “The Great Escape”: the classic isometric 3D game for the 48K Sinclair ZX Spectrum in which you execute a daring escape from a wartime prison camp. Very loosely based on the film of the same name, it was created by Denton Designs and published in 1986 by Ocean Software.

Over here I reverse engineered the original game from a binary snapshot of the Spectrum version, decoding the graphics, data tables and all of the logic. Originally written in Z80 assembly language, I have translated it into portable C code where now builds and runs exactly like the original on macOS, Windows and RISC OS but without the need of an emulator.

The portable C sources have allowed builds for the web, using emscripten and even the BBC Micro, via a Raspberry Pi second processor.

http://www.davespace.co.uk/the.great.escape/ (2019)

1. Fully disassemble, document and understand the original game.
   • Attempting to reimplement the game logic forces you to explore every nook and cranny of the game logic, enabling a complete reimplementation to be made and the original code fully understood.
2. Reimplement The Great Escape in portable C code.
   • While being as accurate a recreation of the original as possible.
3. Fix some bugs in the original game.
4. Analyse the before-and-after metrics.
   • How much bigger and slower is the compiled C reimplementation compared to the original game?
   • What can we learn from the original’s tight coding techniques?
5. Provide a basis for porting the game to contemporary systems of the ZX Spectrum.
   • Although old ports of the game exist for the PC, C64 and CPC, retro fans would like to see the game on other contemporary systems too.

The port is an exact recreation of the ZX Spectrum version of The Great Escape including the input device selection menu. It builds and runs on macOS, Windows and RISC OS. The macOS version is currently the "best" featuring the menu music and sound effects which the Windows port lacks.

When you start the game hit 0 to start - this will let you define your preferred keys. You could also choose 3 for Sinclair (keys 6/7/8/9/0). The macOS port will let you choose Kempston and use the arrow keys and . for fire.

There are various other controls which vary by OS. On macOS consult the menus for keyboard shortcuts.

The front-ends attempt to always preserve the game's aspect ratio and snap to whole pixels.

Consult the github actions file for exact build commands.

This is the main game reimplemented in a single (static) library.

Defines an interface to a virtual ZX Spectrum to which the game talks, replacing the bare-metal IN and OUT instructions and providing a screen to draw to, its border, a keyboard and a speaker. This can convert the Spectrum screen memory to 4bpp or 32bpp pixel formats pretty quickly.

./
    include/            - public headers
        TheGreatEscape/
        ZXSpectrum/
    libraries/          - sources
        TheGreatEscape/
            include/    - private headers
        ZXSpectrum/
    platform/           - platform-specific source
        generic/        - generic Makefile build environment
        osx/            - Xcode build environment
        riscos/         - RISC OS build environment
        windows/        - Windows build environment

Porting Chuckie Egg