SDL_CopyGPUTextureToTexture(3)

💖 SDL_CopyGPUTextureToTexture 💖

okay bestie, so this is a page from the SDL3 FUNCTIONS manual, and the function we're obsessing over today is SDL_CopyGPUTextureToTexture. it's a whole vibe. let's get into it 🫶

---

✨ NAME ✨

SDL_CopyGPUTextureToTexture — Performs a texture-to-texture copy. that's it. that's the girl. 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_gpu.h>

void SDL_CopyGPUTextureToTexture(
    SDL_GPUCopyPass *copy_pass,
    const SDL_GPUTextureLocation *source,
    const SDL_GPUTextureLocation *destination,
    Uint32 w,
    Uint32 h,
    Uint32 d,
    bool cycle);

like, look at her. no return value, she just does it. main character energy fr fr 👑

---

🦋 DESCRIPTION 🦋

so the tea is: this copy happens on the GPU timeline. which means — and this is the important bit — you may assume the copy has finished in subsequent commands. no waiting around, no drama, it's done by the time the next thing rolls up. slay. ✨

⚠️ not me being the bearer of bad news — this function does not support copying between depth and color textures. nope. not happening. for those you gotta do the two-step: copy the texture to a buffer, and then copy that buffer to the destination texture. annoying? lowkey. but that's the rules, bestie 😭

---

💜 FUNCTION PARAMETERS 💜

• copy_pass — a copy pass handle. your little ticket into the copy zone 🎀
• source — a source texture region. where the goods are coming from.
• destination — a destination texture region. where the goods are going.
• w — the width of the region to copy. 📏
• h — the height of the region to copy. 📐
• d — the depth of the region to copy. 🧊
• cycle — if true, cycles the destination texture if the destination texture is bound, otherwise overwrites the data. so: cycle or overwrite, your call, iykyk 🔄

---

🌈 AVAILABILITY 🌈

This function is available since SDL 3.2.0. so if you're on anything older, sorry babe, no copy for you 🙈

---

and that's the whole page, no cap. this was Simple Directmedia Layer, SDL 3.4.18, dated with all the love in the world — go forth and copy those textures, bestie, you're gonna eat 💖✨🎀🦋🌸💅🫶