Set values on an opened, virtual-joystick's axis.
int SDL_SetJoystickVirtualAxis(SDL_Joystick *joystick, int axis, Sint16 value);
joystick | the virtual joystick on which to set state. |
axis | the specific axis on the virtual joystick to set. |
value | the new value for the specified axis. |
Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.
Please note that values set here will not be applied until the next call to SDL_UpdateJoysticks, which can either be called directly, or can be called indirectly through various other SDL APIs, including, but not limited to the following: SDL_PollEvent, SDL_PumpEvents, SDL_WaitEventTimeout, SDL_WaitEvent.
Note that when sending trigger axes, you should scale the value to the full range of Sint16. For example, a trigger at rest would have the value of SDL_JOYSTICK_AXIS_MIN
.
This function is available since SDL 3.0.0.