XCB_GLX_GET_COLOR_TABLE_PARAMETERFV(3)

πŸ“¦
version 1.17.0 Β· 4 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, centos-stream 10, debian trixie, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’… xcb_glx_get_color_table_parameterfv β€” the vibe

ok so bestie, welcome to xcb_glx_get_color_table_parameterfv, a little number from the XCB Requests corner of the universe. No cap, the actual name is long enough to need its own zip code, but we're gonna get through it together. 🫢


✨ NAME ✨

xcb_glx_get_color_table_parameterfv β€” bestie it literally has no one-line description in the original, the NAME section is just... the name. Iconic behaviour honestly. πŸ‘‘


🌸 SYNOPSIS 🌸

First things first, you gotta include the header, always:

#include <xcb/glx.h>

πŸŽ€ Request function πŸŽ€

Here's your main character function, the one you actually call:

xcb_glx_get_color_table_parameterfv_cookie_t
       xcb_glx_get_color_table_parameterfv(xcb_connection_t *conn,
       xcb_glx_context_tag_t context_tag, uint32_t target,
       uint32_t pname);

πŸ¦‹ Reply datastructure πŸ¦‹

This is the struct the server sends back at you, look at all these little fields:

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

πŸ’– Reply function πŸ’–

And this is how you go get that reply, given the cookie:

xcb_glx_get_color_table_parameterfv_reply_t
       *xcb_glx_get_color_table_parameterfv_reply(xcb_connection_t *conn,
       xcb_glx_get_color_table_parameterfv_cookie_t cookie,
       xcb_generic_error_t **e);

✨ Reply accessors ✨

Three lil helpers to peek inside the reply, they ate fr:

xcb_glx_float32_t *xcb_glx_get_color_table_parameterfv_data(const
       xcb_glx_get_color_table_parameterfv_request_t *reply);

int xcb_glx_get_color_table_parameterfv_data_length(const
       xcb_glx_get_color_table_parameterfv_reply_t *reply);

xcb_generic_iterator_t
       xcb_glx_get_color_table_parameterfv_data_end(const
       xcb_glx_get_color_table_parameterfv_reply_t *reply);

πŸ’œ REQUEST ARGUMENTS πŸ’œ

Everything you gotta hand over when you make the call:

  • conn β€” the XCB connection to X11. Your link to the server, your little phone line to the mothership. πŸ“ž
  • context_tag β€” TODO: NOT YET DOCUMENTED. Yeah bestie, the docs said "we'll get to it" and then simply did not. Not me pointing that out. πŸ’€
  • target β€” TODO: NOT YET DOCUMENTED. Same situation, no notes, we just don't know.
  • pname β€” TODO: NOT YET DOCUMENTED. Also a mystery, and I refuse to make something up because that would be lying and we don't do that here.
🫢 Friendly reminder: those three are literally marked TODO in the source. I'm not gatekeeping anything from you β€” that's genuinely all there is.

🌈 REPLY FIELDS 🌈

Here's what comes back in the reply, field by field:

  • response_type β€” the type of this reply, and in this case it's XCB_GLX_GET_COLOR_TABLE_PARAMETERFV. This field also shows up in the xcb_generic_reply_t, so you can use it to tell your replies apart from each other when they're all vibing in the same queue.
  • sequence β€” the sequence number of the last request the X11 server processed. It's like a little timestamp of progress, so you always know where you're at.
  • length β€” the length of the reply, in words. And heads up, a word is 4 bytes, so don't go measuring in regular words like a civilian. πŸ“
  • n β€” TODO: NOT YET DOCUMENTED. We're all in the dark together on this one, bestie.
  • datum β€” TODO: NOT YET DOCUMENTED. Yeah. That's it. That's the whole description.

⭐ DESCRIPTION ⭐

Nothing here. The section exists, it's just empty. We love a mysterious queen with no backstory. πŸ‘‘


πŸ”₯ RETURN VALUE πŸ”₯

You get back an xcb_glx_get_color_table_parameterfv_cookie_t. Yes, a cookie. πŸͺ Errors? You gotta deal with those when you call the reply function, xcb_glx_get_color_table_parameterfv_reply.

If you'd rather catch your errors in the event loop instead β€” very valid, very main character β€” then use xcb_glx_get_color_table_parameterfv_unchecked. Want the full rundown? Go read xcb-requests(3), it explains everything.


πŸ™ˆ ERRORS πŸ™ˆ

This request does never generate any errors. Zero. Zilch. It's giving peaceful. πŸ•ŠοΈ


🧚 SEE ALSO 🧚

Nothing listed here. An empty SEE ALSO. It's a mood, honestly.


🌸 AUTHOR 🌸

Generated from glx.xml. If you spot something wrong and wanna help make it better, hit up xcb@lists.freedesktop.org for corrections and improvements. They're lovely, they take feedback. πŸ’Œ


and that's the whole page, bestie!! πŸŽ€ you read all of it, which is lowkey iconic of you. this was X Version 11, libxcb 1.17.0 energy from start to finish, and the title up top β€” xcb_glx_get_c...le_parameterfv(3), yes it's truncated like that, the man page really did that β€” is now officially your friend. go forth and query your color table parameters. slay. πŸ’…βœ¨πŸ¦‹