xcb_xfixes_fetch_region(3)

💖 xcb_xfixes_fetch_region 💖

okay bestie, welcome to the manual page for xcb_xfixes_fetch_region, part of the XCB requests family (that's the xcb_xfixes_fetch_region(3) page you're looking at, mwah). It's giving "niche X11 region-fetching realness" and honestly? we're obsessed. Let's get into it. 🦋

---

✨ NAME ✨

xcb_xfixes_fetch_region —

so like, the original page literally just leaves a dash and nothing else here. no description, no vibe, just a lonely little hyphen. iconique of them, honestly. we move. 💅

---

✨ SYNOPSIS ✨

first up, you gotta pull in the header, no cap:

#include <xcb/xfixes.h>

🌸 Request function 🌸

xcb_xfixes_fetch_region_cookie_t
       xcb_xfixes_fetch_region(xcb_connection_t *conn,
       xcb_xfixes_region_t region);

🌸 Reply datastructure 🌸

this is the lil struct you're gonna be living in:

typedef struct xcb_xfixes_fetch_region_reply_t {
    uint8_t         response_type;
    uint8_t         pad0;
    uint16_t        sequence;
    uint32_t        length;
    xcb_rectangle_t extents;
    uint8_t         pad1[16];
} xcb_xfixes_fetch_region_reply_t;

🌸 Reply function 🌸

xcb_xfixes_fetch_region_reply_t
       *xcb_xfixes_fetch_region_reply(xcb_connection_t *conn,
       xcb_xfixes_fetch_region_cookie_t cookie,
       xcb_generic_error_t **e);

🌸 Reply accessors 🌸

these are the lil helpers that pull stuff out for you, no manual digging required:

xcb_rectangle_t *xcb_xfixes_fetch_region_rectangles(const
       xcb_xfixes_fetch_region_request_t *reply);

int xcb_xfixes_fetch_region_rectangles_length(const
       xcb_xfixes_fetch_region_reply_t *reply);

xcb_rectangle_iterator_t
       xcb_xfixes_fetch_region_rectangles_iterator(const
       xcb_xfixes_fetch_region_reply_t *reply);

yes bestie, that first accessor really does take const xcb_xfixes_fetch_region_request_t *reply while the other two take const xcb_xfixes_fetch_region_reply_t *reply. we are NOT fixing it, we are NOT touching it, we are simply observing it and moving on. 🫶

---

✨ REQUEST ARGUMENTS ✨

• conn — the XCB connection to X11. your lil telephone line to the server, the group chat gateway, the whole vibe pipeline. 💜
• region — TODO: NOT YET DOCUMENTED. literally that's all the original says, so that's all I'm giving you. the mystery is the moment. 🙈

---

✨ REPLY FIELDS ✨

• response_type — the type of this reply, which in this case is XCB_XFIXES_FETCH_REGION. this field is also chilling inside xcb_generic_reply_t, and you can use it to tell replies apart from each other. very "which one of y'all is this" energy. 👑
• sequence — the sequence number of the last request processed by the X11 server. the receipt number, basically. 🧾✨
• length — the length of the reply, in words. and heads up: a word is 4 bytes, not like, a dictionary word. different kind of word, bestie. 💀
• extents — TODO: NOT YET DOCUMENTED. another mystery box. we respect it. 🎁

---

✨ DESCRIPTION ✨

so the DESCRIPTION section on the original page? completely empty. nada. silence. the void. 😭

genuinely nothing to report here — I'm not about to invent lore that isn't in the source, that's not the move. what you see is what you get, and what you get is a whole lot of nothing. main character energy of a section that simply chose not to speak. periodt. 💅

---

✨ RETURN VALUE ✨

it hands you back an xcb_xfixes_fetch_region_cookie_t — yes, a cookie, we love a snack. 🍓

errors have to be handled when you call the reply function xcb_xfixes_fetch_region_reply.

if you'd rather handle your errors in the event loop instead, use xcb_xfixes_fetch_region_unchecked. see xcb-requests(3) for the deets.

---

✨ ERRORS ✨

this request does never generate any errors. ✨

no errors. zero. none. not a single one. it's a good boy, it behaves. 🌈

---

✨ SEE ALSO ✨

okay so this section is, and I cannot stress this enough, empty on the original page. nothing listed. no cross-references. no friends. just vibes and a heading. 🦋

---

✨ AUTHOR ✨

Generated from xfixes.xml. Contact xcb@lists.freedesktop.org for corrections and improvements. 💌

---

and that's the whole thing, bestie!! this page came from X Version 11, libxcb 1.17.0, and it's the xcb_xfixes_fetch_region(3) manual — go forth and fetch those regions, you absolute legend. slay, stay hydrated, and remember: read your return values. 🎀✨💖🔥🦋