2 * vim:ts=4:sw=4:expandtab
4 * i3 - an improved dynamic tiling window manager
5 * © 2009-2010 Michael Stapelberg and contributors (see also: LICENSE)
7 * con.c contains all functions which deal with containers directly (creating
8 * containers, searching containers, getting specific properties from
28 Con *con_new(Con *parent) {
29 Con *new = scalloc(sizeof(Con));
30 TAILQ_INSERT_TAIL(&all_cons, new, all_cons);
32 new->name = strdup("");
34 LOG("opening window %d\n", cnt);
36 /* TODO: remove window coloring after test-phase */
37 LOG("color %s\n", colors[cnt]);
38 new->name = strdup(colors[cnt]);
39 uint32_t cp = get_colorpixel(colors[cnt]);
41 if ((cnt % (sizeof(colors) / sizeof(char*))) == 0)
46 xcb_change_window_attributes(conn, new->frame, XCB_CW_BACK_PIXEL, &cp);
48 TAILQ_INIT(&(new->floating_head));
49 TAILQ_INIT(&(new->nodes_head));
50 TAILQ_INIT(&(new->focus_head));
51 TAILQ_INIT(&(new->swallow_head));
54 con_attach(new, parent);
59 void con_attach(Con *con, Con *parent) {
61 Con *current = TAILQ_FIRST(&(parent->focus_head));
63 if (current == TAILQ_END(&(parent->focus_head)))
64 TAILQ_INSERT_TAIL(&(parent->nodes_head), con, nodes);
66 DLOG("inserting after\n");
67 TAILQ_INSERT_AFTER(&(parent->nodes_head), current, con, nodes);
69 /* We insert to the TAIL because con_focus() will correct this.
70 * This way, we have the option to insert Cons without having
72 TAILQ_INSERT_TAIL(&(parent->focus_head), con, focused);
75 void con_detach(Con *con) {
76 if (con->type == CT_FLOATING_CON) {
77 TAILQ_REMOVE(&(con->parent->floating_head), con, floating_windows);
78 TAILQ_REMOVE(&(con->parent->focus_head), con, focused);
80 TAILQ_REMOVE(&(con->parent->nodes_head), con, nodes);
81 TAILQ_REMOVE(&(con->parent->focus_head), con, focused);
86 * Sets input focus to the given container. Will be updated in X11 in the next
87 * run of x_push_changes().
90 void con_focus(Con *con) {
93 /* 1: set focused-pointer to the new con */
94 /* 2: exchange the position of the container in focus stack of the parent all the way up */
95 TAILQ_REMOVE(&(con->parent->focus_head), con, focused);
96 TAILQ_INSERT_HEAD(&(con->parent->focus_head), con, focused);
97 if (con->parent->parent != NULL)
98 con_focus(con->parent);
103 workspace_update_urgent_flag(con_get_workspace(con));
108 * Returns true when this node is a leaf node (has no children)
111 bool con_is_leaf(Con *con) {
112 return TAILQ_EMPTY(&(con->nodes_head));
116 * Returns true if this node accepts a window (if the node swallows windows,
117 * it might already have swallowed enough and cannot hold any more).
120 bool con_accepts_window(Con *con) {
121 /* 1: workspaces never accept direct windows */
122 if (con->type == CT_WORKSPACE)
125 if (con->orientation != NO_ORIENTATION) {
126 DLOG("container %p does not accepts windows, orientation != NO_ORIENTATION\n", con);
130 /* TODO: if this is a swallowing container, we need to check its max_clients */
131 return (con->window == NULL);
135 * Gets the output container (first container with CT_OUTPUT in hierarchy) this
139 Con *con_get_output(Con *con) {
141 while (result != NULL && result->type != CT_OUTPUT)
142 result = result->parent;
143 /* We must be able to get an output because focus can never be set higher
144 * in the tree (root node cannot be focused). */
145 assert(result != NULL);
150 * Gets the workspace container this node is on.
153 Con *con_get_workspace(Con *con) {
155 while (result != NULL && result->type != CT_WORKSPACE)
156 result = result->parent;
157 assert(result != NULL);
162 * helper data structure for the breadth-first-search in
163 * con_get_fullscreen_con()
169 TAILQ_ENTRY(bfs_entry) entries;
173 * Returns the first fullscreen node below this node.
176 Con *con_get_fullscreen_con(Con *con) {
177 Con *current, *child;
179 LOG("looking for fullscreen node\n");
180 /* TODO: is breadth-first-search really appropriate? (check as soon as
181 * fullscreen levels and fullscreen for containers is implemented) */
182 TAILQ_HEAD(bfs_head, bfs_entry) bfs_head = TAILQ_HEAD_INITIALIZER(bfs_head);
183 struct bfs_entry *entry = smalloc(sizeof(struct bfs_entry));
185 TAILQ_INSERT_TAIL(&bfs_head, entry, entries);
187 while (!TAILQ_EMPTY(&bfs_head)) {
188 entry = TAILQ_FIRST(&bfs_head);
189 current = entry->con;
190 LOG("checking %p\n", current);
191 if (current != con && current->fullscreen_mode != CF_NONE) {
192 /* empty the queue */
193 while (!TAILQ_EMPTY(&bfs_head)) {
194 entry = TAILQ_FIRST(&bfs_head);
195 TAILQ_REMOVE(&bfs_head, entry, entries);
201 LOG("deleting from queue\n");
202 TAILQ_REMOVE(&bfs_head, entry, entries);
205 TAILQ_FOREACH(child, &(current->nodes_head), nodes) {
206 entry = smalloc(sizeof(struct bfs_entry));
208 TAILQ_INSERT_TAIL(&bfs_head, entry, entries);
216 * Returns true if the node is floating.
219 bool con_is_floating(Con *con) {
221 LOG("checking if con %p is floating\n", con);
222 return (con->floating >= FLOATING_AUTO_ON);
225 Con *con_by_window_id(xcb_window_t window) {
227 TAILQ_FOREACH(con, &all_cons, all_cons)
228 if (con->window != NULL && con->window->id == window)
233 Con *con_by_frame_id(xcb_window_t frame) {
235 TAILQ_FOREACH(con, &all_cons, all_cons)
236 if (con->frame == frame)
242 * Returns the first container which wants to swallow this window
246 Con *con_for_window(i3Window *window, Match **store_match) {
249 LOG("searching con for window %p\n", window);
250 LOG("class == %s\n", window->class_class);
252 TAILQ_FOREACH(con, &all_cons, all_cons)
253 TAILQ_FOREACH(match, &(con->swallow_head), matches) {
254 if (!match_matches_window(match, window))
256 if (store_match != NULL)
257 *store_match = match;
265 * Updates the percent attribute of the children of the given container. This
266 * function needs to be called when a window is added or removed from a
270 void con_fix_percent(Con *con, int action) {
273 TAILQ_FOREACH(child, &(con->nodes_head), nodes)
275 /* TODO: better document why this math works */
277 if (action == WINDOW_ADD)
278 fix = (1.0 - (1.0 / (children+1)));
280 fix = 1.0 / (1.0 - (1.0 / (children+1)));
282 TAILQ_FOREACH(child, &(con->nodes_head), nodes) {
283 if (child->percent <= 0.0)
285 child->percent *= fix;
289 void con_toggle_fullscreen(Con *con) {
290 Con *workspace, *fullscreen;
291 LOG("toggling fullscreen for %p / %s\n", con, con->name);
292 if (con->fullscreen_mode == CF_NONE) {
293 /* 1: check if there already is a fullscreen con */
294 workspace = con_get_workspace(con);
295 if ((fullscreen = con_get_fullscreen_con(workspace)) != NULL) {
296 LOG("Not entering fullscreen mode, container (%p/%s) "
297 "already is in fullscreen mode\n",
298 fullscreen, fullscreen->name);
302 /* 2: enable fullscreen */
303 con->fullscreen_mode = CF_OUTPUT;
305 /* 1: disable fullscreen */
306 con->fullscreen_mode = CF_NONE;
308 LOG("mode now: %d\n", con->fullscreen_mode);
310 /* update _NET_WM_STATE if this container has a window */
311 /* TODO: when a window is assigned to a container which is already
312 * fullscreened, this state needs to be pushed to the client, too */
313 if (con->window == NULL)
317 unsigned int num = 0;
319 if (con->fullscreen_mode != CF_NONE)
320 values[num++] = atoms[_NET_WM_STATE_FULLSCREEN];
322 xcb_change_property(conn, XCB_PROP_MODE_REPLACE, con->window->id,
323 atoms[_NET_WM_STATE], ATOM, 32, num, values);
327 * TODO: is there a better place for this function?
330 void con_move_to_workspace(Con *con, Con *workspace) {
331 /* 1: get the focused container of this workspace by going down as far as
333 Con *next = workspace;
335 while (!TAILQ_EMPTY(&(next->focus_head)))
336 next = TAILQ_FIRST(&(next->focus_head));
338 /* 2: we go up one level, but only when next is a normal container */
339 if (next->type != CT_WORKSPACE)
342 DLOG("Re-attaching container to %p / %s\n", next, next->name);
343 /* 3: re-attach the con to the parent of this focused container */
345 con_attach(con, next);