SDL_GPULoadOp(3type)

💅 SDL_GPULoadOp 💅

okay bestie, welcome to the SDL3 DATATYPES corner of the manual, where today's main character is SDL_GPULoadOp 🎀

---

✨ NAME ✨

SDL_GPULoadOp — tells you how the contents of a texture that's attached to a render pass get treated at the very beginning of that render pass. it's giving "what's the vibe of this texture when we walk in the door" 🚪✨

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_gpu.h>

typedef enum SDL_GPULoadOp
{
    SDL_GPU_LOADOP_LOAD,      /**< The previous contents of the texture will be preserved. */
    SDL_GPU_LOADOP_CLEAR,     /**< The contents of the texture will be cleared to a color. */
    SDL_GPU_LOADOP_DONT_CARE  /**< The previous contents of the texture need not be preserved. The contents will be undefined. */
} SDL_GPULoadOp;

---

👑 the values, one by one 👑

• SDL_GPU_LOADOP_LOAD — the previous contents of the texture will be preserved. no notes, she keeps everything, she remembers 🫶
• SDL_GPU_LOADOP_CLEAR — the contents of the texture will be cleared to a color. fresh start, clean slate, wipe the whiteboard 🧼✨
• SDL_GPU_LOADOP_DONT_CARE — the previous contents of the texture need not be preserved. the contents will be undefined. so like, bestie, you literally do not know what's in there. it's a mystery box 📦 and you should not peek inside and assume anything, fr fr 💀

ngl, SDL_GPU_LOADOP_DONT_CARE is the feral one. undefined means undefined. don't read it, don't trust it, don't build your whole render on it. periodt. 💅

---

🌈 AVAILABILITY 🌈

this enum has been available since SDL 3.2.0. she's not new new, but she's not ancient either. iconic behavior honestly ⭐

---

🦋 SEE ALSO 🦋

• SDL_BeginGPURenderPass(3) — this is where all the load-op magic actually gets used, iykyk 🔥

---

that's the whole page, bestie, you ate it 💖

this little love letter comes from Simple Directmedia Layer, and the docs are sitting at SDL 3.4.18 — and yes the manual page is literally called SDL_GPULoadOp(3type), we stay on brand around here 🎀✨