# Qt-NES-Emulator

**Repository Path**: Morphlng/qt-nes-emulator

## Basic Information

- **Project Name**: Qt-NES-Emulator
- **Description**: Qt实现FC模拟器
- **Primary Language**: C++
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 11
- **Forks**: 7
- **Created**: 2021-05-09
- **Last Updated**: 2025-07-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Qt-NES-Emulator

## 介绍

采用面向对象设计方法，利用Qt实现的FC模拟器。不保证cycle based accuracy，开启Debugger将有明显掉帧情况。

- [x] CPU
- [x] PPU
- [x] APU(套用了Blargg's Nes_Snd_Emu中的Simple_APU接口，未加入IRQ支持)
- [x] Cartridge
- [x] Mapper 0/1/2/3/66
- [x] Controller 
- [x] Debugger(目前只提供了CPU寄存器与内置内存查看)

## 安装教程

1.  Qt 5.15.2 Mingw编译器
2.  编译运行

## 使用说明

1.  Release版本解压即可使用
2.  开始-选择文件，选择一个游戏Rom(.nes文件)即可开始
3.  Debugger-打开Debugger，可以开启内存观察器，有助于进一步开发。Debugger功能有待完善
4.  选项-开启/关闭声音。
5.  Save/Load。在运行游戏时点击Save会创建即时存档，保存于`./save/Game_title/TimeStamp.sav`；点击Load可以选择要加载的存档，注意游戏和存档若不匹配则不会有反应（这里用文件名区分，所以若改名可能会冲突，后续可能考虑更改）
6.  按键说明

    按键对应：上左下右、BA、Select、Start

    控制器1：WASD、JK、LShift、Space

    控制器2：方向键位、ZX、\[、\]


## 参与贡献

1.  Fork 本仓库
2.  提交Issues

## 鸣谢

|             [HaloOrangeWang](https://github.com/HaloOrangeWang)              |                  [Javidx9](https://github.com/OneLoneCoder)                   |                 [James Athey](https://github.com/jamesathey)                 |
| :--------------------------------------------------------------------------: | :---------------------------------------------------------------------------: | :--------------------------------------------------------------------------: |
| <img width="60" src="https://avatars.githubusercontent.com/u/30406969?v=4"/> | <img width="60" src="https://avatars.githubusercontent.com/u/25419386?v=4" /> | <img width="60" src="https://avatars.githubusercontent.com/u/5478953?v=4" /> |