i3
output.c
Go to the documentation of this file.
1/*
2 * vim:ts=4:sw=4:expandtab
3 *
4 * i3 - an improved 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
57/*
58 * Retrieves the output for a given container. Never returns NULL.
59 * There is an assertion that _will_ fail if the container is inside an
60 * internal workspace. Use con_is_internal() if needed before calling this
61 * function.
62 */
64 Con *output_con = con_get_output(con);
65 Output *output = get_output_by_name(output_con->name, true);
66 assert(output != NULL);
67
68 return output;
69}
70
71/*
72 * Iterates over all outputs and pushes sticky windows to the currently visible
73 * workspace on that output.
74 *
75 * old_focus is used to determine if a sticky window is going to be focused.
76 * old_focus might be different than the currently focused container because the
77 * caller might need to temporarily change the focus and then call
78 * output_push_sticky_windows. For example, workspace_show needs to set focus to
79 * one of its descendants first, then call output_push_sticky_windows that
80 * should focus a sticky window if it was the focused in the previous workspace.
81 *
82 */
84 Con *output;
85 TAILQ_FOREACH (output, &(croot->focus_head), focused) {
86 Con *workspace, *visible_ws = NULL;
87 GREP_FIRST(visible_ws, output_get_content(output), workspace_is_visible(child));
88
89 /* We use this loop instead of TAILQ_FOREACH to avoid problems if the
90 * sticky window was the last window on that workspace as moving it in
91 * this case will close the workspace. */
92 for (workspace = TAILQ_FIRST(&(output_get_content(output)->focus_head));
93 workspace != TAILQ_END(&(output_get_content(output)->focus_head));) {
94 Con *current_ws = workspace;
95 workspace = TAILQ_NEXT(workspace, focused);
96
97 /* Since moving the windows actually removes them from the list of
98 * floating windows on this workspace, here too we need to use
99 * another loop than TAILQ_FOREACH. */
100 Con *child;
101 for (child = TAILQ_FIRST(&(current_ws->focus_head));
102 child != TAILQ_END(&(current_ws->focus_head));) {
103 Con *current = child;
104 child = TAILQ_NEXT(child, focused);
105 if (current->type != CT_FLOATING_CON || !con_is_sticky(current)) {
106 continue;
107 }
108
109 bool ignore_focus = (old_focus == NULL) || (current != old_focus->parent);
110 con_move_to_workspace(current, visible_ws, true, false, ignore_focus);
111 if (!ignore_focus) {
112 Con *current_ws = con_get_workspace(focused);
114 /* Pushing sticky windows shouldn't change the focused workspace. */
116 }
117 }
118 }
119 }
120}
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:1574
Con * con_get_workspace(Con *con)
Gets the workspace container this node is on.
Definition con.c:547
void con_activate(Con *con)
Sets input focus to the given container and raises it to the top.
Definition con.c:292
Con * con_get_output(Con *con)
Gets the output container (first container with CT_OUTPUT in hierarchy) this node is on.
Definition con.c:532
Con * con_descend_focused(Con *con)
Returns the focused con inside this client, descending the tree as far as possible.
Definition con.c:1698
bool con_is_sticky(Con *con)
Returns whether the container or any of its children is sticky.
Definition con.c:492
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:83
char * output_primary_name(Output *output)
Retrieves the primary name of an output.
Definition output.c:53
Output * get_output_for_con(Con *con)
Retrieves the output for a given container.
Definition output.c:63
Con * output_get_content(Con *output)
Returns the output container below the given output container.
Definition output.c:16
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:221
struct Con * focused
Definition tree.c:13
struct Con * croot
Definition tree.c:12
bool workspace_is_visible(Con *ws)
Returns true if the workspace is currently visible.
Definition workspace.c:320
@ D_RIGHT
Definition data.h:57
@ D_LEFT
Definition data.h:56
@ D_UP
Definition data.h:58
@ D_DOWN
Definition data.h:59
#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
#define GREP_FIRST(dest, head, condition)
Definition util.h:38
An Output is a physical output on your graphics driver.
Definition data.h:391
A 'Con' represents everything from the X11 root window down to a single X11 window.
Definition data.h:643
struct Con * parent
Definition data.h:678
enum Con::@18 type
char * name
Definition data.h:692