SDL_DEFINE_COLORSPACE(3)

✨ SDL_DEFINE_COLORSPACE ✨

okay bestie, welcome to the SDL_DEFINE_COLORSPACE(3) page — it's part of the SDL3 FUNCTIONS lineup and it's literally the macro that lets you build your own custom SDL_Colorspace formats from scratch. no cap. 🎨💅

---

🌸 NAME 🌸

SDL_DEFINE_COLORSPACE — a macro for defining custom SDL_Colorspace formats. it's giving "build-a-bear but for pixel color metadata" 🧸✨

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_pixels.h>

#define SDL_DEFINE_COLORSPACE(type, range, primaries, transfer, matrix, chroma) \
    (((Uint32)(type) << 28) | ((Uint32)(range) << 24) | ((Uint32)(chroma) << 20) | \
    ((Uint32)(primaries) << 10) | ((Uint32)(transfer) << 5) | ((Uint32)(matrix) << 0))

like… look at that bit-shifting choreography. it's giving main character energy. 🔥

---

💖 DESCRIPTION 💖

so the whole vibe is: you hand it six little pieces of color info, and it smooshes them all into one Uint32 with some very intentional shifting. no judgment, it's just math. 🧮

for example, defining SDL_COLORSPACE_SRGB looks like this:

SDL_DEFINE_COLORSPACE(SDL_COLOR_TYPE_RGB,
                      SDL_COLOR_RANGE_FULL,
                      SDL_COLOR_PRIMARIES_BT709,
                      SDL_TRANSFER_CHARACTERISTICS_SRGB,
                      SDL_MATRIX_COEFFICIENTS_IDENTITY,
                      SDL_CHROMA_LOCATION_NONE)

see how it just… slots everything in? obsessed. 😌

---

🦋 MACRO PARAMETERS 🦋

six besties walk into a macro:

• type — the type of the new format, probably an SDL_ColorType value. 🌈
• range — the range of the new format, probably a SDL_ColorRange value. 📏
• primaries — the primaries of the new format, probably an SDL_ColorPrimaries value. 🎨
• transfer — the transfer characteristics of the new format, probably an SDL_TransferCharacteristics value. 🔄
• matrix — the matrix coefficients of the new format, probably an SDL_MatrixCoefficients value. 🧊
• chroma — the chroma sample location of the new format, probably an SDL_ChromaLocation value. 📍

---

💜 RETURN VALUE 💜

returns a format value in the style of SDL_Colorspace. so like, you give it crumbs and it gives you a whole snack. 🍓

---

🧚 THREAD SAFETY 🧚

it is safe to call this macro from any thread. yes bestie, any thread. go wild. 🫶🔥

---

⭐ AVAILABILITY ⭐

this macro is available since SDL 3.2.0. so if you're on something older… girl. upgrade. 😭💀

---

💀 lowkey important: all those shifts — 28, 24, 20, 10, 5, and 0 — are doing the heavy lifting. copy the macro exactly, don't get creative with the numbers. iykyk.

---

and that's the whole page, bestie!! this was Simple Directmedia Layer, SDL 3.4.18, dated SDL_DEFINE_COLORSPACE(3) — thanks for reading, mwah 💋✨