gainput

该项目已存档。它既不维护，也不再开发。

增益

增益显示是您游戏的很棒的C ++输入库：

• 处理您的输入需求，从低级设备读取到用户定义按钮的高级映射
• 有据可查，干净，轻巧且易于使用
• 所有受支持平台上的统一接口： Android NDK，iOS/TVOS，Linux，MacOS，Windows
• 支持的设备：键盘，鼠标，游戏板，多点触摸，设备内置传感器
• 开源（MIT许可证）
• 完整的功能列表
• API文档

用法

# 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 ();

	// May need some platform-specific message handling here

	if (map. GetBoolWasDown (ButtonConfirm))
	{
		// Confirmed!
	}
}

特征

• 在所有受支持的平台上提供统一的界面。 （设置库是必需的一些小更改。）
• 提供低级和高级接口：直接查询输入设备按钮的状态，或将设备按钮映射到用户按钮。这样，很容易支持替代输入或以后更改输入映射。
• 支持输入序列的记录和播放。
• 具有网络服务器，以获取有关设备和映射的信息。
• 两个增益实例可以通过网络同步设备态。也可以从智能手机的常规浏览器中接收多点触摸输入。
• 完全用便携式C ++编写。
• 不使用STL 。没有例外。不使用RTTI 。没有C ++ 11 ，也没有提升。
• 没有使用奇怪的外部依赖性。依靠现有的平台SDK。
• 使用您喜欢的IDE/构建工具轻松设置和构建。
• 可以为设备按钮和用户按钮安装听众。这样，当按钮状态更改时，您会收到通知。
• 手势允许检测到更复杂的输入模式，例如双击，捏/旋转手势或同时持有多个按钮。
• 可以将外部分配器提供给库，以便按照您想要的方式完成所有内存管理。
• 支持Linux和Windows上的原始输入。
• 在可用的地方支持GamePad Rumblis。
• 很容易检查所有按下按钮，以便为播放器提供一种易于实现的方式。同样，很容易保存和加载映射。
• 可能不必要的功能（例如手势或网络服务器）很容易被禁用。
• 可以为任何浮点值按钮设置死区。
• 状态更改，即可以检查一个按钮新按钮或刚刚释放的按钮。

建筑

默认情况下，使用CMAKE构建增益。

1. 运行mkdir build
2. 运行cmake ..
3. make
4. 该库可以在lib/ samples/ 。

贡献

欢迎每个人为图书馆做出贡献。如果发现任何问题，可以使用GitHub的问题系统提交它们。如果要贡献代码，则应分配项目，然后发送拉动请求。

依赖性

增益量具有最少的外部依赖性，以使其尽可能独立。它使用平台获取输入的默认方式，并且不使用STL。

测试

通常，应通过在所有受支持的平台上构建和运行增益来进行测试。应使用samples/文件夹中的样品，以确定库是否功能。

test/文件夹中的单元测试是由普通CMAKE构建构建的。可执行文件可以在test/文件夹中找到。每当将某些东西推入存储库时，所有构建配置和单元测试均由Travis CI构建和运行。

替代方案

• OIS
• SDL