SDL_VideoInfo(3)

💖 SDL_VideoInfo — Video Target information 💖

okay bestie, pull up a chair, because this is the SDL_VideoInfo(3) page from the SDL API Reference and it's literally just a lil struct that tells you everything about your video setup 🦋 no cap.

🌸 STRUCTURE DEFINITION 🌸

here's the whole thing, copy it exactly how it is, don't be cute with it:

typedef struct{
  Uint32 hw_available:1;
  Uint32 wm_available:1;
  Uint32 blit_hw:1;
  Uint32 blit_hw_CC:1;
  Uint32 blit_hw_A:1;
  Uint32 blit_sw:1;
  Uint32 blit_sw_CC:1;
  Uint32 blit_sw_A:1;
  Uint32 blit_fill;
  Uint32 video_mem;
  SDL_PixelFormat *vfmt;
} SDL_VideoInfo;

look at those bitfields. she's serving structure. 💅

✨ STRUCTURE DATA ✨

every single member, one by one, no skipping, we don't do that here:

• hw_available — can you actually make hardware surfaces? is it possible, yes or no 👀
• wm_available — is there a window manager hanging around?
• blit_hw — are hardware-to-hardware blits accelerated? 🔥
• blit_hw_CC — are hardware-to-hardware colorkey blits accelerated?
• blit_hw_A — are hardware-to-hardware alpha blits accelerated?
• blit_sw — are software-to-hardware blits accelerated?
• blit_sw_CC — are software-to-hardware colorkey blits accelerated?
• blit_sw_A — are software-to-hardware alpha blits accelerated?
• blit_fill — are color fills accelerated?
• video_mem — total amount of video memory, in Kilobytes 🧮
• vfmt — pixel format of the video device, an SDL_PixelFormat * bestie

💫 DESCRIPTION 💫

so this structure is read-only — hands off, you don't write to it — and SDL_GetVideoInfo is the one that hands it to you. 🫶

and what's inside? the tea on either:

• the 'best' available mode, if you called it before SDL_SetVideoMode, or
• the current video mode, if you didn't.

that's the whole vibe. one struct, two possible moods, depending on when you ask. main character energy tbh.

ngl the timing thing is the whole point — ask early and you get the dream scenario, ask late and you get the reality check. 👑

🔍 SEE ALSO 🔍

• SDL_PixelFormat
• SDL_GetVideoInfo

go read those too, iykyk 📚

and that's the page!! this lil slice of the SDL API Reference is brought to you by SDL, dated Tue 11 Sep 2001, 23:01 — yes that date, iconic, historic, we respect it. mwah, bye bestie 💜🎀