SDL_MatrixCoefficients(3type)

πŸ’– SDL_MatrixCoefficients πŸ’–

okay bestie, buckle up, because we're about to talk about the SDL_MatrixCoefficients(3type) enum from the SDL3 DATATYPES era of the SDL manual, and honestly? it's giving ✨color science✨. it's a lil enum that tells you which colorspace matrix coefficients you're working with. lowkey iconic. no cap.


🌸 SYNOPSIS 🌸

#include <SDL3/SDL_pixels.h>

typedef enum SDL_MatrixCoefficients
{
    SDL_MATRIX_COEFFICIENTS_IDENTITY = 0,
    SDL_MATRIX_COEFFICIENTS_BT709 = 1,              /**< ITU-R BT.709-6 */
    SDL_MATRIX_COEFFICIENTS_UNSPECIFIED = 2,
    SDL_MATRIX_COEFFICIENTS_FCC = 4,                /**< US FCC Title 47 */
    SDL_MATRIX_COEFFICIENTS_BT470BG = 5,            /**< ITU-R BT.470-6 System B, G / ITU-R BT.601-7 625, functionally the same as SDL_MATRIX_COEFFICIENTS_BT601 */
    SDL_MATRIX_COEFFICIENTS_BT601 = 6,              /**< ITU-R BT.601-7 525 */
    SDL_MATRIX_COEFFICIENTS_SMPTE240 = 7,           /**< SMPTE 240M */
    SDL_MATRIX_COEFFICIENTS_YCGCO = 8,
    SDL_MATRIX_COEFFICIENTS_BT2020_NCL = 9,         /**< ITU-R BT.2020-2 non-constant luminance */
    SDL_MATRIX_COEFFICIENTS_BT2020_CL = 10,         /**< ITU-R BT.2020-2 constant luminance */
    SDL_MATRIX_COEFFICIENTS_SMPTE2085 = 11,         /**< SMPTE ST 2085 */
    SDL_MATRIX_COEFFICIENTS_CHROMA_DERIVED_NCL = 12,
    SDL_MATRIX_COEFFICIENTS_CHROMA_DERIVED_CL = 13,
    SDL_MATRIX_COEFFICIENTS_ICTCP = 14,             /**< ITU-R BT.2100-0 ICTCP */
    SDL_MATRIX_COEFFICIENTS_CUSTOM = 31
} SDL_MatrixCoefficients;

like, look at her. a whole enum. fifteen members. she ate and left no crumbs πŸ“


✨ DESCRIPTION ✨

so these are the colorspace matrix coefficients, and they're exactly as described by the good people over at:

https://www.itu.int/rec/T-REC-H.273-201612-S/en

that's the source of truth, bestie. ITU-T Recommendation H.273, December 2016 version. if you need the full lore, that's where you go. 🧚


🫢 AVAILABILITY 🫢

this enum has been out here living her best life since SDL 3.2.0. queen behavior, honestly. πŸ‘‘


and that's the whole page, bestie!! go forth and pick your matrix coefficients wisely πŸ’…

mwah πŸ’œ

this has been a page from Simple Directmedia Layer, sitting pretty at version SDL 3.4.18, and yes it's literally the SDL_MatrixCoefficients(3type) page, iykyk πŸŽ€βœ¨

πŸ“¦ where this page comes from