SDL_HINT_MOU...WITH_RELATIVE(3)

✨ SDL_HINT_MOUSE_EMULATE_WARP_WITH_RELATIVE ✨

okay bestie, gather round, because we're diving into a SDL3 FUNCTIONS manual page (section 3, obvs) and it's lowkey one of those hints that only the real ones know about 🫶

---

🌸 NAME 🌸

SDL_HINT_MOUSE_EMULATE_WARP_WITH_RELATIVE — a variable that controls whether warping a hidden mouse cursor will activate relative mouse mode. yes, that's the whole vibe. iconic behavior, honestly 💅

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_hints.h>

#define SDL_HINT_MOUSE_EMULATE_WARP_WITH_RELATIVE "SDL_MOUSE_EMULATE_WARP_WITH_RELATIVE"

like, that's it. that's the whole setup. no cap 🌈

---

💖 DESCRIPTION 💖

so here's the tea ☕ — when this hint is set, the mouse cursor is hidden, and multiple warps to the window center happen within a short time period, SDL will emulate those mouse warps using relative mouse mode. why do we care? because it can give you smoother and more reliable mouse motion for some older games 🕹️ — specifically the ones that keep calculating the distance the mouse pointer traveled and then warp it right back to the center of the window, instead of just using relative mouse motion like a normal person.

ngl, this is giving "grandma game from 1998 refuses to learn new tricks" energy and honestly? we respect it 🙈

one thing to keep in mind though, fr fr: relative mouse mode may have different mouse acceleration behavior than pointer warps do. so it's not a 1:1 swap, it's more like a glow-up with a slightly different silhouette ✨

and if your application needs to repeatedly warp the hidden mouse cursor at a high frequency for other purposes? bestie, it should disable this hint. no hard feelings, it's just not the moment 💀

the variable can be set to the following values:

• "0" — attempts to warp the mouse will always be made. periodt.
• "1" — some mouse warps will be emulated by forcing relative mouse mode. (this is the default, the main character, the chosen one 👑)

if it's not set, this is automatically enabled — unless an application uses relative mouse mode directly. (in which case it's like, okay, you clearly got this yourself, we'll step back 🫶)

and the best part? this hint can be set anytime. whenever. no scheduling, no appointment, just vibes 🦋

---

⭐ AVAILABILITY ⭐

this hint has been available since SDL 3.2.0 — so it's been around, it's established, it's a legend at this point 💜

---

🌟 cute sign-off 🌟

and that's the whole page, bestie!! brought to you by Simple Directmedia Layer and SDL 3.4.18 — go forth and warp responsibly 🎀💖✨