xcb_xfixes_create_region(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_xfixes_create_region β€” the XCB request that makes a region out of rectangles πŸ’–

okay bestie, so this is a page from the XCB Requests section of the X11 manual, and it's all about one lil request function. the manpage NAME line is honestly giving nothing (it's literally just the name with a dash and no description, which is so real of it), so we're just gonna get into it. ✨


πŸ¦‹ SYNOPSIS πŸ¦‹

first, you gotta pull in the header:

#include <xcb/xfixes.h>

🌸 Request function 🌸

here's the actual function, character for character, no notes:

xcb_void_cookie_t xcb_xfixes_create_region(xcb_connection_t *conn,
       xcb_xfixes_region_t region, uint32_t rectangles_len, const
       xcb_rectangle_t *rectangles);

πŸ‘‘ REQUEST ARGUMENTS πŸ‘‘

okay so here's what you're passing in. heads up tho, the docs are kinda unserious about these:

  • conn β€” the XCB connection to X11. that's your link to the server, your whole vibe portal, no connection no nothing πŸ’…
  • region β€” TODO: NOT YET DOCUMENTED. yeah… the manpage really said "figure it out" 😭
  • rectangles_len β€” TODO: NOT YET DOCUMENTED. also left on read πŸ™ˆ
  • rectangles β€” TODO: NOT YET DOCUMENTED. bestie I'm so sorry, the docs are not beating the allegations 🫢
ngl, if you need the real tea on these three, the manpage itself doesn't have it. that's not me gatekeeping, that's literally what's written. ✨

πŸŽ€ DESCRIPTION πŸŽ€

there is no description text on this page. like, the section is there, it's just… empty. the silence is loud fr fr πŸ’€


⭐ RETURN VALUE ⭐

this one returns an xcb_void_cookie_t. and because it's a void cookie, any errors (if any) have to be handled in the event loop, bestie. that's just how it is.

but wait, there's another way πŸ‘€ β€” if you'd rather handle errors directly with xcb_request_check instead, then use xcb_xfixes_create_region_checked. two paths, same energy. for the full details go read xcb-requests(3). periodt.


🌈 ERRORS 🌈

good news era: this request does never generate any errors. zero. none. iconic behaviour honestly. πŸ‘‘


πŸ”₯ SEE ALSO πŸ”₯

this section is empty on the original page β€” nothing listed, nothing linked. the void stares back. πŸ•³οΈβœ¨


πŸ’œ AUTHOR πŸ’œ

this page was generated from xfixes.xml. if you spot something wrong and wanna help make it better, contact xcb@lists.freedesktop.org for corrections and improvements. they're literally asking for it, so don't be shy 🫢


and that's the whole page, bestie!! stay hydrated, keep your cookies checked, and remember: never generate errors if you can help it πŸ’…

mwah πŸ’– this was X Version 11, libxcb 1.17.0 β€” xcb_xfixes_create_region(3), signing off βœ¨πŸŽ€