SDL_HINT_VIDEO_DUMMY_SAVE_FRAMES(3)

πŸ’– SDL_HINT_VIDEO_DUMMY_SAVE_FRAMES(3) πŸ’–

okay bestie, welcome to the SDL3 FUNCTIONS corner of the man pages, where we talk about one (1) very specific hint and we talk about it thoroughly. this one's a lil niche but she's important, so let's get into it 🫢


✨ NAME ✨

SDL_HINT_VIDEO_DUMMY_SAVE_FRAMES β€” a variable that controls whether the dummy video driver saves its output frames. that's it, that's the whole job, no cap πŸ’…


🌸 SYNOPSIS 🌸

#include <SDL3/SDL_hints.h>

#define SDL_HINT_VIDEO_DUMMY_SAVE_FRAMES "SDL_VIDEO_DUMMY_SAVE_FRAMES"

πŸ¦‹ DESCRIPTION πŸ¦‹

so the hint takes two values, and it's giving very much a binary queen moment πŸ‘‘

  • "0" β€” video frames are not saved to disk. this is the default, so if you don't touch anything, nothing gets written anywhere, we love a low-effort queen πŸ’€
  • "1" β€” video frames are saved to files, and the filenames follow the format "SDL_windowX-Y.bmp", where X is the window ID and Y is the frame number. so like, every single frame, just... on your disk. girl. okay. slay but also watch your storage πŸ“βœ¨
lowkey the best part: this hint can be set anytime. no setup window, no "you had to do it before init" nonsense, just set it whenever and go πŸŽ€

🌈 AVAILABILITY 🌈

this hint has been around since SDL 3.2.0. she's new-ish, she's fresh, she's iconic πŸ‘‘


and that's the whole page, bestie!! thanks for reading my little yap session about frame-saving hints πŸ’œ this was brought to you by the fine folks at Simple Directmedia Layer, running the SDL 3.4.18 era of the man pages, and yes i know the header got truncated to SDL_HINT_VIDE...Y_SAVE_FRAMES(3) in the footer, that's just how the terminal do 🫢 go forth and save some frames (or don't, default is don't) πŸ’…βœ¨

πŸ“¦ where this page comes from