devela::_dep::sdl3::sys::joystick

Function SDL_SetJoystickVirtualHat

pub unsafe extern "C" fn SDL_SetJoystickVirtualHat(
    joystick: *mut SDL_Joystick,
    hat: i32,
    value: u8,
) -> bool
Available on crate feature dep_sdl3 only.
Expand description

Set the state of a hat on an opened virtual joystick.

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].

§Parameters

  • joystick: the virtual joystick on which to set state.
  • hat: the index of the hat on the virtual joystick to update.
  • value: the new value for the specified hat.

§Return value

Returns true on success or false on failure; call SDL_GetError() for more information.

§Availability

This function is available since SDL 3.2.0.