SDL Wiki
(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)


Get the number of trackballs on a joystick.

Header File

Defined in <SDL3/SDL_joystick.h>


int SDL_GetNumJoystickBalls(SDL_Joystick *joystick);

Function Parameters

SDL_Joystick * joystick an SDL_Joystick structure containing joystick information.

Return Value

(int) Returns the number of trackballs on success or a negative error code on failure; call SDL_GetError() for more information.


Joystick trackballs have only relative motion events associated with them and their state cannot be polled.

Most joysticks do not have trackballs.


This function is available since SDL 3.0.0.

See Also

CategoryAPI, CategoryAPIFunction, CategoryJoystick

[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.