目次 - SDL 3.0 API(機能別) - ゲームパッド - SDL_GetGamepadAxis

SDL_GetGamepadAxis

ゲームパッドの方向コントローラーの状態を得る

ヘッダ

SDL3/SDL_gamepad.h

構文

Sint16 SDL_GetGamepadAxis(SDL_Gamepad *gamepad, SDL_GamepadAxis axis);

引数

SDL_Gamepad *gamepadゲームパッド
SDL_GamepadAxisaxis方向のインデックス番号(SDL_GamepadAxisの値の1つ)

戻り値

(Sint16) 方向の状態を戻す.

詳細

方向のインデックス番号は0から始まる.

アナログスティックの場合, 値は-32768(上/左)から32767(下/右)の範囲である.

トリガーの場合, 値は0(離した状態)から32767(完全に押した状態)で, 負の値になることはない. この値は全範囲で正規化されているので, 下位レベルのSDL_GetJoystickAxis()が報告した値とは異なる.

無効なゲームパッドや方向の場合, 0を戻す. 0は通常の操作での有効な値でもある(通常は中央).

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_GetGamepadAxis - SDL Wiki