xcb_shape_notify_event_t(3)

💖 xcb_shape_notify_event_t 💖

okay so bestie, welcome to the XCB Events section of the manual — this is xcb_shape_notify_event_t(3), and she's a whole event datastructure, no cap. sit down, grab a boba, we're doing structs today 🧋✨

🌸 NAME 🌸

xcb_shape_notify_event_t — and honestly? that's it. that's the whole name section. the original manpage left it blank after the dash so we're leaving it blank too. iconic minimalism, i guess 💅

✨ SYNOPSIS ✨

first things first, you gotta pull her in:

#include <xcb/shape.h>

🎀 Event datastructure

here's the actual struct, copied character for character because we do NOT freestyle on struct definitions:

typedef struct xcb_shape_notify_event_t {
    uint8_t          response_type;
    xcb_shape_kind_t shape_kind;
    uint16_t         sequence;
    xcb_window_t     affected_window;
    int16_t          extents_x;
    int16_t          extents_y;
    uint16_t         extents_width;
    uint16_t         extents_height;
    xcb_timestamp_t  server_time;
    uint8_t          shaped;
    uint8_t          pad0[11];
} xcb_shape_notify_event_t;

look at her. eleven whole members plus a little pad0[11] for padding. she's built different 🫶

🔥 EVENT FIELDS 🔥

okay so here's the field-by-field breakdown, and yes, we're doing all of them, even the ones that say NOT YET DOCUMENTED, because we don't skip content in this house 🏠

• response_type — the type of this event, which in this specific case is XCB_SHAPE_NOTIFY. this same field also lives inside xcb_generic_event_t, and it's how you tell one event apart from another when they're all just vibing in the same queue. it's giving name tag at a party 🏷️
• sequence — the sequence number of the last request that got processed by the X11 server. think of it as the server's "last seen" timestamp but for requests 📋
• shape_kind — NOT YET DOCUMENTED. yeah. the manpage said what it said. we're not making stuff up, bestie, that's the whole rule 😭
• affected_window — NOT YET DOCUMENTED.
• extents_x — NOT YET DOCUMENTED.
• extents_y — NOT YET DOCUMENTED.
• extents_width — NOT YET DOCUMENTED.
• extents_height — NOT YET DOCUMENTED.
• server_time — NOT YET DOCUMENTED.
• shaped — NOT YET DOCUMENTED.

ngl the original documentation really said "figure it out" for like eight of these fields. not me defending it, just reporting the facts fr fr 🙈

🦋 DESCRIPTION 🦋

okay so. the description section? she's empty. there is nothing in here. the original manpage put the heading down and then simply did not elaborate. main character energy honestly — showing up to the function with zero explanation 💀

💜 SEE ALSO 💜

also empty. no cross-references, no siblings, nothing. she's an only child and she's thriving 🌈

👑 AUTHOR 👑

generated from shape.xml. if you spot something wrong and wanna send corrections or improvements, hit up xcb@lists.freedesktop.org — they're the ones who actually know things 🫶

and that's the whole page, bestie! this little gem came to you from X Version 11, libxcb 1.17.0, and it's filed under xcb_shape_notify_event_t(3). go forth and shape your windows, you absolute icon 💅✨🌸