SDL_GPUCopyPass(3type)

💖 SDL_GPUCopyPass 💖

okay so bestie, welcome to the SDL3 DATATYPES corner of the manual, and today's main character is SDL_GPUCopyPass. she's a handle. she's opaque. she's lowkey mysterious and we respect that. 👑

---

✨ NAME ✨

SDL_GPUCopyPass — an opaque handle representing a copy pass. that's it, that's the whole vibe. 🎀

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_gpu.h>

typedef struct SDL_GPUCopyPass SDL_GPUCopyPass;

like, look at her. no fields. no internals. you get a pointer-ish token and you say thank you. opaque means you literally cannot peek inside, and ngl that's on purpose. 🙈

---

🦋 DESCRIPTION 🦋

so here's the tea, and it's important tea: this handle is transient. it is not yours to keep. it's giving "borrowed hoodie" energy — you wear it for the duration of the pass and then you give it back.

⚠️ fr fr: do not hold onto this handle, and do not reference it after SDL_EndGPUCopyPass is called. once that call happens, the handle is done. periodt. 💀

so like, no stashing it in a struct, no saving it for later, no "but what if I just—" nope. SDL_BeginGPUCopyPass hands it to you, you do your copy things, SDL_EndGPUCopyPass takes it away, and you move on with your life. that's the whole relationship. 💅

---

⭐ AVAILABILITY ⭐

this struct has been around since SDL 3.2.0. so if you're on anything older, she's simply not there, bestie. 😭

---

🌈 SEE ALSO 🌈

• SDL_BeginGPUCopyPass(3) — the one who introduces you 🫶
• SDL_EndGPUCopyPass(3) — the one who says okay bye 👋

---

and that's the page!! written for Simple Directmedia Layer, living in SDL 3.4.18, filed under SDL_GPUCopyPass(3type). go forth and copy responsibly, icon. 💖✨🎀🦋