#emulator #games #nes


Simple rust implementation of a NES emulator, built on top of my emulator_6502 crate

1 unstable release

0.1.0 May 29, 2020

#7 in #nes-emulator

38 downloads per month
Used in 2 crates

MIT license

2.5K SLoC

Crate Documentation


gc_nes_core is, as the name would suggest, the core of my Ninendo Entertainment System emulator. It provides an interface for dependent crates to load and run NES ROMs, provide input, and extract rendered image data. Audio is currently unsupported.

Using the Emulator

Add gc_nes_core as a dependency in Cargo.toml

gc_nes_core = "0.1.0"

Dependent crates can use the emulator functionality as follows:

use gc_nes_core::cartridge::Cartridge;
use gc_nes_core::nes::Nes;

// Load a .nes file as a cartridge
let cartridge = Cartridge::load_from_file("/some/nes/rom.nes".as_ref()).expect("File read error");
// Create the NES with the cartridge loaded
let mut nes = Nes::new(cartridge);
// Run the NES until the next frame completes
let frame_buffer:&[u32; 61440] = nes.frame();
// Or run it cycle by cycle for a finer approach
// Provide input state:
nes.update_controller_two(None); // Disconnected controller

Current version: 0.1.0