i3
ewmh.c
Go to the documentation of this file.
1 #undef I3__FILE__
2 #define I3__FILE__ "ewmh.c"
3 /*
4  * vim:ts=4:sw=4:expandtab
5  *
6  * i3 - an improved dynamic tiling window manager
7  * © 2009-2011 Michael Stapelberg and contributors (see also: LICENSE)
8  *
9  * ewmh.c: Get/set certain EWMH properties easily.
10  *
11  */
12 #include "all.h"
13 
14 /*
15  * Updates _NET_CURRENT_DESKTOP with the current desktop number.
16  *
17  * EWMH: The index of the current desktop. This is always an integer between 0
18  * and _NET_NUMBER_OF_DESKTOPS - 1.
19  *
20  */
22  Con *focused_ws = con_get_workspace(focused);
23  Con *output;
24  uint32_t idx = 0;
25  /* We count to get the index of this workspace because named workspaces
26  * don’t have the ->num property */
27  TAILQ_FOREACH(output, &(croot->nodes_head), nodes) {
28  Con *ws;
29  TAILQ_FOREACH(ws, &(output_get_content(output)->nodes_head), nodes) {
30  if (ws == focused_ws) {
31  xcb_change_property(conn, XCB_PROP_MODE_REPLACE, root,
32  A__NET_CURRENT_DESKTOP, XCB_ATOM_CARDINAL, 32, 1, &idx);
33  return;
34  }
35  ++idx;
36  }
37  }
38 }
39 
40 /*
41  * Updates _NET_ACTIVE_WINDOW with the currently focused window.
42  *
43  * EWMH: The window ID of the currently active window or None if no window has
44  * the focus.
45  *
46  */
47 void ewmh_update_active_window(xcb_window_t window) {
48  xcb_change_property(conn, XCB_PROP_MODE_REPLACE, root,
49  A__NET_ACTIVE_WINDOW, XCB_ATOM_WINDOW, 32, 1, &window);
50 }
51 
52 /*
53  * i3 currently does not support _NET_WORKAREA, because it does not correspond
54  * to i3’s concept of workspaces. See also:
55  * http://bugs.i3wm.org/539
56  * http://bugs.i3wm.org/301
57  * http://bugs.i3wm.org/1038
58  *
59  * We need to actively delete this property because some display managers (e.g.
60  * LightDM) set it.
61  *
62  * EWMH: Contains a geometry for each desktop. These geometries specify an area
63  * that is completely contained within the viewport. Work area SHOULD be used by
64  * desktop applications to place desktop icons appropriately.
65  *
66  */
68  xcb_delete_property(conn, root, A__NET_WORKAREA);
69 }
70 
71 /*
72  * Updates the _NET_CLIENT_LIST_STACKING hint.
73  *
74  */
75 void ewmh_update_client_list_stacking(xcb_window_t *stack, int num_windows) {
76  xcb_change_property(
77  conn,
78  XCB_PROP_MODE_REPLACE,
79  root,
80  A__NET_CLIENT_LIST_STACKING,
82  32,
83  num_windows,
84  stack);
85 }
86 
87 /*
88  * Set up the EWMH hints on the root window.
89  *
90  */
91 void ewmh_setup_hints(void) {
92  xcb_atom_t supported_atoms[] = {
93 #define xmacro(atom) A_ ## atom,
94 #include "atoms.xmacro"
95 #undef xmacro
96  };
97 
98  /* Set up the window manager’s name. According to EWMH, section "Root Window
99  * Properties", to indicate that an EWMH-compliant window manager is
100  * present, a child window has to be created (and kept alive as long as the
101  * window manager is running) which has the _NET_SUPPORTING_WM_CHECK and
102  * _NET_WM_ATOMS. */
103  xcb_window_t child_window = xcb_generate_id(conn);
104  xcb_create_window(
105  conn,
106  XCB_COPY_FROM_PARENT, /* depth */
107  child_window, /* window id */
108  root, /* parent */
109  0, 0, 1, 1, /* dimensions (x, y, w, h) */
110  0, /* border */
111  XCB_WINDOW_CLASS_INPUT_ONLY, /* window class */
112  XCB_COPY_FROM_PARENT, /* visual */
113  0,
114  NULL);
115  xcb_change_property(conn, XCB_PROP_MODE_REPLACE, child_window, A__NET_SUPPORTING_WM_CHECK, XCB_ATOM_WINDOW, 32, 1, &child_window);
116  xcb_change_property(conn, XCB_PROP_MODE_REPLACE, child_window, A__NET_WM_NAME, A_UTF8_STRING, 8, strlen("i3"), "i3");
117  xcb_change_property(conn, XCB_PROP_MODE_REPLACE, root, A__NET_SUPPORTING_WM_CHECK, XCB_ATOM_WINDOW, 32, 1, &child_window);
118 
119  /* I’m not entirely sure if we need to keep _NET_WM_NAME on root. */
120  xcb_change_property(conn, XCB_PROP_MODE_REPLACE, root, A__NET_WM_NAME, A_UTF8_STRING, 8, strlen("i3"), "i3");
121 
122  xcb_change_property(conn, XCB_PROP_MODE_REPLACE, root, A__NET_SUPPORTED, XCB_ATOM_ATOM, 32, 18, supported_atoms);
123 }