]> gitweb.factorcode.org Git - factor.git/blob - apps/space-invaders/readme.txt
cda70ae9de09f80eb228b2efa95b24fbfd26f0a0
[factor.git] / apps / space-invaders / readme.txt
1 This is a simple space invaders emulator. The goal is to produce an
2 emulator, disassembler and assembler for the 8080 processor.
3
4 It is integrated into the Factor module system, the following will
5 load all necessary files and run it:
6
7   "contrib/space-invaders" run-module
8
9 For this to work it needs a ROM file called 'invaders.rom' in the
10 factor root directory.
11
12 'Backspace' inserts a coin, '1' is the one player button and '2' is
13 the two play button. The left and right arrow keys move and the up
14 arrow key fires.
15
16 If the ROM file you have is split into seperate files, you will need
17 to merge them into one 'invaders.rom' file. From Windows this is done
18 with:
19
20   copy /b invaders.h+invaders.g+invaders.f+invaders.e invaders.rom
21
22 Or Linux:
23
24   cat invaders.h invaders.g invaders.f invaders.e >invaders.rom
25
26 The emulator is actually a generic Intel 8080 and the code for this is
27 in cpu-8080.factor. The space invaders specific code is in
28 space-invaders.factor. It specializes generic functions defined by the
29 8080 emulator code to handle the space invaders display and
30 input/output ports.
31
32 Current Issues:
33
34 1) The Escape key does not close the GUI. It does stop the CPU
35    emulation process though.
36
37 2) The best way of stopping if to just close the GUI window.
38
39 For more information, contact the author, Chris Double, at
40 chris.double@double.co.nz or from my weblog
41 http://www.bluishcoder.co.nz