xcb_present_pixmap(3)

💖 xcb_present_pixmap(3) 💖

okay bestie, welcome to the XCB Requests corner of the manual — we're looking at xcb_present_pixmap today and honestly? she's a whole mood. this is the libxcb page for her, and we're gonna walk through it together, no skimming, no skipping, because every single line matters. 🫶

---

✨ NAME ✨

xcb_present_pixmap -

okay so. the name is xcb_present_pixmap. and then there's a dash. and then… nothing. that's not me being lazy, that's literally the whole NAME section — the description after the dash is empty. it's giving mystery. it's giving "she said she'd text back and then didn't." 💀 we move on.

---

✨ SYNOPSIS ✨

first up, the include, because you can't summon her without it:

#include <xcb/present.h>

🎀 Request function 🎀

here's the signature, character for character, don't you dare typo it:

xcb_void_cookie_t xcb_present_pixmap(xcb_connection_t *conn,
       xcb_window_t window, xcb_pixmap_t pixmap, uint32_t serial,
       xcb_xfixes_region_t valid, xcb_xfixes_region_t update,
       int16_t x_off, int16_t y_off, xcb_randr_crtc_t target_crtc,
       xcb_sync_fence_t wait_fence, xcb_sync_fence_t idle_fence,
       uint32_t options, uint64_t target_msc, uint64_t divisor,
       uint64_t remainder, uint32_t notifies_len, const
       xcb_present_notify_t *notifies);

look at all those arguments. she's high maintenance and we respect it. 👑

---

🌸 REQUEST ARGUMENTS 🌸

alright, let's do the roll call. fair warning: a lot of these are marked TODO: NOT YET DOCUMENTED. — and no, i'm not paraphrasing, that's genuinely what the page says for almost every single one of them. i'm not gonna invent lore for them, because making stuff up is not the vibe. 🙈

• conn — the XCB connection to X11. your lil lifeline to the server, bestie.
• window — TODO: NOT YET DOCUMENTED.
• pixmap — TODO: NOT YET DOCUMENTED.
• serial — TODO: NOT YET DOCUMENTED.
• valid — TODO: NOT YET DOCUMENTED.
• update — TODO: NOT YET DOCUMENTED.
• x_off — TODO: NOT YET DOCUMENTED.
• y_off — TODO: NOT YET DOCUMENTED.
• target_crtc — TODO: NOT YET DOCUMENTED.
• wait_fence — TODO: NOT YET DOCUMENTED.
• idle_fence — TODO: NOT YET DOCUMENTED.
• options — TODO: NOT YET DOCUMENTED.
• target_msc — TODO: NOT YET DOCUMENTED.
• divisor — TODO: NOT YET DOCUMENTED.
• remainder — TODO: NOT YET DOCUMENTED.
• notifies_len — TODO: NOT YET DOCUMENTED.
• notifies — TODO: NOT YET DOCUMENTED.

bestie. the way that literally every arg except conn is undocumented?? 😭 the docs said "figure it out" and honestly, that's main character energy of the worst kind.

---

🌈 DESCRIPTION 🌈

…she's empty. like, empty empty. there is no description text on this page. the section heading is there, standing alone, like someone who showed up to the party and said nothing all night. 💅 i can't tell you what this request does beyond what the page itself gives us, and the page gives us… nothing here. periodt.

---

⭐ RETURN VALUE ⭐

okay here's actual info, thank goodness. she returns an xcb_void_cookie_t. 💖

and listen: errors (if any) have to be handled in the event loop. that's the deal. no sneaky synchronous error reporting here.

but if you'd rather handle errors directly with xcb_request_check instead? then you want xcb_present_pixmap_checked, not this one. go check xcb-requests(3) for the deets — that's where all the cookie lore lives. 🍪

---

💀 ERRORS 💀

and now the plot twist of the century:

This request does never generate any errors.

no errors. zero. none. she simply does not miss. ✨ (i'm quoting the page, not being cute — that's literally the sentence.)

---

🦋 SEE ALSO 🦋

…it's empty, bestie. nothing. no cross-references. no lil xcb-whatever(3) links. just vibes and silence. 🧚

---

👑 AUTHOR 👑

generated from present.xml. if you spot something wrong or wanna make it better, hit up xcb@lists.freedesktop.org with corrections and improvements. they're taking notes, fr fr. 🫶

---

and that's the whole page!! you made it, bestie, i'm so proud. 🎀 this one came to you from X Version 11, running libxcb 1.17.0 — that's the source and version, signed, sealed, delivered, with a lil bow on top. mwah. 💖✨💅