---
name: "SDL_TouchFingerEvent"
section: "3type"
platform: "linux"
package: "libsdl3-doc"
version: "3.2.10+ds-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SDL_TouchFingerEvent"
---

# SDL\_TouchFingerEvent(3type)

Touch finger event structure (event.tfinger.\*)

## NAME

SDL\_TouchFingerEvent - Touch finger event structure (event.tfinger.\*)

## HEADER FILE

Defined in SDL3/SDL\_events.h

## SYNOPSIS

```
#include "SDL3/SDL.h"
```

**typedef struct SDL\_TouchFingerEvent** **{**     **SDL\_EventType type; /\*\*\< SDL\_EVENT\_FINGER\_DOWN, SDL\_EVENT\_FINGER\_UP, SDL\_EVENT\_FINGER\_MOTION, or SDL\_EVENT\_FINGER\_CANCELED \*/**     **Uint32 reserved;**     **Uint64 timestamp;   /\*\*\< In nanoseconds, populated using SDL\_GetTicksNS() \*/**     **SDL\_TouchID touchID; /\*\*\< The touch device id \*/**     **SDL\_FingerID fingerID;**     **float x;            /\*\*\< Normalized in the range 0...1 \*/**     **float y;            /\*\*\< Normalized in the range 0...1 \*/**     **float dx;           /\*\*\< Normalized in the range -1...1 \*/**     **float dy;           /\*\*\< Normalized in the range -1...1 \*/**     **float pressure;     /\*\*\< Normalized in the range 0...1 \*/**     **SDL\_WindowID windowID; /\*\*\< The window underneath the finger, if any \*/** **} SDL\_TouchFingerEvent;**

## DESCRIPTION

Coordinates in this event are normalized. **x** and **y** are normalized to a range between 0.0f and 1.0f, relative to the window, so (0,0) is the top left and (1,1) is the bottom right. Delta coordinates **dx** and **dy** are normalized in the ranges of -1.0f (traversed all the way from the bottom or right to all the way up or left) to 1.0f (traversed all the way from the top or left to all the way down or right).

Note that while the coordinates are \_normalized\_, they are not \_clamped\_, which means in some circumstances you can get a value outside of this range. For example, a renderer using logical presentation might give a negative value when the touch is in the letterboxing. Some platforms might report a touch outside of the window, which will also be outside of the range.

## AVAILABILITY

This struct is available since SDL 3.2.0.