PinMAME 项目安装与配置指南

PinMAME 是一个开源项目，旨在模拟几乎所有的固态弹球机硬件，从 1970 年代中期 CPU 控制的机器到 2014 年的 Stern SAM。本项目使用 C++ 作为主要的编程语言。

项目基础介绍

PinMAME 能够模拟超过 770 种独特的弹球机以及更多克隆/修订版本，总共超过 2700 套。它不仅是一个独立的模拟器，还包括 COM 库和库文件，可以驱动 Visual Pinball 等模拟器或硬件替换解决方案。

关键技术和框架

• 模拟技术：PinMAME 通过模拟电子电路板和显示屏来重现弹球机的运作。
• 跨平台支持：项目支持多种操作系统，包括 Windows、Linux、macOS、iOS/tvOS 和 Android。
• 插件支持：PinMAME 支持 P-ROC、PPUC 和 LISY 等插件，用于驱动真实的弹球机。

安装和配置准备工作

在开始安装之前，请确保您的系统中已经安装了以下软件：

• 编译器：对于 Windows，需要安装 Visual Studio；对于 Linux，需要安装 GCC。
• 依赖库：根据您的操作系统，可能需要安装特定的库和工具。
• Git：需要 Git 工具来克隆项目仓库。

安装步骤

克隆项目仓库

首先，您需要从 GitHub 上克隆 PinMAME 项目仓库：

git clone https://github.com/vpinball/pinmame.git

编译项目

Windows 用户

1. 打开 Visual Studio。
2. 选择“打开项目”或“创建项目”。
3. 导航到克隆的项目目录，找到相应的 .sln 文件。
4. 跟随 Visual Studio 的指导完成项目的构建。

Linux 用户

1. 打开终端。
2. 切换到克隆的项目目录。
3. 使用以下命令进行编译：

mkdir build && cd build
cmake ..
make

配置

1. 环境变量：确保您的系统中已经设置了正确的环境变量，以便编译器和链接器可以找到必要的库和工具。
2. 依赖管理：根据您的操作系统，您可能需要安装额外的依赖库。

运行项目

编译完成后，您可以通过以下命令运行 PinMAME：

./pinmame

请注意，PinMAME 本身并不模拟弹球机的玩场和球，这些需要通过其他程序包如 Visual Pinball 来实现。

以上步骤是一个基础的安装和配置指南，具体细节可能会根据您的操作系统和开发环境有所不同。希望这个指南能帮助您成功安装和运行 PinMAME 项目。