xcb_input_xi_query_pointer(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_input_xi_query_pointer πŸ’–

okay bestie, welcome to the manual page for xcb_input_xi_query_pointer, straight outta XCB Requests ✨ this is the one that asks the X server "hey girl, where's the pointer at tho?" πŸ¦‹


✨ NAME ✨

xcb_input_xi_query_pointer β€” no description yet, the original page literally leaves this blank πŸ’€


πŸŽ€ SYNOPSIS πŸŽ€

#include <xcb/xinput.h>

🌸 Request function 🌸

xcb_input_xi_query_pointer_cookie_t
       xcb_input_xi_query_pointer(xcb_connection_t *conn,
       xcb_window_t window, xcb_input_device_id_t deviceid);

πŸ¦‹ Reply datastructure πŸ¦‹

typedef struct xcb_input_xi_query_pointer_reply_t {
    uint8_t                   response_type;
    uint8_t                   pad0;
    uint16_t                  sequence;
    uint32_t                  length;
    xcb_window_t              root;
    xcb_window_t              child;
    xcb_input_fp1616_t        root_x;
    xcb_input_fp1616_t        root_y;
    xcb_input_fp1616_t        win_x;
    xcb_input_fp1616_t        win_y;
    uint8_t                   same_screen;
    uint8_t                   pad1;
    uint16_t                  buttons_len;
    xcb_input_modifier_info_t mods;
    xcb_input_group_info_t    group;
} xcb_input_xi_query_pointer_reply_t;

πŸ’… Reply function πŸ’…

xcb_input_xi_query_pointer_reply_t
       *xcb_input_xi_query_pointer_reply(xcb_connection_t *conn,
       xcb_input_xi_query_pointer_cookie_t cookie,
       xcb_generic_error_t **e);

🌈 Reply accessors 🌈

uint32_t *xcb_input_xi_query_pointer_buttons(const
       xcb_input_xi_query_pointer_request_t *reply);

int xcb_input_xi_query_pointer_buttons_length(const
       xcb_input_xi_query_pointer_reply_t *reply);

xcb_generic_iterator_t xcb_input_xi_query_pointer_buttons_end(const
       xcb_input_xi_query_pointer_reply_t *reply);
yes bestie, that first accessor really does say xcb_input_xi_query_pointer_request_t while the other two say xcb_input_xi_query_pointer_reply_t β€” i'm just reporting what's on the page, no editing, periodt πŸ’…

πŸ’œ REQUEST ARGUMENTS πŸ’œ

  • conn β€” your XCB connection to X11 obvs, the lil string connecting you to the server 🧡
  • window β€” TODO: NOT YET DOCUMENTED. πŸ™ˆ yeah girl, they left this one blank
  • deviceid β€” TODO: NOT YET DOCUMENTED. πŸ’€ also blank, iconic of them

🌟 REPLY FIELDS 🌟

  • response_type β€” the type of this reply, and in this case it's XCB_INPUT_XI_QUERY_POINTER. this field is also chillin' in the xcb_generic_reply_t, so you can use it to tell replies apart from each other πŸ‘€
  • sequence β€” the sequence number of the last request processed by the X11 server πŸ”’
  • length β€” the length of the reply, in words (and a word is 4 bytes, fyi)
  • root β€” TODO: NOT YET DOCUMENTED. 😭
  • child β€” TODO: NOT YET DOCUMENTED. 😭
  • root_x β€” TODO: NOT YET DOCUMENTED. 😭
  • root_y β€” TODO: NOT YET DOCUMENTED. 😭
  • win_x β€” TODO: NOT YET DOCUMENTED. 😭
  • win_y β€” TODO: NOT YET DOCUMENTED. 😭
  • same_screen β€” TODO: NOT YET DOCUMENTED. 😭
  • buttons_len β€” TODO: NOT YET DOCUMENTED. 😭
  • mods β€” TODO: NOT YET DOCUMENTED. 😭
  • group β€” TODO: NOT YET DOCUMENTED. 😭

🫢 DESCRIPTION 🫢

literally nothing here bestie, the DESCRIPTION section is empty. we move πŸšΆβ™€οΈ


⭐ RETURN VALUE ⭐

Returns an xcb_input_xi_query_pointer_cookie_t πŸͺ and heads up: errors have to be handled when you call the reply function xcb_input_xi_query_pointer_reply.

if you'd rather handle errors in the event loop instead, use xcb_input_xi_query_pointer_unchecked ✨ see xcb-requests(3) for details, iykyk.


πŸ”₯ ERRORS πŸ”₯

This request does never generate any errors. not one. zero. clean sheet. slay πŸ’…


πŸ‘‘ SEE ALSO πŸ‘‘

(this section is empty in the original β€” no references, no friends, just vibes)


🌸 AUTHOR 🌸

Generated from xinput.xml. Contact xcb@lists.freedesktop.org for corrections and improvements πŸ“§


and that's the whole page, bestie!! this one came to you from X Version 11 and libxcb 1.17.0 πŸ’– thanks for reading the docs with me, go forth and query those pointers, mwah πŸŽ€βœ¨πŸ¦‹