X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=include%2Frandr.h;h=bfbfd5a90bcbabcec5b261ad39e8c51d6686cb0f;hb=d968d39b27daa98848a28756eed678ec6b95cae9;hp=50e19938eb14c4a371bc1fcbf45b3a08928543ff;hpb=818e02ef3545b000e104b79cf52610ac0f1765cd;p=i3%2Fi3

diff --git a/include/randr.h b/include/randr.h
index 50e19938..bfbfd5a9 100644
--- a/include/randr.h
+++ b/include/randr.h
@@ -1,62 +1,137 @@
 /*
- * vim:ts=8:expandtab
+ * vim:ts=4:sw=4:expandtab
  *
  * i3 - an improved dynamic tiling window manager
+ * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
  *
- * © 2009-2010 Michael Stapelberg and contributors
- *
- * See file LICENSE for license information.
+ * For more information on RandR, please see the X.org RandR specification at
+ * https://cgit.freedesktop.org/xorg/proto/randrproto/tree/randrproto.txt
+ * (take your time to read it completely, it answers all questions).
  *
  */
+#pragma once
+
+#include <config.h>
+
 #include "data.h"
 #include <xcb/randr.h>
 
-#ifndef _RANDR_H
-#define _RANDR_H
-
 TAILQ_HEAD(outputs_head, xoutput);
 extern struct outputs_head outputs;
 
+typedef enum {
+    CLOSEST_OUTPUT = 0,
+    FARTHEST_OUTPUT = 1
+} output_close_far_t;
+
 /**
- * Returns true if both screen objects describe the same screen (checks their
- * size and position).
+ * We have just established a connection to the X server and need the initial
+ * XRandR information to setup workspaces for each screen.
  *
  */
-bool screens_are_equal(Output *screen1, Output *screen2);
+void randr_init(int *event_base, const bool disable_randr15);
 
 /**
- * We have just established a connection to the X server and need the initial
- * XRandR information to setup workspaces for each screen.
+ * Initializes a CT_OUTPUT Con (searches existing ones from inplace restart
+ * before) to use for the given Output.
+ *
+ */
+void output_init_con(Output *output);
+
+/**
+ * Initializes at least one workspace for this output, trying the following
+ * steps until there is at least one workspace:
+ *
+ * • Move existing workspaces, which are assigned to be on the given output, to
+ *   the output.
+ * • Create the first assigned workspace for this output.
+ * • Create the first unused workspace.
  *
  */
-void initialize_randr(xcb_connection_t *conn, int *event_base);
+void init_ws_for_output(Output *output, Con *content);
+
+/**
+ * Initializes the specified output, assigning the specified workspace to it.
+ *
+ */
+//void initialize_output(xcb_connection_t *conn, Output *output, Workspace *workspace);
 
 /**
  * (Re-)queries the outputs via RandR and stores them in the list of outputs.
  *
  */
-void randr_query_screens(xcb_connection_t *conn);
+void randr_query_outputs(void);
+
+/**
+ * Disables the output and moves its content.
+ *
+ */
+void randr_disable_output(Output *output);
 
 /**
  * Returns the first output which is active.
  *
  */
-Output *get_first_output();
+Output *get_first_output(void);
 
 /**
- * Looks in virtual_screens for the i3Screen which contains coordinates x, y
+ * Returns the output with the given name or NULL.
+ * If require_active is true, only active outputs are considered.
  *
  */
-Output *get_screen_containing(int x, int y);
+Output *get_output_by_name(const char *name, const bool require_active);
 
 /**
- * Gets the screen which is the last one in the given direction, for example
- * the screen on the most bottom when direction == D_DOWN, the screen most
- * right when direction == D_RIGHT and so on.
+ * Returns the active (!) output which contains the coordinates x, y or NULL
+ * if there is no output which contains these coordinates.
  *
- * This function always returns a screen.
+ */
+Output *get_output_containing(unsigned int x, unsigned int y);
+
+/**
+ * Returns the active output which spans exactly the area specified by
+ * rect or NULL if there is no output like this.
+ *
+ */
+Output *get_output_with_dimensions(Rect rect);
+
+/*
+ * In contained_by_output, we check if any active output contains part of the container.
+ * We do this by checking if the output rect is intersected by the Rect.
+ * This is the 2-dimensional counterpart of get_output_containing.
+ * Since we don't actually need the outputs intersected by the given Rect (There could
+ * be many), we just return true or false for convenience.
+ *
+ */
+bool contained_by_output(Rect rect);
+
+/**
+ * Gets the output which is the next one in the given direction.
+ *
+ * If close_far == CLOSEST_OUTPUT, then the output next to the current one will
+ * selected.  If close_far == FARTHEST_OUTPUT, the output which is the last one
+ * in the given direction will be selected.
+ *
+ * NULL will be returned when no active outputs are present in the direction
+ * specified (note that ‘current’ counts as such an output).
  *
  */
-Output *get_screen_most(direction_t direction, Output *current);
+Output *get_output_next(direction_t direction, Output *current, output_close_far_t close_far);
 
-#endif
+/**
+ * Like get_output_next with close_far == CLOSEST_OUTPUT, but wraps.
+ *
+ * For example if get_output_next(D_DOWN, x, FARTHEST_OUTPUT) = NULL, then
+ * get_output_next_wrap(D_DOWN, x) will return the topmost output.
+ *
+ * This function always returns a output: if no active outputs can be found,
+ * current itself is returned.
+ *
+ */
+Output *get_output_next_wrap(direction_t direction, Output *current);
+
+/*
+ * Creates an output covering the root window.
+ *
+ */
+Output *create_root_output(xcb_connection_t *conn);