SDL_MouseMotionEvent(3type)

💖 SDL_MouseMotionEvent — like, the mouse moved, bestie 💖

okay so welcome to the SDL_MouseMotionEvent page, from the SDL3 DATATYPES corner of the Simple Directmedia Layer manual 🦋. This is the struct that shows up as event.motion.* when your mouse is out here living its main character life across the screen. Every twitch, every glide, every lil wiggle. We're obsessed. ✨

---

🌸 NAME 🌸

SDL_MouseMotionEvent — the Mouse motion event structure, aka event.motion.* 🐭💫

---

✨ SYNOPSIS ✨

Include it like the good little coder you are:

#include <SDL3/SDL_events.h>

And here's the whole struct, every single field, no cap — I'm giving it to you verbatim because facts are facts 💅:

typedef struct SDL_MouseMotionEvent
{
    SDL_EventType type; /**< SDL_EVENT_MOUSE_MOTION */
    Uint32 reserved;
    Uint64 timestamp;   /**< In nanoseconds, populated using SDL_GetTicksNS() */
    SDL_WindowID windowID; /**< The window with mouse focus, if any */
    SDL_MouseID which;  /**< The mouse instance id in relative mode, SDL_TOUCH_MOUSEID for touch events, SDL_PEN_MOUSEID for pen events, or 0 */
    SDL_MouseButtonFlags state;       /**< The current button state */
    float x;            /**< X coordinate, relative to window */
    float y;            /**< Y coordinate, relative to window */
    float xrel;         /**< The relative motion in the X direction */
    float yrel;         /**< The relative motion in the Y direction */
} SDL_MouseMotionEvent;

---

🎀 what every field is giving 🎀

• type — it's SDL_EVENT_MOUSE_MOTION, that's the vibe check this struct always passes 🫶
• reserved — not yours to touch, bestie, hands off 🙈
• timestamp — in nanoseconds, filled in using SDL_GetTicksNS(), so it's giving very precise ⏱️✨
• windowID — the window that has mouse focus, if any (keyword: if any)
• which — the mouse instance id in relative mode, or SDL_TOUCH_MOUSEID for touch events, or SDL_PEN_MOUSEID for pen events, or 0. so many options, so iconic 👑
• state — the current button state, literally just what buttons are doing rn
• x — X coordinate, relative to window 📍
• y — Y coordinate, relative to window 📍
• xrel — the relative motion in the X direction, the how far did it slide energy
• yrel — the relative motion in the Y direction, same but vertical, periodt

---

💜 AVAILABILITY 💜

This struct has been available since SDL 3.2.0 — so if you're on anything older, it's not you, it's the version 💀

---

heads up bestie: don't go renaming or merging these fields, x and xrel are NOT the same thing and the compiler will absolutely catch you lacking 🙈

---

okay that's the whole page, you ate it, go make something cute with your mouse events 🌈🎀

later, bestie — this was the Simple Directmedia Layer manual, SDL 3.4.18, and the page is SDL_MouseMotionEvent(3type) 💖✨🦋