Mizu

Mizu 是一个使用 Rust 编写的精确 Gameboy 模拟器。

功能

• 模拟原始 Gameboy (DMG) 和 Gameboy Color 硬件。
• 通过大多数硬件测试（见 TESTING.md）。
• 更好的保存支持。
• 控制 SRAM 保存文件和禁用 SRAM 保存的能力。
• MBC3 映射器精确的 RTC 模拟。
• 带有 48KHz 音频的精确 APU 模拟。
• SFML 图形用户界面。
• 强大的测试框架，用于持续测试。
• 轻松更改模拟速度。
• 功能性的映射器
  • NoMapper
  • MBC1
  • MBC2
  • MBC3
  • MBC5
• 打印机模拟
• 保存状态

控制

SFML 前端提供以下键盘绑定

Gameboy

额外

* 我创建了此功能，因为在 Zelda: Link's awakening 中，您需要在同一帧上按下所有这些按钮才能打开保存菜单，这很烦人。

** 这里的 FPS 与普通游戏的 FPS 不同，低 FPS 只会让游戏卡顿，这里的 FPS 控制着模拟速度。通常它会在 60 FPS 下运行。如果用户将 FPS 设置为 30，它将以一半的速度模拟，这包括音频和 CPU 模拟。

打印机窗口键

打印机

Gameboy 打印机是一款串行设备，可以连接到 Gameboy 上，并被某些卡带用于打印图像。使用它的流行卡带包括

• Gameboy 照相机。
• 《塞尔达传说：时之笛 DX》（用于从相册打印图像）。
• 《宝可梦》（多个版本）（用于从图鉴打印宝可梦信息）。

按下 P 键可以打开打印机。

打印机仿真允许将打印的图像保存到磁盘。窗口将只显示 160x144 像素，但图像可以滚动。

保存状态

保存状态是仿真器应该具备的非常有用的功能，它允许在任何时间点保存整个仿真器的状态，并在以后任何时候加载。 mizu 的保存状态文件保存在以下文件夹中

Linux:   /home/<user>/.local/share/mizu/saved_states
Windows: C:\Users\<user>\AppData\Local\Amjad50\Mizu\data\saved_states
macOS:   /Users/<user>/Library/Application Support/Amjad50.Mizu/saved_states

保存文件的结构版本为 2

文件版本之间没有迁移（除从 1 到 2 之外），这意味着从仿真器的早期版本保存的文件将无法在未来版本的仿真器中加载。（如果您有任何关于如何实现这一点的建议，欢迎您提出 PR。）

$ cargo build

$ cargo build --release

$ cargo install mizu