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