目次 - API(機能別) - ゲームコントローラー

# ゲームコントローラー

インクルードファイル: SDL_gamecontroller.h

## 概要

ここに分類される関数は, ゲームコントローラーとゲームコントローラーにマッピング(対応付け)されたジョイスティックを扱う. これは既存のジョイスティックAPIの上に成り立っている.

SDL_GameControllerはゲームパッド(コントローラー)をxbox360-padと同じようなものとして抽象化してあつかう. つまり, ゲームパッドには十字キー, 2つのアナログスティック, 右側の4ボタン(よくA, B, X, Yと呼ばれる), ショルダーボタン(その内の2つはコントローラーかもしれない), 中央の3ボタン(スタート, バック, そしてしばしばロゴボタン)がある. これは似たようなレイアウトのデバイス, 例えばPlaystation DualShockコントローラーにも存在するが, ボタン名が異なる. SDL_GameControllerでは, 対応する全てのデバイスはxbox360/XInputの名称に変換される. 例えば, SDL_CONTROLLER_AXIS_LEFTXは常に左アナログスティックのX軸, SDL_CONTROLLER_BUTTON_Bは常に右側の4ボタンで最も右側のボタンである. これによりあなたのユーザに「Bでジャンプ, 左アナログスティックで移動」のように(同じようなデバイスに)一貫したルールを提供できる. SDL_Joystick(とDirectInputのような下位API)では, SDL(やDirectInput)上のスティックやボタンとデバイス上の物理的なスティック/ボタンの位置の対応付けを知ることはできない.

もしStreamからゲームを起動すると, ゲームコントローラーは自動的にマッピングされる.

## 列挙体

1. SDL_GameControllerAxis
2. SDL_GameControllerButton
3. SDL_GameControllerBindType

## 構造体

1. SDL_GameControllerButtonBind

## 関数

1. SDL_GameControllerAddMapping
2. SDL_GameControllerAddMappingsFromFile
3. SDL_GameControllerAddMappingsFromRW
4. SDL_GameControllerClose
5. SDL_GameControllerEventState
6. SDL_GameControllerFromInstanceID
7. SDL_GameControllerFromPlayerIndex
8. SDL_GameControllerGetAppleSFSymbolsNameForAxis
9. SDL_GameControllerGetAppleSFSymbolsNameForButton
10. SDL_GameControllerGetAttached
11. SDL_GameControllerGetAxis
12. SDL_GameControllerGetAxisFromString
13. SDL_GameControllerGetBindForAxis
14. SDL_GameControllerGetBindForButton
15. SDL_GameControllerGetButton
16. SDL_GameControllerGetButtonFromString
17. SDL_GameControllerGetJoystick
18. SDL_GameControllerGetNumTouchpadFingers
19. SDL_GameControllerGetNumTouchpads
20. SDL_GameControllerGetPlayerIndex
21. SDL_GameControllerGetProduct
22. SDL_GameControllerGetProductVersion
23. SDL_GameControllerGetSensorData
24. SDL_GameControllerGetSensorDataRate
25. SDL_GameControllerGetSerial
26. SDL_GameControllerGetStringForAxis
27. SDL_GameControllerGetStringForButton
28. SDL_GameControllerGetTouchpadFinger
29. SDL_GameControllerGetType
30. SDL_GameControllerGetVendor
31. SDL_GameControllerHasAxis
32. SDL_GameControllerHasButton
33. SDL_GameControllerHasLED
34. SDL_GameControllerHasRumble
35. SDL_GameControllerHasRumbleTriggers
36. SDL_GameControllerHasSensor
37. SDL_GameControllerIsSensorEnabled
38. SDL_GameControllerMapping
39. SDL_GameControllerMappingForDeviceIndex
40. SDL_GameControllerMappingForGUID
41. SDL_GameControllerMappingForIndex
42. SDL_GameControllerName
43. SDL_GameControllerNameForIndex
44. SDL_GameControllerNumMappings
45. SDL_GameControllerOpen
46. SDL_GameControllerRumble
47. SDL_GameControllerRumbleTriggers
48. SDL_GameControllerSendEffect
49. SDL_GameControllerSetLED
50. SDL_GameControllerSetPlayerIndex
51. SDL_GameControllerSetSensorEnabled
52. SDL_GameControllerTypeForIndex
53. SDL_GameControllerUpdate
54. SDL_IsGameController

## SDL Wikiへのリンク

GameController and Joystick Mapping - SDL Wiki