git.demorecorder.com Git - free-sw/xcb/libxcb/blob - src/xcbext.h

   1 /*
   2  * Copyright (C) 2001-2004 Bart Massey and Jamey Sharp.
   3  * All Rights Reserved.
   4  *
   5  * Permission is hereby granted, free of charge, to any person obtaining a
   6  * copy of this software and associated documentation files (the "Software"),
   7  * to deal in the Software without restriction, including without limitation
   8  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   9  * and/or sell copies of the Software, and to permit persons to whom the
  10  * Software is furnished to do so, subject to the following conditions:
  11  *
  12  * The above copyright notice and this permission notice shall be included in
  13  * all copies or substantial portions of the Software.
  14  *
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  18  * AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
  19  * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  20  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  21  *
  22  * Except as contained in this notice, the names of the authors or their
  23  * institutions shall not be used in advertising or otherwise to promote the
  24  * sale, use or other dealings in this Software without prior written
  25  * authorization from the authors.
  26  */
  27
  28 #ifndef __XCBEXT_H
  29 #define __XCBEXT_H
  30
  31 #include "xcb.h"
  32
  33 #ifdef __cplusplus
  34 extern "C" {
  35 #endif
  36
  37 /* xcb_ext.c */
  38
  39 struct xcb_extension_t {
  40     const char *name;
  41     int global_id;
  42 };
  43
  44
  45 /* xcb_out.c */
  46
  47 typedef struct {
  48     size_t count;
  49     xcb_extension_t *ext;
  50     uint8_t opcode;
  51     uint8_t isvoid;
  52 } xcb_protocol_request_t;
  53
  54 enum xcb_send_request_flags_t {
  55     XCB_REQUEST_CHECKED = 1 << 0,
  56     XCB_REQUEST_RAW = 1 << 1,
  57     XCB_REQUEST_DISCARD_REPLY = 1 << 2,
  58     XCB_REQUEST_REPLY_FDS = 1 << 3
  59 };
  60
  61 unsigned int xcb_send_request(xcb_connection_t *c, int flags, struct iovec *vector, const xcb_protocol_request_t *request);
  62
  63 void xcb_send_fd(xcb_connection_t *c, int fd);
  64
  65 /* xcb_take_socket allows external code to ask XCB for permission to
  66  * take over the write side of the socket and send raw data with
  67  * xcb_writev. xcb_take_socket provides the sequence number of the last
  68  * request XCB sent. The caller of xcb_take_socket must supply a
  69  * callback which XCB can call when it wants the write side of the
  70  * socket back to make a request. This callback synchronizes with the
  71  * external socket owner and flushes any output queues if appropriate.
  72  * The callback might be called from different threads at the same time.
  73  * If you are sending requests which won't cause a reply, please note the
  74  * comment for xcb_writev which explains some sequence number wrap issues.
  75  * */
  76 int xcb_take_socket(xcb_connection_t *c, void (*return_socket)(void *closure), void *closure, int flags, uint64_t *sent);
  77
  78 /* You must own the write-side of the socket (you've called
  79  * xcb_take_socket, and haven't returned from return_socket yet) to call
  80  * xcb_writev. Also, the iovec must have at least 1 byte of data in it.
  81  * You have to make sure that xcb can detect sequence number wraps correctly.
  82  * This means that the first request you send after xcb_take_socket must cause a
  83  * reply (e.g. just insert a GetInputFocus request). After every (1 << 16) - 1
  84  * requests without a reply, you have to insert a request which will cause a
  85  * reply. You can again use GetInputFocus for this. You do not have to wait for
  86  * any of the GetInputFocus replies, but can instead handle them via
  87  * xcb_discard_reply(). */
  88 int xcb_writev(xcb_connection_t *c, struct iovec *vector, int count, uint64_t requests);
  89
  90
  91 /* xcb_in.c */
  92
  93 void *xcb_wait_for_reply(xcb_connection_t *c, unsigned int request, xcb_generic_error_t **e);
  94 int xcb_poll_for_reply(xcb_connection_t *c, unsigned int request, void **reply, xcb_generic_error_t **error);
  95 int *xcb_get_reply_fds(xcb_connection_t *c, void *reply, size_t replylen);
  96
  97
  98 /* xcb_util.c */
  99
 100 int xcb_popcount(uint32_t mask);
 101 int xcb_sumof(uint8_t *list, int len);
 102
 103 #ifdef __cplusplus
 104 }
 105 #endif
 106
 107 #endif