dc20-dev / chip8emulator

An implementation of a Chip8 Emulator

Chip8 Emulator

A Chip8 Emulator written in C++ for fun!

Requirements

• CMake version 3.23 or higher to build the app

• Conan package manager 2.0 or higher to fetch and include the dependancies

Build Instructions

• Clone the repository in a directory on your machine

Using CMake

• Run conan install . --profile={your preferred conan profile}

• Run CMake build system generation by either using editor features or by running cmake -B"./build"

• Build the executable using the editor features or by running cmake --build "./build"

Using Conan

• Run conan build . -pr={your preferred conan profile}

Usage

Simply Run Chip8Emulator.exe and have fun!

The key bindings are the following:

Key	Emulator Pad
1	1
2	2
3	3
4	C
Q	4
W	5
E	6
R	D
A	7
S	8
D	9
F	E
Z	A
X	0
C	B
V	F

Note

There is currently no loading solution for your own ROMs as this project is intended for demonstration only, but it will be implemented soon enough; in the meantime You can bring your TicTacToe skills to the next level 😉

Tests

The tests are built together with the main executable unless differently specified. Full test coverage is not yet present, but all the current tests are passing so it is stable enough to fiddle with.

ThirdParty

• The app uses SDL2 library to render the game, which is fetched automatically by Conan

• The tests are implemented using CLove-Unit header-only library, which is already included into the repository by Conan