SDL_GetTouchFingers - Man Page

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

Header File

Defined in SDL3/SDL_touch.h

Synopsis

#include "SDL3/SDL.h"

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

Function Parameters

touchID

the ID of a touch device.

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.

Availability

This function is available since SDL 3.2.0.

Referenced By

SDL_Finger.3type(3).

SDL 3.2.2 Simple Directmedia Layer SDL3 FUNCTIONS