UNPKG

nes-emu

Version:

A NES emulator

109 lines (83 loc) ā€¢ 7.27 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
# NesCore A NES Emulator made in JavaScript for educational purposes. [Try it!](https://afska.github.io/nescore/) Its main objective is to reflect the NES internals as simply as possible by using clean, object-oriented code. It doesn't have any complex bitwise operations, huge switch-case statements or files with lots of magic numbers. > <img alt="rlabs" width="16" height="16" src="https://user-images.githubusercontent.com/1631752/116227197-400d2380-a72a-11eb-9e7b-389aae76f13e.png" /> Created by [[r]labs](https://r-labs.io). > āš ļø This is not a cycle-accurate emulator and performance is not the main concern. ## Features - šŸ‘¾ It emulates the **NES** - šŸ‘Øā€šŸ”§ It plays [Super Mario Bros. 3](https://en.wikipedia.org/wiki/Super_Mario_Bros._3)! - šŸ’» **CPU** - All **official instructions** are implemented - [nestest](https://raw.githubusercontent.com/afska/nescore/master/public/testroms/nestest.txt) passes āœ”ļø - Fully functional šŸ–„ļø **PPU** and šŸ”Š **APU** - šŸ”Œ Supported **mappers** - Mapper **0**: [NROM](https://www.nesdev.org/wiki/NROM) - Mapper **1**: [MMC1](https://www.nesdev.org/wiki/MMC1) - Mapper **2**: [UxROM](https://www.nesdev.org/wiki/UxROM) - Mapper **3**: [CNROM](https://www.nesdev.org/wiki/INES_Mapper_003) - Mapper **4**: [MMC3](https://www.nesdev.org/wiki/MMC3) - šŸ **SRAM** support - šŸ’¾ **Save states** support - šŸŒŽ **Web frontend** with Gamepad support ## Usage **`npm install --save nes-emu`** ```js // configure video and audio: const onFrame = (frameBuffer) => { // write `frameBuffer` (a Uint32Array) to screen... }; const onSample = (sample) => { // write `sample` (a number) to audio buffer... }; // create an instance: const nes = new NES(onFrame, onSample); // load a game: nes.load(rom); // rom = Uint8Array // run at 60 fps, or as fast as you can: { nes.setButton(1, "BUTTON_A", true); // player = 1, button = A, pressed = true nes.setButton(2, "BUTTON_DOWN", false); // player = 2, button = DOWN, pressed = false // ...set the rest of the buttons nes.frame(); } // save / restore states: const saveState = nes.getSaveState(); nes.setSaveState(saveState); ``` šŸ‘€ Have a look at the [demo implementation](https://github.com/afska/nescore/tree/master/src/gui) for more details. ## Full API | Method | Parameters | Description | | --------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **constructor** | `onFrame`, `onSample`, _`logger`_ | Creates an emulator's instance. All properties can be set at any time. | | `load` | `rom`, _`saveFileBytes`_ | Loads a ROM. If a `saveFileBytes` array is provided, it sets the SRAM content. | | `frame` | | Runs the emulation for a whole video frame. | | `samples` | `requestedSamples` | Runs the emulation until the audio system generates `requestedSamples`. | | `scanline` | | Runs the emulation until the next scanline. | | `setButton` | `player`, `button`, `isPressed` | Sets the `button` state of `player` to `isPressed`. The `button` can be one of: `["BUTTON_A", "BUTTON_B", "BUTTON_SELECT", "BUTTON_START", "BUTTON_UP", "BUTTON_DOWN", "BUTTON_LEFT", "BUTTON_RIGHT"]` | | `clearButtons` | `player` | Sets all buttons of `player` to a non-pressed state. | | `getSaveFile` | | Returns an array with the SRAM bytes, or null. | | `getSaveState` | | Returns an object with a snapshot of the current state. | | `setSaveState` | `saveState` | Restores a `saveState`. | ## Screenshots ![nestest screenshot](https://raw.githubusercontent.com/afska/nescore/master/img/capture-sm.png) ## Debugging You can inspect the emulator state by using the global `window.debug` object. Also, if you add `?debug` to the URL and use a gamepad, shoulder buttons will behave as follows: ``` 2--4 1--3 1: Enter debug mode 2: Exit debug mode 3: Hold to run frame 4: Hold to run scanline ``` ## Useful links - [NesDev](https://www.nesdev.org/) | [Mirror](https://afska.github.io/nes-docs-backup/nesdev-wiki.zip) - [NES Emulation Overview](https://ltriant.github.io/2019/11/22/nes-emulator.html) | [Mirror](https://afska.github.io/nes-docs-backup/nes-emulation-good-bad-tedious/) - [NES Ebook](https://bugzmanov.github.io/nes_ebook/chapter_1.html) | [Mirror](https://afska.github.io/nes-docs-backup/nes-emulator-rust/) - [Easy 6502](https://skilldrick.github.io/easy6502/) | [Mirror](https://afska.github.io/nes-docs-backup/easy6502) - [6502 Reference](https://web.archive.org/web/20210724004546/http://www.obelisk.me.uk/6502/reference.html) | [Mirror](https://afska.github.io/nes-docs-backup/6502-reference.zip) - [NES Rendering](https://austinmorlan.com/posts/nes_rendering_overview) | [Mirror](https://afska.github.io/nes-docs-backup/nes-rendering-overview/) - [NES Graphics Part 1](http://www.dustmop.io/blog/2015/04/28/nes-graphics-part-1/) | [Mirror](https://afska.github.io/nes-docs-backup/nes-graphics-part-1/) - [NES Graphics Part 2](http://www.dustmop.io/blog/2015/06/08/nes-graphics-part-2/) | [Mirror](https://afska.github.io/nes-docs-backup/nes-graphics-part-2/) - [NES Graphics Part 3](http://www.dustmop.io/blog/2015/12/18/nes-graphics-part-3/) | [Mirror](https://afska.github.io/nes-docs-backup/nes-graphics-part-3/)