common/xutil.h

   1 /*
   2  * common/xutil.h - X-related useful functions header
   3  *
   4  * Copyright © 2007-2009 Julien Danjou <julien@danjou.info>
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License along
  17  * with this program; if not, write to the Free Software Foundation, Inc.,
  18  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  19  *
  20  */
  21
  22 #ifndef AWESOME_COMMON_XUTIL_H
  23 #define AWESOME_COMMON_XUTIL_H
  24
  25 #include <xcb/xcb.h>
  26 #include <xcb/xcb_keysyms.h>
  27 #include <xcb/xcb_aux.h>
  28 #include <xcb/xcb_event.h>
  29
  30 #include "array.h"
  31
  32 bool xutil_text_prop_get(xcb_connection_t *, xcb_window_t, xcb_atom_t, char **, ssize_t *);
  33
  34 void xutil_lock_mask_get(xcb_connection_t *, xcb_get_modifier_mapping_cookie_t,
  35                          xcb_key_symbols_t *,
  36                          uint16_t *, uint16_t *, uint16_t *, uint16_t *);
  37
  38 /** Set the same handler for all errors */
  39 void xutil_error_handler_catch_all_set(xcb_event_handlers_t *,
  40                                        xcb_generic_error_handler_t, void *);
  41
  42 uint16_t xutil_key_mask_fromstr(const char *, size_t);
  43 void xutil_key_mask_tostr(uint16_t, const char **, size_t *);
  44
  45 /* Get the informations about the screen.
  46  * \param c X connection.
  47  * \param screen Screen number.
  48  * \return Screen informations (must not be freed!).
  49  */
  50 static inline xcb_screen_t *
  51 xutil_screen_get(xcb_connection_t *c, int screen)
  52 {
  53     xcb_screen_t *s;
  54
  55     if(xcb_connection_has_error(c))
  56         fatal("X connection invalid");
  57
  58     s = xcb_aux_get_screen(c, screen);
  59
  60     assert(s);
  61
  62     return s;
  63 }
  64
  65 int xutil_root2screen(xcb_connection_t *, xcb_window_t);
  66
  67 #endif
  68 // vim: filetype=c:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=80