Sint16 SDL_JoystickGetAxis(SDL_Joystick* joystick, int axis)
| joystick | 開いたジョイスティック |
| axis | 調査する軸. 軸番号は0から始まる (詳細を参照すること) |
軸の現在の状態を表す符号付16bit整数を戻す. 失敗のとき0を戻す. SDL_GetError()で詳細を知ることができる.
戻り値は-32768〜32767の範囲である.
extern SDL_Joystick* joy1;
Sint16 x_move, y_move;
x_move = SDL_JoystickGetAxis(joy1, 0);
y_move = SDL_JoystickGetAxis(joy1, 1);
SDLは, 指定された軸がジョイスティックのどの部分を示すのかを保障しない. 設定変更UIを用意して, どの軸がどの部分であるかユーザに特定させる必要がある. SDLの高レベルゲームコントローラーAPIでは, この低レベルインターフェースを秩序立ったものにする努力がなされており, 指定の軸が「左親指スティック」などと分かることができる.
この関数の戻り値は符号つき整数(-32768〜32767)で, 現在の軸を表している. この値はいくらかの揺らぎを考慮する必要がある.