drm_fb_xrgb8888_to_rgb888(9)

📦 version 7.3.1, in nixpkgs unstable

💅 drm_fb_xrgb8888_to_rgb888 — like, the Kernel API Manual page you didn't know you needed

okay so bestie, welcome to the glow-up zone: this is drm_fb_xrgb8888_to_rgb888(9), and it is literally the function that takes your fancy-pants XRGB8888 pixels and serves them as RGB888. iconic behavior. let's get into it 🎀

✨ NAME ✨

drm_fb_xrgb8888_to_rgb888 — convert XRGB8888 to RGB888 clip buffer. that's the whole vibe. no cap. 💖

🌸 SYNOPSIS 🌸

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

like, look at her. six parameters, zero notes. she's booked and busy 🫶

🦋 ARGUMENTS 🦋

  • dst — array of RGB888 destination buffers. the place the pixels are going, basically their new apartment 💅
  • 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 if your rows are all cozy and adjacent, you can just pass NULL and skip the math, ngl that's a serve
  • src — array of XRGB8888 source buffers. the originals, the main characters before the makeover ✨
  • fb — DRM framebuffer. the framebuffer in question, your honor 🌈
  • clip — clip rectangle area to copy. this is the lil window of pixels we're actually touching, keep your hands inside the ride 🎢
  • state — transform and conversion state. the bookkeeping bestie that remembers what happened during the transform 💜

🔥 DESCRIPTION 🔥

okay so what she does: this function copies parts of a framebuffer to display memory and converts the color format during the process. two jobs, one function, she's multitasking and honestly? obsessed.

⚠️ note it: destination and framebuffer formats must match. that's the rule, fr fr, don't come crying to me if you fudge it

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. and each entry stores the value for the format's respective color plane at the same index. so like, index 0 talks to index 0, index 1 talks to index 1 — everybody finds their match, it's giving soulmate energy 🥰

also important, and I need you to hear this: this function does not apply clipping on dst (i.e. the destination is at the top-left corner). she just drops it in the corner and walks away. no offset, no drama, top-left periodt 💀

and the actual use case: drivers can use this function for RGB888 devices that don't natively support XRGB8888. so if your hardware is like "XRGB8888? never heard of her" — that's literally why this exists. you're so welcome 👑

🌟 SEE ALSO 🌟

the whole friend group, and yes you will be meeting all of them 💖

like, that's the page, bestie. you're gonna go convert some pixels and you're gonna slay doing it 💅✨

<x-purple>mwah 💋 — signed off from ./drivers/gpu/drm, dated October 2026, living under the Kernel API Manual banner, and this diva's name is drm_fb_xrgb8888_to_rgb888(9). periodt. 🎀</x-purple>

📦 where this page comes from