# CategoryTouch

SDL offers touch input, on platforms that support it. It can manage
multiple touch devices and track multiple fingers on those devices.

Touches are mostly dealt with through the event system, in the
[SDL_EVENT_FINGER_DOWN](SDL_EVENT_FINGER_DOWN),
[SDL_EVENT_FINGER_MOTION](SDL_EVENT_FINGER_MOTION), and
[SDL_EVENT_FINGER_UP](SDL_EVENT_FINGER_UP) events, but there are also
functions to query for hardware details, etc.

The touch system, by default, will also send virtual mouse events; this can
be useful for making a some desktop apps work on a phone without
significant changes. For apps that care about mouse and touch input
separately, they should ignore mouse events that have a `which` field of
[SDL_TOUCH_MOUSEID](SDL_TOUCH_MOUSEID).

<!-- END CATEGORY DOCUMENTATION -->

## Functions

<!-- DO NOT HAND-EDIT CATEGORY LISTS, THEY ARE AUTOGENERATED AND WILL BE OVERWRITTEN, BASED ON TAGS IN INDIVIDUAL PAGE FOOTERS. EDIT THOSE INSTEAD. -->
<!-- BEGIN CATEGORY LIST: CategoryTouch, CategoryAPIFunction -->
- [SDL_GetTouchDeviceName](SDL_GetTouchDeviceName)
- [SDL_GetTouchDevices](SDL_GetTouchDevices)
- [SDL_GetTouchDeviceType](SDL_GetTouchDeviceType)
- [SDL_GetTouchFingers](SDL_GetTouchFingers)
<!-- END CATEGORY LIST -->

## Datatypes

<!-- DO NOT HAND-EDIT CATEGORY LISTS, THEY ARE AUTOGENERATED AND WILL BE OVERWRITTEN, BASED ON TAGS IN INDIVIDUAL PAGE FOOTERS. EDIT THOSE INSTEAD. -->
<!-- BEGIN CATEGORY LIST: CategoryTouch, CategoryAPIDatatype -->
- [SDL_FingerID](SDL_FingerID)
- [SDL_TouchID](SDL_TouchID)
<!-- END CATEGORY LIST -->

## Structs

<!-- DO NOT HAND-EDIT CATEGORY LISTS, THEY ARE AUTOGENERATED AND WILL BE OVERWRITTEN, BASED ON TAGS IN INDIVIDUAL PAGE FOOTERS. EDIT THOSE INSTEAD. -->
<!-- BEGIN CATEGORY LIST: CategoryTouch, CategoryAPIStruct -->
- [SDL_Finger](SDL_Finger)
- [SDL_TouchFingerEvent](SDL_TouchFingerEvent)
<!-- END CATEGORY LIST -->

## Enums

<!-- DO NOT HAND-EDIT CATEGORY LISTS, THEY ARE AUTOGENERATED AND WILL BE OVERWRITTEN, BASED ON TAGS IN INDIVIDUAL PAGE FOOTERS. EDIT THOSE INSTEAD. -->
<!-- BEGIN CATEGORY LIST: CategoryTouch, CategoryAPIEnum -->
- [SDL_TouchDeviceType](SDL_TouchDeviceType)
<!-- END CATEGORY LIST -->

## Macros

<!-- DO NOT HAND-EDIT CATEGORY LISTS, THEY ARE AUTOGENERATED AND WILL BE OVERWRITTEN, BASED ON TAGS IN INDIVIDUAL PAGE FOOTERS. EDIT THOSE INSTEAD. -->
<!-- BEGIN CATEGORY LIST: CategoryTouch, CategoryAPIMacro -->
- [SDL_MOUSE_TOUCHID](SDL_MOUSE_TOUCHID)
- [SDL_TOUCH_MOUSEID](SDL_TOUCH_MOUSEID)
<!-- END CATEGORY LIST -->


----
[CategoryAPICategory](CategoryAPICategory)


