]> git.sur5r.net Git - i3/i3/blob - src/con.c
Force container to be redrawn upon moving to another container. (#2769)
[i3/i3] / src / con.c
1 /*
2  * vim:ts=4:sw=4:expandtab
3  *
4  * i3 - an improved dynamic tiling window manager
5  * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
6  *
7  * con.c: Functions which deal with containers directly (creating containers,
8  *        searching containers, getting specific properties from containers,
9  *        …).
10  *
11  */
12 #include "all.h"
13
14 #include "yajl_utils.h"
15
16 static void con_on_remove_child(Con *con);
17
18 /*
19  * force parent split containers to be redrawn
20  *
21  */
22 void con_force_split_parents_redraw(Con *con) {
23     Con *parent = con;
24
25     while (parent && parent->type != CT_WORKSPACE && parent->type != CT_DOCKAREA) {
26         if (!con_is_leaf(parent))
27             FREE(parent->deco_render_params);
28         parent = parent->parent;
29     }
30 }
31
32 /*
33  * Create a new container (and attach it to the given parent, if not NULL).
34  * This function only initializes the data structures.
35  *
36  */
37 Con *con_new_skeleton(Con *parent, i3Window *window) {
38     Con *new = scalloc(1, sizeof(Con));
39     new->on_remove_child = con_on_remove_child;
40     TAILQ_INSERT_TAIL(&all_cons, new, all_cons);
41     new->type = CT_CON;
42     new->window = window;
43     new->border_style = config.default_border;
44     new->current_border_width = -1;
45     if (window) {
46         new->depth = window->depth;
47         new->window->aspect_ratio = 0.0;
48     } else {
49         new->depth = root_depth;
50     }
51     DLOG("opening window\n");
52
53     TAILQ_INIT(&(new->floating_head));
54     TAILQ_INIT(&(new->nodes_head));
55     TAILQ_INIT(&(new->focus_head));
56     TAILQ_INIT(&(new->swallow_head));
57     TAILQ_INIT(&(new->marks_head));
58
59     if (parent != NULL)
60         con_attach(new, parent, false);
61
62     return new;
63 }
64
65 /* A wrapper for con_new_skeleton, to retain the old con_new behaviour
66  *
67  */
68 Con *con_new(Con *parent, i3Window *window) {
69     Con *new = con_new_skeleton(parent, window);
70     x_con_init(new);
71     return new;
72 }
73
74 static void _con_attach(Con *con, Con *parent, Con *previous, bool ignore_focus) {
75     con->parent = parent;
76     Con *loop;
77     Con *current = previous;
78     struct nodes_head *nodes_head = &(parent->nodes_head);
79     struct focus_head *focus_head = &(parent->focus_head);
80
81     /* Workspaces are handled differently: they need to be inserted at the
82      * right position. */
83     if (con->type == CT_WORKSPACE) {
84         DLOG("it's a workspace. num = %d\n", con->num);
85         if (con->num == -1 || TAILQ_EMPTY(nodes_head)) {
86             TAILQ_INSERT_TAIL(nodes_head, con, nodes);
87         } else {
88             current = TAILQ_FIRST(nodes_head);
89             if (con->num < current->num) {
90                 /* we need to insert the container at the beginning */
91                 TAILQ_INSERT_HEAD(nodes_head, con, nodes);
92             } else {
93                 while (current->num != -1 && con->num > current->num) {
94                     current = TAILQ_NEXT(current, nodes);
95                     if (current == TAILQ_END(nodes_head)) {
96                         current = NULL;
97                         break;
98                     }
99                 }
100                 /* we need to insert con after current, if current is not NULL */
101                 if (current)
102                     TAILQ_INSERT_BEFORE(current, con, nodes);
103                 else
104                     TAILQ_INSERT_TAIL(nodes_head, con, nodes);
105             }
106         }
107         goto add_to_focus_head;
108     }
109
110     if (con->type == CT_FLOATING_CON) {
111         DLOG("Inserting into floating containers\n");
112         TAILQ_INSERT_TAIL(&(parent->floating_head), con, floating_windows);
113     } else {
114         if (!ignore_focus) {
115             /* Get the first tiling container in focus stack */
116             TAILQ_FOREACH(loop, &(parent->focus_head), focused) {
117                 if (loop->type == CT_FLOATING_CON)
118                     continue;
119                 current = loop;
120                 break;
121             }
122         }
123
124         /* When the container is not a split container (but contains a window)
125          * and is attached to a workspace, we check if the user configured a
126          * workspace_layout. This is done in workspace_attach_to, which will
127          * provide us with the container to which we should attach (either the
128          * workspace or a new split container with the configured
129          * workspace_layout).
130          */
131         if (con->window != NULL &&
132             parent->type == CT_WORKSPACE &&
133             parent->workspace_layout != L_DEFAULT) {
134             DLOG("Parent is a workspace. Applying default layout...\n");
135             Con *target = workspace_attach_to(parent);
136
137             /* Attach the original con to this new split con instead */
138             nodes_head = &(target->nodes_head);
139             focus_head = &(target->focus_head);
140             con->parent = target;
141             current = NULL;
142
143             DLOG("done\n");
144         }
145
146         /* Insert the container after the tiling container, if found.
147          * When adding to a CT_OUTPUT, just append one after another. */
148         if (current && parent->type != CT_OUTPUT) {
149             DLOG("Inserting con = %p after con %p\n", con, current);
150             TAILQ_INSERT_AFTER(nodes_head, current, con, nodes);
151         } else
152             TAILQ_INSERT_TAIL(nodes_head, con, nodes);
153     }
154
155 add_to_focus_head:
156     /* We insert to the TAIL because con_focus() will correct this.
157      * This way, we have the option to insert Cons without having
158      * to focus them. */
159     TAILQ_INSERT_TAIL(focus_head, con, focused);
160     con_force_split_parents_redraw(con);
161 }
162
163 /*
164  * Attaches the given container to the given parent. This happens when moving
165  * a container or when inserting a new container at a specific place in the
166  * tree.
167  *
168  * ignore_focus is to just insert the Con at the end (useful when creating a
169  * new split container *around* some containers, that is, detaching and
170  * attaching them in order without wanting to mess with the focus in between).
171  *
172  */
173 void con_attach(Con *con, Con *parent, bool ignore_focus) {
174     _con_attach(con, parent, NULL, ignore_focus);
175 }
176
177 /*
178  * Detaches the given container from its current parent
179  *
180  */
181 void con_detach(Con *con) {
182     con_force_split_parents_redraw(con);
183     if (con->type == CT_FLOATING_CON) {
184         TAILQ_REMOVE(&(con->parent->floating_head), con, floating_windows);
185         TAILQ_REMOVE(&(con->parent->focus_head), con, focused);
186     } else {
187         TAILQ_REMOVE(&(con->parent->nodes_head), con, nodes);
188         TAILQ_REMOVE(&(con->parent->focus_head), con, focused);
189     }
190 }
191
192 /*
193  * Sets input focus to the given container. Will be updated in X11 in the next
194  * run of x_push_changes().
195  *
196  */
197 void con_focus(Con *con) {
198     assert(con != NULL);
199     DLOG("con_focus = %p\n", con);
200
201     /* 1: set focused-pointer to the new con */
202     /* 2: exchange the position of the container in focus stack of the parent all the way up */
203     TAILQ_REMOVE(&(con->parent->focus_head), con, focused);
204     TAILQ_INSERT_HEAD(&(con->parent->focus_head), con, focused);
205     if (con->parent->parent != NULL)
206         con_focus(con->parent);
207
208     focused = con;
209     /* We can't blindly reset non-leaf containers since they might have
210      * other urgent children. Therefore we only reset leafs and propagate
211      * the changes upwards via con_update_parents_urgency() which does proper
212      * checks before resetting the urgency.
213      */
214     if (con->urgent && con_is_leaf(con)) {
215         con_set_urgency(con, false);
216         con_update_parents_urgency(con);
217         workspace_update_urgent_flag(con_get_workspace(con));
218         ipc_send_window_event("urgent", con);
219     }
220 }
221
222 /*
223  * Closes the given container.
224  *
225  */
226 void con_close(Con *con, kill_window_t kill_window) {
227     assert(con != NULL);
228     DLOG("Closing con = %p.\n", con);
229
230     /* We never close output or root containers. */
231     if (con->type == CT_OUTPUT || con->type == CT_ROOT) {
232         DLOG("con = %p is of type %d, not closing anything.\n", con, con->type);
233         return;
234     }
235
236     if (con->type == CT_WORKSPACE) {
237         DLOG("con = %p is a workspace, closing all children instead.\n", con);
238         Con *child, *nextchild;
239         for (child = TAILQ_FIRST(&(con->focus_head)); child;) {
240             nextchild = TAILQ_NEXT(child, focused);
241             DLOG("killing child = %p.\n", child);
242             tree_close_internal(child, kill_window, false, false);
243             child = nextchild;
244         }
245
246         return;
247     }
248
249     tree_close_internal(con, kill_window, false, false);
250 }
251
252 /*
253  * Returns true when this node is a leaf node (has no children)
254  *
255  */
256 bool con_is_leaf(Con *con) {
257     return TAILQ_EMPTY(&(con->nodes_head));
258 }
259
260 /*
261  * Returns true when this con is a leaf node with a managed X11 window (e.g.,
262  * excluding dock containers)
263  */
264 bool con_has_managed_window(Con *con) {
265     return (con != NULL && con->window != NULL && con->window->id != XCB_WINDOW_NONE && con_get_workspace(con) != NULL);
266 }
267
268 /**
269  * Returns true if this node has regular or floating children.
270  *
271  */
272 bool con_has_children(Con *con) {
273     return (!con_is_leaf(con) || !TAILQ_EMPTY(&(con->floating_head)));
274 }
275
276 /*
277  * Returns true if a container should be considered split.
278  *
279  */
280 bool con_is_split(Con *con) {
281     if (con_is_leaf(con))
282         return false;
283
284     switch (con->layout) {
285         case L_DOCKAREA:
286         case L_OUTPUT:
287             return false;
288
289         default:
290             return true;
291     }
292 }
293
294 /*
295  * This will only return true for containers which have some parent with
296  * a tabbed / stacked parent of which they are not the currently focused child.
297  *
298  */
299 bool con_is_hidden(Con *con) {
300     Con *current = con;
301
302     /* ascend to the workspace level and memorize the highest-up container
303      * which is stacked or tabbed. */
304     while (current != NULL && current->type != CT_WORKSPACE) {
305         Con *parent = current->parent;
306         if (parent != NULL && (parent->layout == L_TABBED || parent->layout == L_STACKED)) {
307             if (TAILQ_FIRST(&(parent->focus_head)) != current)
308                 return true;
309         }
310
311         current = parent;
312     }
313
314     return false;
315 }
316
317 /*
318  * Returns whether the container or any of its children is sticky.
319  *
320  */
321 bool con_is_sticky(Con *con) {
322     if (con->sticky)
323         return true;
324
325     Con *child;
326     TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
327         if (con_is_sticky(child))
328             return true;
329     }
330
331     return false;
332 }
333
334 /*
335  * Returns true if this node accepts a window (if the node swallows windows,
336  * it might already have swallowed enough and cannot hold any more).
337  *
338  */
339 bool con_accepts_window(Con *con) {
340     /* 1: workspaces never accept direct windows */
341     if (con->type == CT_WORKSPACE)
342         return false;
343
344     if (con_is_split(con)) {
345         DLOG("container %p does not accept windows, it is a split container.\n", con);
346         return false;
347     }
348
349     /* TODO: if this is a swallowing container, we need to check its max_clients */
350     return (con->window == NULL);
351 }
352
353 /*
354  * Gets the output container (first container with CT_OUTPUT in hierarchy) this
355  * node is on.
356  *
357  */
358 Con *con_get_output(Con *con) {
359     Con *result = con;
360     while (result != NULL && result->type != CT_OUTPUT)
361         result = result->parent;
362     /* We must be able to get an output because focus can never be set higher
363      * in the tree (root node cannot be focused). */
364     assert(result != NULL);
365     return result;
366 }
367
368 /*
369  * Gets the workspace container this node is on.
370  *
371  */
372 Con *con_get_workspace(Con *con) {
373     Con *result = con;
374     while (result != NULL && result->type != CT_WORKSPACE)
375         result = result->parent;
376     return result;
377 }
378
379 /*
380  * Searches parenst of the given 'con' until it reaches one with the specified
381  * 'orientation'. Aborts when it comes across a floating_con.
382  *
383  */
384 Con *con_parent_with_orientation(Con *con, orientation_t orientation) {
385     DLOG("Searching for parent of Con %p with orientation %d\n", con, orientation);
386     Con *parent = con->parent;
387     if (parent->type == CT_FLOATING_CON)
388         return NULL;
389     while (con_orientation(parent) != orientation) {
390         DLOG("Need to go one level further up\n");
391         parent = parent->parent;
392         /* Abort when we reach a floating con, or an output con */
393         if (parent &&
394             (parent->type == CT_FLOATING_CON ||
395              parent->type == CT_OUTPUT ||
396              (parent->parent && parent->parent->type == CT_OUTPUT)))
397             parent = NULL;
398         if (parent == NULL)
399             break;
400     }
401     DLOG("Result: %p\n", parent);
402     return parent;
403 }
404
405 /*
406  * helper data structure for the breadth-first-search in
407  * con_get_fullscreen_con()
408  *
409  */
410 struct bfs_entry {
411     Con *con;
412
413     TAILQ_ENTRY(bfs_entry)
414     entries;
415 };
416
417 /*
418  * Returns the first fullscreen node below this node.
419  *
420  */
421 Con *con_get_fullscreen_con(Con *con, fullscreen_mode_t fullscreen_mode) {
422     Con *current, *child;
423
424     /* TODO: is breadth-first-search really appropriate? (check as soon as
425      * fullscreen levels and fullscreen for containers is implemented) */
426     TAILQ_HEAD(bfs_head, bfs_entry)
427     bfs_head = TAILQ_HEAD_INITIALIZER(bfs_head);
428
429     struct bfs_entry *entry = smalloc(sizeof(struct bfs_entry));
430     entry->con = con;
431     TAILQ_INSERT_TAIL(&bfs_head, entry, entries);
432
433     while (!TAILQ_EMPTY(&bfs_head)) {
434         entry = TAILQ_FIRST(&bfs_head);
435         current = entry->con;
436         if (current != con && current->fullscreen_mode == fullscreen_mode) {
437             /* empty the queue */
438             while (!TAILQ_EMPTY(&bfs_head)) {
439                 entry = TAILQ_FIRST(&bfs_head);
440                 TAILQ_REMOVE(&bfs_head, entry, entries);
441                 free(entry);
442             }
443             return current;
444         }
445
446         TAILQ_REMOVE(&bfs_head, entry, entries);
447         free(entry);
448
449         TAILQ_FOREACH(child, &(current->nodes_head), nodes) {
450             entry = smalloc(sizeof(struct bfs_entry));
451             entry->con = child;
452             TAILQ_INSERT_TAIL(&bfs_head, entry, entries);
453         }
454
455         TAILQ_FOREACH(child, &(current->floating_head), floating_windows) {
456             entry = smalloc(sizeof(struct bfs_entry));
457             entry->con = child;
458             TAILQ_INSERT_TAIL(&bfs_head, entry, entries);
459         }
460     }
461
462     return NULL;
463 }
464
465 /**
466  * Returns true if the container is internal, such as __i3_scratch
467  *
468  */
469 bool con_is_internal(Con *con) {
470     return (con->name[0] == '_' && con->name[1] == '_');
471 }
472
473 /*
474  * Returns true if the node is floating.
475  *
476  */
477 bool con_is_floating(Con *con) {
478     assert(con != NULL);
479     DLOG("checking if con %p is floating\n", con);
480     return (con->floating >= FLOATING_AUTO_ON);
481 }
482
483 /*
484  * Returns true if the container is a docked container.
485  *
486  */
487 bool con_is_docked(Con *con) {
488     if (con->parent == NULL)
489         return false;
490
491     if (con->parent->type == CT_DOCKAREA)
492         return true;
493
494     return con_is_docked(con->parent);
495 }
496
497 /*
498  * Checks if the given container is either floating or inside some floating
499  * container. It returns the FLOATING_CON container.
500  *
501  */
502 Con *con_inside_floating(Con *con) {
503     assert(con != NULL);
504     if (con->type == CT_FLOATING_CON)
505         return con;
506
507     if (con->floating >= FLOATING_AUTO_ON)
508         return con->parent;
509
510     if (con->type == CT_WORKSPACE || con->type == CT_OUTPUT)
511         return NULL;
512
513     return con_inside_floating(con->parent);
514 }
515
516 /*
517  * Checks if the given container is inside a focused container.
518  *
519  */
520 bool con_inside_focused(Con *con) {
521     if (con == focused)
522         return true;
523     if (!con->parent)
524         return false;
525     return con_inside_focused(con->parent);
526 }
527
528 /*
529  * Returns the container with the given client window ID or NULL if no such
530  * container exists.
531  *
532  */
533 Con *con_by_window_id(xcb_window_t window) {
534     Con *con;
535     TAILQ_FOREACH(con, &all_cons, all_cons)
536     if (con->window != NULL && con->window->id == window)
537         return con;
538     return NULL;
539 }
540
541 /*
542  * Returns the container with the given frame ID or NULL if no such container
543  * exists.
544  *
545  */
546 Con *con_by_frame_id(xcb_window_t frame) {
547     Con *con;
548     TAILQ_FOREACH(con, &all_cons, all_cons)
549     if (con->frame.id == frame)
550         return con;
551     return NULL;
552 }
553
554 /*
555  * Returns the container with the given mark or NULL if no such container
556  * exists.
557  *
558  */
559 Con *con_by_mark(const char *mark) {
560     Con *con;
561     TAILQ_FOREACH(con, &all_cons, all_cons) {
562         if (con_has_mark(con, mark))
563             return con;
564     }
565
566     return NULL;
567 }
568
569 /*
570  * Returns true if and only if the given containers holds the mark.
571  *
572  */
573 bool con_has_mark(Con *con, const char *mark) {
574     mark_t *current;
575     TAILQ_FOREACH(current, &(con->marks_head), marks) {
576         if (strcmp(current->name, mark) == 0)
577             return true;
578     }
579
580     return false;
581 }
582
583 /*
584  * Toggles the mark on a container.
585  * If the container already has this mark, the mark is removed.
586  * Otherwise, the mark is assigned to the container.
587  *
588  */
589 void con_mark_toggle(Con *con, const char *mark, mark_mode_t mode) {
590     assert(con != NULL);
591     DLOG("Toggling mark \"%s\" on con = %p.\n", mark, con);
592
593     if (con_has_mark(con, mark)) {
594         con_unmark(con, mark);
595     } else {
596         con_mark(con, mark, mode);
597     }
598 }
599
600 /*
601  * Assigns a mark to the container.
602  *
603  */
604 void con_mark(Con *con, const char *mark, mark_mode_t mode) {
605     assert(con != NULL);
606     DLOG("Setting mark \"%s\" on con = %p.\n", mark, con);
607
608     con_unmark(NULL, mark);
609     if (mode == MM_REPLACE) {
610         DLOG("Removing all existing marks on con = %p.\n", con);
611
612         mark_t *current;
613         while (!TAILQ_EMPTY(&(con->marks_head))) {
614             current = TAILQ_FIRST(&(con->marks_head));
615             con_unmark(con, current->name);
616         }
617     }
618
619     mark_t *new = scalloc(1, sizeof(mark_t));
620     new->name = sstrdup(mark);
621     TAILQ_INSERT_TAIL(&(con->marks_head), new, marks);
622     ipc_send_window_event("mark", con);
623
624     con->mark_changed = true;
625 }
626
627 /*
628  * Removes marks from containers.
629  * If con is NULL, all containers are considered.
630  * If name is NULL, this removes all existing marks.
631  * Otherwise, it will only remove the given mark (if it is present).
632  *
633  */
634 void con_unmark(Con *con, const char *name) {
635     Con *current;
636     if (name == NULL) {
637         DLOG("Unmarking all containers.\n");
638         TAILQ_FOREACH(current, &all_cons, all_cons) {
639             if (con != NULL && current != con)
640                 continue;
641
642             if (TAILQ_EMPTY(&(current->marks_head)))
643                 continue;
644
645             mark_t *mark;
646             while (!TAILQ_EMPTY(&(current->marks_head))) {
647                 mark = TAILQ_FIRST(&(current->marks_head));
648                 FREE(mark->name);
649                 TAILQ_REMOVE(&(current->marks_head), mark, marks);
650                 FREE(mark);
651
652                 ipc_send_window_event("mark", current);
653             }
654
655             current->mark_changed = true;
656         }
657     } else {
658         DLOG("Removing mark \"%s\".\n", name);
659         current = (con == NULL) ? con_by_mark(name) : con;
660         if (current == NULL) {
661             DLOG("No container found with this mark, so there is nothing to do.\n");
662             return;
663         }
664
665         DLOG("Found mark on con = %p. Removing it now.\n", current);
666         current->mark_changed = true;
667
668         mark_t *mark;
669         TAILQ_FOREACH(mark, &(current->marks_head), marks) {
670             if (strcmp(mark->name, name) != 0)
671                 continue;
672
673             FREE(mark->name);
674             TAILQ_REMOVE(&(current->marks_head), mark, marks);
675             FREE(mark);
676
677             ipc_send_window_event("mark", current);
678             break;
679         }
680     }
681 }
682
683 /*
684  * Returns the first container below 'con' which wants to swallow this window
685  * TODO: priority
686  *
687  */
688 Con *con_for_window(Con *con, i3Window *window, Match **store_match) {
689     Con *child;
690     Match *match;
691     //DLOG("searching con for window %p starting at con %p\n", window, con);
692     //DLOG("class == %s\n", window->class_class);
693
694     TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
695         TAILQ_FOREACH(match, &(child->swallow_head), matches) {
696             if (!match_matches_window(match, window))
697                 continue;
698             if (store_match != NULL)
699                 *store_match = match;
700             return child;
701         }
702         Con *result = con_for_window(child, window, store_match);
703         if (result != NULL)
704             return result;
705     }
706
707     TAILQ_FOREACH(child, &(con->floating_head), floating_windows) {
708         TAILQ_FOREACH(match, &(child->swallow_head), matches) {
709             if (!match_matches_window(match, window))
710                 continue;
711             if (store_match != NULL)
712                 *store_match = match;
713             return child;
714         }
715         Con *result = con_for_window(child, window, store_match);
716         if (result != NULL)
717             return result;
718     }
719
720     return NULL;
721 }
722
723 /*
724  * Returns the number of children of this container.
725  *
726  */
727 int con_num_children(Con *con) {
728     Con *child;
729     int children = 0;
730
731     TAILQ_FOREACH(child, &(con->nodes_head), nodes)
732     children++;
733
734     return children;
735 }
736
737 /**
738  * Returns the number of visible non-floating children of this container.
739  * For example, if the container contains a hsplit which has two children,
740  * this will return 2 instead of 1.
741  */
742 int con_num_visible_children(Con *con) {
743     if (con == NULL)
744         return 0;
745
746     int children = 0;
747     Con *current = NULL;
748     TAILQ_FOREACH(current, &(con->nodes_head), nodes) {
749         /* Visible leaf nodes are a child. */
750         if (!con_is_hidden(current) && con_is_leaf(current))
751             children++;
752         /* All other containers need to be recursed. */
753         else
754             children += con_num_visible_children(current);
755     }
756
757     return children;
758 }
759
760 /*
761  * Count the number of windows (i.e., leaf containers).
762  *
763  */
764 int con_num_windows(Con *con) {
765     if (con == NULL)
766         return 0;
767
768     if (con_has_managed_window(con))
769         return 1;
770
771     int num = 0;
772     Con *current = NULL;
773     TAILQ_FOREACH(current, &(con->nodes_head), nodes) {
774         num += con_num_windows(current);
775     }
776
777     return num;
778 }
779
780 /*
781  * Updates the percent attribute of the children of the given container. This
782  * function needs to be called when a window is added or removed from a
783  * container.
784  *
785  */
786 void con_fix_percent(Con *con) {
787     Con *child;
788     int children = con_num_children(con);
789
790     // calculate how much we have distributed and how many containers
791     // with a percentage set we have
792     double total = 0.0;
793     int children_with_percent = 0;
794     TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
795         if (child->percent > 0.0) {
796             total += child->percent;
797             ++children_with_percent;
798         }
799     }
800
801     // if there were children without a percentage set, set to a value that
802     // will make those children proportional to all others
803     if (children_with_percent != children) {
804         TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
805             if (child->percent <= 0.0) {
806                 if (children_with_percent == 0)
807                     total += (child->percent = 1.0);
808                 else
809                     total += (child->percent = total / children_with_percent);
810             }
811         }
812     }
813
814     // if we got a zero, just distribute the space equally, otherwise
815     // distribute according to the proportions we got
816     if (total == 0.0) {
817         TAILQ_FOREACH(child, &(con->nodes_head), nodes)
818         child->percent = 1.0 / children;
819     } else if (total != 1.0) {
820         TAILQ_FOREACH(child, &(con->nodes_head), nodes)
821         child->percent /= total;
822     }
823 }
824
825 /*
826  * Toggles fullscreen mode for the given container. If there already is a
827  * fullscreen container on this workspace, fullscreen will be disabled and then
828  * enabled for the container the user wants to have in fullscreen mode.
829  *
830  */
831 void con_toggle_fullscreen(Con *con, int fullscreen_mode) {
832     if (con->type == CT_WORKSPACE) {
833         DLOG("You cannot make a workspace fullscreen.\n");
834         return;
835     }
836
837     DLOG("toggling fullscreen for %p / %s\n", con, con->name);
838
839     if (con->fullscreen_mode == CF_NONE)
840         con_enable_fullscreen(con, fullscreen_mode);
841     else
842         con_disable_fullscreen(con);
843 }
844
845 /*
846  * Sets the specified fullscreen mode for the given container, sends the
847  * “fullscreen_mode” event and changes the XCB fullscreen property of the
848  * container’s window, if any.
849  *
850  */
851 static void con_set_fullscreen_mode(Con *con, fullscreen_mode_t fullscreen_mode) {
852     con->fullscreen_mode = fullscreen_mode;
853
854     DLOG("mode now: %d\n", con->fullscreen_mode);
855
856     /* Send an ipc window "fullscreen_mode" event */
857     ipc_send_window_event("fullscreen_mode", con);
858
859     /* update _NET_WM_STATE if this container has a window */
860     /* TODO: when a window is assigned to a container which is already
861      * fullscreened, this state needs to be pushed to the client, too */
862     if (con->window == NULL)
863         return;
864
865     if (con->fullscreen_mode != CF_NONE) {
866         DLOG("Setting _NET_WM_STATE_FULLSCREEN for con = %p / window = %d.\n", con, con->window->id);
867         xcb_add_property_atom(conn, con->window->id, A__NET_WM_STATE, A__NET_WM_STATE_FULLSCREEN);
868     } else {
869         DLOG("Removing _NET_WM_STATE_FULLSCREEN for con = %p / window = %d.\n", con, con->window->id);
870         xcb_remove_property_atom(conn, con->window->id, A__NET_WM_STATE, A__NET_WM_STATE_FULLSCREEN);
871     }
872 }
873
874 /*
875  * Enables fullscreen mode for the given container, if necessary.
876  *
877  * If the container’s mode is already CF_OUTPUT or CF_GLOBAL, the container is
878  * kept fullscreen but its mode is set to CF_GLOBAL and CF_OUTPUT,
879  * respectively.
880  *
881  * Other fullscreen containers will be disabled first, if they hide the new
882  * one.
883  *
884  */
885 void con_enable_fullscreen(Con *con, fullscreen_mode_t fullscreen_mode) {
886     if (con->type == CT_WORKSPACE) {
887         DLOG("You cannot make a workspace fullscreen.\n");
888         return;
889     }
890
891     assert(fullscreen_mode == CF_GLOBAL || fullscreen_mode == CF_OUTPUT);
892
893     if (fullscreen_mode == CF_GLOBAL)
894         DLOG("enabling global fullscreen for %p / %s\n", con, con->name);
895     else
896         DLOG("enabling fullscreen for %p / %s\n", con, con->name);
897
898     if (con->fullscreen_mode == fullscreen_mode) {
899         DLOG("fullscreen already enabled for %p / %s\n", con, con->name);
900         return;
901     }
902
903     Con *con_ws = con_get_workspace(con);
904
905     /* Disable any fullscreen container that would conflict the new one. */
906     Con *fullscreen = con_get_fullscreen_con(croot, CF_GLOBAL);
907     if (fullscreen == NULL)
908         fullscreen = con_get_fullscreen_con(con_ws, CF_OUTPUT);
909     if (fullscreen != NULL)
910         con_disable_fullscreen(fullscreen);
911
912     /* Set focus to new fullscreen container. Unless in global fullscreen mode
913      * and on another workspace restore focus afterwards.
914      * Switch to the container’s workspace if mode is global. */
915     Con *cur_ws = con_get_workspace(focused);
916     Con *old_focused = focused;
917     if (fullscreen_mode == CF_GLOBAL && cur_ws != con_ws)
918         workspace_show(con_ws);
919     con_focus(con);
920     if (fullscreen_mode != CF_GLOBAL && cur_ws != con_ws)
921         con_focus(old_focused);
922
923     con_set_fullscreen_mode(con, fullscreen_mode);
924 }
925
926 /*
927  * Disables fullscreen mode for the given container regardless of the mode, if
928  * necessary.
929  *
930  */
931 void con_disable_fullscreen(Con *con) {
932     if (con->type == CT_WORKSPACE) {
933         DLOG("You cannot make a workspace fullscreen.\n");
934         return;
935     }
936
937     DLOG("disabling fullscreen for %p / %s\n", con, con->name);
938
939     if (con->fullscreen_mode == CF_NONE) {
940         DLOG("fullscreen already disabled for %p / %s\n", con, con->name);
941         return;
942     }
943
944     con_set_fullscreen_mode(con, CF_NONE);
945 }
946
947 static bool _con_move_to_con(Con *con, Con *target, bool behind_focused, bool fix_coordinates, bool dont_warp, bool ignore_focus) {
948     Con *orig_target = target;
949
950     /* Prevent moving if this would violate the fullscreen focus restrictions. */
951     Con *target_ws = con_get_workspace(target);
952     if (!con_fullscreen_permits_focusing(target_ws)) {
953         LOG("Cannot move out of a fullscreen container.\n");
954         return false;
955     }
956
957     if (con_is_floating(con)) {
958         DLOG("Container is floating, using parent instead.\n");
959         con = con->parent;
960     }
961
962     Con *source_ws = con_get_workspace(con);
963
964     if (con->type == CT_WORKSPACE) {
965         /* Re-parent all of the old workspace's floating windows. */
966         Con *child;
967         while (!TAILQ_EMPTY(&(source_ws->floating_head))) {
968             child = TAILQ_FIRST(&(source_ws->floating_head));
969             con_move_to_workspace(child, target_ws, true, true, false);
970         }
971
972         /* If there are no non-floating children, ignore the workspace. */
973         if (con_is_leaf(con))
974             return false;
975
976         con = workspace_encapsulate(con);
977         if (con == NULL) {
978             ELOG("Workspace failed to move its contents into a container!\n");
979             return false;
980         }
981     }
982
983     /* Save the urgency state so that we can restore it. */
984     bool urgent = con->urgent;
985
986     /* Save the current workspace. So we can call workspace_show() by the end
987      * of this function. */
988     Con *current_ws = con_get_workspace(focused);
989
990     Con *source_output = con_get_output(con),
991         *dest_output = con_get_output(target_ws);
992
993     /* 1: save the container which is going to be focused after the current
994      * container is moved away */
995     Con *focus_next = con_next_focused(con);
996
997     /* 2: we go up one level, but only when target is a normal container */
998     if (target->type != CT_WORKSPACE) {
999         DLOG("target originally = %p / %s / type %d\n", target, target->name, target->type);
1000         target = target->parent;
1001     }
1002
1003     /* 3: if the target container is floating, we get the workspace instead.
1004      * Only tiling windows need to get inserted next to the current container.
1005      * */
1006     Con *floatingcon = con_inside_floating(target);
1007     if (floatingcon != NULL) {
1008         DLOG("floatingcon, going up even further\n");
1009         target = floatingcon->parent;
1010     }
1011
1012     if (con->type == CT_FLOATING_CON) {
1013         Con *ws = con_get_workspace(target);
1014         DLOG("This is a floating window, using workspace %p / %s\n", ws, ws->name);
1015         target = ws;
1016     }
1017
1018     if (source_output != dest_output) {
1019         /* Take the relative coordinates of the current output, then add them
1020          * to the coordinate space of the correct output */
1021         if (fix_coordinates && con->type == CT_FLOATING_CON) {
1022             floating_fix_coordinates(con, &(source_output->rect), &(dest_output->rect));
1023         } else
1024             DLOG("Not fixing coordinates, fix_coordinates flag = %d\n", fix_coordinates);
1025
1026         /* If moving to a visible workspace, call show so it can be considered
1027          * focused. Must do before attaching because workspace_show checks to see
1028          * if focused container is in its area. */
1029         if (!ignore_focus && workspace_is_visible(target_ws)) {
1030             workspace_show(target_ws);
1031
1032             /* Don’t warp if told so (when dragging floating windows with the
1033              * mouse for example) */
1034             if (dont_warp)
1035                 x_set_warp_to(NULL);
1036             else
1037                 x_set_warp_to(&(con->rect));
1038         }
1039     }
1040
1041     /* If moving a fullscreen container and the destination already has a
1042      * fullscreen window on it, un-fullscreen the target's fullscreen con. */
1043     Con *fullscreen = con_get_fullscreen_con(target_ws, CF_OUTPUT);
1044     if (con->fullscreen_mode != CF_NONE && fullscreen != NULL) {
1045         con_toggle_fullscreen(fullscreen, CF_OUTPUT);
1046         fullscreen = NULL;
1047     }
1048
1049     DLOG("Re-attaching container to %p / %s\n", target, target->name);
1050     /* 4: re-attach the con to the parent of this focused container */
1051     Con *parent = con->parent;
1052     con_detach(con);
1053     _con_attach(con, target, behind_focused ? NULL : orig_target, !behind_focused);
1054
1055     /* 5: fix the percentages */
1056     con_fix_percent(parent);
1057     con->percent = 0.0;
1058     con_fix_percent(target);
1059
1060     /* 6: focus the con on the target workspace, but only within that
1061      * workspace, that is, don’t move focus away if the target workspace is
1062      * invisible.
1063      * We don’t focus the con for i3 pseudo workspaces like __i3_scratch and
1064      * we don’t focus when there is a fullscreen con on that workspace. We
1065      * also don't do it if the caller requested to ignore focus. */
1066     if (!ignore_focus && !con_is_internal(target_ws) && !fullscreen) {
1067         /* We need to save the focused workspace on the output in case the
1068          * new workspace is hidden and it's necessary to immediately switch
1069          * back to the originally-focused workspace. */
1070         Con *old_focus = TAILQ_FIRST(&(output_get_content(dest_output)->focus_head));
1071         con_focus(con_descend_focused(con));
1072
1073         /* Restore focus if the output's focused workspace has changed. */
1074         if (con_get_workspace(focused) != old_focus)
1075             con_focus(old_focus);
1076     }
1077
1078     /* 7: when moving to another workspace, we leave the focus on the current
1079      * workspace. (see also #809) */
1080
1081     /* Descend focus stack in case focus_next is a workspace which can
1082      * occur if we move to the same workspace.  Also show current workspace
1083      * to ensure it is focused. */
1084     if (!ignore_focus)
1085         workspace_show(current_ws);
1086
1087     /* Set focus only if con was on current workspace before moving.
1088      * Otherwise we would give focus to some window on different workspace. */
1089     if (!ignore_focus && source_ws == current_ws)
1090         con_focus(con_descend_focused(focus_next));
1091
1092     /* 8. If anything within the container is associated with a startup sequence,
1093      * delete it so child windows won't be created on the old workspace. */
1094     struct Startup_Sequence *sequence;
1095     xcb_get_property_cookie_t cookie;
1096     xcb_get_property_reply_t *startup_id_reply;
1097
1098     if (!con_is_leaf(con)) {
1099         Con *child;
1100         TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
1101             if (!child->window)
1102                 continue;
1103
1104             cookie = xcb_get_property(conn, false, child->window->id,
1105                                       A__NET_STARTUP_ID, XCB_GET_PROPERTY_TYPE_ANY, 0, 512);
1106             startup_id_reply = xcb_get_property_reply(conn, cookie, NULL);
1107
1108             sequence = startup_sequence_get(child->window, startup_id_reply, true);
1109             if (sequence != NULL)
1110                 startup_sequence_delete(sequence);
1111         }
1112     }
1113
1114     if (con->window) {
1115         cookie = xcb_get_property(conn, false, con->window->id,
1116                                   A__NET_STARTUP_ID, XCB_GET_PROPERTY_TYPE_ANY, 0, 512);
1117         startup_id_reply = xcb_get_property_reply(conn, cookie, NULL);
1118
1119         sequence = startup_sequence_get(con->window, startup_id_reply, true);
1120         if (sequence != NULL)
1121             startup_sequence_delete(sequence);
1122     }
1123
1124     /* 9. If the container was marked urgent, move the urgency hint. */
1125     if (urgent) {
1126         workspace_update_urgent_flag(source_ws);
1127         con_set_urgency(con, true);
1128     }
1129
1130     /* Ensure the container will be redrawn. */
1131     FREE(con->deco_render_params);
1132
1133     CALL(parent, on_remove_child);
1134
1135     ipc_send_window_event("move", con);
1136     ewmh_update_wm_desktop();
1137     return true;
1138 }
1139
1140 /*
1141  * Moves the given container to the given mark.
1142  *
1143  */
1144 bool con_move_to_mark(Con *con, const char *mark) {
1145     Con *target = con_by_mark(mark);
1146     if (target == NULL) {
1147         DLOG("found no container with mark \"%s\"\n", mark);
1148         return false;
1149     }
1150
1151     /* For floating target containers, we just send the window to the same workspace. */
1152     if (con_is_floating(target)) {
1153         DLOG("target container is floating, moving container to target's workspace.\n");
1154         con_move_to_workspace(con, con_get_workspace(target), true, false, false);
1155         return true;
1156     }
1157
1158     if (con->type == CT_WORKSPACE) {
1159         DLOG("target container is a workspace, simply moving the container there.\n");
1160         con_move_to_workspace(con, target, true, false, false);
1161         return true;
1162     }
1163
1164     /* For split containers, we use the currently focused container within it.
1165      * This allows setting marks on, e.g., tabbed containers which will move
1166      * con to a new tab behind the focused tab. */
1167     if (con_is_split(target)) {
1168         DLOG("target is a split container, descending to the currently focused child.\n");
1169         target = TAILQ_FIRST(&(target->focus_head));
1170     }
1171
1172     if (con == target || con == target->parent) {
1173         DLOG("cannot move the container to or inside itself, aborting.\n");
1174         return false;
1175     }
1176
1177     return _con_move_to_con(con, target, false, true, false, false);
1178 }
1179
1180 /*
1181  * Moves the given container to the currently focused container on the given
1182  * workspace.
1183  *
1184  * The fix_coordinates flag will translate the current coordinates (offset from
1185  * the monitor position basically) to appropriate coordinates on the
1186  * destination workspace.
1187  * Not enabling this behaviour comes in handy when this function gets called by
1188  * floating_maybe_reassign_ws, which will only "move" a floating window when it
1189  * *already* changed its coordinates to a different output.
1190  *
1191  * The dont_warp flag disables pointer warping and will be set when this
1192  * function is called while dragging a floating window.
1193  *
1194  * If ignore_focus is set, the container will be moved without modifying focus
1195  * at all.
1196  *
1197  * TODO: is there a better place for this function?
1198  *
1199  */
1200 void con_move_to_workspace(Con *con, Con *workspace, bool fix_coordinates, bool dont_warp, bool ignore_focus) {
1201     assert(workspace->type == CT_WORKSPACE);
1202
1203     Con *source_ws = con_get_workspace(con);
1204     if (workspace == source_ws) {
1205         DLOG("Not moving, already there\n");
1206         return;
1207     }
1208
1209     Con *target = con_descend_focused(workspace);
1210     _con_move_to_con(con, target, true, fix_coordinates, dont_warp, ignore_focus);
1211 }
1212
1213 /*
1214  * Moves the given container to the currently focused container on the
1215  * visible workspace on the given output.
1216  *
1217  */
1218 void con_move_to_output(Con *con, Output *output) {
1219     Con *ws = NULL;
1220     GREP_FIRST(ws, output_get_content(output->con), workspace_is_visible(child));
1221     assert(ws != NULL);
1222     DLOG("Moving con %p to output %s\n", con, output->name);
1223     con_move_to_workspace(con, ws, false, false, false);
1224 }
1225
1226 /*
1227  * Returns the orientation of the given container (for stacked containers,
1228  * vertical orientation is used regardless of the actual orientation of the
1229  * container).
1230  *
1231  */
1232 orientation_t con_orientation(Con *con) {
1233     switch (con->layout) {
1234         case L_SPLITV:
1235         /* stacking containers behave like they are in vertical orientation */
1236         case L_STACKED:
1237             return VERT;
1238
1239         case L_SPLITH:
1240         /* tabbed containers behave like they are in vertical orientation */
1241         case L_TABBED:
1242             return HORIZ;
1243
1244         case L_DEFAULT:
1245             DLOG("Someone called con_orientation() on a con with L_DEFAULT, this is a bug in the code.\n");
1246             assert(false);
1247             return HORIZ;
1248
1249         case L_DOCKAREA:
1250         case L_OUTPUT:
1251             DLOG("con_orientation() called on dockarea/output (%d) container %p\n", con->layout, con);
1252             assert(false);
1253             return HORIZ;
1254
1255         default:
1256             DLOG("con_orientation() ran into default\n");
1257             assert(false);
1258     }
1259 }
1260
1261 /*
1262  * Returns the container which will be focused next when the given container
1263  * is not available anymore. Called in tree_close_internal and con_move_to_workspace
1264  * to properly restore focus.
1265  *
1266  */
1267 Con *con_next_focused(Con *con) {
1268     Con *next;
1269     /* floating containers are attached to a workspace, so we focus either the
1270      * next floating container (if any) or the workspace itself. */
1271     if (con->type == CT_FLOATING_CON) {
1272         DLOG("selecting next for CT_FLOATING_CON\n");
1273         next = TAILQ_NEXT(con, floating_windows);
1274         DLOG("next = %p\n", next);
1275         if (!next) {
1276             next = TAILQ_PREV(con, floating_head, floating_windows);
1277             DLOG("using prev, next = %p\n", next);
1278         }
1279         if (!next) {
1280             Con *ws = con_get_workspace(con);
1281             next = ws;
1282             DLOG("no more floating containers for next = %p, restoring workspace focus\n", next);
1283             while (next != TAILQ_END(&(ws->focus_head)) && !TAILQ_EMPTY(&(next->focus_head))) {
1284                 next = TAILQ_FIRST(&(next->focus_head));
1285                 if (next == con) {
1286                     DLOG("skipping container itself, we want the next client\n");
1287                     next = TAILQ_NEXT(next, focused);
1288                 }
1289             }
1290             if (next == TAILQ_END(&(ws->focus_head))) {
1291                 DLOG("Focus list empty, returning ws\n");
1292                 next = ws;
1293             }
1294         } else {
1295             /* Instead of returning the next CT_FLOATING_CON, we descend it to
1296              * get an actual window to focus. */
1297             next = con_descend_focused(next);
1298         }
1299         return next;
1300     }
1301
1302     /* dock clients cannot be focused, so we focus the workspace instead */
1303     if (con->parent->type == CT_DOCKAREA) {
1304         DLOG("selecting workspace for dock client\n");
1305         return con_descend_focused(output_get_content(con->parent->parent));
1306     }
1307
1308     /* if 'con' is not the first entry in the focus stack, use the first one as
1309      * it’s currently focused already */
1310     Con *first = TAILQ_FIRST(&(con->parent->focus_head));
1311     if (first != con) {
1312         DLOG("Using first entry %p\n", first);
1313         next = first;
1314     } else {
1315         /* try to focus the next container on the same level as this one or fall
1316          * back to its parent */
1317         if (!(next = TAILQ_NEXT(con, focused)))
1318             next = con->parent;
1319     }
1320
1321     /* now go down the focus stack as far as
1322      * possible, excluding the current container */
1323     while (!TAILQ_EMPTY(&(next->focus_head)) &&
1324            TAILQ_FIRST(&(next->focus_head)) != con)
1325         next = TAILQ_FIRST(&(next->focus_head));
1326
1327     return next;
1328 }
1329
1330 /*
1331  * Get the next/previous container in the specified orientation. This may
1332  * travel up until it finds a container with suitable orientation.
1333  *
1334  */
1335 Con *con_get_next(Con *con, char way, orientation_t orientation) {
1336     DLOG("con_get_next(way=%c, orientation=%d)\n", way, orientation);
1337     /* 1: get the first parent with the same orientation */
1338     Con *cur = con;
1339     while (con_orientation(cur->parent) != orientation) {
1340         DLOG("need to go one level further up\n");
1341         if (cur->parent->type == CT_WORKSPACE) {
1342             LOG("that's a workspace, we can't go further up\n");
1343             return NULL;
1344         }
1345         cur = cur->parent;
1346     }
1347
1348     /* 2: chose next (or previous) */
1349     Con *next;
1350     if (way == 'n') {
1351         next = TAILQ_NEXT(cur, nodes);
1352         /* if we are at the end of the list, we need to wrap */
1353         if (next == TAILQ_END(&(parent->nodes_head)))
1354             return NULL;
1355     } else {
1356         next = TAILQ_PREV(cur, nodes_head, nodes);
1357         /* if we are at the end of the list, we need to wrap */
1358         if (next == TAILQ_END(&(cur->nodes_head)))
1359             return NULL;
1360     }
1361     DLOG("next = %p\n", next);
1362
1363     return next;
1364 }
1365
1366 /*
1367  * Returns the focused con inside this client, descending the tree as far as
1368  * possible. This comes in handy when attaching a con to a workspace at the
1369  * currently focused position, for example.
1370  *
1371  */
1372 Con *con_descend_focused(Con *con) {
1373     Con *next = con;
1374     while (next != focused && !TAILQ_EMPTY(&(next->focus_head)))
1375         next = TAILQ_FIRST(&(next->focus_head));
1376     return next;
1377 }
1378
1379 /*
1380  * Returns the focused con inside this client, descending the tree as far as
1381  * possible. This comes in handy when attaching a con to a workspace at the
1382  * currently focused position, for example.
1383  *
1384  * Works like con_descend_focused but considers only tiling cons.
1385  *
1386  */
1387 Con *con_descend_tiling_focused(Con *con) {
1388     Con *next = con;
1389     Con *before;
1390     Con *child;
1391     if (next == focused)
1392         return next;
1393     do {
1394         before = next;
1395         TAILQ_FOREACH(child, &(next->focus_head), focused) {
1396             if (child->type == CT_FLOATING_CON)
1397                 continue;
1398
1399             next = child;
1400             break;
1401         }
1402     } while (before != next && next != focused);
1403     return next;
1404 }
1405
1406 /*
1407  * Returns the leftmost, rightmost, etc. container in sub-tree. For example, if
1408  * direction is D_LEFT, then we return the rightmost container and if direction
1409  * is D_RIGHT, we return the leftmost container.  This is because if we are
1410  * moving D_LEFT, and thus want the rightmost container.
1411  *
1412  */
1413 Con *con_descend_direction(Con *con, direction_t direction) {
1414     Con *most = NULL;
1415     Con *current;
1416     int orientation = con_orientation(con);
1417     DLOG("con_descend_direction(%p, orientation %d, direction %d)\n", con, orientation, direction);
1418     if (direction == D_LEFT || direction == D_RIGHT) {
1419         if (orientation == HORIZ) {
1420             /* If the direction is horizontal, we can use either the first
1421              * (D_RIGHT) or the last con (D_LEFT) */
1422             if (direction == D_RIGHT)
1423                 most = TAILQ_FIRST(&(con->nodes_head));
1424             else
1425                 most = TAILQ_LAST(&(con->nodes_head), nodes_head);
1426         } else if (orientation == VERT) {
1427             /* Wrong orientation. We use the last focused con. Within that con,
1428              * we recurse to chose the left/right con or at least the last
1429              * focused one. */
1430             TAILQ_FOREACH(current, &(con->focus_head), focused) {
1431                 if (current->type != CT_FLOATING_CON) {
1432                     most = current;
1433                     break;
1434                 }
1435             }
1436         } else {
1437             /* If the con has no orientation set, it’s not a split container
1438              * but a container with a client window, so stop recursing */
1439             return con;
1440         }
1441     }
1442
1443     if (direction == D_UP || direction == D_DOWN) {
1444         if (orientation == VERT) {
1445             /* If the direction is vertical, we can use either the first
1446              * (D_DOWN) or the last con (D_UP) */
1447             if (direction == D_UP)
1448                 most = TAILQ_LAST(&(con->nodes_head), nodes_head);
1449             else
1450                 most = TAILQ_FIRST(&(con->nodes_head));
1451         } else if (orientation == HORIZ) {
1452             /* Wrong orientation. We use the last focused con. Within that con,
1453              * we recurse to chose the top/bottom con or at least the last
1454              * focused one. */
1455             TAILQ_FOREACH(current, &(con->focus_head), focused) {
1456                 if (current->type != CT_FLOATING_CON) {
1457                     most = current;
1458                     break;
1459                 }
1460             }
1461         } else {
1462             /* If the con has no orientation set, it’s not a split container
1463              * but a container with a client window, so stop recursing */
1464             return con;
1465         }
1466     }
1467
1468     if (!most)
1469         return con;
1470     return con_descend_direction(most, direction);
1471 }
1472
1473 /*
1474  * Returns a "relative" Rect which contains the amount of pixels that need to
1475  * be added to the original Rect to get the final position (obviously the
1476  * amount of pixels for normal, 1pixel and borderless are different).
1477  *
1478  */
1479 Rect con_border_style_rect(Con *con) {
1480     if (config.hide_edge_borders == HEBM_SMART && con_num_visible_children(con_get_workspace(con)) <= 1) {
1481         if (!con_is_floating(con)) {
1482             return (Rect){0, 0, 0, 0};
1483         }
1484     }
1485
1486     adjacent_t borders_to_hide = ADJ_NONE;
1487     int border_width = con->current_border_width;
1488     DLOG("The border width for con is set to: %d\n", con->current_border_width);
1489     Rect result;
1490     if (con->current_border_width < 0) {
1491         if (con_is_floating(con)) {
1492             border_width = config.default_floating_border_width;
1493         } else {
1494             border_width = config.default_border_width;
1495         }
1496     }
1497     DLOG("Effective border width is set to: %d\n", border_width);
1498     /* Shortcut to avoid calling con_adjacent_borders() on dock containers. */
1499     int border_style = con_border_style(con);
1500     if (border_style == BS_NONE)
1501         return (Rect){0, 0, 0, 0};
1502     if (border_style == BS_NORMAL) {
1503         result = (Rect){border_width, 0, -(2 * border_width), -(border_width)};
1504     } else {
1505         result = (Rect){border_width, border_width, -(2 * border_width), -(2 * border_width)};
1506     }
1507
1508     borders_to_hide = con_adjacent_borders(con) & config.hide_edge_borders;
1509     if (borders_to_hide & ADJ_LEFT_SCREEN_EDGE) {
1510         result.x -= border_width;
1511         result.width += border_width;
1512     }
1513     if (borders_to_hide & ADJ_RIGHT_SCREEN_EDGE) {
1514         result.width += border_width;
1515     }
1516     if (borders_to_hide & ADJ_UPPER_SCREEN_EDGE && (border_style != BS_NORMAL)) {
1517         result.y -= border_width;
1518         result.height += border_width;
1519     }
1520     if (borders_to_hide & ADJ_LOWER_SCREEN_EDGE) {
1521         result.height += border_width;
1522     }
1523     return result;
1524 }
1525
1526 /*
1527  * Returns adjacent borders of the window. We need this if hide_edge_borders is
1528  * enabled.
1529  */
1530 adjacent_t con_adjacent_borders(Con *con) {
1531     adjacent_t result = ADJ_NONE;
1532     /* Floating windows are never adjacent to any other window, so
1533        don’t hide their border(s). This prevents bug #998. */
1534     if (con_is_floating(con))
1535         return result;
1536
1537     Con *workspace = con_get_workspace(con);
1538     if (con->rect.x == workspace->rect.x)
1539         result |= ADJ_LEFT_SCREEN_EDGE;
1540     if (con->rect.x + con->rect.width == workspace->rect.x + workspace->rect.width)
1541         result |= ADJ_RIGHT_SCREEN_EDGE;
1542     if (con->rect.y == workspace->rect.y)
1543         result |= ADJ_UPPER_SCREEN_EDGE;
1544     if (con->rect.y + con->rect.height == workspace->rect.y + workspace->rect.height)
1545         result |= ADJ_LOWER_SCREEN_EDGE;
1546     return result;
1547 }
1548
1549 /*
1550  * Use this function to get a container’s border style. This is important
1551  * because when inside a stack, the border style is always BS_NORMAL.
1552  * For tabbed mode, the same applies, with one exception: when the container is
1553  * borderless and the only element in the tabbed container, the border is not
1554  * rendered.
1555  *
1556  * For children of a CT_DOCKAREA, the border style is always none.
1557  *
1558  */
1559 int con_border_style(Con *con) {
1560     Con *fs = con_get_fullscreen_con(con->parent, CF_OUTPUT);
1561     if (fs == con) {
1562         DLOG("this one is fullscreen! overriding BS_NONE\n");
1563         return BS_NONE;
1564     }
1565
1566     if (con->parent->layout == L_STACKED)
1567         return (con_num_children(con->parent) == 1 ? con->border_style : BS_NORMAL);
1568
1569     if (con->parent->layout == L_TABBED && con->border_style != BS_NORMAL)
1570         return (con_num_children(con->parent) == 1 ? con->border_style : BS_NORMAL);
1571
1572     if (con->parent->type == CT_DOCKAREA)
1573         return BS_NONE;
1574
1575     return con->border_style;
1576 }
1577
1578 /*
1579  * Sets the given border style on con, correctly keeping the position/size of a
1580  * floating window.
1581  *
1582  */
1583 void con_set_border_style(Con *con, int border_style, int border_width) {
1584     /* Handle the simple case: non-floating containerns */
1585     if (!con_is_floating(con)) {
1586         con->border_style = border_style;
1587         con->current_border_width = border_width;
1588         return;
1589     }
1590
1591     /* For floating containers, we want to keep the position/size of the
1592      * *window* itself. We first add the border pixels to con->rect to make
1593      * con->rect represent the absolute position of the window (same for
1594      * parent). Then, we change the border style and subtract the new border
1595      * pixels. For the parent, we do the same also for the decoration. */
1596     DLOG("This is a floating container\n");
1597
1598     Con *parent = con->parent;
1599     Rect bsr = con_border_style_rect(con);
1600     int deco_height = (con->border_style == BS_NORMAL ? render_deco_height() : 0);
1601
1602     con->rect = rect_add(con->rect, bsr);
1603     parent->rect = rect_add(parent->rect, bsr);
1604     parent->rect.y += deco_height;
1605     parent->rect.height -= deco_height;
1606
1607     /* Change the border style, get new border/decoration values. */
1608     con->border_style = border_style;
1609     con->current_border_width = border_width;
1610     bsr = con_border_style_rect(con);
1611     deco_height = (con->border_style == BS_NORMAL ? render_deco_height() : 0);
1612
1613     con->rect = rect_sub(con->rect, bsr);
1614     parent->rect = rect_sub(parent->rect, bsr);
1615     parent->rect.y -= deco_height;
1616     parent->rect.height += deco_height;
1617 }
1618
1619 /*
1620  * This function changes the layout of a given container. Use it to handle
1621  * special cases like changing a whole workspace to stacked/tabbed (creates a
1622  * new split container before).
1623  *
1624  */
1625 void con_set_layout(Con *con, layout_t layout) {
1626     DLOG("con_set_layout(%p, %d), con->type = %d\n",
1627          con, layout, con->type);
1628
1629     /* Users can focus workspaces, but not any higher in the hierarchy.
1630      * Focus on the workspace is a special case, since in every other case, the
1631      * user means "change the layout of the parent split container". */
1632     if (con->type != CT_WORKSPACE)
1633         con = con->parent;
1634
1635     /* We fill in last_split_layout when switching to a different layout
1636      * since there are many places in the code that don’t use
1637      * con_set_layout(). */
1638     if (con->layout == L_SPLITH || con->layout == L_SPLITV)
1639         con->last_split_layout = con->layout;
1640
1641     /* When the container type is CT_WORKSPACE, the user wants to change the
1642      * whole workspace into stacked/tabbed mode. To do this and still allow
1643      * intuitive operations (like level-up and then opening a new window), we
1644      * need to create a new split container. */
1645     if (con->type == CT_WORKSPACE) {
1646         if (con_num_children(con) == 0) {
1647             layout_t ws_layout = (layout == L_STACKED || layout == L_TABBED) ? layout : L_DEFAULT;
1648             DLOG("Setting workspace_layout to %d\n", ws_layout);
1649             con->workspace_layout = ws_layout;
1650             DLOG("Setting layout to %d\n", layout);
1651             con->layout = layout;
1652         } else if (layout == L_STACKED || layout == L_TABBED) {
1653             DLOG("Creating new split container\n");
1654             /* 1: create a new split container */
1655             Con *new = con_new(NULL, NULL);
1656             new->parent = con;
1657
1658             /* 2: Set the requested layout on the split container and mark it as
1659              * split. */
1660             new->layout = layout;
1661             new->last_split_layout = con->last_split_layout;
1662
1663             /* Save the container that was focused before we move containers
1664              * around, but only if the container is visible (otherwise focus
1665              * will be restored properly automatically when switching). */
1666             Con *old_focused = TAILQ_FIRST(&(con->focus_head));
1667             if (old_focused == TAILQ_END(&(con->focus_head)))
1668                 old_focused = NULL;
1669             if (old_focused != NULL &&
1670                 !workspace_is_visible(con_get_workspace(old_focused)))
1671                 old_focused = NULL;
1672
1673             /* 3: move the existing cons of this workspace below the new con */
1674             DLOG("Moving cons\n");
1675             Con *child;
1676             while (!TAILQ_EMPTY(&(con->nodes_head))) {
1677                 child = TAILQ_FIRST(&(con->nodes_head));
1678                 con_detach(child);
1679                 con_attach(child, new, true);
1680             }
1681
1682             /* 4: attach the new split container to the workspace */
1683             DLOG("Attaching new split to ws\n");
1684             con_attach(new, con, false);
1685
1686             if (old_focused)
1687                 con_focus(old_focused);
1688
1689             tree_flatten(croot);
1690         }
1691         con_force_split_parents_redraw(con);
1692         return;
1693     }
1694
1695     if (layout == L_DEFAULT) {
1696         /* Special case: the layout formerly known as "default" (in combination
1697          * with an orientation). Since we switched to splith/splitv layouts,
1698          * using the "default" layout (which "only" should happen when using
1699          * legacy configs) is using the last split layout (either splith or
1700          * splitv) in order to still do the same thing. */
1701         con->layout = con->last_split_layout;
1702         /* In case last_split_layout was not initialized… */
1703         if (con->layout == L_DEFAULT)
1704             con->layout = L_SPLITH;
1705     } else {
1706         con->layout = layout;
1707     }
1708     con_force_split_parents_redraw(con);
1709 }
1710
1711 /*
1712  * This function toggles the layout of a given container. toggle_mode can be
1713  * either 'default' (toggle only between stacked/tabbed/last_split_layout),
1714  * 'split' (toggle only between splitv/splith) or 'all' (toggle between all
1715  * layouts).
1716  *
1717  */
1718 void con_toggle_layout(Con *con, const char *toggle_mode) {
1719     Con *parent = con;
1720     /* Users can focus workspaces, but not any higher in the hierarchy.
1721      * Focus on the workspace is a special case, since in every other case, the
1722      * user means "change the layout of the parent split container". */
1723     if (con->type != CT_WORKSPACE)
1724         parent = con->parent;
1725     DLOG("con_toggle_layout(%p, %s), parent = %p\n", con, toggle_mode, parent);
1726
1727     const char delim[] = " ";
1728
1729     if (strcasecmp(toggle_mode, "split") == 0 || strstr(toggle_mode, delim)) {
1730         /* L_DEFAULT is used as a placeholder value to distinguish if
1731          * the first layout has already been saved. (it can never be L_DEFAULT) */
1732         layout_t new_layout = L_DEFAULT;
1733         bool current_layout_found = false;
1734         char *tm_dup = sstrdup(toggle_mode);
1735         char *cur_tok = strtok(tm_dup, delim);
1736
1737         for (layout_t layout; cur_tok != NULL; cur_tok = strtok(NULL, delim)) {
1738             if (strcasecmp(cur_tok, "split") == 0) {
1739                 /* Toggle between splits. When the current layout is not a split
1740                  * layout, we just switch back to last_split_layout. Otherwise, we
1741                  * change to the opposite split layout. */
1742                 if (parent->layout != L_SPLITH && parent->layout != L_SPLITV) {
1743                     layout = parent->last_split_layout;
1744                 } else {
1745                     layout = (parent->layout == L_SPLITH) ? L_SPLITV : L_SPLITH;
1746                 }
1747             } else {
1748                 bool success = layout_from_name(cur_tok, &layout);
1749                 if (!success || layout == L_DEFAULT) {
1750                     ELOG("The token '%s' was not recognized and has been skipped.\n", cur_tok);
1751                     continue;
1752                 }
1753             }
1754
1755             /* If none of the specified layouts match the current,
1756              * fall back to the first layout in the list */
1757             if (new_layout == L_DEFAULT) {
1758                 new_layout = layout;
1759             }
1760
1761             /* We found the active layout in the last iteration, so
1762              * now let's activate the current layout (next in list) */
1763             if (current_layout_found) {
1764                 new_layout = layout;
1765                 free(tm_dup);
1766                 break;
1767             }
1768
1769             if (parent->layout == layout) {
1770                 current_layout_found = true;
1771             }
1772         }
1773
1774         con_set_layout(con, new_layout);
1775     } else if (strcasecmp(toggle_mode, "all") == 0 || strcasecmp(toggle_mode, "default") == 0) {
1776         if (parent->layout == L_STACKED)
1777             con_set_layout(con, L_TABBED);
1778         else if (parent->layout == L_TABBED) {
1779             if (strcasecmp(toggle_mode, "all") == 0)
1780                 con_set_layout(con, L_SPLITH);
1781             else
1782                 con_set_layout(con, parent->last_split_layout);
1783         } else if (parent->layout == L_SPLITH || parent->layout == L_SPLITV) {
1784             if (strcasecmp(toggle_mode, "all") == 0) {
1785                 /* When toggling through all modes, we toggle between
1786                  * splith/splitv, whereas normally we just directly jump to
1787                  * stacked. */
1788                 if (parent->layout == L_SPLITH)
1789                     con_set_layout(con, L_SPLITV);
1790                 else
1791                     con_set_layout(con, L_STACKED);
1792             } else {
1793                 con_set_layout(con, L_STACKED);
1794             }
1795         }
1796     }
1797 }
1798
1799 /*
1800  * Callback which will be called when removing a child from the given con.
1801  * Kills the container if it is empty and replaces it with the child if there
1802  * is exactly one child.
1803  *
1804  */
1805 static void con_on_remove_child(Con *con) {
1806     DLOG("on_remove_child\n");
1807
1808     /* Every container 'above' (in the hierarchy) the workspace content should
1809      * not be closed when the last child was removed */
1810     if (con->type == CT_OUTPUT ||
1811         con->type == CT_ROOT ||
1812         con->type == CT_DOCKAREA ||
1813         (con->parent != NULL && con->parent->type == CT_OUTPUT)) {
1814         DLOG("not handling, type = %d, name = %s\n", con->type, con->name);
1815         return;
1816     }
1817
1818     /* For workspaces, close them only if they're not visible anymore */
1819     if (con->type == CT_WORKSPACE) {
1820         if (TAILQ_EMPTY(&(con->focus_head)) && !workspace_is_visible(con)) {
1821             LOG("Closing old workspace (%p / %s), it is empty\n", con, con->name);
1822             yajl_gen gen = ipc_marshal_workspace_event("empty", con, NULL);
1823             tree_close_internal(con, DONT_KILL_WINDOW, false, false);
1824
1825             const unsigned char *payload;
1826             ylength length;
1827             y(get_buf, &payload, &length);
1828             ipc_send_event("workspace", I3_IPC_EVENT_WORKSPACE, (const char *)payload);
1829
1830             y(free);
1831         }
1832         return;
1833     }
1834
1835     con_force_split_parents_redraw(con);
1836     con->urgent = con_has_urgent_child(con);
1837     con_update_parents_urgency(con);
1838
1839     /* TODO: check if this container would swallow any other client and
1840      * don’t close it automatically. */
1841     int children = con_num_children(con);
1842     if (children == 0) {
1843         DLOG("Container empty, closing\n");
1844         tree_close_internal(con, DONT_KILL_WINDOW, false, false);
1845         return;
1846     }
1847 }
1848
1849 /*
1850  * Determines the minimum size of the given con by looking at its children (for
1851  * split/stacked/tabbed cons). Will be called when resizing floating cons
1852  *
1853  */
1854 Rect con_minimum_size(Con *con) {
1855     DLOG("Determining minimum size for con %p\n", con);
1856
1857     if (con_is_leaf(con)) {
1858         DLOG("leaf node, returning 75x50\n");
1859         return (Rect){0, 0, 75, 50};
1860     }
1861
1862     if (con->type == CT_FLOATING_CON) {
1863         DLOG("floating con\n");
1864         Con *child = TAILQ_FIRST(&(con->nodes_head));
1865         return con_minimum_size(child);
1866     }
1867
1868     if (con->layout == L_STACKED || con->layout == L_TABBED) {
1869         uint32_t max_width = 0, max_height = 0, deco_height = 0;
1870         Con *child;
1871         TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
1872             Rect min = con_minimum_size(child);
1873             deco_height += child->deco_rect.height;
1874             max_width = max(max_width, min.width);
1875             max_height = max(max_height, min.height);
1876         }
1877         DLOG("stacked/tabbed now, returning %d x %d + deco_rect = %d\n",
1878              max_width, max_height, deco_height);
1879         return (Rect){0, 0, max_width, max_height + deco_height};
1880     }
1881
1882     /* For horizontal/vertical split containers we sum up the width (h-split)
1883      * or height (v-split) and use the maximum of the height (h-split) or width
1884      * (v-split) as minimum size. */
1885     if (con_is_split(con)) {
1886         uint32_t width = 0, height = 0;
1887         Con *child;
1888         TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
1889             Rect min = con_minimum_size(child);
1890             if (con->layout == L_SPLITH) {
1891                 width += min.width;
1892                 height = max(height, min.height);
1893             } else {
1894                 height += min.height;
1895                 width = max(width, min.width);
1896             }
1897         }
1898         DLOG("split container, returning width = %d x height = %d\n", width, height);
1899         return (Rect){0, 0, width, height};
1900     }
1901
1902     ELOG("Unhandled case, type = %d, layout = %d, split = %d\n",
1903          con->type, con->layout, con_is_split(con));
1904     assert(false);
1905 }
1906
1907 /*
1908  * Returns true if changing the focus to con would be allowed considering
1909  * the fullscreen focus constraints. Specifically, if a fullscreen container or
1910  * any of its descendants is focused, this function returns true if and only if
1911  * focusing con would mean that focus would still be visible on screen, i.e.,
1912  * the newly focused container would not be obscured by a fullscreen container.
1913  *
1914  * In the simplest case, if a fullscreen container or any of its descendants is
1915  * fullscreen, this functions returns true if con is the fullscreen container
1916  * itself or any of its descendants, as this means focus wouldn't escape the
1917  * boundaries of the fullscreen container.
1918  *
1919  * In case the fullscreen container is of type CF_OUTPUT, this function returns
1920  * true if con is on a different workspace, as focus wouldn't be obscured by
1921  * the fullscreen container that is constrained to a different workspace.
1922  *
1923  * Note that this same logic can be applied to moving containers. If a
1924  * container can be focused under the fullscreen focus constraints, it can also
1925  * become a parent or sibling to the currently focused container.
1926  *
1927  */
1928 bool con_fullscreen_permits_focusing(Con *con) {
1929     /* No focus, no problem. */
1930     if (!focused)
1931         return true;
1932
1933     /* Find the first fullscreen ascendent. */
1934     Con *fs = focused;
1935     while (fs && fs->fullscreen_mode == CF_NONE)
1936         fs = fs->parent;
1937
1938     /* fs must be non-NULL since the workspace con doesn’t have CF_NONE and
1939      * there always has to be a workspace con in the hierarchy. */
1940     assert(fs != NULL);
1941     /* The most common case is we hit the workspace level. In this
1942      * situation, changing focus is also harmless. */
1943     assert(fs->fullscreen_mode != CF_NONE);
1944     if (fs->type == CT_WORKSPACE)
1945         return true;
1946
1947     /* Allow it if the container itself is the fullscreen container. */
1948     if (con == fs)
1949         return true;
1950
1951     /* If fullscreen is per-output, the focus being in a different workspace is
1952      * sufficient to guarantee that change won't leave fullscreen in bad shape. */
1953     if (fs->fullscreen_mode == CF_OUTPUT &&
1954         con_get_workspace(con) != con_get_workspace(fs)) {
1955         return true;
1956     }
1957
1958     /* Allow it only if the container to be focused is contained within the
1959      * current fullscreen container. */
1960     do {
1961         if (con->parent == fs)
1962             return true;
1963         con = con->parent;
1964     } while (con);
1965
1966     /* Focusing con would hide it behind a fullscreen window, disallow it. */
1967     return false;
1968 }
1969
1970 /*
1971  *
1972  * Checks if the given container has an urgent child.
1973  *
1974  */
1975 bool con_has_urgent_child(Con *con) {
1976     Con *child;
1977
1978     if (con_is_leaf(con))
1979         return con->urgent;
1980
1981     /* We are not interested in floating windows since they can only be
1982      * attached to a workspace → nodes_head instead of focus_head */
1983     TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
1984         if (con_has_urgent_child(child))
1985             return true;
1986     }
1987
1988     return false;
1989 }
1990
1991 /*
1992  * Make all parent containers urgent if con is urgent or clear the urgent flag
1993  * of all parent containers if there are no more urgent children left.
1994  *
1995  */
1996 void con_update_parents_urgency(Con *con) {
1997     Con *parent = con->parent;
1998
1999     /* Urgency hints should not be set on any container higher up in the
2000      * hierarchy than the workspace level. Unfortunately, since the content
2001      * container has type == CT_CON, that’s not easy to verify in the loop
2002      * below, so we need another condition to catch that case: */
2003     if (con->type == CT_WORKSPACE)
2004         return;
2005
2006     bool new_urgency_value = con->urgent;
2007     while (parent && parent->type != CT_WORKSPACE && parent->type != CT_DOCKAREA) {
2008         if (new_urgency_value) {
2009             parent->urgent = true;
2010         } else {
2011             /* We can only reset the urgency when the parent
2012              * has no other urgent children */
2013             if (!con_has_urgent_child(parent))
2014                 parent->urgent = false;
2015         }
2016         parent = parent->parent;
2017     }
2018 }
2019
2020 /*
2021  * Set urgency flag to the container, all the parent containers and the workspace.
2022  *
2023  */
2024 void con_set_urgency(Con *con, bool urgent) {
2025     if (urgent && focused == con) {
2026         DLOG("Ignoring urgency flag for current client\n");
2027         return;
2028     }
2029
2030     const bool old_urgent = con->urgent;
2031
2032     if (con->urgency_timer == NULL) {
2033         con->urgent = urgent;
2034     } else
2035         DLOG("Discarding urgency WM_HINT because timer is running\n");
2036
2037     //CLIENT_LOG(con);
2038     if (con->window) {
2039         if (con->urgent) {
2040             gettimeofday(&con->window->urgent, NULL);
2041         } else {
2042             con->window->urgent.tv_sec = 0;
2043             con->window->urgent.tv_usec = 0;
2044         }
2045     }
2046
2047     con_update_parents_urgency(con);
2048
2049     Con *ws;
2050     /* Set the urgency flag on the workspace, if a workspace could be found
2051      * (for dock clients, that is not the case). */
2052     if ((ws = con_get_workspace(con)) != NULL)
2053         workspace_update_urgent_flag(ws);
2054
2055     if (con->urgent != old_urgent) {
2056         LOG("Urgency flag changed to %d\n", con->urgent);
2057         ipc_send_window_event("urgent", con);
2058     }
2059 }
2060
2061 /*
2062  * Create a string representing the subtree under con.
2063  *
2064  */
2065 char *con_get_tree_representation(Con *con) {
2066     /* this code works as follows:
2067      *  1) create a string with the layout type (D/V/H/T/S) and an opening bracket
2068      *  2) append the tree representation of the children to the string
2069      *  3) add closing bracket
2070      *
2071      * The recursion ends when we hit a leaf, in which case we return the
2072      * class_instance of the contained window.
2073      */
2074
2075     /* end of recursion */
2076     if (con_is_leaf(con)) {
2077         if (!con->window)
2078             return sstrdup("nowin");
2079
2080         if (!con->window->class_instance)
2081             return sstrdup("noinstance");
2082
2083         return sstrdup(con->window->class_instance);
2084     }
2085
2086     char *buf;
2087     /* 1) add the Layout type to buf */
2088     if (con->layout == L_DEFAULT)
2089         buf = sstrdup("D[");
2090     else if (con->layout == L_SPLITV)
2091         buf = sstrdup("V[");
2092     else if (con->layout == L_SPLITH)
2093         buf = sstrdup("H[");
2094     else if (con->layout == L_TABBED)
2095         buf = sstrdup("T[");
2096     else if (con->layout == L_STACKED)
2097         buf = sstrdup("S[");
2098     else {
2099         ELOG("BUG: Code not updated to account for new layout type\n");
2100         assert(false);
2101     }
2102
2103     /* 2) append representation of children */
2104     Con *child;
2105     TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
2106         char *child_txt = con_get_tree_representation(child);
2107
2108         char *tmp_buf;
2109         sasprintf(&tmp_buf, "%s%s%s", buf,
2110                   (TAILQ_FIRST(&(con->nodes_head)) == child ? "" : " "), child_txt);
2111         free(buf);
2112         buf = tmp_buf;
2113         free(child_txt);
2114     }
2115
2116     /* 3) close the brackets */
2117     char *complete_buf;
2118     sasprintf(&complete_buf, "%s]", buf);
2119     free(buf);
2120
2121     return complete_buf;
2122 }
2123
2124 /*
2125  * Returns the container's title considering the current title format.
2126  *
2127  */
2128 i3String *con_parse_title_format(Con *con) {
2129     assert(con->title_format != NULL);
2130
2131     i3Window *win = con->window;
2132
2133     /* We need to ensure that we only escape the window title if pango
2134      * is used by the current font. */
2135     const bool pango_markup = font_is_pango();
2136
2137     char *title;
2138     char *class;
2139     char *instance;
2140     if (win == NULL) {
2141         title = pango_escape_markup(con_get_tree_representation(con));
2142         class = sstrdup("i3-frame");
2143         instance = sstrdup("i3-frame");
2144     } else {
2145         title = pango_escape_markup(sstrdup((win->name == NULL) ? "" : i3string_as_utf8(win->name)));
2146         class = pango_escape_markup(sstrdup((win->class_class == NULL) ? "" : win->class_class));
2147         instance = pango_escape_markup(sstrdup((win->class_instance == NULL) ? "" : win->class_instance));
2148     }
2149
2150     placeholder_t placeholders[] = {
2151         {.name = "%title", .value = title},
2152         {.name = "%class", .value = class},
2153         {.name = "%instance", .value = instance}};
2154     const size_t num = sizeof(placeholders) / sizeof(placeholder_t);
2155
2156     char *formatted_str = format_placeholders(con->title_format, &placeholders[0], num);
2157     i3String *formatted = i3string_from_utf8(formatted_str);
2158     i3string_set_markup(formatted, pango_markup);
2159     FREE(formatted_str);
2160
2161     for (size_t i = 0; i < num; i++) {
2162         FREE(placeholders[i].value);
2163     }
2164
2165     return formatted;
2166 }