Gainput 技术文档

本文档旨在帮助用户了解和使用 Gainput，这是一个用于游戏的 C++ 开源输入库。以下是安装指南、使用说明和项目 API 使用文档。

1. 安装指南

Gainput 默认使用 CMake 进行构建。

1. 运行 mkdir build 创建构建目录。
2. 运行 cmake .. 配置项目。
3. 运行 make 构建项目。

构建完成后，库文件可以在 lib/ 目录中找到，可执行文件在 samples/ 目录中。

2. 项目使用说明

以下是 Gainput 的基本使用示例：

#include <gainput/gainput.h>

enum Button
{
    ButtonConfirm
};

gainput::InputManager manager;
manager.SetDisplaySize(displayWidth, displayHeight);
const gainput::DeviceId keyboardId = manager.CreateDevice<gainput::InputDeviceKeyboard>();
const gainput::DeviceId mouseId = manager.CreateDevice<gainput::InputDeviceMouse>();
const gainput::DeviceId padId = manager.CreateDevice<gainput::InputDevicePad>();
const gainput::DeviceId touchId = manager.CreateDevice<gainput::InputDeviceTouch>();

gainput::InputMap map(manager);
map.MapBool(ButtonConfirm, keyboardId, gainput::KeyReturn);
map.MapBool(ButtonConfirm, mouseId, gainput::MouseButtonLeft);
map.MapBool(ButtonConfirm, padId, gainput::PadButtonA);
map.MapBool(ButtonConfirm, touchId, gainput::Touch0Down);

while (running)
{
    manager.Update();

    // 可能需要一些平台特定的消息处理

    if (map.GetBoolWasDown(ButtonConfirm))
    {
        // 确认操作
    }
}

3. 项目 API 使用文档

Gainput 的 API 文档可以在 官方网站 上找到。文档详细介绍了库中的类、方法和函数，帮助开发者更好地理解和使用库。

4. 项目安装方式

如前所述，Gainput 使用 CMake 进行构建。以下是详细的安装步骤：

1. 下载或克隆项目到本地。
2. 在项目根目录下创建一个名为 build 的新目录。
3. 在 build 目录中运行 cmake .. 命令配置项目。
4. 运行 make 命令构建项目。

构建完成后，即可在 lib/ 目录中找到库文件，在 samples/ 目录中找到示例程序。