目次 - 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_GameControllerGetAttached
  9. SDL_GameControllerGetAxis
  10. SDL_GameControllerGetAxisFromString
  11. SDL_GameControllerGetBindForAxis
  12. SDL_GameControllerGetBindForButton
  13. SDL_GameControllerGetButton
  14. SDL_GameControllerGetButtonFromString
  15. SDL_GameControllerGetJoystick
  16. SDL_GameControllerGetNumTouchpadFingers
  17. SDL_GameControllerGetNumTouchpads
  18. SDL_GameControllerGetPlayerIndex
  19. SDL_GameControllerGetProduct
  20. SDL_GameControllerGetProductVersion
  21. SDL_GameControllerGetSensorData
  22. SDL_GameControllerGetSerial
  23. SDL_GameControllerGetStringForAxis
  24. SDL_GameControllerGetStringForButton
  25. SDL_GameControllerGetTouchpadFinger
  26. SDL_GameControllerGetType
  27. SDL_GameControllerGetVendor
  28. SDL_GameControllerHasAxis
  29. SDL_GameControllerHasButton
  30. SDL_GameControllerHasLED
  31. SDL_GameControllerHasSensor
  32. SDL_GameControllerIsSensorEnabled
  33. SDL_GameControllerMapping
  34. SDL_GameControllerMappingForDeviceIndex
  35. SDL_GameControllerMappingForGUID
  36. SDL_GameControllerMappingForIndex
  37. SDL_GameControllerName
  38. SDL_GameControllerNameForIndex
  39. SDL_GameControllerNumMappings
  40. SDL_GameControllerOpen
  41. SDL_GameControllerRumble
  42. SDL_GameControllerSetLED
  43. SDL_GameControllerSetPlayerIndex
  44. SDL_GameControllerSetSensorEnabled
  45. SDL_GameControllerTypeForIndex
  46. SDL_GameControllerUpdate
  47. SDL_IsGameController

SDL Wikiへのリンク

GameController and Joystick Mapping - SDL Wiki