STRUCT MSM_FORMAT(9)

💅 NAME 💅

struct msm_format — the struct that defines the format configuration, bestie. it's the whole vibe check for how a pixel format gets described, no cap ✨

this one lives in the struct msm_format(9) section of the Kernel API Manual btw, so you know exactly where to find it 🎀

---

🦋 SYNOPSIS 🦋

okay so here's the whole struct laid out, copy it exactly, don't @ me:

struct msm_format {
    uint32_t pixel_format;
    enum mdp_bpc bpc_g_y, bpc_b_cb, bpc_r_cr;
    enum mdp_bpc_alpha bpc_a;
    u8 element[4];
    enum mdp_fetch_type fetch_type;
    enum mdp_chroma_samp_type chroma_sample;
    bool alpha_enable;
    u8 unpack_count;
    u8 bpp;
    unsigned long flags;
    u8 num_planes;
    enum mdp_fetch_mode fetch_mode;
    u16 tile_height;
 };

---

🌸 Members 🌸

like. every field is a little icon in its own right, so let's go through them one by one 💖

• pixel_format — the format fourcc, literally the ID card of the format 🪪
• bpc_g_y — element bit widths: the BPC for G or Y 👑
• bpc_b_cb — element bit widths: the BPC for B or Cb 🌈
• bpc_r_cr — element bit widths: the BPC for R or Cr 🍓
• bpc_a — element bit widths: the BPC for the alpha channel, yes alpha gets its own field, main character energy 💅
• element — element color ordering, aka who stands where in the lineup ✨
• fetch_type — how the color components are packed in pixel format, the packing lore 📦
• chroma_sample — chroma sub-samplng type (their spelling, not mine, keeping it fr fr) 🌀
• alpha_enable — whether the format has an alpha channel, bool so it's a yes or a no babe 🫶
• unpack_count — number of the components to unpack, count 'em 🔢
• bpp — bytes per pixel, the classic 📏
• flags — usage bit flags, little bitty flags doing their thing 🚩
• num_planes — number of planes (including meta data planes), meta data planes count too, don't forget 😭
• fetch_mode — linear, tiled, or ubwc hw fetch behavior — three modes, all iconic in their own way 🔥
• tile_height — format tile height, the height of the tile, that's it that's the field 🧚

---

⭐ SEE ALSO ⭐

if you wanna go deeper (and you do, i know you do), the kernel file is right here:

• Kernel file ./drivers/gpu/drm/msm/disp/mdp_format.h — go read it, it's giving source of truth 💜

---

ngl bestie, that's the whole struct. every field accounted for, nothing skipped, nothing invented. ate and left no crumbs 🍓

---

okay that's a wrap!! this was struct msm_format(9) from ./drivers/gpu/drm/msm/disp, dated October 2026 — go forth and format responsibly, ily, bye 💖🎀🦋