xcb_create_colormap(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_create_colormap β€” bestie's guide to the XCB requests manual πŸ’–

okay so this is xcb_create_colormap(3) from the XCB Requests crew β€” the whole manpage, no skips, no cap. it's giving "short but mysterious" and honestly? we're gonna walk through every single crumb. ✨


✨ NAME ✨

xcb_create_colormap β€” and that's it, bestie 😭 the description slot is literally empty in the source. no tagline, no subtitle, no nothing. main character energy with zero intro. iconic behavior.


✨ SYNOPSIS ✨

first things first, you gotta bring in the header:

#include <xcb/xproto.h>

πŸŽ€ Request function πŸŽ€

and here's the function itself β€” look at her:

xcb_void_cookie_t xcb_create_colormap(xcb_connection_t *conn,
       uint8_t alloc, xcb_colormap_t mid, xcb_window_t window,
       xcb_visualid_t visual);

yes she returns an xcb_void_cookie_t. yes she's void. we love a queen who gives you a cookie and no actual value πŸ’…


✨ REQUEST ARGUMENTS ✨

let's go through every single one, no skipping, periodt:

  • conn β€” your XCB connection to X11. the whole lifeline, the situationship you can't escape. 🫢
  • alloc β€” one of the following values, and there are exactly two:
    • XCB_COLORMAP_ALLOC_NONE β€” TODO: NOT YET DOCUMENTED. yeah. that's the whole thing. the docs said "we'll get to it" and then never did πŸ™ˆ
    • XCB_COLORMAP_ALLOC_ALL β€” TODO: NOT YET DOCUMENTED. also TODO: NOT YET DOCUMENTED. β€” and listen, there's a second TODO: NOT YET DOCUMENTED. just hanging out after it in the original, unclaimed, unexplained. two whole TODOs. the mystery is not solving itself, bestie 😭
  • mid β€” TODO: NOT YET DOCUMENTED. the placeholder is placeholdering.
  • window β€” TODO: NOT YET DOCUMENTED. same vibe, different argument.
  • visual β€” TODO: NOT YET DOCUMENTED. and that's the last one, all equally undocumented.

✨ DESCRIPTION ✨

nothing. empty. blank. this section has no text in it at all. the void is voiding. we respect her privacy πŸ’–


✨ RETURN VALUE ✨

okay here's actual info, lock in πŸ”₯

Returns an xcb_void_cookie_t. Errors (if any) have to be handled in the event loop.

If you want to handle errors directly with xcb_request_check instead, use xcb_create_colormap_checked. See xcb-requests(3) for details.

so basically: cookie now, consequences later. either you catch your errors in the event loop, or you go the xcb_request_check route with xcb_create_colormap_checked. your choice, your journey, slay ✨


✨ ERRORS ✨

This request does never generate any errors.

read it again. never. zero. none. she is unproblematic in the error department, and honestly? that's the dream 🌸


✨ SEE ALSO ✨

empty. nothing here. no cross-references, no friends, no neighbors. she stands alone πŸ¦‹


✨ AUTHOR ✨

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

like, if you spot something wrong, that's the email. they want your feedback, fr fr πŸ’Œ


and that's the whole page, bestie β€” every option, every argument, every single TODO: NOT YET DOCUMENTED., every section, all of it. we ate and left no crumbs πŸ‘‘

cute little sign-off: this one's from X Version 11, libxcb 1.17.0, and the manpage date stamped alongside it. mwah πŸ’…πŸŽ€