jstest-gtk 项目技术文档

1. 安装指南

系统要求

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

• cmake
• sigc++
• gtkmm

这些软件包通常可以在大多数Linux发行版的包管理器中找到。

安装步骤

1. 打开终端并克隆项目仓库：

   git clone https://github.com/Grumbel/jstest-gtk.git
   

2. 进入项目目录：

   cd jstest-gtk
   

3. 创建一个构建目录并进入该目录：

   mkdir build
   cd build
   

4. 运行cmake配置构建环境：

   cmake ..
   

5. 编译项目：

   make
   

2. 项目的使用说明

启动程序

编译完成后，您可以通过以下命令启动jstest-gtk：

./jstest-gtk

如果您知道要测试的设备，可以直接指定设备路径：

./jstest-gtk /dev/input/js0

主界面功能

• 设备列表：主窗口会显示当前连接的摇杆设备列表。
• 测试对话框：双击设备列表中的某个摇杆，将显示测试对话框，允许您测试摇杆的按钮和轴。
• 映射对话框：允许您重新排列按钮和轴的顺序，适用于某些游戏对按钮和轴顺序有特定要求的情况。
• 校准对话框：允许您调整摇杆的低级细节，例如反转轴、禁用轴或移除死区，以获得更精细的控制。

3. 项目API使用文档

环境变量配置

在某些情况下，您的SDL版本可能不会使用摇杆接口，而是直接使用/dev/input/event*设备。在这种情况下，您可以通过设置环境变量来强制SDL使用摇杆设备：

SDL_JOYSTICK_DEVICE="/dev/input/js0"
export SDL_JOYSTICK_DEVICE

如果您需要使用多个摇杆，上述方法可能无效，您可能需要重新编译SDL并禁用evdev支持。

特殊配置

• SDL_LINUX_JOYSTICK：用于Linux的特殊摇杆配置字符串，格式为name numaxes numhats numballs，其中name是摇杆的名称，其余是轴、帽子和球的数量。
• SDL_JOYSTICK_DEVICE：指定Linux摇杆驱动程序使用的摇杆设备，除了通常的/dev/js*、/dev/input/event*、/dev/input/js*。

4. 项目安装方式

源码安装

1. 克隆项目仓库：

   git clone https://github.com/Grumbel/jstest-gtk.git
   

2. 进入项目目录并创建构建目录：

   cd jstest-gtk
   mkdir build
   cd build
   

3. 配置并编译项目：

   cmake ..
   make
   

包管理器安装

某些Linux发行版可能已经将jstest-gtk打包，您可以通过包管理器直接安装。例如，在Debian/Ubuntu系统上，您可以使用以下命令：

sudo apt-get install jstest-gtk

通过以上步骤，您可以顺利安装并使用jstest-gtk项目。