Skip to content

vcoutasso/chip8-rs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

chip8-rs

A CHIP-8 Emulator written in Rust.

The Emulator's clock speed, window size and pixel size are configured through the use of constants defined in chip8.rs. Their values can be altered to change some behavior.

Building

These instructions assume that both git and Rust toolchain are installed and available.

$ git clone https://github.com/vcoutasso/chip8-rs ; cd chip8-rs # Clone repository and cd into the directory
$ cargo build --release # The release flag is optional but recommended

Usage

$ cargo run --release <PATH/TO/ROM>

Keypad

The original CHIP-8 had a 16-key hexadecimal keypad with the following layout:

1 2 3 C
4 5 6 D
7 8 9 E
A 0 B F

The following is the implemented layout that better fits the QWERTY keyboard layout:

Q W E R
A S D F
U I O P
J K L ;

Screenshots

The following are screenshots of the Emulator working with default settings on some well-known ROM files.

CHIP-8 Logo

Screenshot Pong

Screenshot Invaders

License

This software is free to use under the MIT License. See this reference for more information.

About

A CHIP-8 Emulator written in Rust

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages