Gearboy 使用与技术文档

本文档将详细介绍如何安装、使用Gearboy项目，并描述其API的使用方法。

1. 安装指南

下载安装

Gearboy支持以下平台：

• Windows
• macOS
• Linux
• BSD
• RetroArch

您可以从GitHub发布页下载对应平台的预编译版本。

• Windows:

  • 下载 Gearboy-3.6.0-windows.zip
  • 注意：如果遇到错误，可能需要安装Microsoft Visual C++ Redistributable和OpenGL Compatibility Pack

• macOS:

  • 下载 Gearboy-3.6.0-macos-arm.zip 或 Gearboy-3.6.0-macos-intel.zip

• Linux:

  • 下载 Gearboy-3.6.0-ubuntu-22.04.zip 或 Gearboy-3.6.0-ubuntu-20.04.zip
  • 注意：可能需要安装 libsdl2 和 libglew

• RetroArch: 请参考Libretro核心文档。

源代码编译

如果您希望从源代码编译Gearboy，请参考以下步骤：

Windows

• 安装 Microsoft Visual Studio Community 2022 或更高版本。
• 打开 Gearboy 的 Visual Studio 解决方案 platforms/windows/Gearboy.sln 并构建。

macOS

• 安装 Xcode 并在终端运行 xcode-select --install 以安装编译器。
• 运行以下命令以生成 macOS 应用程序包：

brew install sdl2
cd platforms/macos
make dist

Linux

• 安装编译工具和依赖库：

sudo apt install build-essential libsdl2-dev libglew-dev libgtk-3-dev
cd platforms/linux
make

• 对于其他发行版，可能需要安装相应的开发工具和依赖库。

BSD

• 安装必要的软件包：

su root -c "pkg install -y git gmake pkgconf SDL2 glew lang/gcc gtk3"
cd platforms/bsd
gmake

2. 项目的使用说明

基本使用

• 运行 Gearboy 可执行文件。
• 通过命令行加载 ROM 文件：gearboy [rom_file] [symbol_file]。

功能特性

• Gearboy 拥有准确的 CPU 模拟和指令定时。
• 支持多种类型的游戏卡带。
• 模拟 LCD 控制器，包括中间扫描线效果。
• 支持 Game Boy Color。
• 支持屏幕幽灵效果和点阵效果。
• 支持电池供电的 RAM 保存。
• 支持保存状态。
• 支持压缩的 ROM 文件（ZIP）。
• 支持引导 ROM (BIOS)。
• 支持 Game Genie 和 GameShark 计分支持。
• 支持多种操作系统平台。
• 包含功能齐全的调试器。

小贴士

• 可选加载引导 ROM。
• 鼠标光标在主输出窗口或主菜单关闭时自动隐藏。
• 通过创建名为 portable.ini 的空文件启用便携模式。
• 在调试模式下，可以按住 SHIFT 键拖动窗口以实现窗口停靠。
• 在 Windows 或 macOS 上，可以在调试菜单中启用“多视口”功能。

3. 项目API使用文档

Gearboy 的 API 使用方法将在后续版本中提供。

4. 项目安装方式

项目安装方式已在“安装指南”中详细说明。您可以通过下载预编译版本或从源代码编译来安装 Gearboy。