SDL_CREATEGPUGRAPHICSPIPELINE(3)

💅 SDL_CreateGPUGraphicsPipeline

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual, this one is literally called SDL_CreateGPUGraphicsPipeline and it's about to make your whole graphics workflow pop off ✨

🌸 NAME 🌸

SDL_CreateGPUGraphicsPipeline — creates a pipeline object to be used in a graphics workflow. that's it, that's the job, she builds you a pipeline 🎀

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_gpu.h>

SDL_GPUGraphicsPipeline * SDL_CreateGPUGraphicsPipeline(
    SDL_GPUDevice *device,
    const SDL_GPUGraphicsPipelineCreateInfo *createinfo);

🦋 DESCRIPTION 🦋

so like, there are optional properties you can hand over through props (yes, props, she's a vibe) 💜 and here's the one supported property, no cap:

• SDL_PROP_GPU_GRAPHICSPIPELINE_CREATE_NAME_STRING — a name that can be displayed in debugging tools. it's giving "label your stuff so future you doesn't cry" 🏷️✨

👑 FUNCTION PARAMETERS 👑

• device — a GPU Context. your main character, the whole GPU situation 💅
• createinfo — a struct describing the state of the graphics pipeline to create. it's the blueprint, the mood board, the whole plan fr fr 📋

🌈 RETURN VALUE 🌈

Returns a graphics pipeline object on success, or NULL on failure 😭 — and when it flops, call SDL_GetError() for more information. she will tell you what went wrong, just ask 🫶

not me getting NULL back and forgetting to check the error… bestie. check the error. 🙈

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. so if you're on anything older, she's simply not there yet 💀

💖 SEE ALSO 💖

• SDL_CreateGPUShader(3)
• SDL_BindGPUGraphicsPipeline(3)
• SDL_ReleaseGPUGraphicsPipeline(3)

go read those too, they're the friend group, you can't just know one of them 🌸

---

and that's the whole page babes 💅 brought to you by Simple Directmedia Layer, SDL 3.4.18, and this lil SDL_CreateGPUGraphicsPipeline(3) moment — periodt 🎀✨