xcb_xv_put_image(3)

💖 xcb_xv_put_image — the XCB request page, bestie edition 💖

okay so real talk: this is the manual page for xcb_xv_put_image from libxcb (that's the XCB Requests family, X Version 11 energy). Strap in, it's a whole vibe. ✨

---

🌸 NAME 🌸

xcb_xv_put_image — and honestly? The original page gives you a dash and nothing else. The description slot is just sitting there empty, being mysterious. Iconic of it, honestly. 🎀

---

✨ SYNOPSIS ✨

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

#include <xcb/xv.h>

🦋 Request function 🦋

Here's the whole entire signature, character for character, because we do NOT freestyle function prototypes in this house:

xcb_void_cookie_t xcb_xv_put_image(xcb_connection_t *conn,
       xcb_xv_port_t port, xcb_drawable_t drawable, xcb_gcontext_t gc,
       uint32_t id, int16_t src_x, int16_t src_y, uint16_t src_w,
       uint16_t src_h, int16_t drw_x, int16_t drw_y, uint16_t drw_w,
       uint16_t drw_h, uint16_t width, uint16_t height,
       uint32_t data_len, const uint8_t *data);

Look at all those arguments. Seventeen of them. She's long, she's committed, she knows what she wants. 💅

---

🎀 REQUEST ARGUMENTS 🎀

Okay so here's the thing, and I need you to be seated for this one: every single one of these arguments says TODO: NOT YET DOCUMENTED. Like. All of them. Every last one. The docs said "we'll get to it" and then did not get to it. 😭

So here's the full roster, faithfully reproduced, vibes and all:

• conn — the XCB connection to X11. She's the one who actually knows people. 🫶
• port — TODO: NOT YET DOCUMENTED.
• drawable — TODO: NOT YET DOCUMENTED.
• gc — TODO: NOT YET DOCUMENTED.
• id — TODO: NOT YET DOCUMENTED.
• src_x — TODO: NOT YET DOCUMENTED.
• src_y — TODO: NOT YET DOCUMENTED.
• src_w — TODO: NOT YET DOCUMENTED.
• src_h — TODO: NOT YET DOCUMENTED.
• drw_x — TODO: NOT YET DOCUMENTED.
• drw_y — TODO: NOT YET DOCUMENTED.
• drw_w — TODO: NOT YET DOCUMENTED.
• drw_h — TODO: NOT YET DOCUMENTED.
• width — TODO: NOT YET DOCUMENTED.
• height — TODO: NOT YET DOCUMENTED.
• data_len — TODO: NOT YET DOCUMENTED.
• data — TODO: NOT YET DOCUMENTED.

Sixteen mystery arguments and one conn who's carrying the entire narrative. Not me side-eyeing the documentation team. 🙈

---

💜 DESCRIPTION 💜

So… the DESCRIPTION section? It's empty. Not "short." Not "brief." Empty. The original page just goes straight from the heading to the next section like nothing happened. The audacity. The confidence. She's giving minimalism, she's giving "I said what I said." ✨

So like, technically there's nothing to tell you here that the original didn't already not-tell you. We move. 🦋

---

🌈 RETURN VALUE 🌈

She hands you back an xcb_void_cookie_t. That's the whole return situation. 👑

And listen — because it's a void cookie, any errors are NOT gonna jump out at you right here. You have to go handle them in the event loop, bestie. That's just how it is. 😭

BUT. If you're the type who wants to deal with errors immediately, face to face, no games — use xcb_xv_put_image_checked with xcb_request_check instead. That's the direct line. See xcb-requests(3) for the whole breakdown, iykyk. 💅

---

🔥 ERRORS 🔥

This request never generates any errors. Zero. None. Nada. Clean slate, no drama, no notes. ✨

---

🧚 SEE ALSO 🧚

literally nothing here — the original page leaves this section completely empty. No references, no cross-links, no crumbs. Just a heading and then silence. We respect it, we don't understand it, but we respect it. 💀

---

👑 AUTHOR 👑

Generated from xv.xml. Contact xcb@lists.freedesktop.org for corrections and improvements — that's the official address for "hey bestie, this is wrong" energy. 🫶

---

and that's the whole page, fr fr. this one came to you from X Version 11 and libxcb 1.17.0 — go forth, pass those seventeen arguments, and remember: errors go in the event loop unless you call the _checked version. mwah. 💖✨🎀