[][src]Crate gc_nes_web

gc_nes_web wraps the public functions exposed by my gc_nes_core crate for use in the browser through Web Assembly - Javascript interop. It provides an interface to load and run NES ROMs, provide input, and extract rendered image data. Audio is currently unsupported.

Install in an NPM Project

npm install gc_nes_web

Using the NES Emulator with Javascript

// Import the package
const wasm = await import ("gc_nes_web");
// Create the NES object
let nes = this.state.wasm.nes(romArrayOfBytes);
// Run the emulator to the completion of the next frame and retrieve it
let frame = nes.frame();
// Or run just one cycle and get the frame separately
nes.cycle();
let frame = nes.get_screen();
// Drawing to a Canvas
let offscreenCanvas = new OffscreenCanvas(256, 240);
let offscreenCanvasContext = offscreenCanvas.getContext("2d");
let imageData = offscreenCanvasContext?.createImageData(256, 240);
imageData.data.set(frame);
offscreenCanvasContext.putImageData(imageData, 0, 0);
// mainCanvasContext is the 2D context for the Canvas you actually want to draw to.
mainCanvasContext.drawImage(offscreenCanvas, 0, 0);

Through wasm-pack, gc_nes_web has full Typescript support

Structs

WebCartridge

Structure used to represent a NES Cartridge in WASM.

WebNes

Structure used the represent the NES itself in WASM.

Functions

__wasm_bindgen_generated_get_screen_dimensions

Gets the screen dimensions of the NES

__wasm_bindgen_generated_nes

Creates a new NES instance, loading the passed array of bytes as the ROM

__wasm_bindgen_generated_set_panic_hook

Enables the panic hook that logs panic messages to the browser console

get_screen_dimensions

Gets the screen dimensions of the NES

nes

Creates a new NES instance, loading the passed array of bytes as the ROM

set_panic_hook

Enables the panic hook that logs panic messages to the browser console