1
0
mirror of https://github.com/TomHarte/CLK.git synced 2024-11-22 12:33:29 +00:00
A latency-hating emulator of 8- and 16-bit platforms: the Acorn Electron, Amstrad CPC, Apple II/II+/IIe and early Macintosh, Atari 2600 and ST, ColecoVision, Enterprise 64/128, Commodore Vic-20 and Amiga, MSX 1, Oric 1/Atmos, Sega Master System, Sinclair
Go to file
2021-03-22 09:02:49 -04:00
.github Reduce to less-daunting URL. 2020-12-09 16:38:59 -05:00
Activity Starts to add Qt target; resolves many build warnings. 2020-05-30 00:37:06 -04:00
Analyser Introduces a container for ZX Spectrum-style TAPs. 2021-03-19 23:01:49 -04:00
ClockReceiver Improves the meaning and result of time_since_flush(). 2020-12-01 18:35:07 -05:00
Components Merge branch 'master' into ZXSpectrum 2021-03-21 22:44:37 -04:00
Concurrency Cleans up all redundant lock/unique_guard declarations. 2020-06-15 00:24:10 -04:00
Configurable Removes dead StandardOptions.cpp. 2020-05-09 21:35:15 -04:00
Inputs Ensure MultiKeyboard deconstructs properly. 2020-09-15 22:48:44 -04:00
InstructionSets Adds a shell for video emulation. 2021-03-18 12:47:48 -04:00
Machines Minimises video flushing, moves it to the proper time. 2021-03-22 09:02:49 -04:00
Numeric Enables detection of CPC-format tape data. 2021-03-10 22:02:10 -05:00
OSBindings Merge branch 'master' into ZXSpectrum 2021-03-21 22:44:37 -04:00
Outputs Corrected: PAL machines can now be overt in terms of odd/even colour burst. 2021-03-20 23:45:49 -04:00
Packaging add Ansible build playbook to create RPM package for clksignal and create basic man page 2020-05-11 00:52:51 -04:00
Processors Adds various asserts, some comments. 2021-03-03 20:47:45 -05:00
READMEImages Switches to an image more distinct from the existing. 2020-07-04 22:03:08 -04:00
Reflection Ensures Reflection::set is widely available. 2020-06-27 16:26:01 -04:00
ROMImages Adds the +2a/+3 ROM. 2021-03-17 22:16:57 -04:00
SignalProcessing Merge pull request #800 from TomHarte/QtProject 2020-07-06 22:33:39 -04:00
Storage Relaxes test for a valid TAP. 2021-03-21 20:31:09 -04:00
.editorconfig Adds a .editorconfig to aid Github display. 2018-07-16 19:59:03 -04:00
.gitignore Introduces failing tests of the MSX static analyser. 2018-01-01 16:38:26 -05:00
BUILD.txt Corrected name of build tool. 2017-11-22 20:11:02 -05:00
LICENSE Initial commit 2015-07-16 19:46:52 -04:00
README.md Mention my manual list sorting. 2020-12-23 11:15:57 -04:00

Clock Signal Application Icon

Clock Signal

Clock Signal ('CLK') is an emulator for tourists that seeks to be invisible. Users directly launch classic software with no emulator or per-emulated-machine learning curve.

macOS and source releases are hosted on GitHub. For desktop Linux it is also available as a Snap. On the Mac it is a native Cocoa and Metal application; under Linux, BSD and other UNIXes and UNIX-alikes it uses OpenGL and can be built either with Qt or with SDL.

This emulator seeks to offer:

  • single-click load of any piece of source media for any supported platform;
  • with a heavy signal processing tilt for accurate reproduction of original outputs;
  • while minimising latency.

It currently contains emulations of the:

  • Acorn Electron;
  • Amstrad CPC;
  • Apple II/II+ and IIe;
  • Atari 2600;
  • Atari ST;
  • ColecoVision;
  • Commodore Vic-20 (and Commodore 1540/1);
  • Macintosh 512ke and Plus;
  • MSX 1;
  • Oric 1/Atmos;
  • Sega Master System; and
  • Sinclair ZX80/81.

Single-click Loading

Through static and runtime analysis CLK seeks automatically to select and configure the appropriate machine to run any provided disk, tape or ROM; to issue any commands necessary to run the software contained on the disk, tape or ROM; and to provide accelerated loading where feasible.

The full process of loading a title — even if you've never used the emulated machine before — is therefore:

  1. locate it in your OS;
  2. double click it.

Signal Processing

Consider an ordinary, unmodified Commodore Vic-20. Its only video output is composite. Therefore the emulated machine's only video output is composite. In order to display the video output, your GPU must decode composite video. Therefore composite video artefacts are present and correct not because of a post hoc filter but because the real signal is really being processed.

Similar effort is put into audio generation. If the real machine normally generates audio at 192Khz then the emulator generates a 192Khz source signal and filters it down to whatever the host machine can output.

Samples

1:1 Pixel Copying Composite Decoded
The Electron start screen, with a classic 1:1 pixel emulation The Electron start screen, decoded from an interlaced composite feed
Repton 3 in game, with a classic 1:1 pixel emulation Repton 3 in game, decoded from an interlaced composite feed
Stormlord with a classic 1:1 pixel emulation Stormlord decoded from a composite feed
Road Fighter with a classic 1:1 pixel emulation Road Fighter decoded from a composite feed
A segment of the ColecoVision Donkey Kong title screen with a classic 1:1 pixel emulation A segment of the ColecoVision Donkey Kong title screen decoded from a composite feed
Sonic the Hedgehog with a classic 1:1 pixel emulation Sonic the Hedgehog screen PAL decoded from a composite feed
1:1 Pixel Copying Correct Aspect Ratio, Filtered
Amstrad text, with a classic 1:1 pixel emulation Amstrad text, with correct aspect ratio and subject to a lowpass filter
The Amstrad CPC version of Stormlord, with a classic 1:1 pixel emulation The Amstrad CPC version of Stormlord, with correct aspect ratio and subject to a lowpass filter

Low Latency

The display produced is an emulated CRT, with phosphor decay. Therefore if you have a 140Hz 4k monitor it can produce 140 distinct frames per second at 4k resolution. Latency is dictated by the host hardware, not the emulated machine or emulator.

Audio latency is disjoint from frame rate and is generlaly restrained to 510ms.

Accurate Emulation

Accuracy affects usability; the more accurate an emulator, the more likely that a user can run every piece of software they're interested in without further intervention.

This emulator attempts cycle-accurate emulation of all supported machines. In some cases it succeeds.

Additional Screenshots

Apple IIe Prince of Persia Apple Macintosh MusicWorks
Atari ST Stung Car Racer Amstrad CPC Chase HQ
Acorn Electron Chuckie Egg ColecoVision Galaxian
ZX81 3D Monster Maze ZX80 Kong
SG1000 Chack'n'Pop Atari 2600 Solaris
Vic-20 Gridrunner VIC-20 BASIC

macOS Version Qt Version

Sponsorship

I've been asked several times whether it is possible to sponsor this project; I think that's a poor fit for this emulator's highly-malleable scope, and it makes me uncomfortable because as the author I primarily see only its defects.

An Amazon US wishlist is now attached in the hope of avoiding the question in future. A lot of it is old books now available only secondhand — I like to read about potential future additions well in advance of starting on them. Per the optimism of some book sellers, please don't purchase anything that is currnetly listed only at an absurd price; they were sorted by secondhand price when added to the list, with cheapest being $5.