2 * vim:ts=4:sw=4:expandtab
4 * i3 - an improved dynamic tiling window manager
5 * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
7 * For more information on RandR, please see the X.org RandR specification at
8 * https://cgit.freedesktop.org/xorg/proto/randrproto/tree/randrproto.txt
9 * (take your time to read it completely, it answers all questions).
17 #include <xcb/randr.h>
19 TAILQ_HEAD(outputs_head, xoutput);
20 extern struct outputs_head outputs;
28 * We have just established a connection to the X server and need the initial
29 * XRandR information to setup workspaces for each screen.
32 void randr_init(int *event_base, const bool disable_randr15);
35 * Initializes a CT_OUTPUT Con (searches existing ones from inplace restart
36 * before) to use for the given Output.
39 void output_init_con(Output *output);
42 * Initializes at least one workspace for this output, trying the following
43 * steps until there is at least one workspace:
45 * • Move existing workspaces, which are assigned to be on the given output, to
47 * • Create the first assigned workspace for this output.
48 * • Create the first unused workspace.
51 void init_ws_for_output(Output *output, Con *content);
54 * Initializes the specified output, assigning the specified workspace to it.
57 //void initialize_output(xcb_connection_t *conn, Output *output, Workspace *workspace);
60 * (Re-)queries the outputs via RandR and stores them in the list of outputs.
63 void randr_query_outputs(void);
66 * Disables the output and moves its content.
69 void randr_disable_output(Output *output);
72 * Returns the first output which is active.
75 Output *get_first_output(void);
78 * Returns the output with the given name or NULL.
79 * If require_active is true, only active outputs are considered.
82 Output *get_output_by_name(const char *name, const bool require_active);
85 * Returns the active (!) output which contains the coordinates x, y or NULL
86 * if there is no output which contains these coordinates.
89 Output *get_output_containing(unsigned int x, unsigned int y);
92 * Returns the active output which spans exactly the area specified by
93 * rect or NULL if there is no output like this.
96 Output *get_output_with_dimensions(Rect rect);
99 * In contained_by_output, we check if any active output contains part of the container.
100 * We do this by checking if the output rect is intersected by the Rect.
101 * This is the 2-dimensional counterpart of get_output_containing.
102 * Since we don't actually need the outputs intersected by the given Rect (There could
103 * be many), we just return true or false for convenience.
106 bool contained_by_output(Rect rect);
109 * Gets the output which is the next one in the given direction.
111 * If close_far == CLOSEST_OUTPUT, then the output next to the current one will
112 * selected. If close_far == FARTHEST_OUTPUT, the output which is the last one
113 * in the given direction will be selected.
115 * NULL will be returned when no active outputs are present in the direction
116 * specified (note that ‘current’ counts as such an output).
119 Output *get_output_next(direction_t direction, Output *current, output_close_far_t close_far);
122 * Like get_output_next with close_far == CLOSEST_OUTPUT, but wraps.
124 * For example if get_output_next(D_DOWN, x, FARTHEST_OUTPUT) = NULL, then
125 * get_output_next_wrap(D_DOWN, x) will return the topmost output.
127 * This function always returns a output: if no active outputs can be found,
128 * current itself is returned.
131 Output *get_output_next_wrap(direction_t direction, Output *current);
134 * Creates an output covering the root window.
137 Output *create_root_output(xcb_connection_t *conn);