EmulationStation 技术文档

EmulationStation 是一个跨平台图形前端，用于模拟器并支持控制器导航。以下是详细的安装指南、使用说明、API 使用文档和项目安装方式。

1. 安装指南

依赖安装（Debian/Ubuntu）

sudo apt-get install libsdl2-dev libboost-system-dev libboost-filesystem-dev libboost-date-time-dev libboost-locale-dev libfreeimage-dev libfreetype6-dev libeigen3-dev libcurl4-openssl-dev libasound2-dev libgl1-mesa-dev build-essential cmake fonts-droid

编译

cd YourEmulationStationDirectory
cmake .
make

Windows 平台

• Boost
• Eigen3
• FreeImage
• FreeType2
• SDL2
• cURL
• CMake

编译步骤请参考 CMake 的使用说明。

2. 项目的使用说明

首次运行 EmulationStation 时，会自动创建一个示例配置文件 ~/.emulationstation/es_systems.cfg。该文件包含了系统配置数据，告诉 EmulationStation 你拥有哪些系统、它们对应的平台以及游戏的位置。

运行 EmulationStation 后，可以配置输入设备。按下设备的按钮，按照屏幕提示操作，完成后保存配置。

若控制器停止工作，可以删除 ~/.emulationstation/es_input.cfg 文件，下次运行时会重新出现输入配置屏幕。

可以使用 --help 或 -h 查看命令行选项。

3. 项目API使用文档

EmulationStation 提供了以下命令行选项：

• --resolution [width] [height]：尝试强制特定分辨率
• --gamelist-only：只显示在 gamelist.xml 文件中定义的游戏
• --ignore-gamelist：不解析任何 gamelist.xml 文件
• --draw-framerate：显示帧率
• --no-exit：不在 ES 菜单中显示 '退出'
• --debug：在 Windows 上显示控制台窗口，进行更多日志记录
• --windowed：以窗口模式运行 ES，最好与 --resolution [w] [h] 结合使用
• --vsync [1/on or 0/off]：开启或关闭垂直同步（默认开启）
• --scrape：运行交互式命令行元数据抓取器

4. 项目安装方式

Raspberry Pi 用户可以使用 petrockblog 的脚本自动安装许多模拟器和 ES。你可以在这里找到它：RetroPie-Setup。

Windows 用户需要安装上述依赖，并使用 CMake 生成 Visual Studio 项目。

以上就是 EmulationStation 的技术文档，希望对您有所帮助。