SDL_GetJoystickBall - Man Page
Get the ball axis change since the last poll.
Synopsis
#include <SDL3/SDL_joystick.h> bool SDL_GetJoystickBall(SDL_Joystick *joystick, int ball, int *dx, int *dy);
Description
Trackballs can only return relative motion since the last call to SDL_GetJoystickBall(), these motion deltas are placed into dx and dy.
Most joysticks do not have trackballs.
Function Parameters
- joystick
the SDL_Joystick to query.
- ball
the ball index to query; ball indices start at index 0.
- dx
stores the difference in the x axis position since the last poll.
- dy
stores the difference in the y axis position since the last poll.
Return Value
Returns true on success or false on failure; call SDL_GetError() for more information.
Thread Safety
It is safe to call this function from any thread.
Availability
This function is available since SDL 3.2.0.
See Also
Referenced By
SDL 3.3.2 Simple Directmedia Layer SDL3 FUNCTIONS