SDL_GPUShaderFormat(3type)

💅 SDL_GPUShaderFormat 💅

okay bestie, welcome to the SDL_GPUShaderFormat page — it's a datatype from the SDL3 DATATYPES corner of the manual, and no cap, it's lowkey the whole personality test for your shader code. let's get into it 🫶

---

✨ NAME ✨

SDL_GPUShaderFormat — literally just says what format your shader code is in. that's it. that's the whole job. 👑

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_gpu.h>

typedef Uint32 SDL_GPUShaderFormat;

#define SDL_GPU_SHADERFORMAT_INVALID  0
#define SDL_GPU_SHADERFORMAT_PRIVATE  (1u << 0) /**< Shaders for NDA'd platforms. */
#define SDL_GPU_SHADERFORMAT_SPIRV    (1u << 1) /**< SPIR-V shaders for Vulkan. */
#define SDL_GPU_SHADERFORMAT_DXBC     (1u << 2) /**< DXBC SM5_1 shaders for D3D12. */
#define SDL_GPU_SHADERFORMAT_DXIL     (1u << 3) /**< DXIL SM6_0 shaders for D3D12. */
#define SDL_GPU_SHADERFORMAT_MSL      (1u << 4) /**< MSL shaders for Metal. */
#define SDL_GPU_SHADERFORMAT_METALLIB (1u << 5) /**< Precompiled metallib shaders for Metal. */

so it's a Uint32 under the hood — a lil bitfield situation, one bit per format, iykyk. 🎀 here's the roster:

• SDL_GPU_SHADERFORMAT_INVALID = 0 — the nothing-burger. no format, no vibes. 💀
• SDL_GPU_SHADERFORMAT_PRIVATE = (1u << 0) — shaders for NDA'd platforms. 🤫 secret business, we don't talk about it.
• SDL_GPU_SHADERFORMAT_SPIRV = (1u << 1) — SPIR-V shaders, and they're for Vulkan. 🌋
• SDL_GPU_SHADERFORMAT_DXBC = (1u << 2) — DXBC SM5_1 shaders, for D3D12. 🎮
• SDL_GPU_SHADERFORMAT_DXIL = (1u << 3) — DXIL SM6_0 shaders, also for D3D12. 🎮✨
• SDL_GPU_SHADERFORMAT_MSL = (1u << 4) — MSL shaders, for Metal. 🍎
• SDL_GPU_SHADERFORMAT_METALLIB = (1u << 5) — precompiled metallib shaders, for Metal. already cooked, no compiling needed 🔥

---

✨ DESCRIPTION ✨

each format is matched to one specific backend that actually accepts it. like, it's giving "you're MY format, you go with THIS backend." one format, one backend, iconic pairing behavior. 💖

---

✨ AVAILABILITY ✨

this datatype has been around since SDL 3.2.0. she's not new new, she's established. 👑

---

✨ SEE ALSO ✨

• SDL_CreateGPUShader(3) — go make a shader, bestie 🌸

---

reminder fr fr: keep every one of those (1u << n) values exactly as they are. don't get cute and rename them, they're doing bitshift math and the math is not negotiable. 🙈

---

mwah, that's the whole page 💅 this beauty ships with Simple Directmedia Layer, version SDL 3.4.18, dated with the SDL_GPUShaderFormat(3type) energy it deserves — go forth and shader, my love 🦋💜