SDL_GPUVERTEXBUFFERDESCRIPTION(3type)

📦
version 3.4.18 · 9 versions
, in fedora 43, fedora 44

💖 SDL_GPUVert...Description(3type) 💖

okay bestie, welcome to the SDL3 DATATYPES corner of the manual, where we're gonna talk about a lil struct that tells your graphics pipeline how your vertex buffers are set up. it's giving very important, very structured, very slay. 🎀

✨ NAME ✨

SDL_GPUVertexBufferDescription — a structure specifying the parameters of vertex buffers used in a graphics pipeline.

like. it's the blueprint. the vibe sheet. the "here's how my vertex buffer is built" note you hand to the GPU. 🦋

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_gpu.h>

typedef struct SDL_GPUVertexBufferDescription
{
    Uint32 slot;                        /**< The binding slot of the vertex buffer. */
    Uint32 pitch;                       /**< The size of a single element + the offset between elements. */
    SDL_GPUVertexInputRate input_rate;  /**< Whether attribute addressing is a function of the vertex index or instance index. */
    Uint32 instance_step_rate;          /**< Reserved for future use. Must be set to 0. */
} SDL_GPUVertexBufferDescription;

okay so look at her. four fields. gorgeous. no notes. 💅

🫶 DESCRIPTION 🫶

when you call SDL_BindGPUVertexBuffers, you specify the binding slots of the vertex buffers. it's literally you going "these ones go here, bestie."

for example, if you called SDL_BindGPUVertexBuffers with a first_slot of 2 and num_bindings of 3, then the binding slots 2, 3, 4 would be used by the vertex buffers you pass in. iconic numbering, no cap. ✨

vertex attributes are linked to buffers via the buffer_slot field of SDL_GPUVertexAttribute. so for example, if an attribute has a buffer_slot of 0, then that attribute belongs to the vertex buffer bound at slot 0. it's matching energy. it's soulmate linkage. it's iykyk. 💜

🌈 AVAILABILITY 🌈

this struct is available since SDL 3.2.0. so if you're on anything older, sorry babe, she wasn't born yet. 😭

👑 SEE ALSO 👑

go read those next, fr fr, they're the other half of this whole situation. 🔥

and that's the whole page, bestie!! this was brought to you by the Simple Directmedia Layer girlies, running on SDL 3.4.18. mwah, take care of your vertex buffers, they're doing their best out there. 💖✨🎀🦋🌸💅🫶

📦 where this page comes from