2 * vim:ts=4:sw=4:expandtab
4 * i3 - an improved dynamic tiling window manager
5 * © 2009-2010 Michael Stapelberg and contributors (see also: LICENSE)
7 * manage.c: Contains all functions for initially managing new windows
8 * (or existing ones on restart).
15 * Go through all existing windows (if the window manager is restarted) and manage them
18 void manage_existing_windows(xcb_window_t root) {
19 xcb_query_tree_reply_t *reply;
21 xcb_window_t *children;
22 xcb_get_window_attributes_cookie_t *cookies;
24 /* Get the tree of windows whose parent is the root window (= all) */
25 if ((reply = xcb_query_tree_reply(conn, xcb_query_tree(conn, root), 0)) == NULL)
28 len = xcb_query_tree_children_length(reply);
29 cookies = smalloc(len * sizeof(*cookies));
31 /* Request the window attributes for every window */
32 children = xcb_query_tree_children(reply);
33 for (i = 0; i < len; ++i)
34 cookies[i] = xcb_get_window_attributes(conn, children[i]);
36 /* Call manage_window with the attributes for every window */
37 for (i = 0; i < len; ++i)
38 manage_window(children[i], cookies[i], true);
45 * Restores the geometry of each window by reparenting it to the root window
46 * at the position of its frame.
48 * This is to be called *only* before exiting/restarting i3 because of evil
49 * side-effects which are to be expected when continuing to run i3.
52 void restore_geometry() {
53 DLOG("Restoring geometry\n");
56 TAILQ_FOREACH(con, &all_cons, all_cons)
58 DLOG("Re-adding X11 border of %d px\n", con->border_width);
59 con->window_rect.width += (2 * con->border_width);
60 con->window_rect.height += (2 * con->border_width);
61 xcb_set_window_rect(conn, con->window->id, con->window_rect);
62 DLOG("placing window %08x at %d %d\n", con->window->id, con->rect.x, con->rect.y);
63 xcb_reparent_window(conn, con->window->id, root,
64 con->rect.x, con->rect.y);
67 /* Make sure our changes reach the X server, we restart/exit now */
72 * Do some sanity checks and then reparent the window.
75 void manage_window(xcb_window_t window, xcb_get_window_attributes_cookie_t cookie,
76 bool needs_to_be_mapped) {
77 xcb_drawable_t d = { window };
78 xcb_get_geometry_cookie_t geomc;
79 xcb_get_geometry_reply_t *geom;
80 xcb_get_window_attributes_reply_t *attr = 0;
82 DLOG("---> looking at window 0x%08x\n", window);
84 xcb_get_property_cookie_t wm_type_cookie, strut_cookie, state_cookie,
85 utf8_title_cookie, title_cookie,
86 class_cookie, leader_cookie, transient_cookie;
89 geomc = xcb_get_geometry(conn, d);
91 /* Check if the window is mapped (it could be not mapped when intializing and
92 calling manage_window() for every window) */
93 if ((attr = xcb_get_window_attributes_reply(conn, cookie, 0)) == NULL) {
94 DLOG("Could not get attributes\n");
98 if (needs_to_be_mapped && attr->map_state != XCB_MAP_STATE_VIEWABLE) {
99 DLOG("map_state unviewable\n");
103 /* Don’t manage clients with the override_redirect flag */
104 DLOG("override_redirect is %d\n", attr->override_redirect);
105 if (attr->override_redirect)
108 /* Check if the window is already managed */
109 if (con_by_window_id(window) != NULL) {
110 DLOG("already managed (by con %p)\n", con_by_window_id(window));
114 /* Get the initial geometry (position, size, …) */
115 if ((geom = xcb_get_geometry_reply(conn, geomc, 0)) == NULL) {
116 DLOG("could not get geometry\n");
123 /* Set a temporary event mask for the new window, consisting only of
124 * PropertyChange. We need to be notified of PropertyChanges because the
125 * client can change its properties *after* we requested them but *before*
126 * we actually reparented it and have set our final event mask. */
127 mask = XCB_CW_EVENT_MASK;
128 values[0] = XCB_EVENT_MASK_PROPERTY_CHANGE;
129 xcb_change_window_attributes(conn, window, mask, values);
131 #define GET_PROPERTY(atom, len) xcb_get_property_unchecked(conn, false, window, atom, XCB_GET_PROPERTY_TYPE_ANY, 0, len)
133 wm_type_cookie = GET_PROPERTY(A__NET_WM_WINDOW_TYPE, UINT32_MAX);
134 strut_cookie = GET_PROPERTY(A__NET_WM_STRUT_PARTIAL, UINT32_MAX);
135 state_cookie = GET_PROPERTY(A__NET_WM_STATE, UINT32_MAX);
136 utf8_title_cookie = GET_PROPERTY(A__NET_WM_NAME, 128);
137 leader_cookie = GET_PROPERTY(A_WM_CLIENT_LEADER, UINT32_MAX);
138 transient_cookie = GET_PROPERTY(A_WM_TRANSIENT_FOR, UINT32_MAX);
139 title_cookie = GET_PROPERTY(A_WM_NAME, 128);
140 class_cookie = GET_PROPERTY(A_WM_CLASS, 128);
141 /* TODO: also get wm_normal_hints here. implement after we got rid of xcb-event */
143 DLOG("reparenting!\n");
145 i3Window *cwindow = scalloc(sizeof(i3Window));
146 cwindow->id = window;
148 /* We need to grab the mouse buttons for click to focus */
149 xcb_grab_button(conn, false, window, XCB_EVENT_MASK_BUTTON_PRESS,
150 XCB_GRAB_MODE_SYNC, XCB_GRAB_MODE_ASYNC, root, XCB_NONE,
151 1 /* left mouse button */,
152 XCB_BUTTON_MASK_ANY /* don’t filter for any modifiers */);
154 xcb_grab_button(conn, false, window, XCB_EVENT_MASK_BUTTON_PRESS,
155 XCB_GRAB_MODE_SYNC, XCB_GRAB_MODE_ASYNC, root, XCB_NONE,
156 3 /* right mouse button */,
157 XCB_BUTTON_MASK_ANY /* don’t filter for any modifiers */);
160 /* update as much information as possible so far (some replies may be NULL) */
161 window_update_class(cwindow, xcb_get_property_reply(conn, class_cookie, NULL));
162 window_update_name_legacy(cwindow, xcb_get_property_reply(conn, title_cookie, NULL));
163 window_update_name(cwindow, xcb_get_property_reply(conn, utf8_title_cookie, NULL));
164 window_update_leader(cwindow, xcb_get_property_reply(conn, leader_cookie, NULL));
165 window_update_transient_for(cwindow, xcb_get_property_reply(conn, transient_cookie, NULL));
166 window_update_strut_partial(cwindow, xcb_get_property_reply(conn, strut_cookie, NULL));
168 /* check if the window needs WM_TAKE_FOCUS */
169 cwindow->needs_take_focus = window_supports_protocol(cwindow->id, A_WM_TAKE_FOCUS);
171 /* Where to start searching for a container that swallows the new one? */
172 Con *search_at = croot;
174 xcb_get_property_reply_t *reply = xcb_get_property_reply(conn, wm_type_cookie, NULL);
175 if (xcb_reply_contains_atom(reply, A__NET_WM_WINDOW_TYPE_DOCK)) {
176 LOG("This window is of type dock\n");
177 Output *output = get_output_containing(geom->x, geom->y);
178 if (output != NULL) {
179 DLOG("Starting search at output %s\n", output->name);
180 search_at = output->con;
183 /* find out the desired position of this dock window */
184 if (cwindow->reserved.top > 0 && cwindow->reserved.bottom == 0) {
185 DLOG("Top dock client\n");
186 cwindow->dock = W_DOCK_TOP;
187 } else if (cwindow->reserved.top == 0 && cwindow->reserved.bottom > 0) {
188 DLOG("Bottom dock client\n");
189 cwindow->dock = W_DOCK_BOTTOM;
191 DLOG("Ignoring invalid reserved edges (_NET_WM_STRUT_PARTIAL), using position as fallback:\n");
192 if (geom->y < (search_at->rect.height / 2)) {
193 DLOG("geom->y = %d < rect.height / 2 = %d, it is a top dock client\n",
194 geom->y, (search_at->rect.height / 2));
195 cwindow->dock = W_DOCK_TOP;
197 DLOG("geom->y = %d >= rect.height / 2 = %d, it is a bottom dock client\n",
198 geom->y, (search_at->rect.height / 2));
199 cwindow->dock = W_DOCK_BOTTOM;
204 DLOG("Initial geometry: (%d, %d, %d, %d)\n", geom->x, geom->y, geom->width, geom->height);
209 /* TODO: assignments */
210 /* TODO: two matches for one container */
212 /* See if any container swallows this new window */
213 nc = con_for_window(search_at, cwindow, &match);
215 if (focused->type == CT_CON && con_accepts_window(focused)) {
216 LOG("using current container, focused = %p, focused->name = %s\n",
217 focused, focused->name);
219 } else nc = tree_open_con(NULL);
221 /* M_ACTIVE are assignments */
222 if (match != NULL && match->insert_where == M_ACTIVE) {
223 /* We need to go down the focus stack starting from nc */
224 while (TAILQ_FIRST(&(nc->focus_head)) != TAILQ_END(&(nc->focus_head))) {
225 DLOG("walking down one step...\n");
226 nc = TAILQ_FIRST(&(nc->focus_head));
228 /* We need to open a new con */
229 /* TODO: make a difference between match-once containers (directly assign
230 * cwindow) and match-multiple (tree_open_con first) */
231 nc = tree_open_con(nc->parent);
234 /* M_BELOW inserts the new window as a child of the one which was
235 * matched (e.g. dock areas) */
236 else if (match != NULL && match->insert_where == M_BELOW) {
237 nc = tree_open_con(nc);
241 DLOG("new container = %p\n", nc);
242 nc->window = cwindow;
245 nc->border_width = geom->border_width;
248 asprintf(&name, "[i3 con] container around %p", cwindow);
249 x_set_name(nc, name);
252 Con *ws = con_get_workspace(nc);
253 Con *fs = (ws ? con_get_fullscreen_con(ws) : NULL);
256 DLOG("Not in fullscreen mode, focusing\n");
259 else DLOG("dock, not focusing\n");
261 DLOG("fs = %p, ws = %p, not focusing\n", fs, ws);
262 /* Insert the new container in focus stack *after* the currently
263 * focused (fullscreen) con. This way, the new container will be
264 * focused after we return from fullscreen mode */
265 Con *first = TAILQ_FIRST(&(nc->parent->focus_head));
266 TAILQ_REMOVE(&(nc->parent->focus_head), nc, focused);
267 TAILQ_INSERT_AFTER(&(nc->parent->focus_head), first, nc, focused);
270 /* set floating if necessary */
271 bool want_floating = false;
272 if (xcb_reply_contains_atom(reply, A__NET_WM_WINDOW_TYPE_DIALOG) ||
273 xcb_reply_contains_atom(reply, A__NET_WM_WINDOW_TYPE_UTILITY) ||
274 xcb_reply_contains_atom(reply, A__NET_WM_WINDOW_TYPE_TOOLBAR) ||
275 xcb_reply_contains_atom(reply, A__NET_WM_WINDOW_TYPE_SPLASH)) {
276 LOG("This window is a dialog window, setting floating\n");
277 want_floating = true;
280 if (cwindow->transient_for != XCB_NONE ||
281 (cwindow->leader != XCB_NONE &&
282 cwindow->leader != cwindow->id &&
283 con_by_window_id(cwindow->leader) != NULL)) {
284 LOG("This window is transiert for another window, setting floating\n");
285 want_floating = true;
287 if (config.popup_during_fullscreen == PDF_LEAVE_FULLSCREEN &&
289 LOG("There is a fullscreen window, leaving fullscreen mode\n");
290 con_toggle_fullscreen(fs);
294 /* dock clients cannot be floating, that makes no sense */
296 want_floating = false;
298 /* Store the requested geometry. The width/height gets raised to at least
299 * 75x50 when entering floating mode, which is the minimum size for a
300 * window to be useful (smaller windows are usually overlays/toolbars/…
301 * which are not managed by the wm anyways). We store the original geometry
302 * here because it’s used for dock clients. */
303 nc->geometry = (Rect){ geom->x, geom->y, geom->width, geom->height };
306 DLOG("geometry = %d x %d\n", nc->geometry.width, nc->geometry.height);
307 floating_enable(nc, false);
310 /* to avoid getting an UnmapNotify event due to reparenting, we temporarily
311 * declare no interest in any state change event of this window */
312 values[0] = XCB_NONE;
313 xcb_change_window_attributes(conn, window, XCB_CW_EVENT_MASK, values);
315 xcb_void_cookie_t rcookie = xcb_reparent_window_checked(conn, window, nc->frame, 0, 0);
316 if (xcb_request_check(conn, rcookie) != NULL) {
317 LOG("Could not reparent the window, aborting\n");
321 mask = XCB_CW_EVENT_MASK;
322 values[0] = CHILD_EVENT_MASK;
323 xcb_change_window_attributes(conn, window, mask, values);
325 reply = xcb_get_property_reply(conn, state_cookie, NULL);
326 if (xcb_reply_contains_atom(reply, A__NET_WM_STATE_FULLSCREEN))
327 con_toggle_fullscreen(nc);
329 /* Put the client inside the save set. Upon termination (whether killed or
330 * normal exit does not matter) of the window manager, these clients will
331 * be correctly reparented to their most closest living ancestor (=
333 xcb_change_save_set(conn, XCB_SET_MODE_INSERT, window);
344 void reparent_window(xcb_connection_t *conn, xcb_window_t child,
345 xcb_visualid_t visual, xcb_window_t root, uint8_t depth,
346 int16_t x, int16_t y, uint16_t width, uint16_t height,
347 uint32_t border_width) {
349 /* Minimum useful size for managed windows is 75x50 (primarily affects floating) */
350 width = max(width, 75);
351 height = max(height, 50);
353 if (config.default_border != NULL)
354 client_init_border(conn, new, config.default_border[1]);
356 /* We need to grab the mouse buttons for click to focus */
357 xcb_grab_button(conn, false, child, XCB_EVENT_MASK_BUTTON_PRESS,
358 XCB_GRAB_MODE_SYNC, XCB_GRAB_MODE_ASYNC, root, XCB_NONE,
359 1 /* left mouse button */,
360 XCB_BUTTON_MASK_ANY /* don’t filter for any modifiers */);
362 xcb_grab_button(conn, false, child, XCB_EVENT_MASK_BUTTON_PRESS,
363 XCB_GRAB_MODE_SYNC, XCB_GRAB_MODE_ASYNC, root, XCB_NONE,
364 3 /* right mouse button */,
365 XCB_BUTTON_MASK_ANY /* don’t filter for any modifiers */);
368 DLOG("Window is a dock.\n");
369 Output *t_out = get_output_containing(x, y);
370 if (t_out != c_ws->output) {
371 DLOG("Dock client requested to be on output %s by geometry (%d, %d)\n",
373 new->workspace = t_out->current_workspace;
376 new->borderless = true;
377 new->titlebar_position = TITLEBAR_OFF;
378 new->force_reconfigure = true;
379 new->container = NULL;
380 SLIST_INSERT_HEAD(&(t_out->dock_clients), new, dock_clients);
381 /* If it’s a dock we can’t make it float, so we break */
382 new->floating = FLOATING_AUTO_OFF;
385 /* All clients which have a leader should be floating */
386 if (!new->dock && !client_is_floating(new) && new->leader != 0) {
387 DLOG("Client has WM_CLIENT_LEADER hint set, setting floating\n");
388 new->floating = FLOATING_AUTO_ON;
391 if (new->workspace->auto_float) {
392 new->floating = FLOATING_AUTO_ON;
393 DLOG("workspace is in autofloat mode, setting floating\n");
397 /* Get _NET_WM_STRUT_PARTIAL to determine the client’s requested height */
399 preply = xcb_get_property_reply(conn, strut_cookie, NULL);
400 if (preply != NULL && preply->value_len > 0 && (strut = xcb_get_property_value(preply))) {
401 /* We only use a subset of the provided values, namely the reserved space at the top/bottom
402 of the screen. This is because the only possibility for bars is at to be at the top/bottom
403 with maximum horizontal size.
404 TODO: bars at the top */
405 new->desired_height = strut[3];
406 if (new->desired_height == 0) {
407 DLOG("Client wanted to be 0 pixels high, using the window's height (%d)\n", original_height);
408 new->desired_height = original_height;
410 DLOG("the client wants to be %d pixels high\n", new->desired_height);
412 DLOG("The client didn't specify space to reserve at the screen edge, using its height (%d)\n", original_height);
413 new->desired_height = original_height;
416 /* If it’s not a dock, we can check on which workspace we should put it. */
418 /* Firstly, we need to get the window’s class / title. We asked for the properties at the
419 * top of this function, get them now and pass them to our callback function for window class / title
420 * changes. It is important that the client was already inserted into the by_child table,
421 * because the callbacks won’t work otherwise. */
422 preply = xcb_get_property_reply(conn, utf8_title_cookie, NULL);
423 handle_windowname_change(NULL, conn, 0, new->child, atoms[_NET_WM_NAME], preply);
425 preply = xcb_get_property_reply(conn, title_cookie, NULL);
426 handle_windowname_change_legacy(NULL, conn, 0, new->child, WM_NAME, preply);
428 preply = xcb_get_property_reply(conn, class_cookie, NULL);
429 handle_windowclass_change(NULL, conn, 0, new->child, WM_CLASS, preply);
431 /* if WM_CLIENT_LEADER is set, we put the new window on the
432 * same window as its leader. This might be overwritten by
433 * assignments afterwards. */
434 if (new->leader != XCB_NONE) {
435 DLOG("client->leader is set (to 0x%08x)\n", new->leader);
436 Client *parent = table_get(&by_child, new->leader);
437 if (parent != NULL && parent->container != NULL) {
438 Workspace *t_ws = parent->workspace;
439 new->container = t_ws->table[parent->container->col][parent->container->row];
440 new->workspace = t_ws;
441 old_focused = new->container->currently_focused;
442 map_frame = workspace_is_visible(t_ws);
444 /* This is a little tricky: we cannot use
445 * workspace_update_urgent_flag() because the
446 * new window was not yet inserted into the
447 * focus stack on t_ws. */
450 DLOG("parent is not usable\n");
454 struct Assignment *assign;
455 TAILQ_FOREACH(assign, &assignments, assignments) {
456 if (get_matching_client(conn, assign->windowclass_title, new) == NULL)
459 if (assign->floating == ASSIGN_FLOATING_ONLY ||
460 assign->floating == ASSIGN_FLOATING) {
461 new->floating = FLOATING_AUTO_ON;
462 LOG("Assignment matches, putting client into floating mode\n");
463 if (assign->floating == ASSIGN_FLOATING_ONLY)
467 LOG("Assignment \"%s\" matches, so putting it on workspace %d\n",
468 assign->windowclass_title, assign->workspace);
470 if (c_ws->output->current_workspace->num == (assign->workspace-1)) {
471 DLOG("We are already there, no need to do anything\n");
475 DLOG("Changing container/workspace and unmapping the client\n");
476 Workspace *t_ws = workspace_get(assign->workspace-1, NULL);
477 workspace_initialize(t_ws, c_ws->output, false);
479 new->container = t_ws->table[t_ws->current_col][t_ws->current_row];
480 new->workspace = t_ws;
481 old_focused = new->container->currently_focused;
483 map_frame = workspace_is_visible(t_ws);
489 if (client_is_floating(new)) {
490 SLIST_INSERT_HEAD(&(new->workspace->focus_stack), new, focus_clients);
492 /* Add the client to the list of floating clients for its workspace */
493 TAILQ_INSERT_TAIL(&(new->workspace->floating_clients), new, floating_clients);
495 new->container = NULL;
497 new->rect.width = new->floating_rect.width + 2 + 2;
498 new->rect.height = new->floating_rect.height + (font->height + 2 + 2) + 2;
500 /* Some clients (like GIMP’s color picker window) get mapped
501 * to (0, 0), so we push them to a reasonable position
502 * (centered over their leader) */
503 if (new->leader != 0 && x == 0 && y == 0) {
504 DLOG("Floating client wants to (0x0), moving it over its leader instead\n");
505 Client *leader = table_get(&by_child, new->leader);
506 if (leader == NULL) {
507 DLOG("leader is NULL, centering it over current workspace\n");
509 x = c_ws->rect.x + (c_ws->rect.width / 2) - (new->rect.width / 2);
510 y = c_ws->rect.y + (c_ws->rect.height / 2) - (new->rect.height / 2);
512 x = leader->rect.x + (leader->rect.width / 2) - (new->rect.width / 2);
513 y = leader->rect.y + (leader->rect.height / 2) - (new->rect.height / 2);
516 new->floating_rect.x = new->rect.x = x;
517 new->floating_rect.y = new->rect.y = y;
518 DLOG("copying floating_rect from tiling (%d, %d) size (%d, %d)\n",
519 new->floating_rect.x, new->floating_rect.y,
520 new->floating_rect.width, new->floating_rect.height);
521 DLOG("outer rect (%d, %d) size (%d, %d)\n",
522 new->rect.x, new->rect.y, new->rect.width, new->rect.height);
524 /* Make sure it is on top of the other windows */
525 xcb_raise_window(conn, new->frame);
526 reposition_client(conn, new);
527 resize_client(conn, new);
528 /* redecorate_window flushes */
529 redecorate_window(conn, new);
532 new->initialized = true;
538 /* Map the window first to avoid flickering */
539 xcb_map_window(conn, child);
541 client_map(conn, new);
543 if ((CUR_CELL->workspace->fullscreen_client == NULL || new->fullscreen) && !new->dock) {
544 /* Focus the new window if we’re not in fullscreen mode and if it is not a dock window */
545 if ((new->workspace->fullscreen_client == NULL) || new->fullscreen) {
546 if (!client_is_floating(new)) {
547 new->container->currently_focused = new;
549 render_container(conn, new->container);
551 if (new->container == CUR_CELL || client_is_floating(new)) {
552 xcb_set_input_focus(conn, XCB_INPUT_FOCUS_POINTER_ROOT, new->child, XCB_CURRENT_TIME);
553 ewmh_update_active_window(new->child);