SDL_SetGPUBufferName(3)

💅 SDL_SetGPUBufferName(3) — the SDL3 FUNCTIONS girlies know

okay so bestie, this one lives in the SDL3 FUNCTIONS family and it's literally just "give your buffer a nickname". That's it. That's the whole vibe. 🎀

---

✨ NAME ✨

SDL_SetGPUBufferName — sets an arbitrary string constant to label a buffer. 🏷️

---

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_gpu.h>

void SDL_SetGPUBufferName(
    SDL_GPUDevice *device,
    SDL_GPUBuffer *buffer,
    const char *text);

no cap, that's the whole signature. void. it returns nothing. it just labels. 👑

---

🌸 DESCRIPTION 🌸

okay so here's the tea, and it's important tea: you should use SDL_PROP_GPU_BUFFER_CREATE_NAME_STRING with SDL_CreateGPUBuffer instead of this function to avoid thread safety issues. 😭

like, I know, I know, you found a naming function and you're obsessed (same), but the grown-up move is to name it at creation time. this one is the "oh no I forgot to name it" emergency option. 🙈

---

💖 FUNCTION PARAMETERS 💖

• device — a GPU Context. ✨
• buffer — a buffer to attach the name to. it's getting a glow-up and a name, iconic. 💅
• text — a UTF-8 string constant to mark as the name of the buffer. yes bestie, constant, keep it in mind. 🍓

---

💀 THREAD SAFETY 💀

this function is not thread safe. you must make sure the buffer is not simultaneously used by any other thread. fr fr, do not let two threads touch this buffer at the same time, that's giving undefined chaos and we don't do that here. 🫶

---

🌈 AVAILABILITY 🌈

this function is available since SDL 3.2.0. so if you're on something older, sorry babe, no naming for you. 💜

---

🧚 SEE ALSO 🧚

• SDL_CreateGPUBuffer(3) — the main character of this whole storyline, go read it first. ⭐

---

and that's the page!! mwah 💋 this manual page came to you from Simple Directmedia Layer, rockin' SDL 3.4.18. stay hydrated, name your buffers at creation, and go slay ✨🦋🎀