4 * i3 - an improved dynamic tiling window manager
6 * © 2009 Michael Stapelberg and contributors
8 * See file LICENSE for license information.
10 * xcb.c: Helper functions for easier usage of XCB
23 TAILQ_HEAD(cached_fonts_head, Font) cached_fonts = TAILQ_HEAD_INITIALIZER(cached_fonts);
26 * Loads a font for usage, getting its height. This function is used very often, so it
30 i3Font *load_font(xcb_connection_t *connection, const char *pattern) {
31 /* Check if we got the font cached */
33 TAILQ_FOREACH(font, &cached_fonts, fonts)
34 if (strcmp(font->pattern, pattern) == 0)
37 i3Font *new = smalloc(sizeof(i3Font));
38 xcb_void_cookie_t font_cookie;
39 xcb_list_fonts_with_info_cookie_t info_cookie;
41 /* Send all our requests first */
42 new->id = xcb_generate_id(connection);
43 font_cookie = xcb_open_font_checked(connection, new->id, strlen(pattern), pattern);
44 info_cookie = xcb_list_fonts_with_info(connection, 1, strlen(pattern), pattern);
46 check_error(connection, font_cookie, "Could not open font");
48 /* Get information (height/name) for this font */
49 xcb_list_fonts_with_info_reply_t *reply = xcb_list_fonts_with_info_reply(connection, info_cookie, NULL);
50 exit_if_null(reply, "Could not load font \"%s\"\n", pattern);
52 if (asprintf(&(new->name), "%.*s", xcb_list_fonts_with_info_name_length(reply),
53 xcb_list_fonts_with_info_name(reply)) == -1)
54 die("asprintf() failed\n");
55 new->pattern = sstrdup(pattern);
56 new->height = reply->font_ascent + reply->font_descent;
58 /* Insert into cache */
59 TAILQ_INSERT_TAIL(&cached_fonts, new, fonts);
65 * Returns the colorpixel to use for the given hex color (think of HTML).
67 * The hex_color has to start with #, for example #FF00FF.
69 * The client argument is optional. If it is given, the colorpixel will be cached.
71 * NOTE that get_colorpixel() does _NOT_ check the given color code for validity.
72 * This has to be done by the caller.
75 uint32_t get_colorpixel(xcb_connection_t *conn, Client *client, xcb_window_t window, char *hex) {
76 /* Lookup this colorpixel in the cache if a client was specified */
78 struct Colorpixel *pixel;
79 SLIST_FOREACH(pixel, &(client->colorpixels), colorpixels)
80 if (strcmp(pixel->hex, hex) == 0)
83 #define RGB_8_TO_16(i) (65535 * ((i) & 0xFF) / 255)
84 char strgroups[3][3] = {{hex[1], hex[2], '\0'},
85 {hex[3], hex[4], '\0'},
86 {hex[5], hex[6], '\0'}};
87 int rgb16[3] = {RGB_8_TO_16(strtol(strgroups[0], NULL, 16)),
88 RGB_8_TO_16(strtol(strgroups[1], NULL, 16)),
89 RGB_8_TO_16(strtol(strgroups[2], NULL, 16))};
91 xcb_screen_t *root_screen = xcb_setup_roots_iterator(xcb_get_setup(conn)).data;
93 xcb_colormap_t colormap_id = xcb_generate_id(conn);
94 xcb_void_cookie_t cookie = xcb_create_colormap_checked(conn, XCB_COLORMAP_ALLOC_NONE,
95 colormap_id, window, root_screen->root_visual);
96 check_error(conn, cookie, "Could not create colormap");
97 xcb_alloc_color_reply_t *reply = xcb_alloc_color_reply(conn,
98 xcb_alloc_color(conn, colormap_id, rgb16[0], rgb16[1], rgb16[2]), NULL);
101 printf("Could not allocate color\n");
105 uint32_t pixel = reply->pixel;
107 xcb_free_colormap(conn, colormap_id);
109 /* Store the result in the cache if a client was specified */
110 if (client != NULL) {
111 struct Colorpixel *cache_pixel = scalloc(sizeof(struct Colorpixel));
112 cache_pixel->hex = sstrdup(hex);
113 cache_pixel->pixel = pixel;
115 SLIST_INSERT_HEAD(&(client->colorpixels), cache_pixel, colorpixels);
122 * Convenience wrapper around xcb_create_window which takes care of depth, generating an ID and checking
126 xcb_window_t create_window(xcb_connection_t *conn, Rect dims, uint16_t window_class, uint16_t cursor,
127 uint32_t mask, uint32_t *values) {
128 xcb_window_t root = xcb_setup_roots_iterator(xcb_get_setup(conn)).data->root;
129 xcb_window_t result = xcb_generate_id(conn);
130 xcb_cursor_t cursor_id = xcb_generate_id(conn);
131 xcb_void_cookie_t cookie;
133 /* If the window class is XCB_WINDOW_CLASS_INPUT_ONLY, depth has to be 0 */
134 uint16_t depth = (window_class == XCB_WINDOW_CLASS_INPUT_ONLY ? 0 : XCB_COPY_FROM_PARENT);
136 /* Use the default cursor (left pointer) */
138 i3Font *cursor_font = load_font(conn, "cursor");
139 xcb_create_glyph_cursor(conn, cursor_id, cursor_font->id, cursor_font->id,
140 XCB_CURSOR_LEFT_PTR, XCB_CURSOR_LEFT_PTR + 1,
141 0, 0, 0, 65535, 65535, 65535);
144 cookie = xcb_create_window_checked(conn,
146 result, /* the window id */
147 root, /* parent == root */
148 dims.x, dims.y, dims.width, dims.height, /* dimensions */
149 0, /* border = 0, we draw our own */
151 XCB_WINDOW_CLASS_COPY_FROM_PARENT, /* copy visual from parent */
154 check_error(conn, cookie, "Could not create window");
157 cookie = xcb_change_window_attributes_checked(conn, result, XCB_CW_CURSOR, &cursor_id);
158 check_error(conn, cookie, "Could not change window attributes");
161 /* Map the window (= make it visible) */
162 xcb_map_window(conn, result);
168 * Changes a single value in the graphic context (so one doesn’t have to define an array of values)
171 void xcb_change_gc_single(xcb_connection_t *conn, xcb_gcontext_t gc, uint32_t mask, uint32_t value) {
172 xcb_change_gc(conn, gc, mask, &value);
176 * Draws a line from x,y to to_x,to_y using the given color
179 void xcb_draw_line(xcb_connection_t *conn, xcb_drawable_t drawable, xcb_gcontext_t gc,
180 uint32_t colorpixel, uint32_t x, uint32_t y, uint32_t to_x, uint32_t to_y) {
181 xcb_change_gc_single(conn, gc, XCB_GC_FOREGROUND, colorpixel);
182 xcb_point_t points[] = {{x, y}, {to_x, to_y}};
183 xcb_poly_line(conn, XCB_COORD_MODE_ORIGIN, drawable, gc, 2, points);
187 * Draws a rectangle from x,y with width,height using the given color
190 void xcb_draw_rect(xcb_connection_t *connection, xcb_drawable_t drawable, xcb_gcontext_t gc,
191 uint32_t colorpixel, uint32_t x, uint32_t y, uint32_t width, uint32_t height) {
192 xcb_change_gc_single(connection, gc, XCB_GC_FOREGROUND, colorpixel);
193 xcb_rectangle_t rect = {x, y, width, height};
194 xcb_poly_fill_rectangle(connection, drawable, gc, 1, &rect);