SDL_GetJoystickHat - Man Page

Get the current state of a POV hat on a joystick.

Header File

Defined in SDL3/SDL_joystick.h

Synopsis

#include "SDL3/SDL.h"

Uint8 SDL_GetJoystickHat(SDL_Joystick *joystick, int hat);


#define SDL_HAT_CENTERED    0x00u
#define SDL_HAT_UP          0x01u
#define SDL_HAT_RIGHT       0x02u
#define SDL_HAT_DOWN        0x04u
#define SDL_HAT_LEFT        0x08u
#define SDL_HAT_RIGHTUP     (SDL_HAT_RIGHT|SDL_HAT_UP)
#define SDL_HAT_RIGHTDOWN   (SDL_HAT_RIGHT|SDL_HAT_DOWN)
#define SDL_HAT_LEFTUP      (SDL_HAT_LEFT|SDL_HAT_UP)
#define SDL_HAT_LEFTDOWN    (SDL_HAT_LEFT|SDL_HAT_DOWN)

Description

The returned value will be one of the SDL_HAT_* values.

Function Parameters

joystick

an SDL_Joystick
structure containing joystick information.

hat

the hat index to get the state from; indices start at index 0.

Return Value

Returns the current hat position.

Availability

This function is available since SDL 3.2.0.

See Also

·(3), SDL_GetNumJoystickHats(3)

Referenced By

SDL_GetNumJoystickHats(3).

SDL 3.2.8 Simple Directmedia Layer SDL3 FUNCTIONS