panaroia

A small Chip8 emulator library in C

Instructions

Building

panaroia depends on log.c for logging inside the library, Dear ImGui and imgui-filebrowser to build the sample ui implementation.

To the third party dependencies added as submodules, run:

$ git submodule update --init

Create a build directory and get the conan dependencies:

$ mkdir build
$ cd build
$ conan install ..

Run CMake and build:

$ cmake ..
$ make

If everything went fine, you can check the sample UI made with imgui by running:

$ ./interfaces/panaroia-imgui/bin/panaroia-imgui

To execute the libcheck unit tests, run:

$ ./tests/panaroia-tests

Sample UI

The sample UI looks like this:

In the ROM window, you can select a Chip8 rom to be loaded or reset the current loaded rom file, the Keypad window displays the current keys state and toggling the SDL Mappings will display the actual keys bound to Chip8 keys.