xcb_shape_query_extents(3)

💖 xcb_shape_query_extents — bestie edition 💖

okay so this is a page from the XCB Requests corner of the libxcb world, and it's all about xcb_shape_query_extents. She's a lil request function, she comes with a reply struct AND a reply function, and honestly? she's giving "lowkey mysterious" because half her docs are literally TODO: NOT YET DOCUMENTED 🙈. We're gonna walk through every single field anyway, no cap. Let's go ✨

---

🌸 SYNOPSIS 🌸

#include <xcb/shape.h>

✨ Request function

xcb_shape_query_extents_cookie_t
       xcb_shape_query_extents(xcb_connection_t *conn,
       xcb_window_t destination_window);

🎀 Reply datastructure

typedef struct xcb_shape_query_extents_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    uint8_t  bounding_shaped;
    uint8_t  clip_shaped;
    uint8_t  pad1[2];
    int16_t  bounding_shape_extents_x;
    int16_t  bounding_shape_extents_y;
    uint16_t bounding_shape_extents_width;
    uint16_t bounding_shape_extents_height;
    int16_t  clip_shape_extents_x;
    int16_t  clip_shape_extents_y;
    uint16_t clip_shape_extents_width;
    uint16_t clip_shape_extents_height;
} xcb_shape_query_extents_reply_t;

💅 Reply function

xcb_shape_query_extents_reply_t
       *xcb_shape_query_extents_reply(xcb_connection_t *conn,
       xcb_shape_query_extents_cookie_t cookie,
       xcb_generic_error_t **e);

---

🫶 REQUEST ARGUMENTS 🫶

• conn — the XCB connection to X11, aka your hotline to the server 💌
• destination_window — TODO: NOT YET DOCUMENTED. like... the docs really said "figure it out bestie" 😭

---

👑 REPLY FIELDS 👑

• response_type — the type of this reply, in this case XCB_SHAPE_QUERY_EXTENTS. This field is also present in the xcb_generic_reply_t and can be used to tell replies apart from each other. it's literally the vibe check that says "yep, this one's mine" ⭐
• sequence — the sequence number of the last request processed by the X11 server. the receipts, fr fr 🧾
• length — the length of the reply, in words (a word is 4 bytes). math girlies stay winning ✨
• bounding_shaped — TODO: NOT YET DOCUMENTED. 💀
• clip_shaped — TODO: NOT YET DOCUMENTED. 💀
• bounding_shape_extents_x — TODO: NOT YET DOCUMENTED. 💀
• bounding_shape_extents_y — TODO: NOT YET DOCUMENTED. 💀
• bounding_shape_extents_width — TODO: NOT YET DOCUMENTED. 💀
• bounding_shape_extents_height — TODO: NOT YET DOCUMENTED. 💀
• clip_shape_extents_x — TODO: NOT YET DOCUMENTED. 💀
• clip_shape_extents_y — TODO: NOT YET DOCUMENTED. 💀
• clip_shape_extents_width — TODO: NOT YET DOCUMENTED. 💀
• clip_shape_extents_height — TODO: NOT YET DOCUMENTED. 💀

---

🌈 DESCRIPTION 🌈

...and that's it. that's the section. she's empty. she said "no thoughts, head empty" 🦋✨ (iconic behaviour, honestly)

---

💜 RETURN VALUE 💜

Returns an xcb_shape_query_extents_cookie_t. Errors have to be handled when calling the reply function xcb_shape_query_extents_reply.

If you want to handle errors in the event loop instead, use xcb_shape_query_extents_unchecked. See xcb-requests(3) for details. pick your fighter 🥊

---

🍓 ERRORS 🍓

This request does never generate any errors. zero drama, zero problems, we love a clean queen 👑✨

---

🧚 SEE ALSO 🧚

(empty, bestie — nothing to see here, moving on 🫶)

---

🌸 AUTHOR 🌸

Generated from shape.xml. Contact xcb@lists.freedesktop.org for corrections and improvements. send them an email if something's off, they're literally asking 🙈💌

---

okay that's the whole page, bestie!! 💖 this was X Version 11, libxcb 1.17.0, and the page itself is xcb_shape_query_extents(3). go forth and query those extents, you absolute main character 🎀✨🦋