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 a list of registered touch devices.

Header File

Defined in <SDL3/SDL_touch.h>


const SDL_TouchID * SDL_GetTouchDevices(int *count);

Function Parameters

int * count a pointer filled in with the number of devices returned, may be NULL.

Return Value

(const SDL_TouchID *) Returns a 0 terminated array of touch device IDs or NULL on failure; call SDL_GetError() for more information.


On some platforms SDL first sees the touch device if it was actually used. Therefore the returned list might be empty, although devices are available. After using all devices at least once the number will be correct.

This returns temporary memory which will be automatically freed later, and can be claimed with SDL_ClaimTemporaryMemory().


This function is available since SDL 3.0.0.

CategoryAPI, CategoryAPIFunction, CategoryTouch

[ 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.