SDL_PenTouchEvent(3type)

πŸ’– SDL_PenTouchEvent πŸ’–

okay bestie, welcome to the SDL3 DATATYPES corner of the manual, where we talk about SDL_PenTouchEvent β€” that's the pressure-sensitive pen touched event structure, aka the event.ptouch.* crew. πŸ–ŠοΈβœ¨


✨ NAME ✨

SDL_PenTouchEvent β€” the pressure-sensitive pen touched event structure (you'll see it as event.ptouch.*). It's giving "my stylus just kissed the tablet" energy. πŸ’…


🌸 SYNOPSIS 🌸

#include <SDL3/SDL_events.h>

typedef struct SDL_PenTouchEvent
{
    SDL_EventType type;     /**< SDL_EVENT_PEN_DOWN or SDL_EVENT_PEN_UP */
    Uint32 reserved;
    Uint64 timestamp;       /**< In nanoseconds, populated using SDL_GetTicksNS() */
    SDL_WindowID windowID;  /**< The window with pen focus, if any */
    SDL_PenID which;        /**< The pen instance id */
    SDL_PenInputFlags pen_state;   /**< Complete pen input state at time of event */
    float x;                /**< X coordinate, relative to window */
    float y;                /**< Y coordinate, relative to window */
    bool eraser;        /**< true if eraser end is used (not all pens support this). */
    bool down;          /**< true if the pen is touching or false if the pen is lifted off */
    SDL_PenDeviceType device_type; /**< the device type of the pen, if known (added in 3.4.18). */
} SDL_PenTouchEvent;

so like, every field, no skips, we stan a complete struct. πŸ‘‘


πŸ¦‹ DESCRIPTION πŸ¦‹

These events come when a pen touches a surface (a tablet, etc), or lifts off from one. That's it, that's the whole vibe check β€” touch down, touch up, the two most dramatic moments in any pen's life. 😭🫢


⭐ AVAILABILITY ⭐

This struct is available since SDL 3.2.0. not new new, but still iconic. 🌈


Simple Directmedia Layer β€” SDL 3.4.18 β€” mwah, that's the whole page bestie, go forth and handle your pen events, no cap, periodt. πŸ’–πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from