Sint16 SDL_GetJoystickAxis(SDL_Joystick *joystick, int axis);
| SDL_Joystick * | joystick | ジョイスティックの情報を持つSDL_Joystick |
| int | axis | 状態を得る方向. 方向のインデックス番号は0から始まる |
(Sint16) 現在の方向コントローラの位置を表す16ビット符号あり整数を戻す. 失敗のとき0を戻す. SDL_GetError()を呼んで詳細を知ることができる.
SDLは渡されたaxisがどのコントローラーを示すのかを保証しない.
アプリケーションのUI設定などでユーザに方向を決めさせる必要がある.
これとは異なり, SDLの高レベルゲームパッドAPIでは多くの労力をかけて低レベルインターフェースに順序付けを適用させており, 「左親指スティック」のようにスティックを特定することができる.
SDL_GetJoystickAxis()が戻す符号あり整数(-32768から32767)の値は, 現在の方向の位置を表している. ゆらぎを考慮して, この値に一定の許容値を課す必要があるかもしれない.
この関数はどのスレッドからも安全に呼べる.