SDL_INIT_INTERFACE(3)

💖 SDL_INIT_INTERFACE 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual, where we're talking about SDL_INIT_INTERFACE — a macro that initializes an SDL interface ✨

---

🌸 NAME 🌸

SDL_INIT_INTERFACE — a macro to initialize an SDL interface, no cap 🫶

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_stdinc.h>

#define SDL_INIT_INTERFACE(iface)               \
    do {                                        \
        SDL_zerop(iface);                       \
        (iface)->version = sizeof(*(iface));    \
    } while (0)

---

💅 DESCRIPTION 💅

So this macro initializes an SDL interface structure, and the vibe check here is: you gotta call it before you start filling out the fields with your own implementation. Like, set it up first, then decorate. It's giving "prepare the canvas before the masterpiece" 🎀

You can use it like this:

SDL_IOStreamInterface iface;

SDL_INIT_INTERFACE(&iface);

// Fill in the interface function pointers with your implementation
iface.seek = ...

stream = SDL_OpenIO(&iface, NULL);

And if you're a designated-initializers girlie (respect, honestly), you can just use the size of the interface as the version, like:

SDL_IOStreamInterface iface = {
    .version = sizeof(iface),
    .seek = ...
};
stream = SDL_OpenIO(&iface, NULL);

Both routes, same destination. Pick your fighter 💜

---

🧵 THREAD SAFETY 🧵

It is safe to call this macro from any thread. Multithreaded and unbothered, periodt 👑

---

🌈 AVAILABILITY 🌈

This macro is available since SDL 3.2.0 ⭐

---

🦋 SEE ALSO 🦋

• SDL_IOStreamInterface(3type)
• SDL_StorageInterface(3type)
• SDL_VirtualJoystickDesc(3type)

---

and that's the whole page, bestie!! this lil icon came to you courtesy of Simple Directmedia Layer, rockin' SDL 3.4.18 — mwah, go init those interfaces 💖🎀✨🫶