i3
output.c
Go to the documentation of this file.
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 * output.c: Output (monitor) related functions.
8 *
9 */
10#include "all.h"
11
12/*
13 * Returns the content container below the given output container.
14 *
15 */
17 Con *child;
18
19 TAILQ_FOREACH (child, &(output->nodes_head), nodes) {
20 if (child->type == CT_CON) {
21 return child;
22 }
23 }
24
25 return NULL;
26}
27
28/*
29 * Returns an 'output' corresponding to one of left/right/down/up or a specific
30 * output name.
31 *
32 */
33Output *get_output_from_string(Output *current_output, const char *output_str) {
34 if (strcasecmp(output_str, "current") == 0) {
36 } else if (strcasecmp(output_str, "left") == 0) {
37 return get_output_next_wrap(D_LEFT, current_output);
38 } else if (strcasecmp(output_str, "right") == 0) {
39 return get_output_next_wrap(D_RIGHT, current_output);
40 } else if (strcasecmp(output_str, "up") == 0) {
41 return get_output_next_wrap(D_UP, current_output);
42 } else if (strcasecmp(output_str, "down") == 0) {
43 return get_output_next_wrap(D_DOWN, current_output);
44 }
45
46 return get_output_by_name(output_str, true);
47}
48
49/*
50 * Retrieves the primary name of an output.
51 *
52 */
54 return SLIST_FIRST(&output->names_head)->name;
55}
56
58 Con *output_con = con_get_output(con);
59 Output *output = get_output_by_name(output_con->name, true);
60 assert(output != NULL);
61
62 return output;
63}
64
65/*
66 * Iterates over all outputs and pushes sticky windows to the currently visible
67 * workspace on that output.
68 *
69 * old_focus is used to determine if a sticky window is going to be focused.
70 * old_focus might be different than the currently focused container because the
71 * caller might need to temporarily change the focus and then call
72 * output_push_sticky_windows. For example, workspace_show needs to set focus to
73 * one of its descendants first, then call output_push_sticky_windows that
74 * should focus a sticky window if it was the focused in the previous workspace.
75 *
76 */
78 Con *output;
79 TAILQ_FOREACH (output, &(croot->focus_head), focused) {
80 Con *workspace, *visible_ws = NULL;
81 GREP_FIRST(visible_ws, output_get_content(output), workspace_is_visible(child));
82
83 /* We use this loop instead of TAILQ_FOREACH to avoid problems if the
84 * sticky window was the last window on that workspace as moving it in
85 * this case will close the workspace. */
86 for (workspace = TAILQ_FIRST(&(output_get_content(output)->focus_head));
87 workspace != TAILQ_END(&(output_get_content(output)->focus_head));) {
88 Con *current_ws = workspace;
89 workspace = TAILQ_NEXT(workspace, focused);
90
91 /* Since moving the windows actually removes them from the list of
92 * floating windows on this workspace, here too we need to use
93 * another loop than TAILQ_FOREACH. */
94 Con *child;
95 for (child = TAILQ_FIRST(&(current_ws->focus_head));
96 child != TAILQ_END(&(current_ws->focus_head));) {
97 Con *current = child;
98 child = TAILQ_NEXT(child, focused);
99 if (current->type != CT_FLOATING_CON || !con_is_sticky(current)) {
100 continue;
101 }
102
103 bool ignore_focus = (old_focus == NULL) || (current != old_focus->parent);
104 con_move_to_workspace(current, visible_ws, true, false, ignore_focus);
105 if (!ignore_focus) {
106 Con *current_ws = con_get_workspace(focused);
108 /* Pushing sticky windows shouldn't change the focused workspace. */
110 }
111 }
112 }
113 }
114}
bool workspace_is_visible(Con *ws)
Returns true if the workspace is currently visible.
Definition workspace.c:314
struct Con * focused
Definition tree.c:13
struct Con * croot
Definition tree.c:12
Output * get_output_by_name(const char *name, const bool require_active)
Returns the output with the given name or NULL.
Definition randr.c:50
Output * get_output_next_wrap(direction_t direction, Output *current)
Like get_output_next with close_far == CLOSEST_OUTPUT, but wraps.
Definition randr.c:215
Output * get_output_from_string(Output *current_output, const char *output_str)
Returns an 'output' corresponding to one of left/right/down/up or a specific output name.
Definition output.c:33
void output_push_sticky_windows(Con *old_focus)
Iterates over all outputs and pushes sticky windows to the currently visible workspace on that output...
Definition output.c:77
char * output_primary_name(Output *output)
Retrieves the primary name of an output.
Definition output.c:53
Output * get_output_for_con(Con *con)
Returns the output for the given con.
Definition output.c:57
Con * output_get_content(Con *output)
Returns the output container below the given output container.
Definition output.c:16
void con_move_to_workspace(Con *con, Con *workspace, bool fix_coordinates, bool dont_warp, bool ignore_focus)
Moves the given container to the currently focused container on the given workspace.
Definition con.c:1466
Con * con_get_workspace(Con *con)
Gets the workspace container this node is on.
Definition con.c:477
void con_activate(Con *con)
Sets input focus to the given container and raises it to the top.
Definition con.c:287
Con * con_get_output(Con *con)
Gets the output container (first container with CT_OUTPUT in hierarchy) this node is on.
Definition con.c:463
Con * con_descend_focused(Con *con)
Returns the focused con inside this client, descending the tree as far as possible.
Definition con.c:1590
bool con_is_sticky(Con *con)
Returns whether the container or any of its children is sticky.
Definition con.c:426
#define GREP_FIRST(dest, head, condition)
Definition util.h:38
#define TAILQ_FOREACH(var, head, field)
Definition queue.h:347
#define TAILQ_END(head)
Definition queue.h:337
#define TAILQ_FIRST(head)
Definition queue.h:336
#define SLIST_FIRST(head)
Definition queue.h:109
#define TAILQ_NEXT(elm, field)
Definition queue.h:338
@ D_RIGHT
Definition data.h:57
@ D_LEFT
Definition data.h:56
@ D_UP
Definition data.h:58
@ D_DOWN
Definition data.h:59
An Output is a physical output on your graphics driver.
Definition data.h:395
A 'Con' represents everything from the X11 root window down to a single X11 window.
Definition data.h:647
struct Con * parent
Definition data.h:682
enum Con::@18 type
char * name
Definition data.h:696