xcb_glx_get_separable_filter(3)

💖 xcb_glx_get_separable_filter — the manual page, bestie edition 💖

okay so. you're here for xcb_glx_get_separable_filter, a lil XCB request from the XCB Requests crew, living in the GLX zone. welcome, sit down, grab a strawberry 🍓 — we're doing this together and we're doing it right.

---

✨ NAME ✨

xcb_glx_get_separable_filter — and that's it, that's the whole name section, the original literally gave us a dash and nothing else, so we're matching that energy. it's giving mysterious. it's giving main character with no backstory. 💅

---

✨ SYNOPSIS ✨

first things first, the include:

#include <xcb/glx.h>

🦋 Request function 🦋

xcb_glx_get_separable_filter_cookie_t
       xcb_glx_get_separable_filter(xcb_connection_t *conn,
       xcb_glx_context_tag_t context_tag, uint32_t target,
       uint32_t format, uint32_t type, uint8_t swap_bytes);

she returns a cookie. a cookie! obsessed. 🍪 (not a real cookie, bestie, it's the async handle, but let me live.)

🎀 Reply datastructure 🎀

typedef struct xcb_glx_get_separable_filter_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    uint8_t  pad1[8];
    int32_t  row_w;
    int32_t  col_h;
    uint8_t  pad2[8];
} xcb_glx_get_separable_filter_reply_t;

look at those padding arrays. pad1[8] and pad2[8] are just there holding space, no thoughts, head empty, iconic. 🫶

🌈 Reply function 🌈

xcb_glx_get_separable_filter_reply_t
       *xcb_glx_get_separable_filter_reply(xcb_connection_t *conn,
       xcb_glx_get_separable_filter_cookie_t cookie,
       xcb_generic_error_t **e);

⭐ Reply accessors ⭐

uint8_t *xcb_glx_get_separable_filter_rows_and_cols(const
       xcb_glx_get_separable_filter_request_t *reply);

int xcb_glx_get_separable_filter_rows_and_cols_length(const
       xcb_glx_get_separable_filter_reply_t *reply);

xcb_generic_iterator_t
       xcb_glx_get_separable_filter_rows_and_cols_end(const
       xcb_glx_get_separable_filter_reply_t *reply);

three accessors, one for the pointer, one for the length, one for the end iterator. a whole little family. 🧚

---

💜 REQUEST ARGUMENTS 💜

• conn — the XCB connection to X11. your link to the server, your situationship with the display, if you will. 🔥
• context_tag — TODO: NOT YET DOCUMENTED.
• target — TODO: NOT YET DOCUMENTED.
• format — TODO: NOT YET DOCUMENTED.
• type — TODO: NOT YET DOCUMENTED.
• swap_bytes — TODO: NOT YET DOCUMENTED.

ngl bestie, most of these are literally undocumented in the source. the manpage says TODO: NOT YET DOCUMENTED. and we are not about to make stuff up. the void is the void. 💀

---

🌸 REPLY FIELDS 🌸

• response_type — the type of this reply, in this case XCB_GLX_GET_SEPARABLE_FILTER. this field is also present in the xcb_generic_reply_t and can be used to tell replies apart from each other. she's the name tag at the party. 🎀
• sequence — the sequence number of the last request processed by the X11 server. the receipts. the timeline. ⭐
• length — the length of the reply, in words (a word is 4 bytes). yes bestie, 4 bytes. write that down. ✨
• row_w — TODO: NOT YET DOCUMENTED.
• col_h — TODO: NOT YET DOCUMENTED.

---

✨ DESCRIPTION ✨

...and that's it. that's the section. the original has nothing under DESCRIPTION. an empty description. a blank canvas. honestly? kind of a vibe. lowkey poetic. we respect the silence. 🙈

---

💖 RETURN VALUE 💖

Returns an xcb_glx_get_separable_filter_cookie_t. so far so good.

errors have to be handled when calling the reply function xcb_glx_get_separable_filter_reply.

if you want to handle errors in the event loop instead, use xcb_glx_get_separable_filter_unchecked. see xcb-requests(3) for details. 🫶

---

🎀 ERRORS 🎀

this request does never generate any errors.

like, ever. zero. none. clean record, no drama, the peacekeeper of requests. 🌈

---

👑 SEE ALSO 👑

(the original lists nothing here — no references, no cross-links, just the heading and the void. so: no further reading, bestie. you've seen it all. iykyk.)

---

🌟 AUTHOR 🌟

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

---

and that's the whole page, bestie!! 💅✨ you understood it, you slayed it, you're basically a GLX expert now, no cap. this was xcb_glx_get_separable_filter(3) from X Version 11, shipped with libxcb 1.17.0 — go forth and filter separably, whatever that means (the manpage won't tell us either 🫶). mwah. 💖🦋🌸