xcb_xfixes_se...e_clip_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

πŸ’– NAME πŸ’–

xcb_xfixes_set_picture_clip_region β€” okay bestie, this one's a lil mystery box, the description line is literally just a dash, no cap 🫢

It lives in the XCB Requests corner of the manual (that's the manual name, if you were wondering β€” xcb_xfixes_se...e_clip_region(3), which is giving truncated-title energy fr fr).


✨ SYNOPSIS ✨

First things first, you gotta pull in the header:

#include <xcb/xfixes.h>

πŸŽ€ Request function

xcb_void_cookie_t
       xcb_xfixes_set_picture_clip_region(xcb_connection_t *conn,
       xcb_render_picture_t picture, xcb_xfixes_region_t region,
       int16_t x_origin, int16_t y_origin);

That's the whole signature, copy it exactly, don't freestyle it πŸ’…


🌸 REQUEST ARGUMENTS 🌸

  • conn β€” the XCB connection to X11. Your lil lifeline to the server, the main character of every XCB call tbh.
  • picture β€” TODO: NOT YET DOCUMENTED. Yeah. The docs simply did not show up to the function. Not me exposing the upstream docs like this 😭
  • region β€” TODO: NOT YET DOCUMENTED. Same vibe, same silence πŸ’€
  • x_origin β€” TODO: NOT YET DOCUMENTED. It's an int16_t, that's what we know, that's what we're working with πŸ™ˆ
  • y_origin β€” TODO: NOT YET DOCUMENTED. Also int16_t, also mysterious, also iconic in its elusiveness ✨
Lowkey important: I am not gonna invent meanings for these four, because the manual genuinely doesn't document them. If you need the deets, go read the source, bestie, I'm not gonna lie to you 🫢

πŸ¦‹ DESCRIPTION πŸ¦‹

So… there's a DESCRIPTION heading, and then there is nothing under it. Empty. Void. The girls said nothing. It's giving "we ran out of time before the release" energy 🌈


⭐ RETURN VALUE ⭐

Returns an xcb_void_cookie_t. And because it's a void cookie, any errors (if there even are any) have to be handled over in the event loop β€” that's just how the void-cookie girlies operate.

If you'd rather handle errors directly with xcb_request_check instead, then use xcb_xfixes_set_picture_clip_region_checked. She's the checked twin πŸ‘‘ For all the details, go read xcb-requests(3).


πŸ’… ERRORS πŸ’…

This request does never generate any errors. Zero. None. Clean slate, no drama, we love a low-maintenance call 😌


πŸ”₯ SEE ALSO πŸ”₯

Okay so this section is here… and it's empty. No references. Nothing to see. Literally nothing to also-see. Not me staring at a blank section πŸ’€


🌈 AUTHOR 🌈

Generated from xfixes.xml. If you spot something wrong or wanna send improvements, hit up xcb@lists.freedesktop.org β€” they're the ones who take the corrections and improvements, periodt.


And that's the whole page, bestie!! πŸŽ€ Written up as part of X Version 11, libxcb 1.17.0 β€” thanks for reading all the way through, you absolute icon, mwah πŸ’–βœ¨