xcb_randr_set_screen_config(3)

💖 xcb_randr_set_screen_config — the XCB Requests glow-up 💖

okay bestie, sit down, hydrate, because we're diving into xcb_randr_set_screen_config from the XCB Requests corner of the X11 universe. this is a libxcb function, it lives in <xcb/randr.h>, and it is exactly as extra as it sounds. 🦋

---

✨ NAME ✨

xcb_randr_set_screen_config — setting your screen config, bestie. that's the whole vibe. (the original manpage left this blank, which is honestly so real of it, but we're keeping it blank too because facts don't change just because i'm hyped. 💅)

---

🌸 SYNOPSIS 🌸

#include <xcb/randr.h>

🎀 Request function

xcb_randr_set_screen_config_cookie_t
       xcb_randr_set_screen_config(xcb_connection_t *conn,
       xcb_window_t window, xcb_timestamp_t timestamp,
       xcb_timestamp_t config_timestamp, uint16_t sizeID,
       uint16_t rotation, uint16_t rate);

🎀 Reply datastructure

typedef struct xcb_randr_set_screen_config_reply_t {
    uint8_t         response_type;
    uint8_t         status;
    uint16_t        sequence;
    uint32_t        length;
    xcb_timestamp_t new_timestamp;
    xcb_timestamp_t config_timestamp;
    xcb_window_t    root;
    uint16_t        subpixel_order;
    uint8_t         pad0[10];
} xcb_randr_set_screen_config_reply_t;

🎀 Reply function

xcb_randr_set_screen_config_reply_t
       *xcb_randr_set_screen_config_reply(xcb_connection_t *conn,
       xcb_randr_set_screen_config_cookie_t cookie,
       xcb_generic_error_t **e);

---

💜 REQUEST ARGUMENTS 💜

• conn — your XCB connection to X11. the whole portal to the server, the main character of every XCB call, no cap. 🔥
• window — TODO: NOT YET DOCUMENTED. yeah. the manpage really said "mystery" on this one. 🫶
• timestamp — TODO: NOT YET DOCUMENTED. same energy, bestie. it's giving unwritten. 🙈
• config_timestamp — TODO: NOT YET DOCUMENTED. also undocumented. iconic in a chaotic way. 💀
• sizeID — TODO: NOT YET DOCUMENTED. the docs simply did not come through. 💅
• rotation — TODO: NOT YET DOCUMENTED. spinning, presumably, but the manpage won't confirm that, and neither will i. 🌈
• rate — TODO: NOT YET DOCUMENTED. also a mystery box. ✨

fr fr: every one of those args is literally marked TODO: NOT YET DOCUMENTED. in the source. i am not making this up, and i am not filling in the gaps with guesses. facts only. 🧚

---

🦋 REPLY FIELDS 🦋

• response_type — the type of this reply, in this case XCB_RANDR_SET_SCREEN_CONFIG. this field is also present in the xcb_generic_reply_t and can be used to tell replies apart from each other. it's the little name tag at the party. 🎀
• sequence — the sequence number of the last request processed by the X11 server. basically the receipt number. keep it. 📝
• length — the length of the reply, in words (a word is 4 bytes). math girlies rise. 🔥
• status — TODO: NOT YET DOCUMENTED. yep. 💀
• new_timestamp — TODO: NOT YET DOCUMENTED. 🙈
• config_timestamp — TODO: NOT YET DOCUMENTED. (yes, there's one in the request AND one in the reply, and no, neither is documented. we stay unbothered.) 💅
• root — TODO: NOT YET DOCUMENTED. 🌸
• subpixel_order — TODO: NOT YET DOCUMENTED. ✨

---

🌈 DESCRIPTION 🌈

the DESCRIPTION section of the original manpage is, and i say this with love, completely empty. no paragraphs. no prose. nothing. it's giving silent treatment, it's giving mystery, it's giving "we'll tell you later" and then never telling you. 💀

so we're keeping it empty too, bestie. the vibe is preserved. the facts are preserved. the emptiness is canon. 🫶

---

👑 RETURN VALUE 👑

returns an xcb_randr_set_screen_config_cookie_t. 🍪

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

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

ok so real talk: xcb_randr_set_screen_config_reply = you get your errors right there, up close and personal. xcb_randr_set_screen_config_unchecked = you go event-loop mode and deal with them as they arrive. pick your fighter. 💅

---

💀 ERRORS 💀

this request does never generate any errors.

not one. zero. nada. it's the good kid of the XCB family. 🧚✨

---

💜 SEE ALSO 💜

...and that's it. the SEE ALSO section is genuinely empty in the original. no cross references, no little friends, nothing. it stands alone, main character energy, no supporting cast. 👑

---

🌸 AUTHOR 🌸

generated from randr.xml. contact xcb@lists.freedesktop.org for corrections and improvements.

---

and that's the whole page, bestie!! 🎀 this little gem shipped as part of X Version 11, from libxcb 1.17.0, and yes, the manual page header really does say xcb_randr_set_screen_config(3) — mwah, obsessed, periodt. 💅💖