xcb_xv_list_image_formats(3)

💖 xcb_xv_list_image_formats — bestie, it's an XCB Requests page (section 3) 💖

okay so picture this: you're deep in the X11 lore, you're vibing with Xv (that's the X Video extension, iykyk), and you wanna know which image formats this port is even serving. That's literally this request. She's giving "tell me your formats, king." ✨

No cap, the NAME section is just... a dash. Empty. Iconic of her honestly. 🎀

---

✨ SYNOPSIS ✨

First things first, you gotta let her in:

#include <xcb/xv.h>

🦋 Request function

xcb_xv_list_image_formats_cookie_t
       xcb_xv_list_image_formats(xcb_connection_t *conn,
       xcb_xv_port_t port);

🦋 Reply datastructure

typedef struct xcb_xv_list_image_formats_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    uint32_t num_formats;
    uint8_t  pad1[20];
} xcb_xv_list_image_formats_reply_t;

🦋 Reply function

xcb_xv_list_image_formats_reply_t
       *xcb_xv_list_image_formats_reply(xcb_connection_t *conn,
       xcb_xv_list_image_formats_cookie_t cookie,
       xcb_generic_error_t **e);

🦋 Reply accessors

xcb_xv_image_format_info_t *xcb_xv_list_image_formats_format(const
       xcb_xv_list_image_formats_request_t *reply);

int xcb_xv_list_image_formats_format_length(const
       xcb_xv_list_image_formats_reply_t *reply);

xcb_xv_image_format_info_iterator_t
       xcb_xv_list_image_formats_format_iterator(const
       xcb_xv_list_image_formats_reply_t *reply);

---

🌸 REQUEST ARGUMENTS 🌸

• conn — your XCB connection to X11. Your lil hotline to the server, bestie 💅
• port — TODO: NOT YET DOCUMENTED. Yeah girl, she's a mystery. Nobody wrote her up yet 🙈

---

👑 REPLY FIELDS 👑

• response_type — the type of this reply, and in this case it's XCB_XV_LIST_IMAGE_FORMATS. Plot twist: this field also lives in the xcb_generic_reply_t, so you can use it to tell your replies apart from each other. Very "which one of y'all is this" energy.
• sequence — the sequence number of the last request the X11 server got around to processing. She's the timeline, fr fr ⭐
• length — how long the reply is, in words (and a word here is 4 bytes, don't forget 🫶)
• num_formats — TODO: NOT YET DOCUMENTED. Also a mystery. We stay humble 💀

---

🧚 DESCRIPTION 🧚

...and that's it. That's the whole section. The DESCRIPTION is empty. She said "no thoughts, head empty" and honestly? Respect. 🌈

---

💜 RETURN VALUE 💜

She hands you back an xcb_xv_list_image_formats_cookie_t. 🍓

Heads up bestie: errors have to be handled when you call the reply function xcb_xv_list_image_formats_reply.

But wait — if you'd rather handle errors in the event loop instead, use xcb_xv_list_image_formats_unchecked. See xcb-requests(3) for the deets. Choose your fighter 💅

---

🔥 ERRORS 🔥

This request does never generate any errors. Not one. Zero. She's an angel, she would never. 😭✨

---

🦋 SEE ALSO 🦋

Nothing here either. Empty. A whole vibe. 🎀

---

💖 AUTHOR 💖

Generated from xv.xml. If you spot something that needs fixing or improving, hit up xcb@lists.freedesktop.org — they're taking corrections, no cap. 📧

---

okay and that's the whole page, bestie!! mwah 💋 This lil masterpiece came to you courtesy of X Version 11, libxcb 1.17.0, and the one and only xcb_xv_list_image_formats(3). Stay slay, go list some formats, and remember: the DESCRIPTION is empty and that's valid 💅💖✨