drm_fb_xrgb8888_to_argb8888(9)

📦 version 7.3.1, in nixpkgs unstable

💅 drm_fb_xrgb8888_to_argb8888(9) — the Kernel API Manual, bestie edition 🎀

okay so this is a page from the Kernel API Manual and honestly? it's giving "niche but iconic." it's all about one little function that does a glow-up on your pixels. let's get into it ✨

🌸 NAME 🌸

drm_fb_xrgb8888_to_argb8888 — converts XRGB8888 to ARGB8888 in a clip buffer. that's the whole vibe. no cap.

🦋 SYNOPSIS 🦋

void drm_fb_xrgb8888_to_argb8888 (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 );

literally just read it, it's right there 💖

🎀 ARGUMENTS 🎀

  • dst — an array of ARGB8888 destination buffers. yes bestie, plural, it's an array.
  • dst_pitch — an array of numbers of bytes between the start of two consecutive scanlines within dst. this one can be NULL if the scanlines are stored next to each other (they're snuggle buddies, it's fine).
  • src — an array of XRGB8888 source buffer. the original, the blueprint, the main character.
  • fb — the DRM framebuffer. hi king 👑
  • clip — the clip rectangle area to copy. basically "this part only, thank you."
  • state — transform and conversion state. it holds the lore.

✨ DESCRIPTION ✨

so what does this function actually do? it copies parts of a framebuffer over to display memory, and converts the color format while it's at it. multitasking icon behavior, honestly 🔥

the parameters dst, dst_pitch and src refer to arrays. and here's the rule: each array must have at least as many entries as there are planes in fb's format. every entry stores the value for the format's respective color plane at the same index. matching indexes, matching energies, we love to see it 🫶

⚠️ heads up: this function does not apply clipping on dst — meaning the destination sits at the top-left corner. top-left only. periodt.

drivers can use this function for ARGB8888 devices that don't support XRGB8888 natively. and as part of the conversion, it sets an opaque alpha channel — so nothing's see-through, everything's fully there. slay 💅

👑 SEE ALSO 👑

the kernel file that lives here: ./drivers/gpu/drm/drm_format_helper.c

and the whole friend group (squad goals, fr fr):

and that's the whole page, bestie 💖 this little beauty lives over at ./drivers/gpu/drm, dated October 2026, and it goes by drm_fb_xrgb8888_to_argb8888(9). go forth and convert those pixels responsibly 🧚‍♀️⭐

📦 where this page comes from