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 (STARTS_WITH(ws->name, "__"))
31  continue;
32 
33  if (ws == focused_ws) {
34  xcb_change_property(conn, XCB_PROP_MODE_REPLACE, root,
35  A__NET_CURRENT_DESKTOP, XCB_ATOM_CARDINAL, 32, 1, &idx);
36  return;
37  }
38  ++idx;
39  }
40  }
41 }
42 
43 /*
44  * Updates _NET_ACTIVE_WINDOW with the currently focused window.
45  *
46  * EWMH: The window ID of the currently active window or None if no window has
47  * the focus.
48  *
49  */
50 void ewmh_update_active_window(xcb_window_t window) {
51  xcb_change_property(conn, XCB_PROP_MODE_REPLACE, root,
52  A__NET_ACTIVE_WINDOW, XCB_ATOM_WINDOW, 32, 1, &window);
53 }
54 
55 /*
56  * i3 currently does not support _NET_WORKAREA, because it does not correspond
57  * to i3’s concept of workspaces. See also:
58  * http://bugs.i3wm.org/539
59  * http://bugs.i3wm.org/301
60  * http://bugs.i3wm.org/1038
61  *
62  * We need to actively delete this property because some display managers (e.g.
63  * LightDM) set it.
64  *
65  * EWMH: Contains a geometry for each desktop. These geometries specify an area
66  * that is completely contained within the viewport. Work area SHOULD be used by
67  * desktop applications to place desktop icons appropriately.
68  *
69  */
71  xcb_delete_property(conn, root, A__NET_WORKAREA);
72 }
73 
74 /*
75  * Updates the _NET_CLIENT_LIST hint.
76  *
77  */
78 void ewmh_update_client_list(xcb_window_t *list, int num_windows) {
79  xcb_change_property(
80  conn,
81  XCB_PROP_MODE_REPLACE,
82  root,
83  A__NET_CLIENT_LIST,
85  32,
86  num_windows,
87  list);
88 }
89 
90 /*
91  * Updates the _NET_CLIENT_LIST_STACKING hint.
92  *
93  */
94 void ewmh_update_client_list_stacking(xcb_window_t *stack, int num_windows) {
95  xcb_change_property(
96  conn,
97  XCB_PROP_MODE_REPLACE,
98  root,
99  A__NET_CLIENT_LIST_STACKING,
101  32,
102  num_windows,
103  stack);
104 }
105 
106 /*
107  * Set up the EWMH hints on the root window.
108  *
109  */
110 void ewmh_setup_hints(void) {
111  xcb_atom_t supported_atoms[] = {
112 #define xmacro(atom) A_##atom,
113 #include "atoms.xmacro"
114 #undef xmacro
115  };
116 
117  /* Set up the window manager’s name. According to EWMH, section "Root Window
118  * Properties", to indicate that an EWMH-compliant window manager is
119  * present, a child window has to be created (and kept alive as long as the
120  * window manager is running) which has the _NET_SUPPORTING_WM_CHECK and
121  * _NET_WM_ATOMS. */
122  xcb_window_t child_window = xcb_generate_id(conn);
123  xcb_create_window(
124  conn,
125  XCB_COPY_FROM_PARENT, /* depth */
126  child_window, /* window id */
127  root, /* parent */
128  0, 0, 1, 1, /* dimensions (x, y, w, h) */
129  0, /* border */
130  XCB_WINDOW_CLASS_INPUT_ONLY, /* window class */
131  XCB_COPY_FROM_PARENT, /* visual */
132  0,
133  NULL);
134  xcb_change_property(conn, XCB_PROP_MODE_REPLACE, child_window, A__NET_SUPPORTING_WM_CHECK, XCB_ATOM_WINDOW, 32, 1, &child_window);
135  xcb_change_property(conn, XCB_PROP_MODE_REPLACE, child_window, A__NET_WM_NAME, A_UTF8_STRING, 8, strlen("i3"), "i3");
136  xcb_change_property(conn, XCB_PROP_MODE_REPLACE, root, A__NET_SUPPORTING_WM_CHECK, XCB_ATOM_WINDOW, 32, 1, &child_window);
137 
138  /* I’m not entirely sure if we need to keep _NET_WM_NAME on root. */
139  xcb_change_property(conn, XCB_PROP_MODE_REPLACE, root, A__NET_WM_NAME, A_UTF8_STRING, 8, strlen("i3"), "i3");
140 
141  xcb_change_property(conn, XCB_PROP_MODE_REPLACE, root, A__NET_SUPPORTED, XCB_ATOM_ATOM, 32, 19, supported_atoms);
142 }
#define STARTS_WITH(string, needle)
Definition: util.h:19
void ewmh_update_client_list_stacking(xcb_window_t *stack, int num_windows)
Updates the _NET_CLIENT_LIST_STACKING hint.
Definition: ewmh.c:94
#define XCB_ATOM_ATOM
Definition: xcb_compat.h:45
xcb_connection_t * conn
Definition: main.c:47
Con * con_get_workspace(Con *con)
Gets the workspace container this node is on.
Definition: con.c:317
void ewmh_update_client_list(xcb_window_t *list, int num_windows)
Updates the _NET_CLIENT_LIST hint.
Definition: ewmh.c:78
static struct stack_entry stack[10]
Con * focused
Definition: tree.c:15
void ewmh_update_workarea(void)
i3 currently does not support _NET_WORKAREA, because it does not correspond to i3’s concept of worksp...
Definition: ewmh.c:70
char * name
Definition: data.h:520
void ewmh_update_current_desktop(void)
Updates _NET_CURRENT_DESKTOP with the current desktop number.
Definition: ewmh.c:21
void ewmh_setup_hints(void)
Set up the EWMH hints on the root window.
Definition: ewmh.c:110
A 'Con' represents everything from the X11 root window down to a single X11 window.
Definition: data.h:479
struct Con * croot
Definition: tree.c:14
xcb_window_t root
Definition: main.c:60
Con * output_get_content(Con *output)
Returns the output container below the given output container.
Definition: output.c:18
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:334
void ewmh_update_active_window(xcb_window_t window)
Updates _NET_ACTIVE_WINDOW with the currently focused window.
Definition: ewmh.c:50
#define XCB_ATOM_WINDOW
Definition: xcb_compat.h:40
#define XCB_ATOM_CARDINAL
Definition: xcb_compat.h:39