drm_fb_xrgb8888_to_bgr888(9)

📦 version 7.3.1, in nixpkgs unstable

💅 drm_fb_xrgb8888_to_bgr888(9) — the Kernel API Manual glow-up 🎀

okay bestie, so this page lives in the Kernel API Manual (section 9, dry land for kernel functions) and it's literally about drm_fb_xrgb8888_to_bgr888 — one tiny function doing the color-format glow-up from XRGB8888 to BGR888 on your clip buffer. it's giving "backstage wardrobe change but for pixels" ✨

🌸 NAME 🌸

drm_fb_xrgb8888_to_bgr888 — Convert XRGB8888 to BGR888 clip buffer 💖

no cap, that's the whole vibe: pixel format makeover, clip buffer edition.

✨ SYNOPSIS ✨

void drm_fb_xrgb8888_to_bgr888 (struct iosys_map *dst , const unsigned
int *dst_pitch , const struct iosys_map *src , const struct
drm_framebuffer *fb , const struct drm_rect *clip , struct
drm_format_conv_state *state );

six params, zero drama (okay maybe a little drama, it's a void function so nothing comes back, she just does the work and leaves 💅).

🫶 ARGUMENTS 🫶

  • dst — Array of BGR888 destination buffers. this is where the glow-up lands, bestie 🎀
  • dst_pitch — Array of numbers of bytes between the start of two consecutive scanlines within dst; can be NULL if scanlines are stored next to each other. so like, the gap between rows — and if there's no gap, just pass NULL and breathe 🌸
  • src — Array of XRGB8888 source buffers. the before picture 💖
  • fb — DRM framebuffer. the main character of this whole operation 👑
  • clip — Clip rectangle area to copy. only this lil window gets copied, periodt ✂️
  • state — Transform and conversion state. the behind-the-scenes lore 🦋

💜 DESCRIPTION 💜

so what she actually does: this function copies parts of a framebuffer to display memory and converts the color format during the process. like a two-in-one, highkey efficient, we love to see it 🔥

Destination and framebuffer formats must match. not "should", must — this is not a drill 🚨

the parameters dst, dst_pitch and src refer to arrays. Each array must have at least as many entries as there are planes in fb's format. Each entry stores the value for the format's respective color plane at the same index. so like, keep your arrays long enough for every plane, and keep the indices lined up — same index, same plane, no mixing 🧚

⚠️ heads up bestie: this function does not apply clipping on dst (i.e. the destination is at the top-left corner). so the clipping already happened conceptually — dst starts at the top-left corner and she just writes. don't expect extra clipping magic on the destination side, okay? 😭

Drivers can use this function for BGR888 devices that don't natively support XRGB8888. literally built for the devices that can't speak XRGB8888 natively — she translates, she slays 💅

🌈 SEE ALSO 🌈

the whole friend group, fr fr — you're gonna want to know all of them:

and that's the page, bestie 🫶 this one ships out of ./drivers/gpu/drm, dated October 2026, and it's the Kernel API Manual's own drm_fb_xrgb8888_to_bgr888(9) — go convert something iconic 💅✨

📦 where this page comes from