XCB_SCREENSAVER_SET_ATTRIBUTES_CHECKED(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_screensaver_set_attributes πŸ’–

okay bestie, so this is a page from the XCB Requests manual set β€” the libxcb crew β€” and it's all about one lil' request function called xcb_screensaver_set_attributes. pull up a chair, grab a strawberry πŸ“, and let's get into it.


✨ NAME ✨

xcb_screensaver_set_attributes -

and that's it. that's the whole name section. the dash is just… sitting there. no description. iconic in a "the vibes are mysterious" way, honestly πŸ’€


✨ SYNOPSIS ✨

first, you gotta pull in the header, no cap:

#include <xcb/screensaver.h>

πŸŽ€ Request function πŸŽ€

here's the function signature, copy it exactly bestie:

xcb_void_cookie_t xcb_screensaver_set_attributes(xcb_connection_t *conn,
       xcb_drawable_t drawable, int16_t x, int16_t y, uint16_t width,
       uint16_t height, uint16_t border_width, uint8_t _class,
       uint8_t depth, xcb_visualid_t visual, uint32_t value_mask, const
       void *value_list);

look at all those arguments. it's giving "we have so much to talk about" 🌸


✨ REQUEST ARGUMENTS ✨

so here's every single thing you can hand this function, and what the docs say about each one. spoiler: the docs say basically nothing, and honestly? that's the tea. πŸ«–

  • conn β€” the XCB connection to X11. your lil' hotline to the X server, the main character of the whole operation πŸ‘‘
  • drawable β€” TODO: NOT YET DOCUMENTED. 😭
  • x β€” TODO: NOT YET DOCUMENTED. 😭
  • y β€” TODO: NOT YET DOCUMENTED. 😭
  • width β€” TODO: NOT YET DOCUMENTED. 😭
  • height β€” TODO: NOT YET DOCUMENTED. 😭
  • border_width β€” TODO: NOT YET DOCUMENTED. 😭
  • _class β€” TODO: NOT YET DOCUMENTED. 😭
  • depth β€” TODO: NOT YET DOCUMENTED. 😭
  • visual β€” TODO: NOT YET DOCUMENTED. 😭
  • value_mask β€” TODO: NOT YET DOCUMENTED. 😭
  • value_list β€” TODO: NOT YET DOCUMENTED. 😭

every single one of those TODOs is straight from the original page, i'm not hiding anything from you bestie, the docs just haven't been written yet. it's a whole "coming soon" situation and we respect the suspense πŸ’…


✨ DESCRIPTION ✨

nothing here. the section exists, it's just… empty. a blank canvas. a vibe. 🌈


✨ RETURN VALUE ✨

so this bad boy hands you back an xcb_void_cookie_t. and here's the important part, so listen up:

  • any errors? they do not come back to you right here. you have to deal with them over in the event loop. that's the whole deal with void cookies, bestie πŸͺ
  • if you'd rather catch errors immediately with xcb_request_check, then use xcb_screensaver_set_attributes_checked instead. that's your checked twin πŸ‘―

and if you want the full lore on how request handling works, go read xcb-requests(3). fr fr, it explains it better than i ever could.


✨ ERRORS ✨

good news, gorgeous: this request does never generate any errors. zero. none. not a single one. we love a low-drama function 😌✨


✨ SEE ALSO ✨

also empty. no references, no cross-links, just vibes. πŸ¦‹


✨ AUTHOR ✨

generated from screensaver.xml. if you spot something wrong or wanna make it better, hit up xcb@lists.freedesktop.org with your corrections and improvements. the group chat is always open πŸ’Œ


heads up bestie: this page is pretty much a skeleton β€” all those TODO: NOT YET DOCUMENTED. lines and the empty NAME, DESCRIPTION and SEE ALSO sections are exactly how it comes. i'm not gatekeeping, i'm just keeping it 100. πŸ™ˆ

okay that's the whole page!! this beauty ships with X Version 11, libxcb 1.17.0, and the header up top is xcb_screensaver_set_attributes(3) from the XCB Requests manual. mwah, go set some attributes, you've got this πŸ’–πŸŽ€βœ¨