shot

Documentation

Overview

Command shot renders a headless screenshot of an NES ROM: it runs the emulator for a number of frames, then writes the final framebuffer to a PNG. It is the quick "does this game boot to the right screen?" check used while bringing up new mappers (no window, no input).

Usage:

go run ./tools/shot <rom> <out.png> [frames]

frames defaults to 240 (about four NTSC seconds), enough to clear most title screens. The image is the full 256x240 frame at an integer scale, so overscan and edge artifacts stay visible. It drives the same nes package the emulator uses, so the pixels match what the game would show.