RetroArch 技术文档

1. 安装指南

1.1 系统要求

RetroArch 支持多种平台，包括 Windows、Linux、macOS、Android 等。根据不同的平台，系统要求可能有所不同。以下是一些常见平台的基本要求：

• Windows: Windows 95 及以上版本。
• Linux: 支持 OpenGL 1.1 及以上版本的显卡。
• macOS: 需要最新版本的 Xcode 进行编译。
• Android: Android 2.x 及以上版本。

1.2 依赖库

RetroArch 在 PC 端运行时，依赖于一些常见的库，如 OpenGL、Vulkan、ALSA、OSS 等。具体依赖库如下：

• OpenGL 头文件 / Vulkan 头文件
• X11 头文件和库，或 EGL/KMS/GBM
• 音频驱动库：ALSA、OSS、RoarAudio、RSound、OpenAL、JACK、SDL、PulseAudio 等。

1.3 安装步骤

1. 下载二进制文件：可以从 buildbot 下载最新的 RetroArch 二进制文件。
2. 解压并运行：将下载的文件解压到目标目录，运行 retroarch 可执行文件即可启动。
3. 配置文件：首次运行时，RetroArch 会在 $XDG_CONFIG_HOME/retroarch/retroarch.cfg 目录下创建一个默认配置文件。用户可以根据需要修改该文件。

2. 项目的使用说明

2.1 启动 RetroArch

启动 RetroArch 后，用户可以通过界面选择不同的菜单驱动（如 XMB、RGUI、Ozone 等），并加载不同的 libretro 核心来运行游戏或应用程序。

2.2 加载游戏

1. 选择核心：在 RetroArch 的菜单中，选择“加载核心”并选择合适的 libretro 核心（如 NES 模拟器、SNES 模拟器等）。
2. 加载游戏：选择“加载内容”并选择要运行的游戏 ROM 文件。
3. 开始游戏：加载完成后，游戏将自动开始运行。

2.3 配置选项

RetroArch 提供了丰富的配置选项，用户可以通过菜单或配置文件进行调整。常见的配置选项包括：

• 视频设置：分辨率、全屏模式、滤镜等。
• 音频设置：音量、音频驱动等。
• 输入设置：手柄、键盘配置等。

3. 项目 API 使用文档

3.1 libretro API

RetroArch 是基于 libretro API 的前端。libretro API 提供了一组通用的音频、视频和输入回调接口，使得开发者可以轻松地将模拟器或游戏引擎移植到 libretro 平台上。

3.2 核心开发

开发者可以通过实现 libretro API 来创建自己的 libretro 核心。核心可以是模拟器、游戏引擎或其他类型的应用程序。核心通常以动态库的形式加载到 RetroArch 中。

3.3 API 头文件

libretro API 的头文件可以在 libretro API header 中找到。开发者可以参考该文件进行核心开发。

4. 项目安装方式

4.1 源码编译

1. 克隆仓库：使用 git clone https://github.com/libretro/RetroArch.git 克隆 RetroArch 仓库。
2. 编译：根据平台不同，使用相应的编译工具（如 make、cmake 等）进行编译。
3. 安装：编译完成后，运行 make install 进行安装。

4.2 二进制安装

1. 下载二进制文件：从 buildbot 下载适用于目标平台的二进制文件。
2. 解压并运行：将下载的文件解压到目标目录，运行 retroarch 可执行文件即可启动。

4.3 配置文件

RetroArch 的配置文件可以通过修改 retroarch.cfg 文件进行自定义。默认配置文件位于 $XDG_CONFIG_HOME/retroarch/retroarch.cfg。

5. 常见问题

5.1 如何配置手柄？

用户可以通过 RetroArch 的内置菜单或手动编辑 retroarch.cfg 文件来配置手柄。

5.2 如何启用 CRT 15Khz 分辨率切换？

启用 CRT 15Khz 分辨率切换后，RetroArch 将自动切换到 2560 x 480 @ 60 分辨率。用户需要在 Windows 系统上安装 CRTEmudriver 并配置相应的 modelines。

5.3 如何使用 Slang 着色器？

用户可以在 RetroArch 的设置中选择 OpenGL3 或 Direct3D 11 驱动，并加载 Slang 着色器文件以获得现代着色器效果。

通过以上文档，用户可以轻松安装、配置和使用 RetroArch，并了解其 API 的使用方法。