bool SDL_SetJoystickVirtualAxis(SDL_Joystick *joystick, int axis, Sint16 value);
| SDL_Joystick * | joystick | 状態を設定する仮想ジョイスティック |
| int | axis | 更新する仮想ジョイスティックの方向のインデックス番号 |
| Sint16 | value | 方向の新しい値 |
(bool) 成功のとき真, 失敗のとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.
ここで設定した値は, 直接または(SDL_PollEvent, SDL_PumpEvents, SDL_WaitEventTimeout, SDL_WaitEvent以外を含む)様々なSDL APIを通してSDL_UpdateJoysticksが呼ばれるまで適用されない.
トリガーの方向を送信する場合, Sint16の最大の値にする必要がある. 例えば, トリガーが引かれていない場合の値はSDL_JOYSTICK_AXIS_MINである.
この関数はどのスレッドからも安全に呼べる.