SDL_GameControllerDB 项目使用教程

1. 项目的目录结构及介绍

SDL_GameControllerDB 项目的目录结构如下：

SDL_GameControllerDB/
├── LICENSE
├── README.md
├── gamecontrollerdb.txt
├── mapping_guide.png
├── duplicates.py
└── github/
    └── workflows/

目录结构介绍

• LICENSE: 项目的许可证文件，采用 Zlib 许可证。
• README.md: 项目的说明文件，包含项目的基本介绍、使用方法和贡献指南。
• gamecontrollerdb.txt: 游戏控制器映射数据库文件，包含各种游戏控制器的映射信息。
• mapping_guide.png: 映射指南的图片文件，可能包含映射的图形化说明。
• duplicates.py: 用于检测重复映射的 Python 脚本。
• github/workflows/: 包含 GitHub Actions 的工作流配置文件。

2. 项目的启动文件介绍

SDL_GameControllerDB 项目本身是一个数据库文件集合，没有传统的“启动文件”。项目的主要功能是通过 gamecontrollerdb.txt 文件提供游戏控制器的映射信息。

使用方法

在 SDL2 或 SDL3 项目中，可以通过以下代码加载 gamecontrollerdb.txt 文件：

• SDL2:

  SDL_GameControllerAddMappingsFromFile("gamecontrollerdb.txt");
  

• SDL3:

  SDL_AddGamepadMappingsFromFile("gamecontrollerdb.txt");
  

3. 项目的配置文件介绍

SDL_GameControllerDB 项目的主要配置文件是 gamecontrollerdb.txt，该文件包含了各种游戏控制器的映射信息。每个映射条目通常包含以下内容：

• 控制器 GUID: 控制器的唯一标识符。
• 控制器名称: 控制器的描述性名称。
• 按钮/轴映射: 控制器按钮和轴的映射信息。
• 平台: 控制器所支持的操作系统平台。

示例映射条目

030000004c050000c405000000010000,PS4 Controller,a:b1,b:b2,back:b8,dpdown:h0.4,dpleft:h0.8,dpright:h0.2,dpup:h0.1,guide:b12,leftshoulder:b4,leftstick:b10,lefttrigger:a3,leftx:a0,lefty:a1,rightshoulder:b5,rightstick:b11,righttrigger:a4,rightx:a2,righty:a5,start:b9,x:b0,y:b3,platform:Mac OS X

配置文件的使用

开发者可以通过编辑 gamecontrollerdb.txt 文件来添加或修改控制器的映射信息。确保每个映射条目的格式正确，并且控制器名称和平台信息准确无误。

总结

SDL_GameControllerDB 项目是一个社区驱动的游戏控制器映射数据库，主要通过 gamecontrollerdb.txt 文件提供映射信息。开发者可以在 SDL2 或 SDL3 项目中加载该文件，以支持各种游戏控制器的输入。