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 #include <X11/XKBlib.h>
20 #define SN_API_NOT_YET_FROZEN 1
21 #include <libsn/sn-monitor.h>
25 int xkb_current_group;
27 /* After mapping/unmapping windows, a notify event is generated. However, we don’t want it,
28 since it’d trigger an infinite loop of switching between the different windows when
29 changing workspaces */
30 static SLIST_HEAD(ignore_head, Ignore_Event) ignore_events;
33 * Adds the given sequence to the list of events which are ignored.
34 * If this ignore should only affect a specific response_type, pass
35 * response_type, otherwise, pass -1.
37 * Every ignored sequence number gets garbage collected after 5 seconds.
40 void add_ignore_event(const int sequence, const int response_type) {
41 struct Ignore_Event *event = smalloc(sizeof(struct Ignore_Event));
43 event->sequence = sequence;
44 event->response_type = response_type;
45 event->added = time(NULL);
47 SLIST_INSERT_HEAD(&ignore_events, event, ignore_events);
51 * Checks if the given sequence is ignored and returns true if so.
54 bool event_is_ignored(const int sequence, const int response_type) {
55 struct Ignore_Event *event;
56 time_t now = time(NULL);
57 for (event = SLIST_FIRST(&ignore_events); event != SLIST_END(&ignore_events);) {
58 if ((now - event->added) > 5) {
59 struct Ignore_Event *save = event;
60 event = SLIST_NEXT(event, ignore_events);
61 SLIST_REMOVE(&ignore_events, save, Ignore_Event, ignore_events);
64 event = SLIST_NEXT(event, ignore_events);
67 SLIST_FOREACH(event, &ignore_events, ignore_events) {
68 if (event->sequence != sequence)
71 if (event->response_type != -1 &&
72 event->response_type != response_type)
75 /* instead of removing a sequence number we better wait until it gets
76 * garbage collected. it may generate multiple events (there are multiple
77 * enter_notifies for one configure_request, for example). */
78 //SLIST_REMOVE(&ignore_events, event, Ignore_Event, ignore_events);
87 * Called with coordinates of an enter_notify event or motion_notify event
88 * to check if the user crossed virtual screen boundaries and adjust the
89 * current workspace, if so.
92 static void check_crossing_screen_boundary(uint32_t x, uint32_t y) {
95 /* If the user disable focus follows mouse, we have nothing to do here */
96 if (config.disable_focus_follows_mouse)
99 if ((output = get_output_containing(x, y)) == NULL) {
100 ELOG("ERROR: No such screen\n");
104 if (output->con == NULL) {
105 ELOG("ERROR: The screen is not recognized by i3 (no container associated)\n");
109 /* Focus the output on which the user moved their cursor */
110 Con *old_focused = focused;
111 Con *next = con_descend_focused(output_get_content(output->con));
112 /* Since we are switching outputs, this *must* be a different workspace, so
113 * call workspace_show() */
114 workspace_show(con_get_workspace(next));
117 /* If the focus changed, we re-render to get updated decorations */
118 if (old_focused != focused)
123 * When the user moves the mouse pointer onto a window, this callback gets called.
126 static void handle_enter_notify(xcb_enter_notify_event_t *event) {
129 last_timestamp = event->time;
131 DLOG("enter_notify for %08x, mode = %d, detail %d, serial %d\n",
132 event->event, event->mode, event->detail, event->sequence);
133 DLOG("coordinates %d, %d\n", event->event_x, event->event_y);
134 if (event->mode != XCB_NOTIFY_MODE_NORMAL) {
135 DLOG("This was not a normal notify, ignoring\n");
138 /* Some events are not interesting, because they were not generated
139 * actively by the user, but by reconfiguration of windows */
140 if (event_is_ignored(event->sequence, XCB_ENTER_NOTIFY)) {
141 DLOG("Event ignored\n");
145 bool enter_child = false;
146 /* Get container by frame or by child window */
147 if ((con = con_by_frame_id(event->event)) == NULL) {
148 con = con_by_window_id(event->event);
152 /* If not, then the user moved their cursor to the root window. In that case, we adjust c_ws */
154 DLOG("Getting screen at %d x %d\n", event->root_x, event->root_y);
155 check_crossing_screen_boundary(event->root_x, event->root_y);
159 if (con->parent->type == CT_DOCKAREA) {
160 DLOG("Ignoring, this is a dock client\n");
164 /* see if the user entered the window on a certain window decoration */
165 layout_t layout = (enter_child ? con->parent->layout : con->layout);
166 if (layout == L_DEFAULT) {
168 TAILQ_FOREACH(child, &(con->nodes_head), nodes)
169 if (rect_contains(child->deco_rect, event->event_x, event->event_y)) {
170 LOG("using child %p / %s instead!\n", child, child->name);
177 if (client->workspace != c_ws && client->workspace->output == c_ws->output) {
178 /* This can happen when a client gets assigned to a different workspace than
179 * the current one (see src/mainx.c:reparent_window). Shortly after it was created,
180 * an enter_notify will follow. */
181 DLOG("enter_notify for a client on a different workspace but the same screen, ignoring\n");
186 if (config.disable_focus_follows_mouse)
189 /* if this container is already focused, there is nothing to do. */
193 /* Get the currently focused workspace to check if the focus change also
194 * involves changing workspaces. If so, we need to call workspace_show() to
195 * correctly update state and send the IPC event. */
196 Con *ws = con_get_workspace(con);
197 if (ws != con_get_workspace(focused))
200 focused_id = XCB_NONE;
201 con_focus(con_descend_focused(con));
208 * When the user moves the mouse but does not change the active window
209 * (e.g. when having no windows opened but moving mouse on the root screen
210 * and crossing virtual screen boundaries), this callback gets called.
213 static void handle_motion_notify(xcb_motion_notify_event_t *event) {
214 last_timestamp = event->time;
216 /* Skip events where the pointer was over a child window, we are only
217 * interested in events on the root window. */
218 if (event->child != XCB_NONE)
222 if ((con = con_by_frame_id(event->event)) == NULL) {
223 DLOG("MotionNotify for an unknown container, checking if it crosses screen boundaries.\n");
224 check_crossing_screen_boundary(event->root_x, event->root_y);
228 if (config.disable_focus_follows_mouse)
231 if (con->layout != L_DEFAULT && con->layout != L_SPLITV && con->layout != L_SPLITH)
234 /* see over which rect the user is */
236 TAILQ_FOREACH(current, &(con->nodes_head), nodes) {
237 if (!rect_contains(current->deco_rect, event->event_x, event->event_y))
240 /* We found the rect, let’s see if this window is focused */
241 if (TAILQ_FIRST(&(con->focus_head)) == current)
245 x_push_changes(croot);
251 * Called when the keyboard mapping changes (for example by using Xmodmap),
252 * we need to update our key bindings then (re-translate symbols).
255 static void handle_mapping_notify(xcb_mapping_notify_event_t *event) {
256 if (event->request != XCB_MAPPING_KEYBOARD &&
257 event->request != XCB_MAPPING_MODIFIER)
260 DLOG("Received mapping_notify for keyboard or modifier mapping, re-grabbing keys\n");
261 xcb_refresh_keyboard_mapping(keysyms, event);
263 xcb_numlock_mask = aio_get_mod_mask_for(XCB_NUM_LOCK, keysyms);
265 ungrab_all_keys(conn);
267 grab_all_keys(conn, false);
273 * A new window appeared on the screen (=was mapped), so let’s manage it.
276 static void handle_map_request(xcb_map_request_event_t *event) {
277 xcb_get_window_attributes_cookie_t cookie;
279 cookie = xcb_get_window_attributes_unchecked(conn, event->window);
281 DLOG("window = 0x%08x, serial is %d.\n", event->window, event->sequence);
282 add_ignore_event(event->sequence, -1);
284 manage_window(event->window, cookie, false);
289 * Configure requests are received when the application wants to resize windows
292 * We generate a synthethic configure notify event to signalize the client its
296 static void handle_configure_request(xcb_configure_request_event_t *event) {
299 DLOG("window 0x%08x wants to be at %dx%d with %dx%d\n",
300 event->window, event->x, event->y, event->width, event->height);
302 /* For unmanaged windows, we just execute the configure request. As soon as
303 * it gets mapped, we will take over anyways. */
304 if ((con = con_by_window_id(event->window)) == NULL) {
305 DLOG("Configure request for unmanaged window, can do that.\n");
310 #define COPY_MASK_MEMBER(mask_member, event_member) \
312 if (event->value_mask & mask_member) { \
313 mask |= mask_member; \
314 values[c++] = event->event_member; \
318 COPY_MASK_MEMBER(XCB_CONFIG_WINDOW_X, x);
319 COPY_MASK_MEMBER(XCB_CONFIG_WINDOW_Y, y);
320 COPY_MASK_MEMBER(XCB_CONFIG_WINDOW_WIDTH, width);
321 COPY_MASK_MEMBER(XCB_CONFIG_WINDOW_HEIGHT, height);
322 COPY_MASK_MEMBER(XCB_CONFIG_WINDOW_BORDER_WIDTH, border_width);
323 COPY_MASK_MEMBER(XCB_CONFIG_WINDOW_SIBLING, sibling);
324 COPY_MASK_MEMBER(XCB_CONFIG_WINDOW_STACK_MODE, stack_mode);
326 xcb_configure_window(conn, event->window, mask, values);
332 DLOG("Configure request!\n");
334 Con *workspace = con_get_workspace(con),
337 /* There might not be a corresponding workspace for dock cons, therefore we
338 * have to be careful here. */
340 fullscreen = con_get_fullscreen_con(workspace, CF_OUTPUT);
342 fullscreen = con_get_fullscreen_con(workspace, CF_GLOBAL);
345 if (fullscreen != con && con_is_floating(con) && con_is_leaf(con)) {
346 /* find the height for the decorations */
347 int deco_height = con->deco_rect.height;
348 /* we actually need to apply the size/position changes to the *parent*
350 Rect bsr = con_border_style_rect(con);
351 if (con->border_style == BS_NORMAL) {
352 bsr.y += deco_height;
353 bsr.height -= deco_height;
355 Con *floatingcon = con->parent;
357 if (strcmp(con_get_workspace(floatingcon)->name, "__i3_scratch") == 0) {
358 DLOG("This is a scratchpad container, ignoring ConfigureRequest\n");
362 Rect newrect = floatingcon->rect;
364 if (event->value_mask & XCB_CONFIG_WINDOW_X) {
365 newrect.x = event->x + (-1) * bsr.x;
366 DLOG("proposed x = %d, new x is %d\n", event->x, newrect.x);
368 if (event->value_mask & XCB_CONFIG_WINDOW_Y) {
369 newrect.y = event->y + (-1) * bsr.y;
370 DLOG("proposed y = %d, new y is %d\n", event->y, newrect.y);
372 if (event->value_mask & XCB_CONFIG_WINDOW_WIDTH) {
373 newrect.width = event->width + (-1) * bsr.width;
374 newrect.width += con->border_width * 2;
375 DLOG("proposed width = %d, new width is %d (x11 border %d)\n",
376 event->width, newrect.width, con->border_width);
378 if (event->value_mask & XCB_CONFIG_WINDOW_HEIGHT) {
379 newrect.height = event->height + (-1) * bsr.height;
380 newrect.height += con->border_width * 2;
381 DLOG("proposed height = %d, new height is %d (x11 border %d)\n",
382 event->height, newrect.height, con->border_width);
385 DLOG("Container is a floating leaf node, will do that.\n");
386 floating_reposition(floatingcon, newrect);
390 /* Dock windows can be reconfigured in their height */
391 if (con->parent && con->parent->type == CT_DOCKAREA) {
392 DLOG("Dock window, only height reconfiguration allowed\n");
393 if (event->value_mask & XCB_CONFIG_WINDOW_HEIGHT) {
394 DLOG("Height given, changing\n");
396 con->geometry.height = event->height;
401 fake_absolute_configure_notify(con);
408 * Configuration notifies are only handled because we need to set up ignore for
409 * the following enter notify events.
412 int handle_configure_event(void *prophs, xcb_connection_t *conn, xcb_configure_notify_event_t *event) {
413 DLOG("configure_event, sequence %d\n", event->sequence);
414 /* We ignore this sequence twice because events for child and frame should be ignored */
415 add_ignore_event(event->sequence);
416 add_ignore_event(event->sequence);
423 * Gets triggered upon a RandR screen change event, that is when the user
424 * changes the screen configuration in any way (mode, position, …)
427 static void handle_screen_change(xcb_generic_event_t *e) {
428 DLOG("RandR screen change\n");
430 /* The geometry of the root window is used for “fullscreen global” and
431 * changes when new outputs are added. */
432 xcb_get_geometry_cookie_t cookie = xcb_get_geometry(conn, root);
433 xcb_get_geometry_reply_t *reply = xcb_get_geometry_reply(conn, cookie, NULL);
435 ELOG("Could not get geometry of the root window, exiting\n");
438 DLOG("root geometry reply: (%d, %d) %d x %d\n", reply->x, reply->y, reply->width, reply->height);
440 croot->rect.width = reply->width;
441 croot->rect.height = reply->height;
443 randr_query_outputs();
445 scratchpad_fix_resolution();
447 ipc_send_event("output", I3_IPC_EVENT_OUTPUT, "{\"change\":\"unspecified\"}");
453 * Our window decorations were unmapped. That means, the window will be killed
454 * now, so we better clean up before.
457 static void handle_unmap_notify_event(xcb_unmap_notify_event_t *event) {
458 DLOG("UnmapNotify for 0x%08x (received from 0x%08x), serial %d\n", event->window, event->event, event->sequence);
459 xcb_get_input_focus_cookie_t cookie;
460 Con *con = con_by_window_id(event->window);
462 /* This could also be an UnmapNotify for the frame. We need to
463 * decrement the ignore_unmap counter. */
464 con = con_by_frame_id(event->window);
466 LOG("Not a managed window, ignoring UnmapNotify event\n");
470 if (con->ignore_unmap > 0)
472 /* See the end of this function. */
473 cookie = xcb_get_input_focus(conn);
474 DLOG("ignore_unmap = %d for frame of container %p\n", con->ignore_unmap, con);
478 /* See the end of this function. */
479 cookie = xcb_get_input_focus(conn);
481 if (con->ignore_unmap > 0) {
482 DLOG("ignore_unmap = %d, dec\n", con->ignore_unmap);
487 tree_close(con, DONT_KILL_WINDOW, false, false);
491 /* If the client (as opposed to i3) destroyed or unmapped a window, an
492 * EnterNotify event will follow (indistinguishable from an EnterNotify
493 * event caused by moving your mouse), causing i3 to set focus to whichever
494 * window is now visible.
496 * In a complex stacked or tabbed layout (take two v-split containers in a
497 * tabbed container), when the bottom window in tab2 is closed, the bottom
498 * window of tab1 is visible instead. X11 will thus send an EnterNotify
499 * event for the bottom window of tab1, while the focus should be set to
500 * the remaining window of tab2.
502 * Therefore, we ignore all EnterNotify events which have the same sequence
503 * as an UnmapNotify event. */
504 add_ignore_event(event->sequence, XCB_ENTER_NOTIFY);
506 /* Since we just ignored the sequence of this UnmapNotify, we want to make
507 * sure that following events use a different sequence. When putting xterm
508 * into fullscreen and moving the pointer to a different window, without
509 * using GetInputFocus, subsequent (legitimate) EnterNotify events arrived
510 * with the same sequence and thus were ignored (see ticket #609). */
511 free(xcb_get_input_focus_reply(conn, cookie, NULL));
515 * A destroy notify event is sent when the window is not unmapped, but
516 * immediately destroyed (for example when starting a window and immediately
517 * killing the program which started it).
519 * We just pass on the event to the unmap notify handler (by copying the
520 * important fields in the event data structure).
523 static void handle_destroy_notify_event(xcb_destroy_notify_event_t *event) {
524 DLOG("destroy notify for 0x%08x, 0x%08x\n", event->event, event->window);
526 xcb_unmap_notify_event_t unmap;
527 unmap.sequence = event->sequence;
528 unmap.event = event->event;
529 unmap.window = event->window;
531 handle_unmap_notify_event(&unmap);
534 static bool window_name_changed(i3Window *window, char *old_name) {
535 if ((old_name == NULL) && (window->name == NULL))
538 /* Either the old or the new one is NULL, but not both. */
539 if ((old_name == NULL) ^ (window->name == NULL))
542 return (strcmp(old_name, i3string_as_utf8(window->name)) != 0);
546 * Called when a window changes its title
549 static bool handle_windowname_change(void *data, xcb_connection_t *conn, uint8_t state,
550 xcb_window_t window, xcb_atom_t atom, xcb_get_property_reply_t *prop) {
552 if ((con = con_by_window_id(window)) == NULL || con->window == NULL)
555 char *old_name = (con->window->name != NULL ? sstrdup(i3string_as_utf8(con->window->name)) : NULL);
557 window_update_name(con->window, prop, false);
559 x_push_changes(croot);
561 if (window_name_changed(con->window, old_name))
562 ipc_send_window_event("title", con);
570 * Handles legacy window name updates (WM_NAME), see also src/window.c,
571 * window_update_name_legacy().
574 static bool handle_windowname_change_legacy(void *data, xcb_connection_t *conn, uint8_t state,
575 xcb_window_t window, xcb_atom_t atom, xcb_get_property_reply_t *prop) {
577 if ((con = con_by_window_id(window)) == NULL || con->window == NULL)
580 char *old_name = (con->window->name != NULL ? sstrdup(i3string_as_utf8(con->window->name)) : NULL);
582 window_update_name_legacy(con->window, prop, false);
584 x_push_changes(croot);
586 if (window_name_changed(con->window, old_name))
587 ipc_send_window_event("title", con);
595 * Called when a window changes its WM_WINDOW_ROLE.
598 static bool handle_windowrole_change(void *data, xcb_connection_t *conn, uint8_t state,
599 xcb_window_t window, xcb_atom_t atom, xcb_get_property_reply_t *prop) {
601 if ((con = con_by_window_id(window)) == NULL || con->window == NULL)
604 window_update_role(con->window, prop, false);
611 * Updates the client’s WM_CLASS property
614 static int handle_windowclass_change(void *data, xcb_connection_t *conn, uint8_t state,
615 xcb_window_t window, xcb_atom_t atom, xcb_get_property_reply_t *prop) {
617 if ((con = con_by_window_id(window)) == NULL || con->window == NULL)
620 window_update_class(con->window, prop, false);
627 * Expose event means we should redraw our windows (= title bar)
630 static void handle_expose_event(xcb_expose_event_t *event) {
633 DLOG("window = %08x\n", event->window);
635 if ((parent = con_by_frame_id(event->window)) == NULL) {
636 LOG("expose event for unknown window, ignoring\n");
640 /* Since we render to our pixmap on every change anyways, expose events
641 * only tell us that the X server lost (parts of) the window contents. We
642 * can handle that by copying the appropriate part from our pixmap to the
644 xcb_copy_area(conn, parent->pixmap, parent->frame, parent->pm_gc,
645 event->x, event->y, event->x, event->y,
646 event->width, event->height);
652 #define _NET_WM_MOVERESIZE_SIZE_TOPLEFT 0
653 #define _NET_WM_MOVERESIZE_SIZE_TOP 1
654 #define _NET_WM_MOVERESIZE_SIZE_TOPRIGHT 2
655 #define _NET_WM_MOVERESIZE_SIZE_RIGHT 3
656 #define _NET_WM_MOVERESIZE_SIZE_BOTTOMRIGHT 4
657 #define _NET_WM_MOVERESIZE_SIZE_BOTTOM 5
658 #define _NET_WM_MOVERESIZE_SIZE_BOTTOMLEFT 6
659 #define _NET_WM_MOVERESIZE_SIZE_LEFT 7
660 #define _NET_WM_MOVERESIZE_MOVE 8 /* movement only */
661 #define _NET_WM_MOVERESIZE_SIZE_KEYBOARD 9 /* size via keyboard */
662 #define _NET_WM_MOVERESIZE_MOVE_KEYBOARD 10 /* move via keyboard */
663 #define _NET_WM_MOVERESIZE_CANCEL 11 /* cancel operation */
666 * Handle client messages (EWMH)
669 static void handle_client_message(xcb_client_message_event_t *event) {
670 /* If this is a startup notification ClientMessage, the library will handle
671 * it and call our monitor_event() callback. */
672 if (sn_xcb_display_process_event(sndisplay, (xcb_generic_event_t *)event))
675 LOG("ClientMessage for window 0x%08x\n", event->window);
676 if (event->type == A__NET_WM_STATE) {
677 if (event->format != 32 ||
678 (event->data.data32[1] != A__NET_WM_STATE_FULLSCREEN &&
679 event->data.data32[1] != A__NET_WM_STATE_DEMANDS_ATTENTION)) {
680 DLOG("Unknown atom in clientmessage of type %d\n", event->data.data32[1]);
684 Con *con = con_by_window_id(event->window);
686 DLOG("Could not get window for client message\n");
690 if (event->data.data32[1] == A__NET_WM_STATE_FULLSCREEN) {
691 /* Check if the fullscreen state should be toggled */
692 if ((con->fullscreen_mode != CF_NONE &&
693 (event->data.data32[0] == _NET_WM_STATE_REMOVE ||
694 event->data.data32[0] == _NET_WM_STATE_TOGGLE)) ||
695 (con->fullscreen_mode == CF_NONE &&
696 (event->data.data32[0] == _NET_WM_STATE_ADD ||
697 event->data.data32[0] == _NET_WM_STATE_TOGGLE))) {
698 DLOG("toggling fullscreen\n");
699 con_toggle_fullscreen(con, CF_OUTPUT);
701 } else if (event->data.data32[1] == A__NET_WM_STATE_DEMANDS_ATTENTION) {
702 /* Check if the urgent flag must be set or not */
703 if (event->data.data32[0] == _NET_WM_STATE_ADD)
704 con_set_urgency(con, true);
705 else if (event->data.data32[0] == _NET_WM_STATE_REMOVE)
706 con_set_urgency(con, false);
707 else if (event->data.data32[0] == _NET_WM_STATE_TOGGLE)
708 con_set_urgency(con, !con->urgent);
712 } else if (event->type == A__NET_ACTIVE_WINDOW) {
713 if (event->format != 32)
716 DLOG("_NET_ACTIVE_WINDOW: Window 0x%08x should be activated\n", event->window);
718 Con *con = con_by_window_id(event->window);
720 DLOG("Could not get window for client message\n");
724 Con *ws = con_get_workspace(con);
727 DLOG("Window is not being managed, ignoring _NET_ACTIVE_WINDOW\n");
731 if (con_is_internal(ws)) {
732 DLOG("Workspace is internal, ignoring _NET_ACTIVE_WINDOW\n");
736 /* data32[0] indicates the source of the request (application or pager) */
737 if (event->data.data32[0] == 2) {
738 /* Always focus the con if it is from a pager, because this is most
739 * likely from some user action */
740 DLOG("This request came from a pager. Focusing con = %p\n", con);
744 /* Request is from an application. */
746 if (config.focus_on_window_activation == FOWA_FOCUS || (config.focus_on_window_activation == FOWA_SMART && workspace_is_visible(ws))) {
747 DLOG("Focusing con = %p\n", con);
750 } else if (config.focus_on_window_activation == FOWA_URGENT || (config.focus_on_window_activation == FOWA_SMART && !workspace_is_visible(ws))) {
751 DLOG("Marking con = %p urgent\n", con);
752 con_set_urgency(con, true);
754 DLOG("Ignoring request for con = %p.\n", con);
758 } else if (event->type == A_I3_SYNC) {
759 xcb_window_t window = event->data.data32[0];
760 uint32_t rnd = event->data.data32[1];
761 DLOG("[i3 sync protocol] Sending random value %d back to X11 window 0x%08x\n", rnd, window);
763 void *reply = scalloc(32);
764 xcb_client_message_event_t *ev = reply;
766 ev->response_type = XCB_CLIENT_MESSAGE;
768 ev->type = A_I3_SYNC;
770 ev->data.data32[0] = window;
771 ev->data.data32[1] = rnd;
773 xcb_send_event(conn, false, window, XCB_EVENT_MASK_NO_EVENT, (char *)ev);
776 } else if (event->type == A__NET_REQUEST_FRAME_EXTENTS) {
778 * A client can request an estimate for the frame size which the window
779 * manager will put around it before actually mapping its window. Java
780 * does this (as of openjdk-7).
782 * Note that the calculation below is not entirely accurate — once you
783 * set a different border type, it’s off. We _could_ request all the
784 * window properties (which have to be set up at this point according
785 * to EWMH), but that seems rather elaborate. The standard explicitly
786 * says the application must cope with an estimate that is not entirely
789 DLOG("_NET_REQUEST_FRAME_EXTENTS for window 0x%08x\n", event->window);
791 /* The reply data: approximate frame size */
793 config.default_border_width, /* left */
794 config.default_border_width, /* right */
795 config.font.height + 5, /* top */
796 config.default_border_width /* bottom */
800 XCB_PROP_MODE_REPLACE,
802 A__NET_FRAME_EXTENTS,
803 XCB_ATOM_CARDINAL, 32, 4,
806 } else if (event->type == A__NET_CURRENT_DESKTOP) {
807 /* This request is used by pagers and bars to change the current
808 * desktop likely as a result of some user action. We interpret this as
809 * a request to focus the given workspace. See
810 * http://standards.freedesktop.org/wm-spec/latest/ar01s03.html#idm140251368135008
814 DLOG("Request to change current desktop to index %d\n", event->data.data32[0]);
816 TAILQ_FOREACH(output, &(croot->nodes_head), nodes) {
818 TAILQ_FOREACH(ws, &(output_get_content(output)->nodes_head), nodes) {
819 if (STARTS_WITH(ws->name, "__"))
822 if (idx == event->data.data32[0]) {
823 /* data32[1] is a timestamp used to prevent focus race conditions */
824 if (event->data.data32[1])
825 last_timestamp = event->data.data32[1];
827 DLOG("Handling request to focus workspace %s\n", ws->name);
838 } else if (event->type == A__NET_CLOSE_WINDOW) {
840 * Pagers wanting to close a window MUST send a _NET_CLOSE_WINDOW
841 * client message request to the root window.
842 * http://standards.freedesktop.org/wm-spec/wm-spec-latest.html#idm140200472668896
844 Con *con = con_by_window_id(event->window);
846 DLOG("Handling _NET_CLOSE_WINDOW request (con = %p)\n", con);
848 if (event->data.data32[0])
849 last_timestamp = event->data.data32[0];
851 tree_close(con, KILL_WINDOW, false, false);
854 DLOG("Couldn't find con for _NET_CLOSE_WINDOW request. (window = %d)\n", event->window);
856 } else if (event->type == A__NET_WM_MOVERESIZE) {
858 * Client-side decorated Gtk3 windows emit this signal when being
859 * dragged by their GtkHeaderBar
861 Con *con = con_by_window_id(event->window);
862 if (!con || !con_is_floating(con)) {
863 DLOG("Couldn't find con for _NET_WM_MOVERESIZE request, or con not floating (window = %d)\n", event->window);
866 DLOG("Handling _NET_WM_MOVERESIZE request (con = %p)\n", con);
867 uint32_t direction = event->data.data32[2];
868 uint32_t x_root = event->data.data32[0];
869 uint32_t y_root = event->data.data32[1];
870 /* construct fake xcb_button_press_event_t */
871 xcb_button_press_event_t fake = {
874 .event_x = x_root - (con->rect.x),
875 .event_y = y_root - (con->rect.y)};
877 case _NET_WM_MOVERESIZE_MOVE:
878 floating_drag_window(con->parent, &fake);
880 case _NET_WM_MOVERESIZE_SIZE_TOPLEFT... _NET_WM_MOVERESIZE_SIZE_LEFT:
881 floating_resize_window(con->parent, false, &fake);
884 DLOG("_NET_WM_MOVERESIZE direction %d not implemented\n", direction);
888 DLOG("unhandled clientmessage\n");
893 bool handle_window_type(void *data, xcb_connection_t *conn, uint8_t state, xcb_window_t window,
894 xcb_atom_t atom, xcb_get_property_reply_t *reply) {
896 if ((con = con_by_window_id(window)) == NULL || con->window == NULL)
899 window_update_type(con->window, reply);
904 * Handles the size hints set by a window, but currently only the part necessary for displaying
905 * clients proportionally inside their frames (mplayer for example)
907 * See ICCCM 4.1.2.3 for more details
910 static bool handle_normal_hints(void *data, xcb_connection_t *conn, uint8_t state, xcb_window_t window,
911 xcb_atom_t name, xcb_get_property_reply_t *reply) {
912 Con *con = con_by_window_id(window);
914 DLOG("Received WM_NORMAL_HINTS for unknown client\n");
918 xcb_size_hints_t size_hints;
920 //CLIENT_LOG(client);
922 /* If the hints were already in this event, use them, if not, request them */
924 xcb_icccm_get_wm_size_hints_from_reply(&size_hints, reply);
926 xcb_icccm_get_wm_normal_hints_reply(conn, xcb_icccm_get_wm_normal_hints_unchecked(conn, con->window->id), &size_hints, NULL);
928 if ((size_hints.flags & XCB_ICCCM_SIZE_HINT_P_MIN_SIZE)) {
929 // TODO: Minimum size is not yet implemented
930 DLOG("Minimum size: %d (width) x %d (height)\n", size_hints.min_width, size_hints.min_height);
933 bool changed = false;
934 if ((size_hints.flags & XCB_ICCCM_SIZE_HINT_P_RESIZE_INC)) {
935 if (size_hints.width_inc > 0 && size_hints.width_inc < 0xFFFF)
936 if (con->width_increment != size_hints.width_inc) {
937 con->width_increment = size_hints.width_inc;
940 if (size_hints.height_inc > 0 && size_hints.height_inc < 0xFFFF)
941 if (con->height_increment != size_hints.height_inc) {
942 con->height_increment = size_hints.height_inc;
947 DLOG("resize increments changed\n");
950 int base_width = 0, base_height = 0;
952 /* base_width/height are the desired size of the window.
953 We check if either the program-specified size or the program-specified
954 min-size is available */
955 if (size_hints.flags & XCB_ICCCM_SIZE_HINT_BASE_SIZE) {
956 base_width = size_hints.base_width;
957 base_height = size_hints.base_height;
958 } else if (size_hints.flags & XCB_ICCCM_SIZE_HINT_P_MIN_SIZE) {
959 /* TODO: is this right? icccm says not */
960 base_width = size_hints.min_width;
961 base_height = size_hints.min_height;
964 if (base_width != con->base_width ||
965 base_height != con->base_height) {
966 con->base_width = base_width;
967 con->base_height = base_height;
968 DLOG("client's base_height changed to %d\n", base_height);
969 DLOG("client's base_width changed to %d\n", base_width);
973 /* If no aspect ratio was set or if it was invalid, we ignore the hints */
974 if (!(size_hints.flags & XCB_ICCCM_SIZE_HINT_P_ASPECT) ||
975 (size_hints.min_aspect_num <= 0) ||
976 (size_hints.min_aspect_den <= 0)) {
977 goto render_and_return;
980 /* XXX: do we really use rect here, not window_rect? */
981 double width = con->rect.width - base_width;
982 double height = con->rect.height - base_height;
983 /* Convert numerator/denominator to a double */
984 double min_aspect = (double)size_hints.min_aspect_num / size_hints.min_aspect_den;
985 double max_aspect = (double)size_hints.max_aspect_num / size_hints.min_aspect_den;
987 DLOG("Aspect ratio set: minimum %f, maximum %f\n", min_aspect, max_aspect);
988 DLOG("width = %f, height = %f\n", width, height);
990 /* Sanity checks, this is user-input, in a way */
991 if (max_aspect <= 0 || min_aspect <= 0 || height == 0 || (width / height) <= 0)
992 goto render_and_return;
994 /* Check if we need to set proportional_* variables using the correct ratio */
995 double aspect_ratio = 0.0;
996 if ((width / height) < min_aspect) {
997 aspect_ratio = min_aspect;
998 } else if ((width / height) > max_aspect) {
999 aspect_ratio = max_aspect;
1001 goto render_and_return;
1003 if (fabs(con->aspect_ratio - aspect_ratio) > DBL_EPSILON) {
1004 con->aspect_ratio = aspect_ratio;
1016 * Handles the WM_HINTS property for extracting the urgency state of the window.
1019 static bool handle_hints(void *data, xcb_connection_t *conn, uint8_t state, xcb_window_t window,
1020 xcb_atom_t name, xcb_get_property_reply_t *reply) {
1021 Con *con = con_by_window_id(window);
1023 DLOG("Received WM_HINTS for unknown client\n");
1029 reply = xcb_get_property_reply(conn, xcb_icccm_get_wm_hints(conn, window), NULL);
1030 window_update_hints(con->window, reply, &urgency_hint);
1031 con_set_urgency(con, urgency_hint);
1038 * Handles the transient for hints set by a window, signalizing that this window is a popup window
1039 * for some other window.
1041 * See ICCCM 4.1.2.6 for more details
1044 static bool handle_transient_for(void *data, xcb_connection_t *conn, uint8_t state, xcb_window_t window,
1045 xcb_atom_t name, xcb_get_property_reply_t *prop) {
1048 if ((con = con_by_window_id(window)) == NULL || con->window == NULL) {
1049 DLOG("No such window\n");
1054 prop = xcb_get_property_reply(conn, xcb_get_property_unchecked(conn,
1055 false, window, XCB_ATOM_WM_TRANSIENT_FOR, XCB_ATOM_WINDOW, 0, 32),
1061 window_update_transient_for(con->window, prop);
1067 * Handles changes of the WM_CLIENT_LEADER atom which specifies if this is a
1068 * toolwindow (or similar) and to which window it belongs (logical parent).
1071 static bool handle_clientleader_change(void *data, xcb_connection_t *conn, uint8_t state, xcb_window_t window,
1072 xcb_atom_t name, xcb_get_property_reply_t *prop) {
1074 if ((con = con_by_window_id(window)) == NULL || con->window == NULL)
1078 prop = xcb_get_property_reply(conn, xcb_get_property_unchecked(conn,
1079 false, window, A_WM_CLIENT_LEADER, XCB_ATOM_WINDOW, 0, 32),
1085 window_update_leader(con->window, prop);
1091 * Handles FocusIn events which are generated by clients (i3’s focus changes
1092 * don’t generate FocusIn events due to a different EventMask) and updates the
1093 * decorations accordingly.
1096 static void handle_focus_in(xcb_focus_in_event_t *event) {
1097 DLOG("focus change in, for window 0x%08x\n", event->event);
1099 if ((con = con_by_window_id(event->event)) == NULL || con->window == NULL)
1101 DLOG("That is con %p / %s\n", con, con->name);
1103 if (event->mode == XCB_NOTIFY_MODE_GRAB ||
1104 event->mode == XCB_NOTIFY_MODE_UNGRAB) {
1105 DLOG("FocusIn event for grab/ungrab, ignoring\n");
1109 if (event->detail == XCB_NOTIFY_DETAIL_POINTER) {
1110 DLOG("notify detail is pointer, ignoring this event\n");
1114 if (focused_id == event->event) {
1115 DLOG("focus matches the currently focused window, not doing anything\n");
1119 /* Skip dock clients, they cannot get the i3 focus. */
1120 if (con->parent->type == CT_DOCKAREA) {
1121 DLOG("This is a dock client, not focusing.\n");
1125 DLOG("focus is different, updating decorations\n");
1127 /* Get the currently focused workspace to check if the focus change also
1128 * involves changing workspaces. If so, we need to call workspace_show() to
1129 * correctly update state and send the IPC event. */
1130 Con *ws = con_get_workspace(con);
1131 if (ws != con_get_workspace(focused))
1135 /* We update focused_id because we don’t need to set focus again */
1136 focused_id = event->event;
1137 x_push_changes(croot);
1142 * Handles the WM_CLASS property for assignments and criteria selection.
1145 static bool handle_class_change(void *data, xcb_connection_t *conn, uint8_t state, xcb_window_t window,
1146 xcb_atom_t name, xcb_get_property_reply_t *prop) {
1148 if ((con = con_by_window_id(window)) == NULL || con->window == NULL)
1152 prop = xcb_get_property_reply(conn, xcb_get_property_unchecked(conn,
1153 false, window, XCB_ATOM_WM_CLASS, XCB_ATOM_STRING, 0, 32),
1160 window_update_class(con->window, prop, false);
1166 * Handles the _NET_WM_STRUT_PARTIAL property for allocating space for dock clients.
1169 static bool handle_strut_partial_change(void *data, xcb_connection_t *conn, uint8_t state, xcb_window_t window,
1170 xcb_atom_t name, xcb_get_property_reply_t *prop) {
1171 DLOG("strut partial change for window 0x%08x\n", window);
1174 if ((con = con_by_window_id(window)) == NULL || con->window == NULL) {
1179 xcb_generic_error_t *err = NULL;
1180 xcb_get_property_cookie_t strut_cookie = xcb_get_property(conn, false, window, A__NET_WM_STRUT_PARTIAL,
1181 XCB_GET_PROPERTY_TYPE_ANY, 0, UINT32_MAX);
1182 prop = xcb_get_property_reply(conn, strut_cookie, &err);
1185 DLOG("got error when getting strut partial property: %d\n", err->error_code);
1195 DLOG("That is con %p / %s\n", con, con->name);
1197 window_update_strut_partial(con->window, prop);
1199 /* we only handle this change for dock clients */
1200 if (con->parent == NULL || con->parent->type != CT_DOCKAREA) {
1204 Con *search_at = croot;
1205 Con *output = con_get_output(con);
1206 if (output != NULL) {
1207 DLOG("Starting search at output %s\n", output->name);
1211 /* find out the desired position of this dock window */
1212 if (con->window->reserved.top > 0 && con->window->reserved.bottom == 0) {
1213 DLOG("Top dock client\n");
1214 con->window->dock = W_DOCK_TOP;
1215 } else if (con->window->reserved.top == 0 && con->window->reserved.bottom > 0) {
1216 DLOG("Bottom dock client\n");
1217 con->window->dock = W_DOCK_BOTTOM;
1219 DLOG("Ignoring invalid reserved edges (_NET_WM_STRUT_PARTIAL), using position as fallback:\n");
1220 if (con->geometry.y < (search_at->rect.height / 2)) {
1221 DLOG("geom->y = %d < rect.height / 2 = %d, it is a top dock client\n",
1222 con->geometry.y, (search_at->rect.height / 2));
1223 con->window->dock = W_DOCK_TOP;
1225 DLOG("geom->y = %d >= rect.height / 2 = %d, it is a bottom dock client\n",
1226 con->geometry.y, (search_at->rect.height / 2));
1227 con->window->dock = W_DOCK_BOTTOM;
1231 /* find the dockarea */
1232 Con *dockarea = con_for_window(search_at, con->window, NULL);
1233 assert(dockarea != NULL);
1235 /* attach the dock to the dock area */
1237 con->parent = dockarea;
1238 TAILQ_INSERT_HEAD(&(dockarea->focus_head), con, focused);
1239 TAILQ_INSERT_HEAD(&(dockarea->nodes_head), con, nodes);
1246 /* Returns false if the event could not be processed (e.g. the window could not
1247 * be found), true otherwise */
1248 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);
1250 struct property_handler_t {
1253 cb_property_handler_t cb;
1256 static struct property_handler_t property_handlers[] = {
1257 {0, 128, handle_windowname_change},
1258 {0, UINT_MAX, handle_hints},
1259 {0, 128, handle_windowname_change_legacy},
1260 {0, UINT_MAX, handle_normal_hints},
1261 {0, UINT_MAX, handle_clientleader_change},
1262 {0, UINT_MAX, handle_transient_for},
1263 {0, 128, handle_windowrole_change},
1264 {0, 128, handle_class_change},
1265 {0, UINT_MAX, handle_strut_partial_change},
1266 {0, UINT_MAX, handle_window_type}};
1267 #define NUM_HANDLERS (sizeof(property_handlers) / sizeof(struct property_handler_t))
1270 * Sets the appropriate atoms for the property handlers after the atoms were
1274 void property_handlers_init(void) {
1275 sn_monitor_context_new(sndisplay, conn_screen, startup_monitor_event, NULL, NULL);
1277 property_handlers[0].atom = A__NET_WM_NAME;
1278 property_handlers[1].atom = XCB_ATOM_WM_HINTS;
1279 property_handlers[2].atom = XCB_ATOM_WM_NAME;
1280 property_handlers[3].atom = XCB_ATOM_WM_NORMAL_HINTS;
1281 property_handlers[4].atom = A_WM_CLIENT_LEADER;
1282 property_handlers[5].atom = XCB_ATOM_WM_TRANSIENT_FOR;
1283 property_handlers[6].atom = A_WM_WINDOW_ROLE;
1284 property_handlers[7].atom = XCB_ATOM_WM_CLASS;
1285 property_handlers[8].atom = A__NET_WM_STRUT_PARTIAL;
1286 property_handlers[9].atom = A__NET_WM_WINDOW_TYPE;
1289 static void property_notify(uint8_t state, xcb_window_t window, xcb_atom_t atom) {
1290 struct property_handler_t *handler = NULL;
1291 xcb_get_property_reply_t *propr = NULL;
1293 for (size_t c = 0; c < sizeof(property_handlers) / sizeof(struct property_handler_t); c++) {
1294 if (property_handlers[c].atom != atom)
1297 handler = &property_handlers[c];
1301 if (handler == NULL) {
1302 //DLOG("Unhandled property notify for atom %d (0x%08x)\n", atom, atom);
1306 if (state != XCB_PROPERTY_DELETE) {
1307 xcb_get_property_cookie_t cookie = xcb_get_property(conn, 0, window, atom, XCB_GET_PROPERTY_TYPE_ANY, 0, handler->long_len);
1308 propr = xcb_get_property_reply(conn, cookie, 0);
1311 /* the handler will free() the reply unless it returns false */
1312 if (!handler->cb(NULL, conn, state, window, atom, propr))
1317 * Takes an xcb_generic_event_t and calls the appropriate handler, based on the
1321 void handle_event(int type, xcb_generic_event_t *event) {
1322 DLOG("event type %d, xkb_base %d\n", type, xkb_base);
1323 if (randr_base > -1 &&
1324 type == randr_base + XCB_RANDR_SCREEN_CHANGE_NOTIFY) {
1325 handle_screen_change(event);
1329 if (xkb_base > -1 && type == xkb_base) {
1330 DLOG("xkb event, need to handle it.\n");
1332 xcb_xkb_state_notify_event_t *state = (xcb_xkb_state_notify_event_t *)event;
1333 if (state->xkbType == XCB_XKB_NEW_KEYBOARD_NOTIFY) {
1334 DLOG("xkb new keyboard notify, sequence %d, time %d\n", state->sequence, state->time);
1335 xcb_key_symbols_free(keysyms);
1336 keysyms = xcb_key_symbols_alloc(conn);
1337 ungrab_all_keys(conn);
1338 translate_keysyms();
1339 grab_all_keys(conn, false);
1340 } else if (state->xkbType == XCB_XKB_MAP_NOTIFY) {
1341 if (event_is_ignored(event->sequence, type)) {
1342 DLOG("Ignoring map notify event for sequence %d.\n", state->sequence);
1344 DLOG("xkb map notify, sequence %d, time %d\n", state->sequence, state->time);
1345 add_ignore_event(event->sequence, type);
1346 xcb_key_symbols_free(keysyms);
1347 keysyms = xcb_key_symbols_alloc(conn);
1348 ungrab_all_keys(conn);
1349 translate_keysyms();
1350 grab_all_keys(conn, false);
1352 } else if (state->xkbType == XCB_XKB_STATE_NOTIFY) {
1353 DLOG("xkb state group = %d\n", state->group);
1355 /* See The XKB Extension: Library Specification, section 14.1 */
1356 /* We check if the current group (each group contains
1357 * two levels) has been changed. Mode_switch activates
1358 * group XCB_XKB_GROUP_2 */
1359 if (xkb_current_group == state->group)
1361 xkb_current_group = state->group;
1362 if (state->group == XCB_XKB_GROUP_1) {
1363 DLOG("Mode_switch disabled\n");
1364 ungrab_all_keys(conn);
1365 grab_all_keys(conn, false);
1367 DLOG("Mode_switch enabled\n");
1368 grab_all_keys(conn, true);
1377 case XCB_KEY_RELEASE:
1378 handle_key_press((xcb_key_press_event_t *)event);
1381 case XCB_BUTTON_PRESS:
1382 case XCB_BUTTON_RELEASE:
1383 handle_button_press((xcb_button_press_event_t *)event);
1386 case XCB_MAP_REQUEST:
1387 handle_map_request((xcb_map_request_event_t *)event);
1390 case XCB_UNMAP_NOTIFY:
1391 handle_unmap_notify_event((xcb_unmap_notify_event_t *)event);
1394 case XCB_DESTROY_NOTIFY:
1395 handle_destroy_notify_event((xcb_destroy_notify_event_t *)event);
1399 handle_expose_event((xcb_expose_event_t *)event);
1402 case XCB_MOTION_NOTIFY:
1403 handle_motion_notify((xcb_motion_notify_event_t *)event);
1406 /* Enter window = user moved their mouse over the window */
1407 case XCB_ENTER_NOTIFY:
1408 handle_enter_notify((xcb_enter_notify_event_t *)event);
1411 /* Client message are sent to the root window. The only interesting
1412 * client message for us is _NET_WM_STATE, we honour
1413 * _NET_WM_STATE_FULLSCREEN and _NET_WM_STATE_DEMANDS_ATTENTION */
1414 case XCB_CLIENT_MESSAGE:
1415 handle_client_message((xcb_client_message_event_t *)event);
1418 /* Configure request = window tried to change size on its own */
1419 case XCB_CONFIGURE_REQUEST:
1420 handle_configure_request((xcb_configure_request_event_t *)event);
1423 /* Mapping notify = keyboard mapping changed (Xmodmap), re-grab bindings */
1424 case XCB_MAPPING_NOTIFY:
1425 handle_mapping_notify((xcb_mapping_notify_event_t *)event);
1429 handle_focus_in((xcb_focus_in_event_t *)event);
1432 case XCB_PROPERTY_NOTIFY: {
1433 xcb_property_notify_event_t *e = (xcb_property_notify_event_t *)event;
1434 last_timestamp = e->time;
1435 property_notify(e->state, e->window, e->atom);
1440 //DLOG("Unhandled event of type %d\n", type);