gainput

このプロジェクトはアーカイブされています。それはもう維持されておらず、開発されていません。

gainput

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!
	}
}

特徴

• サポートされているすべてのプラットフォームで統一されたインターフェイスを提供します。 （ライブラリをセットアップするには、いくつかの小さな変更が必要です。）
• 低レベルと高レベルのインターフェイスを提供します。入力デバイスボタンの状態を直接クエリするか、デバイスボタンをユーザーボタンにマップします。そうすれば、代替入力をサポートしたり、後で入力マッピングを変更したりするのは簡単です。
• 入力シーケンスの記録と再生をサポートします。
• デバイスとマッピングに関する情報を取得するためのネットワークサーバーを備えています。
• 2つのGainputインスタンスは、ネットワーク上でデバイスの状態を同期できます。スマートフォンの通常のブラウザからマルチタッチ入力を受信することもできます。
• ポータブルC ++で完全に記述されています。
• STLは使用されていません。例外は投げられません。 RTTIは使用されません。 C ++ 11はありませんし、ブーストもありません。
• 奇妙な外部依存関係は使用されません。既存のプラットフォームSDKに依存しています。
• お気に入りのIDE/ビルドツールを使用して簡単にセットアップおよび構築できます。
• リスナーは、デバイスボタンとユーザーボタンの両方にインストールできます。そうすれば、ボタン状態が変更されたときに通知されます。
• ジェスチャーにより、ダブルクリック、ピンチ/回転ジェスチャーなど、より複雑な入力パターンを検出するか、複数のボタンを同時に保持します。
• 外部アロケーターをライブラリに提供できるため、すべてのメモリ管理が必要になります。
• LinuxとWindowsの生の入力をサポートします。
• GamePadのゴロゴロは、利用可能な場合はサポートされています。
• すべてのプレスボタンをチェックするのは簡単です。そうすれば、プレイヤーにボタンを再マッピングする方法を提供することが簡単に実装できます。同様に、マッピングを保存してロードするのは簡単です。
• ジェスチャーやネットワークサーバーなどの不要な機能は、簡単に無効になります。
• デッドゾーンは、任意のフロート値ボタン用にセットアップできます。
• 状態の変更、つまり、ボタンが新しく下になっているか、リリースされただけの場合、チェックすることができます。

建物

デフォルトでは、gainputはcmakeを使用して構築されます。

1. mkdir buildを実行します
2. cmake ..
3. 実行しmake
4. ライブラリは、 lib/ 、 samples/の実行可能ファイルにあります。

貢献

誰もが図書館に貢献できます。問題がある場合は、GitHubの問題システムを使用してそれらを送信できます。コードを寄付したい場合は、プロジェクトをフォークしてからプルリクエストを送信する必要があります。

依存関係

Gainputには、可能な限り自己完結型にするための外部依存関係の数が最小限に抑えられています。プラットフォームのデフォルトの入力の取得方法を使用し、STLを使用しません。

テスト

通常、テストは、サポートされているすべてのプラットフォームでGainputを構築および実行することで行う必要があります。ライブラリが機能しているかどうかを判断するには、 samples/フォルダー内のサンプルを使用する必要があります。

test/フォルダーのユニットテストは、通常のcmakeビルドによって構築されます。実行可能ファイルは、 test/フォルダーにあります。すべてのビルド構成とユニットテストは、何かがリポジトリに押し込まれるたびにTravis CIによって構築および実行されます。

代替案

• ois
• SDL