(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_GetNumJoystickAxes

Get the number of general axis controls on a joystick.

Header File

Syntax

int SDL_GetNumJoystickAxes(SDL_Joystick *joystick);

Function Parameters

SDL_Joystick *

joystick

an SDL_Joystick structure containing joystick information.

Return Value

(int) Returns the number of axis controls/number of axes on success or -1 on failure; call SDL_GetError() for more information.

Remarks

Often, the directional pad on a game controller will either look like 4 separate buttons or a POV hat, and not axes, but all of this is up to the device and platform.

Version

This function is available since SDL 3.1.3.