Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/inunix3/nchip8
CHIP-8/SCHIP interpreter powered by SDL2 & Dear ImGui.
https://github.com/inunix3/nchip8
chip-8 chip8-emulator chip8-interpreter cpp imgui schip schip-emulator sdl sdl2
Last synced: 1 day ago
JSON representation
CHIP-8/SCHIP interpreter powered by SDL2 & Dear ImGui.
- Host: GitHub
- URL: https://github.com/inunix3/nchip8
- Owner: inunix3
- License: mit
- Created: 2024-08-04T03:27:16.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-09-14T09:12:18.000Z (5 months ago)
- Last Synced: 2024-09-14T20:00:07.213Z (5 months ago)
- Topics: chip-8, chip8-emulator, chip8-interpreter, cpp, imgui, schip, schip-emulator, sdl, sdl2
- Language: C++
- Homepage:
- Size: 93.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# nCHIP-8
A CHIP-8/SCHIP interpreter, written in C++17 with the use of SDL2 and Dear ImGui for UI. It's customizable and has debug capabilities!
[**Video**](https://drive.google.com/file/d/1VJpbM7gC9RqfsyXIdQ_G24tuiyJ7AvO9/view?usp=sharing)
[**Screenshots**](screenshots/)
Written just for fun.
## Features
- Full SCHIP support
- Sound support (Waveforms: sine, square and saw)
- Changeable frequency and dB level
- Display colors are in RGB and they can be changed
- Two keypad mappings: the original COSMAC VIP and the modern one (which is used by most other interpreters)
- You can set custom CPU frequency value
- You can change the RANDOM seed (useful for debugging)
- If some games don't have mood to function properly, you can try to make them feel better by touching these quirks:
- `BNNN`: use V0 as the offset
- `DXYN`: horizontal wrapping
- `DXYN`: vertical wrapping
- `8XY6` & `8XYE`: set VX to VY
- `8XY1`, `8XY2` and `8XY3`: reset VF
- `FX55` & `FX65`: increment the I register
- `DXY0`: draw 8x16 sprite in lo-res mode
- Debug capabilities:
- Disassembler
- Set, edit and remove breakpoints (they can also be named)
- View stack
- View and modify registers
- Instruction executor
- Keypad, in which buttons are held until they are released by second click (useful in the STEP mode)
## Building
You can build simply by creating `build` directory, going to it and calling the cmake (e.g. `cmake ..`)
Optionally, you can install nchip8 by typing `sudo cmake --install .`
## Usage
Just type `./nchip8` (or `nchip8` if you've installed it)!
For certain games you may like to change the amount of cycles per second, colors, etc.
## Todo
- ~~Ability to optionally disable flickering~~
- [x] Add pixel fading to smooth out the flickering
- [x] Support for SCHIP
- [ ] Support for XO-CHIP
- [ ] More debug features
- [ ] Watch window
- [ ] Memory view (and editor)
- [ ] Logger
- [ ] Add more controls to the existing tools
- [ ] CLI options
- [ ] Some kind of library that has a list of games, and for each game one can specify quirks and other options.
## Used resources
[**Tobias' guide**](https://tobiasvl.github.io/blog/write-a-chip-8-emulator/)
[**Wikipedia article**](https://en.wikipedia.org/wiki/CHIP-8)
[**CHIP-8 test suite**](https://github.com/Timendus/chip8-test-suite)
[**Instruction set reference**](https://chip8.gulrak.net/)
[**List of most known CHIP-8 extensions**](https://gist.github.com/tobiasvl/a0e43bdcd64d9ef6be35f5c67fcff0dd)
[**Collections of ROMs for CHIP-8**](https://github.com/kripod/chip8-roms)
[**CHIP-8 Archive**](https://johnearnest.github.io/chip8Archive/)
[**Mastering SuperChip**](http://johnearnest.github.io/Octo/docs/SuperChip.html)
[**SuperChip investigations**](https://github.com/Chromatophore/HP48-Superchip)
[**Original SCHIP spec**](http://devernay.free.fr/hacks/chip8/schip.txt)