2 #define I3__FILE__ "handlers.c"
4 * vim:ts=4:sw=4:expandtab
6 * i3 - an improved dynamic tiling window manager
7 * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
9 * handlers.c: Small handlers for various events (keypresses, focus changes,
18 #include <xcb/randr.h>
19 #define SN_API_NOT_YET_FROZEN 1
20 #include <libsn/sn-monitor.h>
24 int xkb_current_group;
26 /* After mapping/unmapping windows, a notify event is generated. However, we don’t want it,
27 since it’d trigger an infinite loop of switching between the different windows when
28 changing workspaces */
29 static SLIST_HEAD(ignore_head, Ignore_Event) ignore_events;
32 * Adds the given sequence to the list of events which are ignored.
33 * If this ignore should only affect a specific response_type, pass
34 * response_type, otherwise, pass -1.
36 * Every ignored sequence number gets garbage collected after 5 seconds.
39 void add_ignore_event(const int sequence, const int response_type) {
40 struct Ignore_Event *event = smalloc(sizeof(struct Ignore_Event));
42 event->sequence = sequence;
43 event->response_type = response_type;
44 event->added = time(NULL);
46 SLIST_INSERT_HEAD(&ignore_events, event, ignore_events);
50 * Checks if the given sequence is ignored and returns true if so.
53 bool event_is_ignored(const int sequence, const int response_type) {
54 struct Ignore_Event *event;
55 time_t now = time(NULL);
56 for (event = SLIST_FIRST(&ignore_events); event != SLIST_END(&ignore_events);) {
57 if ((now - event->added) > 5) {
58 struct Ignore_Event *save = event;
59 event = SLIST_NEXT(event, ignore_events);
60 SLIST_REMOVE(&ignore_events, save, Ignore_Event, ignore_events);
63 event = SLIST_NEXT(event, ignore_events);
66 SLIST_FOREACH(event, &ignore_events, ignore_events) {
67 if (event->sequence != sequence)
70 if (event->response_type != -1 &&
71 event->response_type != response_type)
74 /* instead of removing a sequence number we better wait until it gets
75 * garbage collected. it may generate multiple events (there are multiple
76 * enter_notifies for one configure_request, for example). */
77 //SLIST_REMOVE(&ignore_events, event, Ignore_Event, ignore_events);
86 * Called with coordinates of an enter_notify event or motion_notify event
87 * to check if the user crossed virtual screen boundaries and adjust the
88 * current workspace, if so.
91 static void check_crossing_screen_boundary(uint32_t x, uint32_t y) {
94 /* If the user disable focus follows mouse, we have nothing to do here */
95 if (config.disable_focus_follows_mouse)
98 if ((output = get_output_containing(x, y)) == NULL) {
99 ELOG("ERROR: No such screen\n");
103 if (output->con == NULL) {
104 ELOG("ERROR: The screen is not recognized by i3 (no container associated)\n");
108 /* Focus the output on which the user moved their cursor */
109 Con *old_focused = focused;
110 Con *next = con_descend_focused(output_get_content(output->con));
111 /* Since we are switching outputs, this *must* be a different workspace, so
112 * call workspace_show() */
113 workspace_show(con_get_workspace(next));
116 /* If the focus changed, we re-render to get updated decorations */
117 if (old_focused != focused)
122 * When the user moves the mouse pointer onto a window, this callback gets called.
125 static void handle_enter_notify(xcb_enter_notify_event_t *event) {
128 last_timestamp = event->time;
130 DLOG("enter_notify for %08x, mode = %d, detail %d, serial %d\n",
131 event->event, event->mode, event->detail, event->sequence);
132 DLOG("coordinates %d, %d\n", event->event_x, event->event_y);
133 if (event->mode != XCB_NOTIFY_MODE_NORMAL) {
134 DLOG("This was not a normal notify, ignoring\n");
137 /* Some events are not interesting, because they were not generated
138 * actively by the user, but by reconfiguration of windows */
139 if (event_is_ignored(event->sequence, XCB_ENTER_NOTIFY)) {
140 DLOG("Event ignored\n");
144 bool enter_child = false;
145 /* Get container by frame or by child window */
146 if ((con = con_by_frame_id(event->event)) == NULL) {
147 con = con_by_window_id(event->event);
151 /* If not, then the user moved their cursor to the root window. In that case, we adjust c_ws */
153 DLOG("Getting screen at %d x %d\n", event->root_x, event->root_y);
154 check_crossing_screen_boundary(event->root_x, event->root_y);
158 if (con->parent->type == CT_DOCKAREA) {
159 DLOG("Ignoring, this is a dock client\n");
163 /* see if the user entered the window on a certain window decoration */
164 layout_t layout = (enter_child ? con->parent->layout : con->layout);
165 if (layout == L_DEFAULT) {
167 TAILQ_FOREACH(child, &(con->nodes_head), nodes)
168 if (rect_contains(child->deco_rect, event->event_x, event->event_y)) {
169 LOG("using child %p / %s instead!\n", child, child->name);
176 if (client->workspace != c_ws && client->workspace->output == c_ws->output) {
177 /* This can happen when a client gets assigned to a different workspace than
178 * the current one (see src/mainx.c:reparent_window). Shortly after it was created,
179 * an enter_notify will follow. */
180 DLOG("enter_notify for a client on a different workspace but the same screen, ignoring\n");
185 if (config.disable_focus_follows_mouse)
188 /* if this container is already focused, there is nothing to do. */
192 /* Get the currently focused workspace to check if the focus change also
193 * involves changing workspaces. If so, we need to call workspace_show() to
194 * correctly update state and send the IPC event. */
195 Con *ws = con_get_workspace(con);
196 if (ws != con_get_workspace(focused))
199 focused_id = XCB_NONE;
200 con_focus(con_descend_focused(con));
207 * When the user moves the mouse but does not change the active window
208 * (e.g. when having no windows opened but moving mouse on the root screen
209 * and crossing virtual screen boundaries), this callback gets called.
212 static void handle_motion_notify(xcb_motion_notify_event_t *event) {
213 last_timestamp = event->time;
215 /* Skip events where the pointer was over a child window, we are only
216 * interested in events on the root window. */
217 if (event->child != XCB_NONE)
221 if ((con = con_by_frame_id(event->event)) == NULL) {
222 DLOG("MotionNotify for an unknown container, checking if it crosses screen boundaries.\n");
223 check_crossing_screen_boundary(event->root_x, event->root_y);
227 if (config.disable_focus_follows_mouse)
230 if (con->layout != L_DEFAULT && con->layout != L_SPLITV && con->layout != L_SPLITH)
233 /* see over which rect the user is */
235 TAILQ_FOREACH(current, &(con->nodes_head), nodes) {
236 if (!rect_contains(current->deco_rect, event->event_x, event->event_y))
239 /* We found the rect, let’s see if this window is focused */
240 if (TAILQ_FIRST(&(con->focus_head)) == current)
244 x_push_changes(croot);
250 * Called when the keyboard mapping changes (for example by using Xmodmap),
251 * we need to update our key bindings then (re-translate symbols).
254 static void handle_mapping_notify(xcb_mapping_notify_event_t *event) {
255 if (event->request != XCB_MAPPING_KEYBOARD &&
256 event->request != XCB_MAPPING_MODIFIER)
259 DLOG("Received mapping_notify for keyboard or modifier mapping, re-grabbing keys\n");
260 xcb_refresh_keyboard_mapping(keysyms, event);
262 xcb_numlock_mask = aio_get_mod_mask_for(XCB_NUM_LOCK, keysyms);
264 ungrab_all_keys(conn);
272 * A new window appeared on the screen (=was mapped), so let’s manage it.
275 static void handle_map_request(xcb_map_request_event_t *event) {
276 xcb_get_window_attributes_cookie_t cookie;
278 cookie = xcb_get_window_attributes_unchecked(conn, event->window);
280 DLOG("window = 0x%08x, serial is %d.\n", event->window, event->sequence);
281 add_ignore_event(event->sequence, -1);
283 manage_window(event->window, cookie, false);
288 * Configure requests are received when the application wants to resize windows
291 * We generate a synthethic configure notify event to signalize the client its
295 static void handle_configure_request(xcb_configure_request_event_t *event) {
298 DLOG("window 0x%08x wants to be at %dx%d with %dx%d\n",
299 event->window, event->x, event->y, event->width, event->height);
301 /* For unmanaged windows, we just execute the configure request. As soon as
302 * it gets mapped, we will take over anyways. */
303 if ((con = con_by_window_id(event->window)) == NULL) {
304 DLOG("Configure request for unmanaged window, can do that.\n");
309 #define COPY_MASK_MEMBER(mask_member, event_member) \
311 if (event->value_mask & mask_member) { \
312 mask |= mask_member; \
313 values[c++] = event->event_member; \
317 COPY_MASK_MEMBER(XCB_CONFIG_WINDOW_X, x);
318 COPY_MASK_MEMBER(XCB_CONFIG_WINDOW_Y, y);
319 COPY_MASK_MEMBER(XCB_CONFIG_WINDOW_WIDTH, width);
320 COPY_MASK_MEMBER(XCB_CONFIG_WINDOW_HEIGHT, height);
321 COPY_MASK_MEMBER(XCB_CONFIG_WINDOW_BORDER_WIDTH, border_width);
322 COPY_MASK_MEMBER(XCB_CONFIG_WINDOW_SIBLING, sibling);
323 COPY_MASK_MEMBER(XCB_CONFIG_WINDOW_STACK_MODE, stack_mode);
325 xcb_configure_window(conn, event->window, mask, values);
331 DLOG("Configure request!\n");
333 Con *workspace = con_get_workspace(con),
336 /* There might not be a corresponding workspace for dock cons, therefore we
337 * have to be careful here. */
339 fullscreen = con_get_fullscreen_con(workspace, CF_OUTPUT);
341 fullscreen = con_get_fullscreen_con(workspace, CF_GLOBAL);
344 if (fullscreen != con && con_is_floating(con) && con_is_leaf(con)) {
345 /* find the height for the decorations */
346 int deco_height = con->deco_rect.height;
347 /* we actually need to apply the size/position changes to the *parent*
349 Rect bsr = con_border_style_rect(con);
350 if (con->border_style == BS_NORMAL) {
351 bsr.y += deco_height;
352 bsr.height -= deco_height;
354 Con *floatingcon = con->parent;
356 if (strcmp(con_get_workspace(floatingcon)->name, "__i3_scratch") == 0) {
357 DLOG("This is a scratchpad container, ignoring ConfigureRequest\n");
361 Rect newrect = floatingcon->rect;
363 if (event->value_mask & XCB_CONFIG_WINDOW_X) {
364 newrect.x = event->x + (-1) * bsr.x;
365 DLOG("proposed x = %d, new x is %d\n", event->x, newrect.x);
367 if (event->value_mask & XCB_CONFIG_WINDOW_Y) {
368 newrect.y = event->y + (-1) * bsr.y;
369 DLOG("proposed y = %d, new y is %d\n", event->y, newrect.y);
371 if (event->value_mask & XCB_CONFIG_WINDOW_WIDTH) {
372 newrect.width = event->width + (-1) * bsr.width;
373 newrect.width += con->border_width * 2;
374 DLOG("proposed width = %d, new width is %d (x11 border %d)\n",
375 event->width, newrect.width, con->border_width);
377 if (event->value_mask & XCB_CONFIG_WINDOW_HEIGHT) {
378 newrect.height = event->height + (-1) * bsr.height;
379 newrect.height += con->border_width * 2;
380 DLOG("proposed height = %d, new height is %d (x11 border %d)\n",
381 event->height, newrect.height, con->border_width);
384 DLOG("Container is a floating leaf node, will do that.\n");
385 floating_reposition(floatingcon, newrect);
389 /* Dock windows can be reconfigured in their height */
390 if (con->parent && con->parent->type == CT_DOCKAREA) {
391 DLOG("Dock window, only height reconfiguration allowed\n");
392 if (event->value_mask & XCB_CONFIG_WINDOW_HEIGHT) {
393 DLOG("Height given, changing\n");
395 con->geometry.height = event->height;
400 fake_absolute_configure_notify(con);
407 * Configuration notifies are only handled because we need to set up ignore for
408 * the following enter notify events.
411 int handle_configure_event(void *prophs, xcb_connection_t *conn, xcb_configure_notify_event_t *event) {
412 DLOG("configure_event, sequence %d\n", event->sequence);
413 /* We ignore this sequence twice because events for child and frame should be ignored */
414 add_ignore_event(event->sequence);
415 add_ignore_event(event->sequence);
422 * Gets triggered upon a RandR screen change event, that is when the user
423 * changes the screen configuration in any way (mode, position, …)
426 static void handle_screen_change(xcb_generic_event_t *e) {
427 DLOG("RandR screen change\n");
429 /* The geometry of the root window is used for “fullscreen global” and
430 * changes when new outputs are added. */
431 xcb_get_geometry_cookie_t cookie = xcb_get_geometry(conn, root);
432 xcb_get_geometry_reply_t *reply = xcb_get_geometry_reply(conn, cookie, NULL);
434 ELOG("Could not get geometry of the root window, exiting\n");
437 DLOG("root geometry reply: (%d, %d) %d x %d\n", reply->x, reply->y, reply->width, reply->height);
439 croot->rect.width = reply->width;
440 croot->rect.height = reply->height;
442 randr_query_outputs();
444 scratchpad_fix_resolution();
446 ipc_send_event("output", I3_IPC_EVENT_OUTPUT, "{\"change\":\"unspecified\"}");
452 * Our window decorations were unmapped. That means, the window will be killed
453 * now, so we better clean up before.
456 static void handle_unmap_notify_event(xcb_unmap_notify_event_t *event) {
457 DLOG("UnmapNotify for 0x%08x (received from 0x%08x), serial %d\n", event->window, event->event, event->sequence);
458 xcb_get_input_focus_cookie_t cookie;
459 Con *con = con_by_window_id(event->window);
461 /* This could also be an UnmapNotify for the frame. We need to
462 * decrement the ignore_unmap counter. */
463 con = con_by_frame_id(event->window);
465 LOG("Not a managed window, ignoring UnmapNotify event\n");
469 if (con->ignore_unmap > 0)
471 /* See the end of this function. */
472 cookie = xcb_get_input_focus(conn);
473 DLOG("ignore_unmap = %d for frame of container %p\n", con->ignore_unmap, con);
477 /* See the end of this function. */
478 cookie = xcb_get_input_focus(conn);
480 if (con->ignore_unmap > 0) {
481 DLOG("ignore_unmap = %d, dec\n", con->ignore_unmap);
486 tree_close(con, DONT_KILL_WINDOW, false, false);
490 /* If the client (as opposed to i3) destroyed or unmapped a window, an
491 * EnterNotify event will follow (indistinguishable from an EnterNotify
492 * event caused by moving your mouse), causing i3 to set focus to whichever
493 * window is now visible.
495 * In a complex stacked or tabbed layout (take two v-split containers in a
496 * tabbed container), when the bottom window in tab2 is closed, the bottom
497 * window of tab1 is visible instead. X11 will thus send an EnterNotify
498 * event for the bottom window of tab1, while the focus should be set to
499 * the remaining window of tab2.
501 * Therefore, we ignore all EnterNotify events which have the same sequence
502 * as an UnmapNotify event. */
503 add_ignore_event(event->sequence, XCB_ENTER_NOTIFY);
505 /* Since we just ignored the sequence of this UnmapNotify, we want to make
506 * sure that following events use a different sequence. When putting xterm
507 * into fullscreen and moving the pointer to a different window, without
508 * using GetInputFocus, subsequent (legitimate) EnterNotify events arrived
509 * with the same sequence and thus were ignored (see ticket #609). */
510 free(xcb_get_input_focus_reply(conn, cookie, NULL));
514 * A destroy notify event is sent when the window is not unmapped, but
515 * immediately destroyed (for example when starting a window and immediately
516 * killing the program which started it).
518 * We just pass on the event to the unmap notify handler (by copying the
519 * important fields in the event data structure).
522 static void handle_destroy_notify_event(xcb_destroy_notify_event_t *event) {
523 DLOG("destroy notify for 0x%08x, 0x%08x\n", event->event, event->window);
525 xcb_unmap_notify_event_t unmap;
526 unmap.sequence = event->sequence;
527 unmap.event = event->event;
528 unmap.window = event->window;
530 handle_unmap_notify_event(&unmap);
533 static bool window_name_changed(i3Window *window, char *old_name) {
534 if ((old_name == NULL) && (window->name == NULL))
537 /* Either the old or the new one is NULL, but not both. */
538 if ((old_name == NULL) ^ (window->name == NULL))
541 return (strcmp(old_name, i3string_as_utf8(window->name)) != 0);
545 * Called when a window changes its title
548 static bool handle_windowname_change(void *data, xcb_connection_t *conn, uint8_t state,
549 xcb_window_t window, xcb_atom_t atom, xcb_get_property_reply_t *prop) {
551 if ((con = con_by_window_id(window)) == NULL || con->window == NULL)
554 char *old_name = (con->window->name != NULL ? sstrdup(i3string_as_utf8(con->window->name)) : NULL);
556 window_update_name(con->window, prop, false);
558 x_push_changes(croot);
560 if (window_name_changed(con->window, old_name))
561 ipc_send_window_event("title", con);
569 * Handles legacy window name updates (WM_NAME), see also src/window.c,
570 * window_update_name_legacy().
573 static bool handle_windowname_change_legacy(void *data, xcb_connection_t *conn, uint8_t state,
574 xcb_window_t window, xcb_atom_t atom, xcb_get_property_reply_t *prop) {
576 if ((con = con_by_window_id(window)) == NULL || con->window == NULL)
579 char *old_name = (con->window->name != NULL ? sstrdup(i3string_as_utf8(con->window->name)) : NULL);
581 window_update_name_legacy(con->window, prop, false);
583 x_push_changes(croot);
585 if (window_name_changed(con->window, old_name))
586 ipc_send_window_event("title", con);
594 * Called when a window changes its WM_WINDOW_ROLE.
597 static bool handle_windowrole_change(void *data, xcb_connection_t *conn, uint8_t state,
598 xcb_window_t window, xcb_atom_t atom, xcb_get_property_reply_t *prop) {
600 if ((con = con_by_window_id(window)) == NULL || con->window == NULL)
603 window_update_role(con->window, prop, false);
610 * Updates the client’s WM_CLASS property
613 static int handle_windowclass_change(void *data, xcb_connection_t *conn, uint8_t state,
614 xcb_window_t window, xcb_atom_t atom, xcb_get_property_reply_t *prop) {
616 if ((con = con_by_window_id(window)) == NULL || con->window == NULL)
619 window_update_class(con->window, prop, false);
626 * Expose event means we should redraw our windows (= title bar)
629 static void handle_expose_event(xcb_expose_event_t *event) {
632 DLOG("window = %08x\n", event->window);
634 if ((parent = con_by_frame_id(event->window)) == NULL) {
635 LOG("expose event for unknown window, ignoring\n");
639 /* Since we render to our pixmap on every change anyways, expose events
640 * only tell us that the X server lost (parts of) the window contents. We
641 * can handle that by copying the appropriate part from our pixmap to the
643 xcb_copy_area(conn, parent->pixmap, parent->frame, parent->pm_gc,
644 event->x, event->y, event->x, event->y,
645 event->width, event->height);
651 #define _NET_WM_MOVERESIZE_SIZE_TOPLEFT 0
652 #define _NET_WM_MOVERESIZE_SIZE_TOP 1
653 #define _NET_WM_MOVERESIZE_SIZE_TOPRIGHT 2
654 #define _NET_WM_MOVERESIZE_SIZE_RIGHT 3
655 #define _NET_WM_MOVERESIZE_SIZE_BOTTOMRIGHT 4
656 #define _NET_WM_MOVERESIZE_SIZE_BOTTOM 5
657 #define _NET_WM_MOVERESIZE_SIZE_BOTTOMLEFT 6
658 #define _NET_WM_MOVERESIZE_SIZE_LEFT 7
659 #define _NET_WM_MOVERESIZE_MOVE 8 /* movement only */
660 #define _NET_WM_MOVERESIZE_SIZE_KEYBOARD 9 /* size via keyboard */
661 #define _NET_WM_MOVERESIZE_MOVE_KEYBOARD 10 /* move via keyboard */
662 #define _NET_WM_MOVERESIZE_CANCEL 11 /* cancel operation */
665 * Handle client messages (EWMH)
668 static void handle_client_message(xcb_client_message_event_t *event) {
669 /* If this is a startup notification ClientMessage, the library will handle
670 * it and call our monitor_event() callback. */
671 if (sn_xcb_display_process_event(sndisplay, (xcb_generic_event_t *)event))
674 LOG("ClientMessage for window 0x%08x\n", event->window);
675 if (event->type == A__NET_WM_STATE) {
676 if (event->format != 32 ||
677 (event->data.data32[1] != A__NET_WM_STATE_FULLSCREEN &&
678 event->data.data32[1] != A__NET_WM_STATE_DEMANDS_ATTENTION)) {
679 DLOG("Unknown atom in clientmessage of type %d\n", event->data.data32[1]);
683 Con *con = con_by_window_id(event->window);
685 DLOG("Could not get window for client message\n");
689 if (event->data.data32[1] == A__NET_WM_STATE_FULLSCREEN) {
690 /* Check if the fullscreen state should be toggled */
691 if ((con->fullscreen_mode != CF_NONE &&
692 (event->data.data32[0] == _NET_WM_STATE_REMOVE ||
693 event->data.data32[0] == _NET_WM_STATE_TOGGLE)) ||
694 (con->fullscreen_mode == CF_NONE &&
695 (event->data.data32[0] == _NET_WM_STATE_ADD ||
696 event->data.data32[0] == _NET_WM_STATE_TOGGLE))) {
697 DLOG("toggling fullscreen\n");
698 con_toggle_fullscreen(con, CF_OUTPUT);
700 } else if (event->data.data32[1] == A__NET_WM_STATE_DEMANDS_ATTENTION) {
701 /* Check if the urgent flag must be set or not */
702 if (event->data.data32[0] == _NET_WM_STATE_ADD)
703 con_set_urgency(con, true);
704 else if (event->data.data32[0] == _NET_WM_STATE_REMOVE)
705 con_set_urgency(con, false);
706 else if (event->data.data32[0] == _NET_WM_STATE_TOGGLE)
707 con_set_urgency(con, !con->urgent);
711 } else if (event->type == A__NET_ACTIVE_WINDOW) {
712 if (event->format != 32)
715 DLOG("_NET_ACTIVE_WINDOW: Window 0x%08x should be activated\n", event->window);
717 Con *con = con_by_window_id(event->window);
719 DLOG("Could not get window for client message\n");
723 Con *ws = con_get_workspace(con);
726 DLOG("Window is not being managed, ignoring _NET_ACTIVE_WINDOW\n");
730 if (con_is_internal(ws)) {
731 DLOG("Workspace is internal, ignoring _NET_ACTIVE_WINDOW\n");
735 /* data32[0] indicates the source of the request (application or pager) */
736 if (event->data.data32[0] == 2) {
737 /* Always focus the con if it is from a pager, because this is most
738 * likely from some user action */
739 DLOG("This request came from a pager. Focusing con = %p\n", con);
743 /* Request is from an application. */
745 if (config.focus_on_window_activation == FOWA_FOCUS || (config.focus_on_window_activation == FOWA_SMART && workspace_is_visible(ws))) {
746 DLOG("Focusing con = %p\n", con);
749 } else if (config.focus_on_window_activation == FOWA_URGENT || (config.focus_on_window_activation == FOWA_SMART && !workspace_is_visible(ws))) {
750 DLOG("Marking con = %p urgent\n", con);
751 con_set_urgency(con, true);
753 DLOG("Ignoring request for con = %p.\n", con);
757 } else if (event->type == A_I3_SYNC) {
758 xcb_window_t window = event->data.data32[0];
759 uint32_t rnd = event->data.data32[1];
760 DLOG("[i3 sync protocol] Sending random value %d back to X11 window 0x%08x\n", rnd, window);
762 void *reply = scalloc(32, 1);
763 xcb_client_message_event_t *ev = reply;
765 ev->response_type = XCB_CLIENT_MESSAGE;
767 ev->type = A_I3_SYNC;
769 ev->data.data32[0] = window;
770 ev->data.data32[1] = rnd;
772 xcb_send_event(conn, false, window, XCB_EVENT_MASK_NO_EVENT, (char *)ev);
775 } else if (event->type == A__NET_REQUEST_FRAME_EXTENTS) {
777 * A client can request an estimate for the frame size which the window
778 * manager will put around it before actually mapping its window. Java
779 * does this (as of openjdk-7).
781 * Note that the calculation below is not entirely accurate — once you
782 * set a different border type, it’s off. We _could_ request all the
783 * window properties (which have to be set up at this point according
784 * to EWMH), but that seems rather elaborate. The standard explicitly
785 * says the application must cope with an estimate that is not entirely
788 DLOG("_NET_REQUEST_FRAME_EXTENTS for window 0x%08x\n", event->window);
790 /* The reply data: approximate frame size */
792 config.default_border_width, /* left */
793 config.default_border_width, /* right */
794 config.font.height + 5, /* top */
795 config.default_border_width /* bottom */
799 XCB_PROP_MODE_REPLACE,
801 A__NET_FRAME_EXTENTS,
802 XCB_ATOM_CARDINAL, 32, 4,
805 } else if (event->type == A__NET_CURRENT_DESKTOP) {
806 /* This request is used by pagers and bars to change the current
807 * desktop likely as a result of some user action. We interpret this as
808 * a request to focus the given workspace. See
809 * http://standards.freedesktop.org/wm-spec/latest/ar01s03.html#idm140251368135008
813 DLOG("Request to change current desktop to index %d\n", event->data.data32[0]);
815 TAILQ_FOREACH(output, &(croot->nodes_head), nodes) {
817 TAILQ_FOREACH(ws, &(output_get_content(output)->nodes_head), nodes) {
818 if (STARTS_WITH(ws->name, "__"))
821 if (idx == event->data.data32[0]) {
822 /* data32[1] is a timestamp used to prevent focus race conditions */
823 if (event->data.data32[1])
824 last_timestamp = event->data.data32[1];
826 DLOG("Handling request to focus workspace %s\n", ws->name);
837 } else if (event->type == A__NET_CLOSE_WINDOW) {
839 * Pagers wanting to close a window MUST send a _NET_CLOSE_WINDOW
840 * client message request to the root window.
841 * http://standards.freedesktop.org/wm-spec/wm-spec-latest.html#idm140200472668896
843 Con *con = con_by_window_id(event->window);
845 DLOG("Handling _NET_CLOSE_WINDOW request (con = %p)\n", con);
847 if (event->data.data32[0])
848 last_timestamp = event->data.data32[0];
850 tree_close(con, KILL_WINDOW, false, false);
853 DLOG("Couldn't find con for _NET_CLOSE_WINDOW request. (window = %d)\n", event->window);
855 } else if (event->type == A__NET_WM_MOVERESIZE) {
857 * Client-side decorated Gtk3 windows emit this signal when being
858 * dragged by their GtkHeaderBar
860 Con *con = con_by_window_id(event->window);
861 if (!con || !con_is_floating(con)) {
862 DLOG("Couldn't find con for _NET_WM_MOVERESIZE request, or con not floating (window = %d)\n", event->window);
865 DLOG("Handling _NET_WM_MOVERESIZE request (con = %p)\n", con);
866 uint32_t direction = event->data.data32[2];
867 uint32_t x_root = event->data.data32[0];
868 uint32_t y_root = event->data.data32[1];
869 /* construct fake xcb_button_press_event_t */
870 xcb_button_press_event_t fake = {
873 .event_x = x_root - (con->rect.x),
874 .event_y = y_root - (con->rect.y)};
876 case _NET_WM_MOVERESIZE_MOVE:
877 floating_drag_window(con->parent, &fake);
879 case _NET_WM_MOVERESIZE_SIZE_TOPLEFT... _NET_WM_MOVERESIZE_SIZE_LEFT:
880 floating_resize_window(con->parent, false, &fake);
883 DLOG("_NET_WM_MOVERESIZE direction %d not implemented\n", direction);
887 DLOG("unhandled clientmessage\n");
892 bool handle_window_type(void *data, xcb_connection_t *conn, uint8_t state, xcb_window_t window,
893 xcb_atom_t atom, xcb_get_property_reply_t *reply) {
895 if ((con = con_by_window_id(window)) == NULL || con->window == NULL)
898 window_update_type(con->window, reply);
903 * Handles the size hints set by a window, but currently only the part necessary for displaying
904 * clients proportionally inside their frames (mplayer for example)
906 * See ICCCM 4.1.2.3 for more details
909 static bool handle_normal_hints(void *data, xcb_connection_t *conn, uint8_t state, xcb_window_t window,
910 xcb_atom_t name, xcb_get_property_reply_t *reply) {
911 Con *con = con_by_window_id(window);
913 DLOG("Received WM_NORMAL_HINTS for unknown client\n");
917 xcb_size_hints_t size_hints;
919 //CLIENT_LOG(client);
921 /* If the hints were already in this event, use them, if not, request them */
923 xcb_icccm_get_wm_size_hints_from_reply(&size_hints, reply);
925 xcb_icccm_get_wm_normal_hints_reply(conn, xcb_icccm_get_wm_normal_hints_unchecked(conn, con->window->id), &size_hints, NULL);
927 if ((size_hints.flags & XCB_ICCCM_SIZE_HINT_P_MIN_SIZE)) {
928 // TODO: Minimum size is not yet implemented
929 DLOG("Minimum size: %d (width) x %d (height)\n", size_hints.min_width, size_hints.min_height);
932 bool changed = false;
933 if ((size_hints.flags & XCB_ICCCM_SIZE_HINT_P_RESIZE_INC)) {
934 if (size_hints.width_inc > 0 && size_hints.width_inc < 0xFFFF)
935 if (con->window->width_increment != size_hints.width_inc) {
936 con->window->width_increment = size_hints.width_inc;
939 if (size_hints.height_inc > 0 && size_hints.height_inc < 0xFFFF)
940 if (con->window->height_increment != size_hints.height_inc) {
941 con->window->height_increment = size_hints.height_inc;
946 DLOG("resize increments changed\n");
949 int base_width = 0, base_height = 0;
951 /* base_width/height are the desired size of the window.
952 We check if either the program-specified size or the program-specified
953 min-size is available */
954 if (size_hints.flags & XCB_ICCCM_SIZE_HINT_BASE_SIZE) {
955 base_width = size_hints.base_width;
956 base_height = size_hints.base_height;
957 } else if (size_hints.flags & XCB_ICCCM_SIZE_HINT_P_MIN_SIZE) {
958 /* TODO: is this right? icccm says not */
959 base_width = size_hints.min_width;
960 base_height = size_hints.min_height;
963 if (base_width != con->window->base_width ||
964 base_height != con->window->base_height) {
965 con->window->base_width = base_width;
966 con->window->base_height = base_height;
967 DLOG("client's base_height changed to %d\n", base_height);
968 DLOG("client's base_width changed to %d\n", base_width);
972 /* If no aspect ratio was set or if it was invalid, we ignore the hints */
973 if (!(size_hints.flags & XCB_ICCCM_SIZE_HINT_P_ASPECT) ||
974 (size_hints.min_aspect_num <= 0) ||
975 (size_hints.min_aspect_den <= 0)) {
976 goto render_and_return;
979 /* XXX: do we really use rect here, not window_rect? */
980 double width = con->rect.width - base_width;
981 double height = con->rect.height - base_height;
982 /* Convert numerator/denominator to a double */
983 double min_aspect = (double)size_hints.min_aspect_num / size_hints.min_aspect_den;
984 double max_aspect = (double)size_hints.max_aspect_num / size_hints.min_aspect_den;
986 DLOG("Aspect ratio set: minimum %f, maximum %f\n", min_aspect, max_aspect);
987 DLOG("width = %f, height = %f\n", width, height);
989 /* Sanity checks, this is user-input, in a way */
990 if (max_aspect <= 0 || min_aspect <= 0 || height == 0 || (width / height) <= 0)
991 goto render_and_return;
993 /* Check if we need to set proportional_* variables using the correct ratio */
994 double aspect_ratio = 0.0;
995 if ((width / height) < min_aspect) {
996 aspect_ratio = min_aspect;
997 } else if ((width / height) > max_aspect) {
998 aspect_ratio = max_aspect;
1000 goto render_and_return;
1002 if (fabs(con->aspect_ratio - aspect_ratio) > DBL_EPSILON) {
1003 con->aspect_ratio = aspect_ratio;
1015 * Handles the WM_HINTS property for extracting the urgency state of the window.
1018 static bool handle_hints(void *data, xcb_connection_t *conn, uint8_t state, xcb_window_t window,
1019 xcb_atom_t name, xcb_get_property_reply_t *reply) {
1020 Con *con = con_by_window_id(window);
1022 DLOG("Received WM_HINTS for unknown client\n");
1028 reply = xcb_get_property_reply(conn, xcb_icccm_get_wm_hints(conn, window), NULL);
1029 window_update_hints(con->window, reply, &urgency_hint);
1030 con_set_urgency(con, urgency_hint);
1037 * Handles the transient for hints set by a window, signalizing that this window is a popup window
1038 * for some other window.
1040 * See ICCCM 4.1.2.6 for more details
1043 static bool handle_transient_for(void *data, xcb_connection_t *conn, uint8_t state, xcb_window_t window,
1044 xcb_atom_t name, xcb_get_property_reply_t *prop) {
1047 if ((con = con_by_window_id(window)) == NULL || con->window == NULL) {
1048 DLOG("No such window\n");
1053 prop = xcb_get_property_reply(conn, xcb_get_property_unchecked(conn,
1054 false, window, XCB_ATOM_WM_TRANSIENT_FOR, XCB_ATOM_WINDOW, 0, 32),
1060 window_update_transient_for(con->window, prop);
1066 * Handles changes of the WM_CLIENT_LEADER atom which specifies if this is a
1067 * toolwindow (or similar) and to which window it belongs (logical parent).
1070 static bool handle_clientleader_change(void *data, xcb_connection_t *conn, uint8_t state, xcb_window_t window,
1071 xcb_atom_t name, xcb_get_property_reply_t *prop) {
1073 if ((con = con_by_window_id(window)) == NULL || con->window == NULL)
1077 prop = xcb_get_property_reply(conn, xcb_get_property_unchecked(conn,
1078 false, window, A_WM_CLIENT_LEADER, XCB_ATOM_WINDOW, 0, 32),
1084 window_update_leader(con->window, prop);
1090 * Handles FocusIn events which are generated by clients (i3’s focus changes
1091 * don’t generate FocusIn events due to a different EventMask) and updates the
1092 * decorations accordingly.
1095 static void handle_focus_in(xcb_focus_in_event_t *event) {
1096 DLOG("focus change in, for window 0x%08x\n", event->event);
1098 if ((con = con_by_window_id(event->event)) == NULL || con->window == NULL)
1100 DLOG("That is con %p / %s\n", con, con->name);
1102 if (event->mode == XCB_NOTIFY_MODE_GRAB ||
1103 event->mode == XCB_NOTIFY_MODE_UNGRAB) {
1104 DLOG("FocusIn event for grab/ungrab, ignoring\n");
1108 if (event->detail == XCB_NOTIFY_DETAIL_POINTER) {
1109 DLOG("notify detail is pointer, ignoring this event\n");
1113 if (focused_id == event->event) {
1114 DLOG("focus matches the currently focused window, not doing anything\n");
1118 /* Skip dock clients, they cannot get the i3 focus. */
1119 if (con->parent->type == CT_DOCKAREA) {
1120 DLOG("This is a dock client, not focusing.\n");
1124 DLOG("focus is different, updating decorations\n");
1126 /* Get the currently focused workspace to check if the focus change also
1127 * involves changing workspaces. If so, we need to call workspace_show() to
1128 * correctly update state and send the IPC event. */
1129 Con *ws = con_get_workspace(con);
1130 if (ws != con_get_workspace(focused))
1134 /* We update focused_id because we don’t need to set focus again */
1135 focused_id = event->event;
1136 x_push_changes(croot);
1141 * Handles the WM_CLASS property for assignments and criteria selection.
1144 static bool handle_class_change(void *data, xcb_connection_t *conn, uint8_t state, xcb_window_t window,
1145 xcb_atom_t name, xcb_get_property_reply_t *prop) {
1147 if ((con = con_by_window_id(window)) == NULL || con->window == NULL)
1151 prop = xcb_get_property_reply(conn, xcb_get_property_unchecked(conn,
1152 false, window, XCB_ATOM_WM_CLASS, XCB_ATOM_STRING, 0, 32),
1159 window_update_class(con->window, prop, false);
1165 * Handles the _NET_WM_STRUT_PARTIAL property for allocating space for dock clients.
1168 static bool handle_strut_partial_change(void *data, xcb_connection_t *conn, uint8_t state, xcb_window_t window,
1169 xcb_atom_t name, xcb_get_property_reply_t *prop) {
1170 DLOG("strut partial change for window 0x%08x\n", window);
1173 if ((con = con_by_window_id(window)) == NULL || con->window == NULL) {
1178 xcb_generic_error_t *err = NULL;
1179 xcb_get_property_cookie_t strut_cookie = xcb_get_property(conn, false, window, A__NET_WM_STRUT_PARTIAL,
1180 XCB_GET_PROPERTY_TYPE_ANY, 0, UINT32_MAX);
1181 prop = xcb_get_property_reply(conn, strut_cookie, &err);
1184 DLOG("got error when getting strut partial property: %d\n", err->error_code);
1194 DLOG("That is con %p / %s\n", con, con->name);
1196 window_update_strut_partial(con->window, prop);
1198 /* we only handle this change for dock clients */
1199 if (con->parent == NULL || con->parent->type != CT_DOCKAREA) {
1203 Con *search_at = croot;
1204 Con *output = con_get_output(con);
1205 if (output != NULL) {
1206 DLOG("Starting search at output %s\n", output->name);
1210 /* find out the desired position of this dock window */
1211 if (con->window->reserved.top > 0 && con->window->reserved.bottom == 0) {
1212 DLOG("Top dock client\n");
1213 con->window->dock = W_DOCK_TOP;
1214 } else if (con->window->reserved.top == 0 && con->window->reserved.bottom > 0) {
1215 DLOG("Bottom dock client\n");
1216 con->window->dock = W_DOCK_BOTTOM;
1218 DLOG("Ignoring invalid reserved edges (_NET_WM_STRUT_PARTIAL), using position as fallback:\n");
1219 if (con->geometry.y < (search_at->rect.height / 2)) {
1220 DLOG("geom->y = %d < rect.height / 2 = %d, it is a top dock client\n",
1221 con->geometry.y, (search_at->rect.height / 2));
1222 con->window->dock = W_DOCK_TOP;
1224 DLOG("geom->y = %d >= rect.height / 2 = %d, it is a bottom dock client\n",
1225 con->geometry.y, (search_at->rect.height / 2));
1226 con->window->dock = W_DOCK_BOTTOM;
1230 /* find the dockarea */
1231 Con *dockarea = con_for_window(search_at, con->window, NULL);
1232 assert(dockarea != NULL);
1234 /* attach the dock to the dock area */
1236 con->parent = dockarea;
1237 TAILQ_INSERT_HEAD(&(dockarea->focus_head), con, focused);
1238 TAILQ_INSERT_HEAD(&(dockarea->nodes_head), con, nodes);
1245 /* Returns false if the event could not be processed (e.g. the window could not
1246 * be found), true otherwise */
1247 typedef bool (*cb_property_handler_t)(void *data, xcb_connection_t *c, uint8_t state, xcb_window_t window, xcb_atom_t atom, xcb_get_property_reply_t *property);
1249 struct property_handler_t {
1252 cb_property_handler_t cb;
1255 static struct property_handler_t property_handlers[] = {
1256 {0, 128, handle_windowname_change},
1257 {0, UINT_MAX, handle_hints},
1258 {0, 128, handle_windowname_change_legacy},
1259 {0, UINT_MAX, handle_normal_hints},
1260 {0, UINT_MAX, handle_clientleader_change},
1261 {0, UINT_MAX, handle_transient_for},
1262 {0, 128, handle_windowrole_change},
1263 {0, 128, handle_class_change},
1264 {0, UINT_MAX, handle_strut_partial_change},
1265 {0, UINT_MAX, handle_window_type}};
1266 #define NUM_HANDLERS (sizeof(property_handlers) / sizeof(struct property_handler_t))
1269 * Sets the appropriate atoms for the property handlers after the atoms were
1273 void property_handlers_init(void) {
1274 sn_monitor_context_new(sndisplay, conn_screen, startup_monitor_event, NULL, NULL);
1276 property_handlers[0].atom = A__NET_WM_NAME;
1277 property_handlers[1].atom = XCB_ATOM_WM_HINTS;
1278 property_handlers[2].atom = XCB_ATOM_WM_NAME;
1279 property_handlers[3].atom = XCB_ATOM_WM_NORMAL_HINTS;
1280 property_handlers[4].atom = A_WM_CLIENT_LEADER;
1281 property_handlers[5].atom = XCB_ATOM_WM_TRANSIENT_FOR;
1282 property_handlers[6].atom = A_WM_WINDOW_ROLE;
1283 property_handlers[7].atom = XCB_ATOM_WM_CLASS;
1284 property_handlers[8].atom = A__NET_WM_STRUT_PARTIAL;
1285 property_handlers[9].atom = A__NET_WM_WINDOW_TYPE;
1288 static void property_notify(uint8_t state, xcb_window_t window, xcb_atom_t atom) {
1289 struct property_handler_t *handler = NULL;
1290 xcb_get_property_reply_t *propr = NULL;
1292 for (size_t c = 0; c < sizeof(property_handlers) / sizeof(struct property_handler_t); c++) {
1293 if (property_handlers[c].atom != atom)
1296 handler = &property_handlers[c];
1300 if (handler == NULL) {
1301 //DLOG("Unhandled property notify for atom %d (0x%08x)\n", atom, atom);
1305 if (state != XCB_PROPERTY_DELETE) {
1306 xcb_get_property_cookie_t cookie = xcb_get_property(conn, 0, window, atom, XCB_GET_PROPERTY_TYPE_ANY, 0, handler->long_len);
1307 propr = xcb_get_property_reply(conn, cookie, 0);
1310 /* the handler will free() the reply unless it returns false */
1311 if (!handler->cb(NULL, conn, state, window, atom, propr))
1316 * Takes an xcb_generic_event_t and calls the appropriate handler, based on the
1320 void handle_event(int type, xcb_generic_event_t *event) {
1321 if (type != XCB_MOTION_NOTIFY)
1322 DLOG("event type %d, xkb_base %d\n", type, xkb_base);
1324 if (randr_base > -1 &&
1325 type == randr_base + XCB_RANDR_SCREEN_CHANGE_NOTIFY) {
1326 handle_screen_change(event);
1330 if (xkb_base > -1 && type == xkb_base) {
1331 DLOG("xkb event, need to handle it.\n");
1333 xcb_xkb_state_notify_event_t *state = (xcb_xkb_state_notify_event_t *)event;
1334 if (state->xkbType == XCB_XKB_NEW_KEYBOARD_NOTIFY) {
1335 DLOG("xkb new keyboard notify, sequence %d, time %d\n", state->sequence, state->time);
1336 xcb_key_symbols_free(keysyms);
1337 keysyms = xcb_key_symbols_alloc(conn);
1338 ungrab_all_keys(conn);
1339 translate_keysyms();
1340 grab_all_keys(conn);
1341 if (((xcb_xkb_new_keyboard_notify_event_t *)event)->changed & XCB_XKB_NKN_DETAIL_KEYCODES)
1342 (void)load_keymap();
1343 } else if (state->xkbType == XCB_XKB_MAP_NOTIFY) {
1344 if (event_is_ignored(event->sequence, type)) {
1345 DLOG("Ignoring map notify event for sequence %d.\n", state->sequence);
1347 DLOG("xkb map notify, sequence %d, time %d\n", state->sequence, state->time);
1348 add_ignore_event(event->sequence, type);
1349 xcb_key_symbols_free(keysyms);
1350 keysyms = xcb_key_symbols_alloc(conn);
1351 ungrab_all_keys(conn);
1352 translate_keysyms();
1353 grab_all_keys(conn);
1354 (void)load_keymap();
1356 } else if (state->xkbType == XCB_XKB_STATE_NOTIFY) {
1357 DLOG("xkb state group = %d\n", state->group);
1358 if (xkb_current_group == state->group)
1360 xkb_current_group = state->group;
1361 ungrab_all_keys(conn);
1362 grab_all_keys(conn);
1370 case XCB_KEY_RELEASE:
1371 handle_key_press((xcb_key_press_event_t *)event);
1374 case XCB_BUTTON_PRESS:
1375 case XCB_BUTTON_RELEASE:
1376 handle_button_press((xcb_button_press_event_t *)event);
1379 case XCB_MAP_REQUEST:
1380 handle_map_request((xcb_map_request_event_t *)event);
1383 case XCB_UNMAP_NOTIFY:
1384 handle_unmap_notify_event((xcb_unmap_notify_event_t *)event);
1387 case XCB_DESTROY_NOTIFY:
1388 handle_destroy_notify_event((xcb_destroy_notify_event_t *)event);
1392 handle_expose_event((xcb_expose_event_t *)event);
1395 case XCB_MOTION_NOTIFY:
1396 handle_motion_notify((xcb_motion_notify_event_t *)event);
1399 /* Enter window = user moved their mouse over the window */
1400 case XCB_ENTER_NOTIFY:
1401 handle_enter_notify((xcb_enter_notify_event_t *)event);
1404 /* Client message are sent to the root window. The only interesting
1405 * client message for us is _NET_WM_STATE, we honour
1406 * _NET_WM_STATE_FULLSCREEN and _NET_WM_STATE_DEMANDS_ATTENTION */
1407 case XCB_CLIENT_MESSAGE:
1408 handle_client_message((xcb_client_message_event_t *)event);
1411 /* Configure request = window tried to change size on its own */
1412 case XCB_CONFIGURE_REQUEST:
1413 handle_configure_request((xcb_configure_request_event_t *)event);
1416 /* Mapping notify = keyboard mapping changed (Xmodmap), re-grab bindings */
1417 case XCB_MAPPING_NOTIFY:
1418 handle_mapping_notify((xcb_mapping_notify_event_t *)event);
1422 handle_focus_in((xcb_focus_in_event_t *)event);
1425 case XCB_PROPERTY_NOTIFY: {
1426 xcb_property_notify_event_t *e = (xcb_property_notify_event_t *)event;
1427 last_timestamp = e->time;
1428 property_notify(e->state, e->window, e->atom);
1433 //DLOG("Unhandled event of type %d\n", type);