|Corey Prophitt 6f0729e66a Added stack overflow detection and handling||4 years ago|
|bin||5 years ago|
|data||5 years ago|
|screenshots||5 years ago|
|src||4 years ago|
|.gitignore||5 years ago|
|Makefile||5 years ago|
|README.md||5 years ago|
The emulator is complete and is able to run all Chip-8 games and demos. The
data folder contains a collection of common Chip-8 games that are freely
data/roms/readme.md for the game credits.
This readme assumes you have the following installed:
iC8 was developed on OSX and tested on Linux. The make file does not consider Windows environments and compilation on Windows would have to be done manually. The make file can be modified to specify your system's compiler preference as well as SDL2 library and include paths.
The Makefile has an
init task that installs all required libraries. You can
run the task via:
$ make init
You can globally install and uninstall via the Makefile as well:
$ sudo make install
$ sudo make uninstall
The emulator is meant to be used via the command line. You can run a game via
the command line by executing
ic8 with a single argument (a path to a Chip-8
$ ic8 ./data/roms/PONG
The Chip-8 system uses an odd keypad. The layout is as follows:
1234 qwer asdf zxcv
Each game uses some of the keys and there is no real pattern to the key layouts so each game usually requires some fiddling around to figure out the keys.
An interpreted Chip-8 emulator. Copyright (C) 2015, Corey Prophitt. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.