4 * i3 - an improved dynamic tiling window manager
6 * © 2009-2010 Michael Stapelberg and contributors
8 * See file LICENSE for license information.
10 * For more information on RandR, please see the X.org RandR specification at
11 * http://cgit.freedesktop.org/xorg/proto/randrproto/tree/randrproto.txt
12 * (take your time to read it completely, it answers all questions).
24 #include <xcb/randr.h>
34 #include "workspace.h"
40 /* While a clean namespace is usually a pretty good thing, we really need
41 * to use shorter names than the whole xcb_randr_* default names. */
42 typedef xcb_randr_get_crtc_info_reply_t crtc_info;
43 typedef xcb_randr_mode_info_t mode_info;
44 typedef xcb_randr_get_screen_resources_current_reply_t resources_reply;
46 /* Stores all outputs available in your current session. */
47 struct outputs_head outputs = TAILQ_HEAD_INITIALIZER(outputs);
49 static bool randr_disabled = false;
52 * Get a specific output by its internal X11 id. Used by randr_query_outputs
53 * to check if the output is new (only in the first scan) or if we are
57 static Output *get_output_by_id(xcb_randr_output_t id) {
59 TAILQ_FOREACH(output, &outputs, outputs)
67 * Returns the output with the given name if it is active (!) or NULL.
70 Output *get_output_by_name(const char *name) {
72 TAILQ_FOREACH(output, &outputs, outputs)
74 strcasecmp(output->name, name) == 0)
81 * Returns the first output which is active.
84 Output *get_first_output() {
87 TAILQ_FOREACH(output, &outputs, outputs)
95 * Returns the active (!) output which contains the coordinates x, y or NULL
96 * if there is no output which contains these coordinates.
99 Output *get_output_containing(int x, int y) {
101 TAILQ_FOREACH(output, &outputs, outputs) {
104 DLOG("comparing x=%d y=%d with x=%d and y=%d width %d height %d\n",
105 x, y, output->rect.x, output->rect.y, output->rect.width, output->rect.height);
106 if (x >= output->rect.x && x < (output->rect.x + output->rect.width) &&
107 y >= output->rect.y && y < (output->rect.y + output->rect.height))
115 * Gets the output which is the last one in the given direction, for example
116 * the output on the most bottom when direction == D_DOWN, the output most
117 * right when direction == D_RIGHT and so on.
119 * This function always returns a output.
122 Output *get_output_most(direction_t direction, Output *current) {
123 Output *output, *candidate = NULL;
125 TAILQ_FOREACH(output, &outputs, outputs) {
129 /* Repeated calls of WIN determine the winner of the comparison */
130 #define WIN(variable, condition) \
131 if (variable condition) { \
132 candidate = output; \
133 position = variable; \
137 if (((direction == D_UP) || (direction == D_DOWN)) &&
138 (current->rect.x != output->rect.x))
141 if (((direction == D_LEFT) || (direction == D_RIGHT)) &&
142 (current->rect.y != output->rect.y))
147 WIN(output->rect.y, <= position);
149 WIN(output->rect.y, >= position);
151 WIN(output->rect.x, <= position);
153 WIN(output->rect.x, >= position);
157 assert(candidate != NULL);
163 * Initializes the specified output, assigning the specified workspace to it.
166 void initialize_output(xcb_connection_t *conn, Output *output, Workspace *workspace) {
167 i3Font *font = load_font(conn, config.font);
169 workspace->output = output;
170 output->current_workspace = workspace;
172 /* Copy rect for the workspace */
173 memcpy(&(workspace->rect), &(output->rect), sizeof(Rect));
175 /* Map clients on the workspace, if any */
176 workspace_map_clients(conn, workspace);
178 /* Create a bar window on each output */
179 if (!config.disable_workspace_bar) {
180 Rect bar_rect = {output->rect.x,
181 output->rect.y + output->rect.height - (font->height + 6),
182 output->rect.x + output->rect.width,
184 uint32_t mask = XCB_CW_OVERRIDE_REDIRECT | XCB_CW_EVENT_MASK;
185 uint32_t values[] = {1, XCB_EVENT_MASK_EXPOSURE | XCB_EVENT_MASK_BUTTON_PRESS};
186 output->bar = create_window(conn, bar_rect, XCB_WINDOW_CLASS_INPUT_OUTPUT, XCB_CURSOR_LEFT_PTR, true, mask, values);
187 output->bargc = xcb_generate_id(conn);
188 xcb_create_gc(conn, output->bargc, output->bar, 0, 0);
191 SLIST_INIT(&(output->dock_clients));
193 ipc_send_event("workspace", I3_IPC_EVENT_WORKSPACE, "{\"change\":\"init\"}");
194 DLOG("initialized output at (%d, %d) with %d x %d\n",
195 output->rect.x, output->rect.y, output->rect.width, output->rect.height);
197 DLOG("assigning configured workspaces to this output...\n");
199 TAILQ_FOREACH(ws, workspaces, workspaces) {
202 if (ws->preferred_output == NULL ||
203 get_output_by_name(ws->preferred_output) != output)
206 DLOG("assigning ws %d\n", ws->num + 1);
207 workspace_assign_to(ws, output, true);
212 * Disables RandR support by creating exactly one output with the size of the
216 void disable_randr(xcb_connection_t *conn) {
217 xcb_screen_t *root_screen = xcb_setup_roots_iterator(xcb_get_setup(conn)).data;
219 DLOG("RandR extension unusable, disabling.\n");
221 Output *s = scalloc(sizeof(Output));
226 s->rect.width = root_screen->width_in_pixels;
227 s->rect.height = root_screen->height_in_pixels;
230 TAILQ_INSERT_TAIL(&outputs, s, outputs);
232 randr_disabled = true;
236 * This function needs to be called when changing the mode of an output when
237 * it already has some workspaces (or a bar window) assigned.
239 * It reconfigures the bar window for the new mode, copies the new rect into
240 * each workspace on this output and forces all windows on the affected
241 * workspaces to be reconfigured.
243 * It is necessary to call render_layout() afterwards.
246 static void output_change_mode(xcb_connection_t *conn, Output *output) {
247 i3Font *font = load_font(conn, config.font);
251 DLOG("Output mode changed, reconfiguring bar, updating workspaces\n");
252 Rect bar_rect = {output->rect.x,
253 output->rect.y + output->rect.height - (font->height + 6),
254 output->rect.x + output->rect.width,
257 xcb_set_window_rect(conn, output->bar, bar_rect);
259 /* go through all workspaces and set force_reconfigure */
260 TAILQ_FOREACH(ws, workspaces, workspaces) {
261 if (ws->output != output)
264 SLIST_FOREACH(client, &(ws->focus_stack), focus_clients) {
265 client->force_reconfigure = true;
266 if (!client_is_floating(client))
268 /* For floating clients we need to translate the
269 * coordinates (old workspace to new workspace) */
270 DLOG("old: (%x, %x)\n", client->rect.x, client->rect.y);
271 client->rect.x -= ws->rect.x;
272 client->rect.y -= ws->rect.y;
273 client->rect.x += ws->output->rect.x;
274 client->rect.y += ws->output->rect.y;
275 DLOG("new: (%x, %x)\n", client->rect.x, client->rect.y);
278 /* Update dimensions from output */
279 memcpy(&(ws->rect), &(ws->output->rect), sizeof(Rect));
281 /* Update the dimensions of a fullscreen client, if any */
282 if (ws->fullscreen_client != NULL) {
283 DLOG("Updating fullscreen client size\n");
284 client = ws->fullscreen_client;
286 xcb_set_window_rect(conn, client->frame, r);
290 xcb_set_window_rect(conn, client->child, r);
296 * Gets called by randr_query_outputs() for each output. The function adds new
297 * outputs to the list of outputs, checks if the mode of existing outputs has
298 * been changed or if an existing output has been disabled. It will then change
299 * either the "changed" or the "to_be_deleted" flag of the output, if
303 static void handle_output(xcb_connection_t *conn, xcb_randr_output_t id,
304 xcb_randr_get_output_info_reply_t *output,
305 xcb_timestamp_t cts, resources_reply *res) {
306 /* each CRT controller has a position in which we are interested in */
309 Output *new = get_output_by_id(id);
310 bool existing = (new != NULL);
312 new = scalloc(sizeof(Output));
315 asprintf(&new->name, "%.*s",
316 xcb_randr_get_output_info_name_length(output),
317 xcb_randr_get_output_info_name(output));
319 DLOG("found output with name %s\n", new->name);
321 /* Even if no CRTC is used at the moment, we store the output so that
322 * we do not need to change the list ever again (we only update the
324 if (output->crtc == XCB_NONE) {
326 TAILQ_INSERT_TAIL(&outputs, new, outputs);
327 else if (new->active)
328 new->to_be_disabled = true;
332 xcb_randr_get_crtc_info_cookie_t icookie;
333 icookie = xcb_randr_get_crtc_info(conn, output->crtc, cts);
334 if ((crtc = xcb_randr_get_crtc_info_reply(conn, icookie, NULL)) == NULL) {
335 DLOG("Skipping output %s: could not get CRTC (%p)\n",
341 bool updated = update_if_necessary(&(new->rect.x), crtc->x) |
342 update_if_necessary(&(new->rect.y), crtc->y) |
343 update_if_necessary(&(new->rect.width), crtc->width) |
344 update_if_necessary(&(new->rect.height), crtc->height);
346 new->active = (new->rect.width != 0 && new->rect.height != 0);
348 DLOG("width/height 0/0, disabling output\n");
352 DLOG("mode: %dx%d+%d+%d\n", new->rect.width, new->rect.height,
353 new->rect.x, new->rect.y);
355 /* If we don’t need to change an existing output or if the output
356 * does not exist in the first place, the case is simple: we either
357 * need to insert the new output or we are done. */
358 if (!updated || !existing) {
360 TAILQ_INSERT_TAIL(&outputs, new, outputs);
367 static void init_workspaces() {
371 /* Just go through each active output and associate one workspace */
372 TAILQ_FOREACH(output, &outputs, outputs) {
373 if (!output->active || output->current_workspace != NULL)
375 ws = get_first_workspace_for_output(output);
376 initialize_output(global_conn, output, ws);
379 /* render_layout flushes */
380 render_layout(global_conn);
384 * (Re-)queries the outputs via RandR and stores them in the list of outputs.
387 void randr_query_outputs(xcb_connection_t *conn) {
389 Output *output, *other, *first;
390 xcb_randr_get_screen_resources_current_cookie_t rcookie;
391 resources_reply *res;
392 /* timestamp of the configuration so that we get consistent replies to all
393 * requests (if the configuration changes between our different calls) */
396 /* an output is VGA-1, LVDS-1, etc. (usually physical video outputs) */
397 xcb_randr_output_t *randr_outputs;
402 /* Get screen resources (crtcs, outputs, modes) */
403 rcookie = xcb_randr_get_screen_resources_current(conn, root);
404 if ((res = xcb_randr_get_screen_resources_current_reply(conn, rcookie, NULL)) == NULL) {
409 cts = res->config_timestamp;
411 int len = xcb_randr_get_screen_resources_current_outputs_length(res);
412 randr_outputs = xcb_randr_get_screen_resources_current_outputs(res);
414 /* Request information for each output */
415 xcb_randr_get_output_info_cookie_t ocookie[len];
416 for (int i = 0; i < len; i++)
417 ocookie[i] = xcb_randr_get_output_info(conn, randr_outputs[i], cts);
419 /* Loop through all outputs available for this X11 screen */
420 for (int i = 0; i < len; i++) {
421 xcb_randr_get_output_info_reply_t *output;
423 if ((output = xcb_randr_get_output_info_reply(conn, ocookie[i], NULL)) == NULL)
426 handle_output(conn, randr_outputs[i], output, cts, res);
431 /* Check for clones, disable the clones and reduce the mode to the
432 * lowest common mode */
433 TAILQ_FOREACH(output, &outputs, outputs) {
434 if (!output->active || output->to_be_disabled)
436 DLOG("output %p, position (%d, %d), checking for clones\n",
437 output, output->rect.x, output->rect.y);
440 other != TAILQ_END(&outputs);
441 other = TAILQ_NEXT(other, outputs)) {
442 if (other == output || !other->active || other->to_be_disabled)
445 if (other->rect.x != output->rect.x ||
446 other->rect.y != output->rect.y)
449 DLOG("output %p has the same position, his mode = %d x %d\n",
450 other, other->rect.width, other->rect.height);
451 uint32_t width = min(other->rect.width, output->rect.width);
452 uint32_t height = min(other->rect.height, output->rect.height);
454 if (update_if_necessary(&(output->rect.width), width) |
455 update_if_necessary(&(output->rect.height), height))
456 output->changed = true;
458 update_if_necessary(&(other->rect.width), width);
459 update_if_necessary(&(other->rect.height), height);
461 DLOG("disabling output %p (%s)\n", other, other->name);
462 other->to_be_disabled = true;
464 DLOG("new output mode %d x %d, other mode %d x %d\n",
465 output->rect.width, output->rect.height,
466 other->rect.width, other->rect.height);
470 /* Handle outputs which have a new mode or are disabled now (either
471 * because the user disabled them or because they are clones) */
472 TAILQ_FOREACH(output, &outputs, outputs) {
473 if (output->to_be_disabled) {
474 output->active = false;
475 DLOG("Output %s disabled, re-assigning workspaces/docks\n", output->name);
477 if ((first = get_first_output()) == NULL)
478 die("No usable outputs available\n");
480 bool needs_init = (first->current_workspace == NULL);
482 TAILQ_FOREACH(ws, workspaces, workspaces) {
483 if (ws->output != output)
486 workspace_assign_to(ws, first, true);
489 initialize_output(conn, first, ws);
494 while (!SLIST_EMPTY(&(output->dock_clients))) {
495 dock = SLIST_FIRST(&(output->dock_clients));
496 SLIST_REMOVE_HEAD(&(output->dock_clients), dock_clients);
497 SLIST_INSERT_HEAD(&(first->dock_clients), dock, dock_clients);
499 output->current_workspace = NULL;
500 output->to_be_disabled = false;
501 } else if (output->changed) {
502 output_change_mode(conn, output);
503 output->changed = false;
507 if (TAILQ_EMPTY(&outputs)) {
508 ELOG("No outputs found via RandR, disabling\n");
512 ewmh_update_workarea();
518 * We have just established a connection to the X server and need the initial
519 * XRandR information to setup workspaces for each screen.
522 void initialize_randr(xcb_connection_t *conn, int *event_base) {
523 const xcb_query_extension_reply_t *extreply;
525 extreply = xcb_get_extension_data(conn, &xcb_randr_id);
526 if (!extreply->present)
528 else randr_query_outputs(conn);
530 if (event_base != NULL)
531 *event_base = extreply->first_event;
533 xcb_randr_select_input(conn, root,
534 XCB_RANDR_NOTIFY_MASK_SCREEN_CHANGE |
535 XCB_RANDR_NOTIFY_MASK_OUTPUT_CHANGE |
536 XCB_RANDR_NOTIFY_MASK_CRTC_CHANGE |
537 XCB_RANDR_NOTIFY_MASK_OUTPUT_PROPERTY);