VisualBoyAdvance 使用与技术文档

1. 安装指南

系统要求

• Windows: PIII 500MHz 或更高配置，GBA 模拟需要更强的处理器，GB 模拟则要求较低。
• Linux, MacOS X, BeOS: 需要安装 SDL (≥ 1.2.2) 运行时库。

编译指南

• 对于 Windows 用户，需要 Microsoft Visual C++ 6 或更高版本。
• 对于 Linux, MacOS X, BeOS 用户，需要 GCC 3.x 或更高版本以编译 GBA.cpp。

安装步骤

将所有分布文件放在同一目录下即可完成安装。

2. 项目使用说明

VisualBoyAdvance 是一款 GB/GBC/GBA 模拟器，支持 Windows、Linux、MacOS X 和 BeOS 系统。它包含以下特点：

• 可配置的 GB/GBA 键位，支持摇杆。
• 可选使用 BIOS 文件。
• 支持 zip/gzip 文件。
• 可以选择保存状态、电池和屏幕捕捉的目录。
• 支持全屏模式（可选分辨率）。
• 支持 1x、2x、3x 和 4x 视频尺寸。
• 支持多种图形过滤器。
• 支持帧间混合。
• 内置 ARM/THUMB 汇编调试器。
• 10 个可通过键盘访问的保存状态。
• 自动加载/保存电池文件。
• 支持自动开火。
• 支持键盘暂停、重置。
• 支持 16、24 和 32 位桌面系统。
• 支持 GDB 远程调试。
• 支持自动跳帧和节流。
• 支持 AGBPrint 开发功能。
• 支持 RTC。

3. 项目API使用文档

VisualBoyAdvance 提供了丰富的 API 用于调试和开发，具体使用方法如下：

• 使用 TCP 或 PIPE 与 GDB 连接进行远程调试。
• 使用内置调试器的命令，例如 break、locals、print、symbols 等。
• 支持 ELF 文件加载和调试。

4. 项目安装方式

根据操作系统选择以下任一方式进行安装：

• Windows: 下载预编译的 VisualBoyAdvance 可执行文件，并将其放置在合适目录下。
• Linux, MacOS X, BeOS: 需要从源代码编译。请参考 INSTALL 文件中的编译指南。

使用说明

• 运行 VisualBoyAdvance，通过键盘快捷键进行操作，如 F1-F10 加载/保存状态，Ctrl+N 暂停下一帧等。
• 通过修改 vba-over.ini 文件，可以为每个游戏设置特定的选项，如 RTC 启用、闪存大小、保存类型等。

调试支持

• 通过 TCP 或 PIPE 支持 GDB 远程调试。
• 使用内置调试器进行调试，通过 F11 进入。

控制台输出

• 使用 print 函数输出信息到控制台。

性能分析

• 通过调用 monstartup、moncontrol、moncleanup 和 mcount 函数进行性能分析。

GCC 问题

• 如果使用 GCC，请确保版本为 3.3 或更高，以避免编译时出现已知问题。

以上是 VisualBoyAdvance 的安装指南、使用说明以及 API 文档的详细说明。希望对您使用本项目有所帮助。