xcb_xv_query_image_attributes(3)

✨ NAME ✨

xcb_xv_query_image_attributes — bestie it's an XCB request, and the description slot is literally empty, so like… that's the whole name, no cap 💅

It lives in section 3 of the manual (xcb_xv_query_image_attributes(3)), under the XCB Requests umbrella. 🦋

---

🌸 SYNOPSIS 🌸

okay so first things first, you gotta pull in the header:

#include <xcb/xv.h>

💖 Request function

xcb_xv_query_image_attributes_cookie_t
       xcb_xv_query_image_attributes(xcb_connection_t *conn,
       xcb_xv_port_t port, uint32_t id, uint16_t width,
       uint16_t height);

🎀 Reply datastructure

typedef struct xcb_xv_query_image_attributes_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    uint32_t num_planes;
    uint32_t data_size;
    uint16_t width;
    uint16_t height;
    uint8_t  pad1[12];
} xcb_xv_query_image_attributes_reply_t;

🧚 Reply function

xcb_xv_query_image_attributes_reply_t
       *xcb_xv_query_image_attributes_reply(xcb_connection_t *conn,
       xcb_xv_query_image_attributes_cookie_t cookie,
       xcb_generic_error_t **e);

🫶 Reply accessors

uint32_t *xcb_xv_query_image_attributes_pitches(const
       xcb_xv_query_image_attributes_request_t *reply);

int xcb_xv_query_image_attributes_pitches_length(const
       xcb_xv_query_image_attributes_reply_t *reply);

xcb_generic_iterator_t xcb_xv_query_image_attributes_pitches_end(const
       xcb_xv_query_image_attributes_reply_t *reply);

uint32_t *xcb_xv_query_image_attributes_offsets(const
       xcb_xv_query_image_attributes_request_t *reply);

int xcb_xv_query_image_attributes_offsets_length(const
       xcb_xv_query_image_attributes_reply_t *reply);

xcb_generic_iterator_t xcb_xv_query_image_attributes_offsets_end(const
       xcb_xv_query_image_attributes_reply_t *reply);

not me noticing the pitches and offsets accessors take an xcb_xv_query_image_attributes_request_t *reply while their _length and _end besties take the xcb_xv_query_image_attributes_reply_t *reply 👀 that's just how it is, don't touch it, copy it character for character fr fr

---

🔥 REQUEST ARGUMENTS 🔥

• conn — the XCB connection to X11, your lil hotline to the server 💖
• port — TODO: NOT YET DOCUMENTED. yeah bestie the docs simply did not show up to the function 🙈
• id — TODO: NOT YET DOCUMENTED. same vibe, empty slot 😭
• width — TODO: NOT YET DOCUMENTED. nothing here either 💀
• height — TODO: NOT YET DOCUMENTED. and that's the whole list, all mysterious ✨

---

👑 REPLY FIELDS 👑

• response_type — the type of this reply, and in this case it's XCB_XV_QUERY_IMAGE_ATTRIBUTES. this field also lives in the xcb_generic_reply_t, so you can use it to tell your replies apart from each other 🦋
• sequence — the sequence number of the last request processed by the X11 server, lowkey the server's lil timestamp for your request 💅
• length — the length of the reply, in words. and yes a word is 4 bytes, write that down 📝
• num_planes — TODO: NOT YET DOCUMENTED. undocumented, iconic behaviour 🙈
• data_size — TODO: NOT YET DOCUMENTED. also a mystery 🎀
• width — TODO: NOT YET DOCUMENTED. yeah. again. 😭
• height — TODO: NOT YET DOCUMENTED. we love a fully blank field set 🫶

---

🌈 DESCRIPTION 🌈

this section is empty in the original. literally nothing. the description has no description. that's the vibe. 💀

---

⭐ RETURN VALUE ⭐

You get back an xcb_xv_query_image_attributes_cookie_t 🍪 — adorable, I know.

Errors have to be handled when you call the reply function, xcb_xv_query_image_attributes_reply.

And if you'd rather handle errors in the event loop instead? Then use xcb_xv_query_image_attributes_unchecked. see xcb-requests(3) for the deets, bestie 📚

---

💜 ERRORS 💜

This request does never generate any errors. zero. none. clean run, slay ✨

---

🌸 SEE ALSO 🌸

nothing listed here in the original — the section's just vibing with an empty guest list 🙈

---

🦋 AUTHOR 🦋

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

---

and that's the whole page, bestie!! 🎀 this one came from X Version 11, libxcb 1.17.0, and it's xcb_xv_query_image_attributes(3) — go query those image attributes, you absolute main character 👑💖✨