SDL_WarpMouseInWindow(3)

✨ SDL_WarpMouseInWindow ✨

okay so bestie, welcome to SDL_WarpMouseInWindow(3) — it's a lil function from the SDL3 functions fam, and it does exactly what it says on the tin: Move the mouse cursor to the given position within the window. teleportation but for your cursor, no cap 💅

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_mouse.h>

void SDL_WarpMouseInWindow(SDL_Window *window,
                           float x, float y);

---

🌸 DESCRIPTION 🌸

so here's the tea 🫖 — this function generates a mouse motion event if relative mode is not enabled. that's the default vibe.

but if relative mode is enabled? then the warp is lowkey silent, and you can force mouse events for the warp by setting the SDL_HINT_MOUSE_RELATIVE_WARP_MOTION hint. iykyk 👑

⚠️ important reality check: this function will appear to succeed, but not actually move the mouse when used over Microsoft Remote Desktop. it's giving "lying to your face" energy 😭 not a bug in your code, just how it is.

---

🦋 FUNCTION PARAMETERS 🦋

• window — the window to move the mouse into, or NULL for the current mouse focus. yeah, NULL is valid here, main character behaviour ✨
• x — the x coordinate within the window.
• y — the y coordinate within the window.

---

💖 THREAD SAFETY 💖

this function should only be called on the main thread. no side-quest threads, bestie, this one stays on main 🚫🧵

---

🌈 AVAILABILITY 🌈

this function is available since SDL 3.2.0. so if you're on something older… ma'am, please update 💀

---

👑 SEE ALSO 👑

• SDL_WarpMouseGlobal(3) — same energy, but global. go peek 🫶

---

mwah 💋 that's the whole page. this one came from the Simple Directmedia Layer girlies, rocking SDL 3.4.18 — slay, stay warping, and don't forget to check your thread. bye bestie! 🎀✨