XCB_GLX_GET_CONVOLUTION_PARAMETERIV_DATA_LENGTH(3)

💖 xcb_glx_get_convolution_parameteriv 💖

okay bestie, so this is a page from the XCB Requests manual (yes, the xcb_glx_get_c...on_parameteriv(3) one, the name is literally so long it gets truncated with an ellipsis, iconic behavior honestly). She's a GLX request, she's got a cookie, she's got a reply struct, and she's coming to spill all the deets. let's get into it 🎀

---

✨ NAME ✨

xcb_glx_get_convolution_parameteriv — and that's it, that's the whole name section. the original left it blank, so we're leaving it blank. no cap, there's literally no description line here. 💀

---

🌸 SYNOPSIS 🌸

first up, the include, always the include:

#include <xcb/glx.h>

🦋 Request function

xcb_glx_get_convolution_parameteriv_cookie_t
xcb_glx_get_convolution_parameteriv(xcb_connection_t *conn,
        xcb_glx_context_tag_t context_tag, uint32_t target,
        uint32_t pname);

she hands you back a cookie, not the actual answer. the answer comes later. patience, babe. ✨

🎀 Reply datastructure

typedef struct xcb_glx_get_convolution_parameteriv_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    uint8_t  pad1[4];
    uint32_t n;
    int32_t  datum;
    uint8_t  pad2[12];
} xcb_glx_get_convolution_parameteriv_reply_t;

look at all those pad fields. they're just vibing. don't touch them, they're doing their job. 🙈

🌈 Reply function

xcb_glx_get_convolution_parameteriv_reply_t
*xcb_glx_get_convolution_parameteriv_reply(xcb_connection_t *conn,
        xcb_glx_get_convolution_parameteriv_cookie_t cookie,
        xcb_generic_error_t **e);

this is where you cash in the cookie and actually get your reply. 🍪

👑 Reply accessors

int32_t *xcb_glx_get_convolution_parameteriv_data(const
        xcb_glx_get_convolution_parameteriv_request_t *reply);

int xcb_glx_get_convolution_parameteriv_data_length(const
        xcb_glx_get_convolution_parameteriv_reply_t *reply);

xcb_generic_iterator_t
        xcb_glx_get_convolution_parameteriv_data_end(const
        xcb_glx_get_convolution_parameteriv_reply_t *reply);

yes bestie, those signatures are exactly as the original wrote them — including the one that takes a ..._request_t in ..._data(). we do not fix. we do not rename. we report. 🫶

---

💅 REQUEST ARGUMENTS 💅

• conn — your XCB connection to X11. the whole portal to the server, ngl.
• context_tag — TODO: NOT YET DOCUMENTED. yeah. the docs said "not yet documented" and honestly same, girl. 😭
• target — TODO: NOT YET DOCUMENTED. also a mystery. a little enigmatic, a little main character. ✨
• pname — TODO: NOT YET DOCUMENTED. the third mystery parameter. the trio of unknowns. 💀

---

⭐ REPLY FIELDS ⭐

• response_type — the type of this reply. in this case it's XCB_GLX_GET_CONVOLUTION_PARAMETERIV. this field is also chillin' in the xcb_generic_reply_t, so you can use it to tell replies apart from each other when you're sifting through your inbox of server responses. 🦋
• sequence — the sequence number of the last request processed by the X11 server. basically a little "I've gotten this far" receipt. 🧾
• length — the length of the reply, in words. and before you ask: a word is 4 bytes. periodt.
• n — TODO: NOT YET DOCUMENTED. 🙈
• datum — TODO: NOT YET DOCUMENTED. 🙈

---

💜 DESCRIPTION 💜

so… there is no description. the section exists, and it is empty. that's the whole tea. nothing here. not a single sentence. the section is giving minimalism, and honestly? respect. 🎀

---

🔥 RETURN VALUE 🔥

she returns an xcb_glx_get_convolution_parameteriv_cookie_t. that's your little voucher for later.

errors are not handled here, bestie — you have to deal with them when you call the reply function, xcb_glx_get_convolution_parameteriv_reply.

but wait, there's a plot twist: if you'd rather handle errors in the event loop instead, use xcb_glx_get_convolution_parameteriv_unchecked. see xcb-requests(3) for the details, iykyk. ✨

---

💀 ERRORS 💀

this request does never generate any errors. none. zero. not a single one. she's drama-free, she's unproblematic, she's the moment. 🌸

---

🌈 SEE ALSO 🌈

• (the original lists nothing here — the section is empty, so we're keeping it empty. sometimes the absence is the statement. 💅)

---

🫶 AUTHOR 🫶

generated from glx.xml. got corrections or improvements? contact xcb@lists.freedesktop.org and tell them. they want to hear from you, fr fr. 💌

---

and that's the whole page, babe — brought to you by X Version 11, libxcb 1.17.0. thanks for reading all the way to the end, you're literally the bestie of all time. slay, and go get that convolution parameter. 💖✨👑