SDL_CopyGPUBufferToBuffer(3)

💖 SDL_CopyGPUBufferToBuffer 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual, and today's main character is SDL_CopyGPUBufferToBuffer — she does exactly what her name says and she does it flawlessly. no notes. ✨

---

🌸 NAME 🌸

SDL_CopyGPUBufferToBuffer — Performs a buffer-to-buffer copy.

like… literally that. buffer goes in, buffer comes out. it's giving copy-paste but make it GPU. 💅

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_gpu.h>

void SDL_CopyGPUBufferToBuffer(
    SDL_GPUCopyPass *copy_pass,
    const SDL_GPUBufferLocation *source,
    const SDL_GPUBufferLocation *destination,
    Uint32 size,
    bool cycle);

look at her. five arguments, returns nothing, zero drama. 🦋

---

✨ DESCRIPTION ✨

This copy occurs on the GPU timeline. You may assume the copy has finished in subsequent commands.

fr fr — that's the important part. you don't gotta sit around waiting or syncing anything, because on the GPU timeline it's already done done by the time the next commands roll around. no cap. 😭👑

---

🧚 FUNCTION PARAMETERS 🧚

• copy_pass — a copy pass handle. your backstage pass to the whole operation, bestie. 🎟️
• source — the buffer and offset to copy from. where the tea is coming from. 🍓
• destination — the buffer and offset to copy to. where the tea is going. ☕
• size — the length of the buffer to copy. how much of the tea we're pouring. measure twice, copy once. 📏
• cycle — if true, cycles the destination buffer if it is already bound, otherwise overwrites the data. so like… cycle = true means she politely rotates that buffer if it's already claimed, and cycle = false means she just steamrolls over whatever's there. choose wisely, queen. 🙈

---

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. so if you're on something older… girl, update. 💀

---

⚠️ quick vibe check: this is a void function — no return value, no error code, nothing to check. it just does the thing. but cycle being false on an already-bound destination buffer means an overwrite, so don't come crying to me when your data's gone. i warned you. 💖

---

and that's the whole page, bestie!! 🫶 this was pulled straight from the Simple Directmedia Layer manual, SDL 3.4.18 edition — stan a stable release. 🌈 mwah, go copy some buffers. 💜🎀