SDL_GetTouchFingers

Get a list of active fingers for a given touch device.

Header File

Defined in <SDL3/SDL_touch.h>

Syntax

SDL_Finger ** SDL_GetTouchFingers(SDL_TouchID touchID, int *count);

Function Parameters

SDL_TouchID touchID the ID of a touch device.
int * count a pointer filled in with the number of fingers returned, can be NULL.

Return Value

(SDL_Finger **) Returns a NULL terminated array of SDL_Finger pointers or NULL on failure; call SDL_GetError() for more information. This is a single allocation that should be freed with SDL_free() when it is no longer needed.

Version

This function is available since SDL 3.2.0.

CategoryAPI, CategoryAPIFunction, CategoryTouch