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 #include <xcb/xcb_atom.h>
  30 #include <xcb/xproto.h>
  31
  32 #include "common/array.h"
  33 #include "common/atoms.h"
  34
  35 static inline char *
  36 xutil_get_text_property_from_reply(xcb_get_property_reply_t *reply)
  37 {
  38     if(reply
  39        && (reply->type == XCB_ATOM_STRING
  40            || reply->type == UTF8_STRING
  41            || reply->type == COMPOUND_TEXT)
  42        && reply->format == 8
  43        && xcb_get_property_value_length(reply))
  44     {
  45         /* We need to copy it that way since the string may not be
  46          * NULL-terminated */
  47         int len = xcb_get_property_value_length(reply);
  48         char *value = p_new(char, len + 1);
  49         memcpy(value, xcb_get_property_value(reply), len);
  50         value[len] = '\0';
  51         return value;
  52     }
  53     return NULL;
  54 }
  55
  56 void xutil_lock_mask_get(xcb_connection_t *, xcb_get_modifier_mapping_cookie_t,
  57                          xcb_key_symbols_t *,
  58                          uint16_t *, uint16_t *, uint16_t *, uint16_t *);
  59
  60 uint16_t xutil_key_mask_fromstr(const char *, size_t);
  61 void xutil_key_mask_tostr(uint16_t, const char **, size_t *);
  62
  63 /* Get the informations about the screen.
  64  * \param c X connection.
  65  * \param screen Screen number.
  66  * \return Screen informations (must not be freed!).
  67  */
  68 static inline xcb_screen_t *
  69 xutil_screen_get(xcb_connection_t *c, int screen)
  70 {
  71     xcb_screen_t *s;
  72
  73     if(xcb_connection_has_error(c))
  74         fatal("X connection invalid");
  75
  76     s = xcb_aux_get_screen(c, screen);
  77
  78     assert(s);
  79
  80     return s;
  81 }
  82
  83 int xutil_root2screen(xcb_connection_t *, xcb_window_t);
  84
  85 #endif
  86 // vim: filetype=c:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=80