git.sur5r.net Git - i3/i3/blob - src/con.c

   1 /*
   2  * vim:ts=4:sw=4:expandtab
   3  *
   4  * i3 - an improved dynamic tiling window manager
   5  * © 2009-2010 Michael Stapelberg and contributors (see also: LICENSE)
   6  *
   7  * con.c contains all functions which deal with containers directly (creating
   8  * containers, searching containers, getting specific properties from
   9  * containers, …).
  10  *
  11  */
  12 #include "all.h"
  13
  14 char *colors[] = {
  15     "#ff0000",
  16     "#00FF00",
  17     "#0000FF",
  18     "#ff00ff",
  19     "#00ffff",
  20     "#ffff00",
  21     "#aa0000",
  22     "#00aa00",
  23     "#0000aa",
  24     "#aa00aa"
  25 };
  26
  27 static void con_on_remove_child(Con *con);
  28
  29 /*
  30  * Create a new container (and attach it to the given parent, if not NULL).
  31  * This function initializes the data structures and creates the appropriate
  32  * X11 IDs using x_con_init().
  33  *
  34  */
  35 Con *con_new(Con *parent, i3Window *window) {
  36     Con *new = scalloc(sizeof(Con));
  37     new->on_remove_child = con_on_remove_child;
  38     TAILQ_INSERT_TAIL(&all_cons, new, all_cons);
  39     new->type = CT_CON;
  40     new->window = window;
  41     new->border_style = config.default_border;
  42     static int cnt = 0;
  43     DLOG("opening window %d\n", cnt);
  44
  45     /* TODO: remove window coloring after test-phase */
  46     DLOG("color %s\n", colors[cnt]);
  47     new->name = strdup(colors[cnt]);
  48     //uint32_t cp = get_colorpixel(colors[cnt]);
  49     cnt++;
  50     if ((cnt % (sizeof(colors) / sizeof(char*))) == 0)
  51         cnt = 0;
  52
  53     x_con_init(new);
  54
  55     // TODO: this needs to be integrated into src/x.c and updated on config file reloads
  56     xcb_change_window_attributes(conn, new->frame, XCB_CW_BACK_PIXEL, &config.client.background);
  57
  58     TAILQ_INIT(&(new->floating_head));
  59     TAILQ_INIT(&(new->nodes_head));
  60     TAILQ_INIT(&(new->focus_head));
  61     TAILQ_INIT(&(new->swallow_head));
  62
  63     if (parent != NULL)
  64         con_attach(new, parent, false);
  65
  66     return new;
  67 }
  68
  69 /*
  70  * Attaches the given container to the given parent. This happens when moving
  71  * a container or when inserting a new container at a specific place in the
  72  * tree.
  73  *
  74  * ignore_focus is to just insert the Con at the end (useful when creating a
  75  * new split container *around* some containers, that is, detaching and
  76  * attaching them in order without wanting to mess with the focus in between).
  77  *
  78  */
  79 void con_attach(Con *con, Con *parent, bool ignore_focus) {
  80     con->parent = parent;
  81     Con *loop;
  82     Con *current = NULL;
  83     struct nodes_head *nodes_head = &(parent->nodes_head);
  84     struct focus_head *focus_head = &(parent->focus_head);
  85
  86     /* Workspaces are handled differently: they need to be inserted at the
  87      * right position. */
  88     if (con->type == CT_WORKSPACE) {
  89         DLOG("it's a workspace. num = %d\n", con->num);
  90         if (con->num == -1 || TAILQ_EMPTY(nodes_head)) {
  91             TAILQ_INSERT_TAIL(nodes_head, con, nodes);
  92         } else {
  93             current = TAILQ_FIRST(nodes_head);
  94             if (con->num < current->num) {
  95                 /* we need to insert the container at the beginning */
  96                 TAILQ_INSERT_HEAD(nodes_head, con, nodes);
  97             } else {
  98                 while (current->num != -1 && con->num > current->num) {
  99                     current = TAILQ_NEXT(current, nodes);
 100                     if (current == TAILQ_END(nodes_head)) {
 101                         current = NULL;
 102                         break;
 103                     }
 104                 }
 105                 /* we need to insert con after current, if current is not NULL */
 106                 if (current)
 107                     TAILQ_INSERT_BEFORE(current, con, nodes);
 108                 else TAILQ_INSERT_TAIL(nodes_head, con, nodes);
 109             }
 110         }
 111         goto add_to_focus_head;
 112     }
 113
 114     if (con->type == CT_FLOATING_CON) {
 115         DLOG("Inserting into floating containers\n");
 116         TAILQ_INSERT_TAIL(&(parent->floating_head), con, floating_windows);
 117     } else {
 118         if (!ignore_focus) {
 119             /* Get the first tiling container in focus stack */
 120             TAILQ_FOREACH(loop, &(parent->focus_head), focused) {
 121                 if (loop->type == CT_FLOATING_CON)
 122                     continue;
 123                 current = loop;
 124                 break;
 125             }
 126         }
 127
 128         /* When the container is not a split container (but contains a window)
 129          * and is attached to a workspace, we check if the user configured a
 130          * workspace_layout. This is done in workspace_attach_to, which will
 131          * provide us with the container to which we should attach (either the
 132          * workspace or a new split container with the configured
 133          * workspace_layout).
 134          */
 135         if (con->window != NULL && parent->type == CT_WORKSPACE) {
 136             DLOG("Parent is a workspace. Applying default layout...\n");
 137             Con *target = workspace_attach_to(parent);
 138
 139             /* Attach the original con to this new split con instead */
 140             nodes_head = &(target->nodes_head);
 141             focus_head = &(target->focus_head);
 142             con->parent = target;
 143             current = NULL;
 144
 145             DLOG("done\n");
 146         }
 147
 148         /* Insert the container after the tiling container, if found.
 149          * When adding to a CT_OUTPUT, just append one after another. */
 150         if (current && parent->type != CT_OUTPUT) {
 151             DLOG("Inserting con = %p after last focused tiling con %p\n",
 152                  con, current);
 153             TAILQ_INSERT_AFTER(nodes_head, current, con, nodes);
 154         } else TAILQ_INSERT_TAIL(nodes_head, con, nodes);
 155     }
 156
 157 add_to_focus_head:
 158     /* We insert to the TAIL because con_focus() will correct this.
 159      * This way, we have the option to insert Cons without having
 160      * to focus them. */
 161     TAILQ_INSERT_TAIL(focus_head, con, focused);
 162 }
 163
 164 /*
 165  * Detaches the given container from its current parent
 166  *
 167  */
 168 void con_detach(Con *con) {
 169     if (con->type == CT_FLOATING_CON) {
 170         TAILQ_REMOVE(&(con->parent->floating_head), con, floating_windows);
 171         TAILQ_REMOVE(&(con->parent->focus_head), con, focused);
 172     } else {
 173         TAILQ_REMOVE(&(con->parent->nodes_head), con, nodes);
 174         TAILQ_REMOVE(&(con->parent->focus_head), con, focused);
 175     }
 176 }
 177
 178 /*
 179  * Sets input focus to the given container. Will be updated in X11 in the next
 180  * run of x_push_changes().
 181  *
 182  */
 183 void con_focus(Con *con) {
 184     assert(con != NULL);
 185     DLOG("con_focus = %p\n", con);
 186
 187     /* 1: set focused-pointer to the new con */
 188     /* 2: exchange the position of the container in focus stack of the parent all the way up */
 189     TAILQ_REMOVE(&(con->parent->focus_head), con, focused);
 190     TAILQ_INSERT_HEAD(&(con->parent->focus_head), con, focused);
 191     if (con->parent->parent != NULL)
 192         con_focus(con->parent);
 193
 194     focused = con;
 195     if (con->urgent) {
 196         con->urgent = false;
 197         workspace_update_urgent_flag(con_get_workspace(con));
 198     }
 199     DLOG("con_focus done = %p\n", con);
 200 }
 201
 202 /*
 203  * Returns true when this node is a leaf node (has no children)
 204  *
 205  */
 206 bool con_is_leaf(Con *con) {
 207     return TAILQ_EMPTY(&(con->nodes_head));
 208 }
 209
 210 /*
 211  * Returns true if this node accepts a window (if the node swallows windows,
 212  * it might already have swallowed enough and cannot hold any more).
 213  *
 214  */
 215 bool con_accepts_window(Con *con) {
 216     /* 1: workspaces never accept direct windows */
 217     if (con->type == CT_WORKSPACE)
 218         return false;
 219
 220     if (con->orientation != NO_ORIENTATION) {
 221         DLOG("container %p does not accepts windows, orientation != NO_ORIENTATION\n", con);
 222         return false;
 223     }
 224
 225     /* TODO: if this is a swallowing container, we need to check its max_clients */
 226     return (con->window == NULL);
 227 }
 228
 229 /*
 230  * Gets the output container (first container with CT_OUTPUT in hierarchy) this
 231  * node is on.
 232  *
 233  */
 234 Con *con_get_output(Con *con) {
 235     Con *result = con;
 236     while (result != NULL && result->type != CT_OUTPUT)
 237         result = result->parent;
 238     /* We must be able to get an output because focus can never be set higher
 239      * in the tree (root node cannot be focused). */
 240     assert(result != NULL);
 241     return result;
 242 }
 243
 244 /*
 245  * Gets the workspace container this node is on.
 246  *
 247  */
 248 Con *con_get_workspace(Con *con) {
 249     Con *result = con;
 250     while (result != NULL && result->type != CT_WORKSPACE)
 251         result = result->parent;
 252     return result;
 253 }
 254
 255 /*
 256  * Searches parenst of the given 'con' until it reaches one with the specified
 257  * 'orientation'. Aborts when it comes across a floating_con.
 258  *
 259  */
 260 Con *con_parent_with_orientation(Con *con, orientation_t orientation) {
 261     DLOG("Searching for parent of Con %p with orientation %d\n", con, orientation);
 262     Con *parent = con->parent;
 263     if (parent->type == CT_FLOATING_CON)
 264         return NULL;
 265     while (con_orientation(parent) != orientation) {
 266         DLOG("Need to go one level further up\n");
 267         parent = parent->parent;
 268         /* Abort when we reach a floating con */
 269         if (parent && parent->type == CT_FLOATING_CON)
 270             parent = NULL;
 271         if (parent == NULL)
 272             break;
 273     }
 274     DLOG("Result: %p\n", parent);
 275     return parent;
 276 }
 277
 278 /*
 279  * helper data structure for the breadth-first-search in
 280  * con_get_fullscreen_con()
 281  *
 282  */
 283 struct bfs_entry {
 284     Con *con;
 285
 286     TAILQ_ENTRY(bfs_entry) entries;
 287 };
 288
 289 /*
 290  * Returns the first fullscreen node below this node.
 291  *
 292  */
 293 Con *con_get_fullscreen_con(Con *con) {
 294     Con *current, *child;
 295
 296     /* TODO: is breadth-first-search really appropriate? (check as soon as
 297      * fullscreen levels and fullscreen for containers is implemented) */
 298     TAILQ_HEAD(bfs_head, bfs_entry) bfs_head = TAILQ_HEAD_INITIALIZER(bfs_head);
 299     struct bfs_entry *entry = smalloc(sizeof(struct bfs_entry));
 300     entry->con = con;
 301     TAILQ_INSERT_TAIL(&bfs_head, entry, entries);
 302
 303     while (!TAILQ_EMPTY(&bfs_head)) {
 304         entry = TAILQ_FIRST(&bfs_head);
 305         current = entry->con;
 306         if (current != con && current->fullscreen_mode != CF_NONE) {
 307             /* empty the queue */
 308             while (!TAILQ_EMPTY(&bfs_head)) {
 309                 entry = TAILQ_FIRST(&bfs_head);
 310                 TAILQ_REMOVE(&bfs_head, entry, entries);
 311                 free(entry);
 312             }
 313             return current;
 314         }
 315
 316         TAILQ_REMOVE(&bfs_head, entry, entries);
 317         free(entry);
 318
 319         TAILQ_FOREACH(child, &(current->nodes_head), nodes) {
 320             entry = smalloc(sizeof(struct bfs_entry));
 321             entry->con = child;
 322             TAILQ_INSERT_TAIL(&bfs_head, entry, entries);
 323         }
 324
 325         TAILQ_FOREACH(child, &(current->floating_head), floating_windows) {
 326             entry = smalloc(sizeof(struct bfs_entry));
 327             entry->con = child;
 328             TAILQ_INSERT_TAIL(&bfs_head, entry, entries);
 329         }
 330     }
 331
 332     return NULL;
 333 }
 334
 335 /*
 336  * Returns true if the node is floating.
 337  *
 338  */
 339 bool con_is_floating(Con *con) {
 340     assert(con != NULL);
 341     DLOG("checking if con %p is floating\n", con);
 342     return (con->floating >= FLOATING_AUTO_ON);
 343 }
 344
 345 /*
 346  * Checks if the given container is either floating or inside some floating
 347  * container. It returns the FLOATING_CON container.
 348  *
 349  */
 350 Con *con_inside_floating(Con *con) {
 351     assert(con != NULL);
 352     if (con->type == CT_FLOATING_CON)
 353         return con;
 354
 355     if (con->floating >= FLOATING_AUTO_ON)
 356         return con->parent;
 357
 358     if (con->type == CT_WORKSPACE || con->type == CT_OUTPUT)
 359         return NULL;
 360
 361     return con_inside_floating(con->parent);
 362 }
 363
 364 /*
 365  * Returns the container with the given client window ID or NULL if no such
 366  * container exists.
 367  *
 368  */
 369 Con *con_by_window_id(xcb_window_t window) {
 370     Con *con;
 371     TAILQ_FOREACH(con, &all_cons, all_cons)
 372         if (con->window != NULL && con->window->id == window)
 373             return con;
 374     return NULL;
 375 }
 376
 377 /*
 378  * Returns the container with the given frame ID or NULL if no such container
 379  * exists.
 380  *
 381  */
 382 Con *con_by_frame_id(xcb_window_t frame) {
 383     Con *con;
 384     TAILQ_FOREACH(con, &all_cons, all_cons)
 385         if (con->frame == frame)
 386             return con;
 387     return NULL;
 388 }
 389
 390 /*
 391  * Returns the first container below 'con' which wants to swallow this window
 392  * TODO: priority
 393  *
 394  */
 395 Con *con_for_window(Con *con, i3Window *window, Match **store_match) {
 396     Con *child;
 397     Match *match;
 398     DLOG("searching con for window %p starting at con %p\n", window, con);
 399     DLOG("class == %s\n", window->class_class);
 400
 401     TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
 402         TAILQ_FOREACH(match, &(child->swallow_head), matches) {
 403             if (!match_matches_window(match, window))
 404                 continue;
 405             if (store_match != NULL)
 406                 *store_match = match;
 407             return child;
 408         }
 409         Con *result = con_for_window(child, window, store_match);
 410         if (result != NULL)
 411             return result;
 412     }
 413
 414     TAILQ_FOREACH(child, &(con->floating_head), floating_windows) {
 415         TAILQ_FOREACH(match, &(child->swallow_head), matches) {
 416             if (!match_matches_window(match, window))
 417                 continue;
 418             if (store_match != NULL)
 419                 *store_match = match;
 420             return child;
 421         }
 422         Con *result = con_for_window(child, window, store_match);
 423         if (result != NULL)
 424             return result;
 425     }
 426
 427     return NULL;
 428 }
 429
 430 /*
 431  * Returns the number of children of this container.
 432  *
 433  */
 434 int con_num_children(Con *con) {
 435     Con *child;
 436     int children = 0;
 437
 438     TAILQ_FOREACH(child, &(con->nodes_head), nodes)
 439         children++;
 440
 441     return children;
 442 }
 443
 444 /*
 445  * Updates the percent attribute of the children of the given container. This
 446  * function needs to be called when a window is added or removed from a
 447  * container.
 448  *
 449  */
 450 void con_fix_percent(Con *con) {
 451     Con *child;
 452     int children = con_num_children(con);
 453
 454     // calculate how much we have distributed and how many containers
 455     // with a percentage set we have
 456     double total = 0.0;
 457     int children_with_percent = 0;
 458     TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
 459         if (child->percent > 0.0) {
 460             total += child->percent;
 461             ++children_with_percent;
 462         }
 463     }
 464
 465     // if there were children without a percentage set, set to a value that
 466     // will make those children proportional to all others
 467     if (children_with_percent != children) {
 468         TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
 469             if (child->percent <= 0.0) {
 470                 if (children_with_percent == 0)
 471                     total += (child->percent = 1.0);
 472                 else total += (child->percent = total / children_with_percent);
 473             }
 474         }
 475     }
 476
 477     // if we got a zero, just distribute the space equally, otherwise
 478     // distribute according to the proportions we got
 479     if (total == 0.0) {
 480         TAILQ_FOREACH(child, &(con->nodes_head), nodes)
 481             child->percent = 1.0 / children;
 482     } else if (total != 1.0) {
 483         TAILQ_FOREACH(child, &(con->nodes_head), nodes)
 484             child->percent /= total;
 485     }
 486 }
 487
 488 /*
 489  * Toggles fullscreen mode for the given container. Fullscreen mode will not be
 490  * entered when there already is a fullscreen container on this workspace.
 491  *
 492  */
 493 void con_toggle_fullscreen(Con *con) {
 494     Con *workspace, *fullscreen;
 495
 496     if (con->type == CT_WORKSPACE) {
 497         DLOG("You cannot make a workspace fullscreen.\n");
 498         return;
 499     }
 500
 501     DLOG("toggling fullscreen for %p / %s\n", con, con->name);
 502     if (con->fullscreen_mode == CF_NONE) {
 503         /* 1: check if there already is a fullscreen con */
 504         workspace = con_get_workspace(con);
 505         if ((fullscreen = con_get_fullscreen_con(workspace)) != NULL) {
 506             LOG("Not entering fullscreen mode, container (%p/%s) "
 507                 "already is in fullscreen mode\n",
 508                 fullscreen, fullscreen->name);
 509         } else {
 510             /* 2: enable fullscreen */
 511             con->fullscreen_mode = CF_OUTPUT;
 512         }
 513     } else {
 514         /* 1: disable fullscreen */
 515         con->fullscreen_mode = CF_NONE;
 516     }
 517     DLOG("mode now: %d\n", con->fullscreen_mode);
 518
 519     /* update _NET_WM_STATE if this container has a window */
 520     /* TODO: when a window is assigned to a container which is already
 521      * fullscreened, this state needs to be pushed to the client, too */
 522     if (con->window == NULL)
 523         return;
 524
 525     uint32_t values[1];
 526     unsigned int num = 0;
 527
 528     if (con->fullscreen_mode != CF_NONE)
 529         values[num++] = A__NET_WM_STATE_FULLSCREEN;
 530
 531     xcb_change_property(conn, XCB_PROP_MODE_REPLACE, con->window->id,
 532                         A__NET_WM_STATE, A_ATOM, 32, num, values);
 533 }
 534
 535 /*
 536  * Moves the given container to the currently focused container on the given
 537  * workspace.
 538  * TODO: is there a better place for this function?
 539  *
 540  */
 541 void con_move_to_workspace(Con *con, Con *workspace) {
 542     if (con->type == CT_WORKSPACE) {
 543         DLOG("Moving workspaces is not yet implemented.\n");
 544         return;
 545     }
 546
 547     if (con_is_floating(con)) {
 548         DLOG("Using FLOATINGCON instead\n");
 549         con = con->parent;
 550     }
 551
 552     Con *source_output = con_get_output(con),
 553         *dest_output = con_get_output(workspace);
 554
 555     /* 1: save the container which is going to be focused after the current
 556      * container is moved away */
 557     Con *focus_next = con_next_focused(con);
 558
 559     /* 2: get the focused container of this workspace */
 560     Con *next = con_descend_focused(workspace);
 561
 562     /* 3: we go up one level, but only when next is a normal container */
 563     if (next->type != CT_WORKSPACE) {
 564         DLOG("next originally = %p / %s / type %d\n", next, next->name, next->type);
 565         next = next->parent;
 566     }
 567
 568     /* 4: if the target container is floating, we get the workspace instead.
 569      * Only tiling windows need to get inserted next to the current container.
 570      * */
 571     Con *floatingcon = con_inside_floating(next);
 572     if (floatingcon != NULL) {
 573         DLOG("floatingcon, going up even further\n");
 574         next = floatingcon->parent;
 575     }
 576
 577     if (con->type == CT_FLOATING_CON) {
 578         Con *ws = con_get_workspace(next);
 579         DLOG("This is a floating window, using workspace %p / %s\n", ws, ws->name);
 580         next = ws;
 581     }
 582
 583     DLOG("Re-attaching container to %p / %s\n", next, next->name);
 584     /* 5: re-attach the con to the parent of this focused container */
 585     Con *parent = con->parent;
 586     con_detach(con);
 587     con_attach(con, next, false);
 588
 589     /* 6: fix the percentages */
 590     con_fix_percent(parent);
 591     con->percent = 0.0;
 592     con_fix_percent(next);
 593
 594     /* 7: focus the con on the target workspace (the X focus is only updated by
 595      * calling tree_render(), so for the "real" focus this is a no-op) */
 596     con_focus(con);
 597
 598     /* 8: when moving to a visible workspace on a different output, we keep the
 599      * con focused. Otherwise, we leave the focus on the current workspace as we
 600      * don’t want to focus invisible workspaces */
 601     if (source_output != dest_output &&
 602         workspace_is_visible(workspace)) {
 603         DLOG("Moved to a different output, focusing target\n");
 604     } else {
 605         con_focus(focus_next);
 606     }
 607
 608     CALL(parent, on_remove_child);
 609 }
 610
 611 /*
 612  * Returns the orientation of the given container (for stacked containers,
 613  * vertical orientation is used regardless of the actual orientation of the
 614  * container).
 615  *
 616  */
 617 int con_orientation(Con *con) {
 618     /* stacking containers behave like they are in vertical orientation */
 619     if (con->layout == L_STACKED)
 620         return VERT;
 621
 622     if (con->layout == L_TABBED)
 623         return HORIZ;
 624
 625     return con->orientation;
 626 }
 627
 628 /*
 629  * Returns the container which will be focused next when the given container
 630  * is not available anymore. Called in tree_close and con_move_to_workspace
 631  * to properly restore focus.
 632  *
 633  */
 634 Con *con_next_focused(Con *con) {
 635     Con *next;
 636     /* floating containers are attached to a workspace, so we focus either the
 637      * next floating container (if any) or the workspace itself. */
 638     if (con->type == CT_FLOATING_CON) {
 639         DLOG("selecting next for CT_FLOATING_CON\n");
 640         next = TAILQ_NEXT(con, floating_windows);
 641         if (next == TAILQ_END(&(parent->floating_head))) {
 642             Con *ws = con_get_workspace(con);
 643             next = ws;
 644             DLOG("no more floating containers for next = %p, restoring workspace focus\n", next);
 645             while (next != TAILQ_END(&(ws->focus_head)) && !TAILQ_EMPTY(&(next->focus_head))) {
 646                 next = TAILQ_FIRST(&(next->focus_head));
 647                 if (next == con) {
 648                     DLOG("skipping container itself, we want the next client\n");
 649                     next = TAILQ_NEXT(next, focused);
 650                 }
 651             }
 652             if (next == TAILQ_END(&(ws->focus_head))) {
 653                 DLOG("Focus list empty, returning ws\n");
 654                 next = ws;
 655             }
 656         } else {
 657             /* Instead of returning the next CT_FLOATING_CON, we descend it to
 658              * get an actual window to focus. */
 659             next = con_descend_focused(next);
 660         }
 661         return next;
 662     }
 663
 664     /* dock clients cannot be focused, so we focus the workspace instead */
 665     if (con->parent->type == CT_DOCKAREA) {
 666         DLOG("selecting workspace for dock client\n");
 667         return con_descend_focused(output_get_content(con->parent->parent));
 668     }
 669
 670     /* if 'con' is not the first entry in the focus stack, use the first one as
 671      * it’s currently focused already */
 672     Con *first = TAILQ_FIRST(&(con->parent->focus_head));
 673     if (first != con) {
 674         DLOG("Using first entry %p\n", first);
 675         next = first;
 676     } else {
 677         /* try to focus the next container on the same level as this one or fall
 678          * back to its parent */
 679         if (!(next = TAILQ_NEXT(con, focused)))
 680             next = con->parent;
 681     }
 682
 683     /* now go down the focus stack as far as
 684      * possible, excluding the current container */
 685     while (!TAILQ_EMPTY(&(next->focus_head)) &&
 686            TAILQ_FIRST(&(next->focus_head)) != con)
 687         next = TAILQ_FIRST(&(next->focus_head));
 688
 689     return next;
 690 }
 691
 692 /*
 693  * Get the next/previous container in the specified orientation. This may
 694  * travel up until it finds a container with suitable orientation.
 695  *
 696  */
 697 Con *con_get_next(Con *con, char way, orientation_t orientation) {
 698     DLOG("con_get_next(way=%c, orientation=%d)\n", way, orientation);
 699     /* 1: get the first parent with the same orientation */
 700     Con *cur = con;
 701     while (con_orientation(cur->parent) != orientation) {
 702         DLOG("need to go one level further up\n");
 703         if (cur->parent->type == CT_WORKSPACE) {
 704             LOG("that's a workspace, we can't go further up\n");
 705             return NULL;
 706         }
 707         cur = cur->parent;
 708     }
 709
 710     /* 2: chose next (or previous) */
 711     Con *next;
 712     if (way == 'n') {
 713         next = TAILQ_NEXT(cur, nodes);
 714         /* if we are at the end of the list, we need to wrap */
 715         if (next == TAILQ_END(&(parent->nodes_head)))
 716             return NULL;
 717     } else {
 718         next = TAILQ_PREV(cur, nodes_head, nodes);
 719         /* if we are at the end of the list, we need to wrap */
 720         if (next == TAILQ_END(&(cur->nodes_head)))
 721             return NULL;
 722     }
 723     DLOG("next = %p\n", next);
 724
 725     return next;
 726 }
 727
 728 /*
 729  * Returns the focused con inside this client, descending the tree as far as
 730  * possible. This comes in handy when attaching a con to a workspace at the
 731  * currently focused position, for example.
 732  *
 733  */
 734 Con *con_descend_focused(Con *con) {
 735     Con *next = con;
 736     while (!TAILQ_EMPTY(&(next->focus_head)))
 737         next = TAILQ_FIRST(&(next->focus_head));
 738     return next;
 739 }
 740
 741 /*
 742  * Returns the focused con inside this client, descending the tree as far as
 743  * possible. This comes in handy when attaching a con to a workspace at the
 744  * currently focused position, for example.
 745  *
 746  * Works like con_descend_focused but considers only tiling cons.
 747  *
 748  */
 749 Con *con_descend_tiling_focused(Con *con) {
 750     Con *next = con;
 751     Con *before;
 752     Con *child;
 753     do {
 754         before = next;
 755         TAILQ_FOREACH(child, &(next->focus_head), focused) {
 756             if (child->type == CT_FLOATING_CON)
 757                 continue;
 758
 759             next = child;
 760             break;
 761         }
 762     } while (before != next);
 763     return next;
 764 }
 765
 766
 767 /*
 768  * Returns a "relative" Rect which contains the amount of pixels that need to
 769  * be added to the original Rect to get the final position (obviously the
 770  * amount of pixels for normal, 1pixel and borderless are different).
 771  *
 772  */
 773 Rect con_border_style_rect(Con *con) {
 774     switch (con_border_style(con)) {
 775     case BS_NORMAL:
 776         return (Rect){2, 0, -(2 * 2), -2};
 777
 778     case BS_1PIXEL:
 779         return (Rect){1, 1, -2, -2};
 780
 781     case BS_NONE:
 782         return (Rect){0, 0, 0, 0};
 783
 784     default:
 785         assert(false);
 786     }
 787 }
 788
 789 /*
 790  * Use this function to get a container’s border style. This is important
 791  * because when inside a stack, the border style is always BS_NORMAL.
 792  * For tabbed mode, the same applies, with one exception: when the container is
 793  * borderless and the only element in the tabbed container, the border is not
 794  * rendered.
 795  *
 796  * For children of a CT_DOCKAREA, the border style is always none.
 797  *
 798  */
 799 int con_border_style(Con *con) {
 800     Con *fs = con_get_fullscreen_con(con->parent);
 801     if (fs == con) {
 802         DLOG("this one is fullscreen! overriding BS_NONE\n");
 803         return BS_NONE;
 804     }
 805
 806     if (con->parent->layout == L_STACKED)
 807         return (con_num_children(con->parent) == 1 ? con->border_style : BS_NORMAL);
 808
 809     if (con->parent->layout == L_TABBED && con->border_style != BS_NORMAL)
 810         return (con_num_children(con->parent) == 1 ? con->border_style : BS_NORMAL);
 811
 812     if (con->parent->type == CT_DOCKAREA)
 813         return BS_NONE;
 814
 815     return con->border_style;
 816 }
 817
 818 /*
 819  * This function changes the layout of a given container. Use it to handle
 820  * special cases like changing a whole workspace to stacked/tabbed (creates a
 821  * new split container before).
 822  *
 823  */
 824 void con_set_layout(Con *con, int layout) {
 825     /* When the container type is CT_WORKSPACE, the user wants to change the
 826      * whole workspace into stacked/tabbed mode. To do this and still allow
 827      * intuitive operations (like level-up and then opening a new window), we
 828      * need to create a new split container. */
 829     if (con->type == CT_WORKSPACE) {
 830         DLOG("Creating new split container\n");
 831         /* 1: create a new split container */
 832         Con *new = con_new(NULL, NULL);
 833         new->parent = con;
 834
 835         /* 2: set the requested layout on the split con */
 836         new->layout = layout;
 837
 838         /* 3: While the layout is irrelevant in stacked/tabbed mode, it needs
 839          * to be set. Otherwise, this con will not be interpreted as a split
 840          * container. */
 841         if (config.default_orientation == NO_ORIENTATION) {
 842             new->orientation = (con->rect.height > con->rect.width) ? VERT : HORIZ;
 843         } else {
 844             new->orientation = config.default_orientation;
 845         }
 846
 847         Con *old_focused = TAILQ_FIRST(&(con->focus_head));
 848         if (old_focused == TAILQ_END(&(con->focus_head)))
 849             old_focused = NULL;
 850
 851         /* 4: move the existing cons of this workspace below the new con */
 852         DLOG("Moving cons\n");
 853         Con *child;
 854         while (!TAILQ_EMPTY(&(con->nodes_head))) {
 855             child = TAILQ_FIRST(&(con->nodes_head));
 856             con_detach(child);
 857             con_attach(child, new, true);
 858         }
 859
 860         /* 4: attach the new split container to the workspace */
 861         DLOG("Attaching new split to ws\n");
 862         con_attach(new, con, false);
 863
 864         if (old_focused)
 865             con_focus(old_focused);
 866
 867         tree_flatten(croot);
 868
 869         return;
 870     }
 871
 872     con->layout = layout;
 873 }
 874
 875 /*
 876  * Callback which will be called when removing a child from the given con.
 877  * Kills the container if it is empty and replaces it with the child if there
 878  * is exactly one child.
 879  *
 880  */
 881 static void con_on_remove_child(Con *con) {
 882     DLOG("on_remove_child\n");
 883
 884     /* Every container 'above' (in the hierarchy) the workspace content should
 885      * not be closed when the last child was removed */
 886     if (con->type == CT_WORKSPACE ||
 887         con->type == CT_OUTPUT ||
 888         con->type == CT_ROOT ||
 889         con->type == CT_DOCKAREA) {
 890         DLOG("not handling, type = %d\n", con->type);
 891         return;
 892     }
 893
 894     /* TODO: check if this container would swallow any other client and
 895      * don’t close it automatically. */
 896     int children = con_num_children(con);
 897     if (children == 0) {
 898         DLOG("Container empty, closing\n");
 899         tree_close(con, DONT_KILL_WINDOW, false);
 900         return;
 901     }
 902 }
 903
 904 /*
 905  * Determines the minimum size of the given con by looking at its children (for
 906  * split/stacked/tabbed cons). Will be called when resizing floating cons
 907  *
 908  */
 909 Rect con_minimum_size(Con *con) {
 910     DLOG("Determining minimum size for con %p\n", con);
 911
 912     if (con_is_leaf(con)) {
 913         DLOG("leaf node, returning 75x50\n");
 914         return (Rect){ 0, 0, 75, 50 };
 915     }
 916
 917     if (con->type == CT_FLOATING_CON) {
 918         DLOG("floating con\n");
 919         Con *child = TAILQ_FIRST(&(con->nodes_head));
 920         return con_minimum_size(child);
 921     }
 922
 923     if (con->layout == L_STACKED || con->layout == L_TABBED) {
 924         uint32_t max_width = 0, max_height = 0, deco_height = 0;
 925         Con *child;
 926         TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
 927             Rect min = con_minimum_size(child);
 928             deco_height += child->deco_rect.height;
 929             max_width = max(max_width, min.width);
 930             max_height = max(max_height, min.height);
 931         }
 932         DLOG("stacked/tabbed now, returning %d x %d + deco_rect = %d\n",
 933              max_width, max_height, deco_height);
 934         return (Rect){ 0, 0, max_width, max_height + deco_height };
 935     }
 936
 937     /* For horizontal/vertical split containers we sum up the width (h-split)
 938      * or height (v-split) and use the maximum of the height (h-split) or width
 939      * (v-split) as minimum size. */
 940     if (con->orientation == HORIZ || con->orientation == VERT) {
 941         uint32_t width = 0, height = 0;
 942         Con *child;
 943         TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
 944             Rect min = con_minimum_size(child);
 945             if (con->orientation == HORIZ) {
 946                 width += min.width;
 947                 height = max(height, min.height);
 948             } else {
 949                 height += min.height;
 950                 width = max(width, min.width);
 951             }
 952         }
 953         DLOG("split container, returning width = %d x height = %d\n", width, height);
 954         return (Rect){ 0, 0, width, height };
 955     }
 956
 957     ELOG("Unhandled case, type = %d, layout = %d, orientation = %d\n",
 958          con->type, con->layout, con->orientation);
 959     assert(false);
 960 }