xcb_render_fill_rectangles(3)

📦
version 1.17.0 · 4 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, centos-stream 10, debian trixie, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

xcb_render_fill_rectangles 💅

okay bestie, so this one is a page from the XCB Requests corner of the libxcb universe ✨ (XCB = X protocol C-language Binding, and she's serving real ones, fr fr).

🌸 NAME 🌸

xcb_render_fill_rectangles — and then… nothing?? 😭 The description field on this one is literally empty. Not me getting a whole NAME section with the dash and no words after it. It's giving mystery. It's giving "the docs said 💀". We move anyway 💖

🎀 SYNOPSIS 🎀

✨ Request function ✨

#include <xcb/render.h>

xcb_void_cookie_t xcb_render_fill_rectangles(xcb_connection_t *conn,
       uint8_t op, xcb_render_picture_t dst, xcb_render_color_t color,
       uint32_t rects_len, const xcb_rectangle_t *rects);

so first you gotta pull in <xcb/render.h> — that's the header, she's essential, no skips 🫶 — and then you call that function with those six things. Look at her. Iconic signature. ⭐

🦋 REQUEST ARGUMENTS 🦋

  • conn — bestie this is your XCB connection to X11. Your lil hotline to the server. 💜
  • op — TODO: NOT YET DOCUMENTED. 🙈
  • dst — TODO: NOT YET DOCUMENTED. 🙈
  • color — TODO: NOT YET DOCUMENTED. 🙈
  • rects_len — TODO: NOT YET DOCUMENTED. 🙈
  • rects — TODO: NOT YET DOCUMENTED. 🙈
ngl, five out of six of these are straight up "TODO: NOT YET DOCUMENTED." and I'm not about to make up lore for them, because inventing behaviour is not the vibe. The docs are the docs, and right now they're saying nothing. Periodt. 😭 We respect the mystery. 💅

💖 DESCRIPTION 💖

also empty. Like, genuinely nothing here. The original page has a DESCRIPTION heading and then just… air. 🌬️ So consider this your moment of silence, bestie. 🎀

🔥 RETURN VALUE 🔥

She returns an xcb_void_cookie_t. 💫 And here's the tea: errors (if there are any) have to be handled in the event loop. That's the deal.

If you'd rather handle errors directly with xcb_request_check, then use xcb_render_fill_rectangles_checked instead — that's her checked twin, she'll tell you what went wrong. 💅

For the full story on how any of this cookie business works, go see xcb-requests(3). 👑

😭 ERRORS 😭

This request does never generate any errors.

yup. zero. none. she's perfect, she's unbothered, she cannot fail you like that. 🌈 (Obviously still handle your cookie in the event loop like a responsible main character, but there's nothing to catch. Slay.)

👑 SEE ALSO 👑

…bestie there's literally nothing listed here. The section exists, the entries do not. It's giving an empty group chat. 🫶

✨ AUTHOR ✨

Generated from render.xml. 📜 Contact xcb@lists.freedesktop.org for corrections and improvements. (If you know what op, dst, color, rects_len and rects actually do — please email them, they're begging. 🙏)

okay that's the whole page, we ate and left no crumbs 💅 this was X Version 11, libxcb 1.17.0, and it's xcb_render_fill_rectangles(3) — ily, go fill some rectangles bestie 🎀✨💖

📦 where this page comes from