2 * vim:ts=4:sw=4:expandtab
4 * i3 - an improved dynamic tiling window manager
5 * © 2009-2011 Michael Stapelberg and contributors (see also: LICENSE)
7 * render.c: Renders (determines position/sizes) the layout tree, updating the
8 * various rects. Needs to be pushed to X11 (see x.c) to be visible.
13 /* change this to 'true' if you want to have additional borders around every
14 * container (for debugging purposes) */
15 static bool show_debug_borders = false;
18 * Renders a container with layout L_OUTPUT. In this layout, all CT_DOCKAREAs
19 * get the height of their content and the remaining CT_CON gets the rest.
22 static void render_l_output(Con *con) {
23 Con *child, *dockchild;
27 int height = con->rect.height;
29 /* Find the content container and ensure that there is exactly one. Also
30 * check for any non-CT_DOCKAREA clients. */
32 TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
33 if (child->type == CT_CON) {
34 if (content != NULL) {
35 DLOG("More than one CT_CON on output container\n");
39 } else if (child->type != CT_DOCKAREA) {
40 DLOG("Child %p of type %d is inside the OUTPUT con\n", child, child->type);
45 assert(content != NULL);
47 /* We need to find out if there is a fullscreen con on the current workspace
48 * and take the short-cut to render it directly (the user does not want to
49 * see the dockareas in that case) */
50 Con *ws = con_get_fullscreen_con(content, CF_OUTPUT);
51 Con *fullscreen = con_get_fullscreen_con(ws, CF_OUTPUT);
53 fullscreen->rect = con->rect;
54 x_raise_con(fullscreen);
55 render_con(fullscreen, true);
59 /* First pass: determine the height of all CT_DOCKAREAs (the sum of their
60 * children) and figure out how many pixels we have left for the rest */
61 TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
62 if (child->type != CT_DOCKAREA)
65 child->rect.height = 0;
66 TAILQ_FOREACH(dockchild, &(child->nodes_head), nodes)
67 child->rect.height += dockchild->geometry.height;
69 height -= child->rect.height;
72 /* Second pass: Set the widths/heights */
73 TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
74 if (child->type == CT_CON) {
77 child->rect.width = con->rect.width;
78 child->rect.height = height;
83 child->rect.width = con->rect.width;
85 child->deco_rect.x = 0;
86 child->deco_rect.y = 0;
87 child->deco_rect.width = 0;
88 child->deco_rect.height = 0;
90 y += child->rect.height;
92 DLOG("child at (%d, %d) with (%d x %d)\n",
93 child->rect.x, child->rect.y, child->rect.width, child->rect.height);
95 render_con(child, false);
100 * "Renders" the given container (and its children), meaning that all rects are
101 * updated correctly. Note that this function does not call any xcb_*
102 * functions, so the changes are completely done in memory only (and
103 * side-effect free). As soon as you call x_push_changes(), the changes will be
107 void render_con(Con *con, bool render_fullscreen) {
108 int children = con_num_children(con);
109 DLOG("Rendering %snode %p / %s / layout %d / children %d / orient %d\n",
110 (render_fullscreen ? "fullscreen " : ""), con, con->name, con->layout,
111 children, con->orientation);
113 /* Copy container rect, subtract container border */
114 /* This is the actually usable space inside this container for clients */
115 Rect rect = con->rect;
117 /* Display a border if this is a leaf node. For container nodes, we don’t
118 * draw borders (except when in debug mode) */
119 if (show_debug_borders) {
123 rect.height -= 2 * 2;
133 /* if this container contains a window, set the coordinates */
135 /* depending on the border style, the rect of the child window
136 * needs to be smaller */
137 Rect *inset = &(con->window_rect);
138 *inset = (Rect){0, 0, con->rect.width, con->rect.height};
139 if (!render_fullscreen)
140 *inset = rect_add(*inset, con_border_style_rect(con));
142 /* Obey x11 border */
143 inset->width -= (2 * con->border_width);
144 inset->height -= (2 * con->border_width);
146 /* Obey the aspect ratio, if any */
147 if (con->proportional_height != 0 &&
148 con->proportional_width != 0) {
149 double new_height = inset->height + 1;
150 int new_width = inset->width;
152 while (new_height > inset->height) {
153 new_height = ((double)con->proportional_height / con->proportional_width) * new_width;
155 if (new_height > inset->height)
158 /* Center the window */
159 inset->y += ceil(inset->height / 2) - floor(new_height / 2);
160 inset->x += ceil(inset->width / 2) - floor(new_width / 2);
162 inset->height = new_height;
163 inset->width = new_width;
166 if (con->height_increment > 1) {
167 int old_height = inset->height;
168 inset->height -= (inset->height - con->base_height) % con->height_increment;
169 DLOG("Lost %d pixel due to client's height_increment (%d px, base_height = %d)\n",
170 old_height - inset->height, con->height_increment, con->base_height);
173 if (con->width_increment > 1) {
174 int old_width = inset->width;
175 inset->width -= (inset->width - con->base_width) % con->width_increment;
176 DLOG("Lost %d pixel due to client's width_increment (%d px, base_width = %d)\n",
177 old_width - inset->width, con->width_increment, con->base_width);
180 DLOG("child will be at %dx%d with size %dx%d\n", inset->x, inset->y, inset->width, inset->height);
183 /* Check for fullscreen nodes */
184 Con *fullscreen = NULL;
185 if (con->type != CT_OUTPUT) {
186 fullscreen = con_get_fullscreen_con(con, (con->type == CT_ROOT ? CF_GLOBAL : CF_OUTPUT));
189 fullscreen->rect = rect;
190 x_raise_con(fullscreen);
191 render_con(fullscreen, true);
195 /* find the height for the decorations */
196 int deco_height = config.font.height + 5;
198 /* precalculate the sizes to be able to correct rounding errors */
200 if (con->layout == L_DEFAULT && children > 0) {
201 assert(!TAILQ_EMPTY(&con->nodes_head));
203 int i = 0, assigned = 0;
204 int total = con->orientation == HORIZ ? rect.width : rect.height;
205 TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
206 double percentage = child->percent > 0.0 ? child->percent : 1.0 / children;
207 assigned += sizes[i++] = percentage * total;
209 assert(assigned == total ||
210 (assigned > total && assigned - total <= children * 2) ||
211 (assigned < total && total - assigned <= children * 2));
212 int signal = assigned < total ? 1 : -1;
213 while (assigned != total) {
214 for (i = 0; i < children && assigned != total; ++i) {
221 if (con->layout == L_OUTPUT) {
222 render_l_output(con);
223 } else if (con->type == CT_ROOT) {
225 TAILQ_FOREACH(output, &(con->nodes_head), nodes) {
226 render_con(output, false);
229 /* We need to render floating windows after rendering all outputs’
230 * tiling windows because they need to be on top of *every* output at
231 * all times. This is important when the user places floating
232 * windows/containers so that they overlap on another output. */
233 DLOG("Rendering floating windows:\n");
234 TAILQ_FOREACH(output, &(con->nodes_head), nodes) {
235 /* Get the active workspace of that output */
236 Con *content = output_get_content(output);
237 Con *workspace = TAILQ_FIRST(&(content->focus_head));
239 /* Check for (floating!) fullscreen nodes */
240 /* XXX: This code duplication is unfortunate. Keep in mind to fix
241 * this when we clean up the whole render.c */
242 Con *fullscreen = NULL;
243 fullscreen = con_get_fullscreen_con(workspace, CF_OUTPUT);
245 /* Either the fullscreen window is inside the floating
246 * container, then we need to render and raise it now… */
247 if (con_inside_floating(fullscreen)) {
248 fullscreen->rect = output->rect;
249 x_raise_con(fullscreen);
250 render_con(fullscreen, true);
253 /* …or it’s a tiling window, in which case the floating
254 * windows should not overlap it, so we skip rendering this
261 TAILQ_FOREACH(child, &(workspace->floating_head), floating_windows) {
262 DLOG("floating child at (%d,%d) with %d x %d\n", child->rect.x, child->rect.y, child->rect.width, child->rect.height);
264 render_con(child, false);
270 /* FIXME: refactor this into separate functions: */
272 TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
273 assert(children > 0);
276 if (con->layout == L_DEFAULT) {
277 if (con->orientation == HORIZ) {
280 child->rect.width = sizes[i];
281 child->rect.height = rect.height;
282 x += child->rect.width;
286 child->rect.width = rect.width;
287 child->rect.height = sizes[i];
288 y += child->rect.height;
291 /* first we have the decoration, if this is a leaf node */
292 if (con_is_leaf(child) && child->border_style == BS_NORMAL) {
293 /* TODO: make a function for relative coords? */
294 child->deco_rect.x = child->rect.x - con->rect.x;
295 child->deco_rect.y = child->rect.y - con->rect.y;
297 child->rect.y += deco_height;
298 child->rect.height -= deco_height;
300 child->deco_rect.width = child->rect.width;
301 child->deco_rect.height = deco_height;
306 else if (con->layout == L_STACKED) {
309 child->rect.width = rect.width;
310 child->rect.height = rect.height;
312 child->deco_rect.x = x - con->rect.x;
313 child->deco_rect.y = y - con->rect.y + (i * deco_height);
314 child->deco_rect.width = child->rect.width;
315 child->deco_rect.height = deco_height;
317 if (children > 1 || (child->border_style != BS_1PIXEL && child->border_style != BS_NONE)) {
318 child->rect.y += (deco_height * children);
319 child->rect.height -= (deco_height * children);
324 else if (con->layout == L_TABBED) {
327 child->rect.width = rect.width;
328 child->rect.height = rect.height;
330 child->deco_rect.width = child->rect.width / children;
331 child->deco_rect.height = deco_height;
332 child->deco_rect.x = x - con->rect.x + i * child->deco_rect.width;
333 child->deco_rect.y = y - con->rect.y;
335 if (children > 1 || (child->border_style != BS_1PIXEL && child->border_style != BS_NONE)) {
336 child->rect.y += deco_height;
337 child->rect.height -= deco_height;
341 /* dockarea layout */
342 else if (con->layout == L_DOCKAREA) {
345 child->rect.width = rect.width;
346 child->rect.height = child->geometry.height;
348 child->deco_rect.x = 0;
349 child->deco_rect.y = 0;
350 child->deco_rect.width = 0;
351 child->deco_rect.height = 0;
352 y += child->rect.height;
355 DLOG("child at (%d, %d) with (%d x %d)\n",
356 child->rect.x, child->rect.y, child->rect.width, child->rect.height);
358 render_con(child, false);
362 /* in a stacking or tabbed container, we ensure the focused client is raised */
363 if (con->layout == L_STACKED || con->layout == L_TABBED) {
364 TAILQ_FOREACH_REVERSE(child, &(con->focus_head), focus_head, focused)
366 if ((child = TAILQ_FIRST(&(con->focus_head)))) {
367 /* By rendering the stacked container again, we handle the case
368 * that we have a non-leaf-container inside the stack. In that
369 * case, the children of the non-leaf-container need to be raised
371 render_con(child, false);
375 /* Raise the stack con itself. This will put the stack decoration on
376 * top of every stack window. That way, when a new window is opened in
377 * the stack, the old window will not obscure part of the decoration
378 * (it’s unmapped afterwards). */