目次 - 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_GameControllerHasSensor
  36. SDL_GameControllerIsSensorEnabled
  37. SDL_GameControllerMapping
  38. SDL_GameControllerMappingForDeviceIndex
  39. SDL_GameControllerMappingForGUID
  40. SDL_GameControllerMappingForIndex
  41. SDL_GameControllerName
  42. SDL_GameControllerNameForIndex
  43. SDL_GameControllerNumMappings
  44. SDL_GameControllerOpen
  45. SDL_GameControllerRumble
  46. SDL_GameControllerRumbleTriggers
  47. SDL_GameControllerSendEffect
  48. SDL_GameControllerSetLED
  49. SDL_GameControllerSetPlayerIndex
  50. SDL_GameControllerSetSensorEnabled
  51. SDL_GameControllerTypeForIndex
  52. SDL_GameControllerUpdate
  53. SDL_IsGameController

SDL Wikiへのリンク

GameController and Joystick Mapping - SDL Wiki