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 Rumbling은 사용 가능한 경우 지원됩니다.
• 플레이어가 버튼을 다시 찍을 수있는 방법을 제공 할 수 있도록 모든 누름 버튼을 쉽게 확인할 수 있습니다. 마찬가지로 매핑을 저장하고로드하기 쉽습니다.
• 제스처 나 네트워크 서버와 같은 불필요한 기능은 쉽게 비활성화 될 수 있습니다.
• 플로트 값 버튼에 대한 데드 존을 설정할 수 있습니다.
• 상태 변경 , 즉 버튼이 새로 다운되었거나 방금 릴리스 된 경우 확인할 수 있습니다.

건물

기본적으로 Gainput은 CMAKE를 사용하여 구축됩니다.

1. mkdir build 실행하십시오
2. cmake ..
3. make
4. 라이브러리는 lib/ , samples/ 에서 실행 파일로 찾을 수 있습니다.

기여

모든 사람은 도서관에 기여할 수 있습니다. 문제가있는 경우 GitHub의 문제 시스템을 사용하여 문제를 제출할 수 있습니다. 코드를 기여하려면 프로젝트를 포크 한 다음 풀 요청을 보내야합니다.

의존성

이득은 최소한의 외부 종속성을 가지고있어 가능한 한 독립적 인 자체를 제공합니다. 입력을 얻는 플랫폼의 기본 방법을 사용하고 STL을 사용하지 않습니다.

테스트

일반적으로 모든 지원되는 플랫폼에서 게인을 구축하고 실행하여 테스트를 수행해야합니다. 라이브러리가 작동하는지 확인하기 위해 samples/ 폴더의 샘플을 사용해야합니다.

test/ 폴더의 단위 테스트는 일반 CMAKE 빌드에 의해 구축됩니다. 실행 파일은 test/ 폴더에서 찾을 수 있습니다. 모든 빌드 구성 및 단위 테스트는 무언가가 저장소로 밀릴 때마다 Travis CI에 의해 구축되고 실행됩니다.

대안

• OIS
• SDL