mirrors/SDL
1
0
Fork 0
mirror of https://github.com/libsdl-org/SDL.git synced 2025-09-06 03:18:13 +00:00
Code Issues Packages Projects Releases Wiki Activity

Clarify that you shouldn't make any assumptions about the an SDL_FingerID value.

Browse Source 
Fixes https://github.com/libsdl-org/SDL/issues/11667
This commit is contained in:
Sam Lantinga
2024-12-23 14:28:11 -08:00
parent 37b87f79fb
commit 8691408baf
1 changed files with 1 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
include/SDL3/SDL_touch.h
View File

@@ -53,12 +53,7 @@ typedef Uint64 SDL_TouchID;
/** /**
* A unique ID for a single finger on a touch device. * A unique ID for a single finger on a touch device.
* *
* This ID is valid for the time the finger (stylus, etc) is touching, and is * This ID is valid for the time the finger (stylus, etc) is touching and will be unique for all fingers currently in contact, so this ID tracks the lifetime of a single continuous touch. This value may represent an index, a pointer, or some other unique ID, depending on the platform.
* never reused for the lifetime of the application.
*
* The same physical finger will have a different ID if it lifts off the touch
* device and then starts a new touch, so this ID tracks the lifetime of a
* single continuous touch.
* *
* The value 0 is an invalid ID. * The value 0 is an invalid ID.
* *