SDL_HINT_VIDEO_ALLOW_SCREENSAVER(3)

💖 SDL_HINT_VIDEO_ALLOW_SCREENSAVER 💖

okay bestie, so this is a page from the SDL3 FUNCTIONS manual — yes, the big SDL3 one, we're living in the future fr fr. Sit down, hydrate, and let's talk about whether your screen is allowed to go sleepy-bye. 🦋

---

✨ NAME ✨

SDL_HINT_VIDEO_ALLOW_SCREENSAVER — a variable controlling whether the screensaver is enabled. 👑

Like, that's it. That's the whole job. She's a hint, she's got one (1) opinion, and her opinion is: screensaver on or off? 💅

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_hints.h>

#define SDL_HINT_VIDEO_ALLOW_SCREENSAVER "SDL_VIDEO_ALLOW_SCREENSAVER"

so you pull in the header, and the macro itself literally expands to that string, no cap. "SDL_VIDEO_ALLOW_SCREENSAVER" — character for character, don't go freestyling it. 🙈

---

✨ DESCRIPTION ✨

The variable can be set to the following values:

• "0": Disable screensaver. (default) — this is the vibe she ships with, the factory setting, the main character default ✨
• "1": Enable screensaver. 🌸

⚠️ real talk — this hint should be set before SDL is initialized. Not after. Before. If you roll up late with your hint in hand, that's giving "arrived after the group photo" energy and it will not do what you want. 😭

---

✨ AVAILABILITY ✨

This hint is available since SDL 3.2.0. 🎀 If you're on anything older, bestie, I'm so sorry, she simply does not exist yet. 🧚

---

Simple Directmedia Layer · SDL 3.4.18 · SDL_HINT_VIDEO_ALLOW_SCREENSAVER(3) — and that's the whole page, love u, go forth and control ur screensaver responsibly 💜🫶✨