X-Git-Url: https://git.sur5r.net/?p=i3%2Fi3;a=blobdiff_plain;f=include%2Frandr.h;h=ec533a28045f92f4719c4f810efd8b56d0fa90f2;hp=2c379f6fb58bab5d477195de81d2e612abe47add;hb=HEAD;hpb=f3d898be4baac73a8c8f3dca4115a67111e677bd diff --git a/include/randr.h b/include/randr.h index 2c379f6f..ec533a28 100644 --- a/include/randr.h +++ b/include/randr.h @@ -5,12 +5,14 @@ * © 2009 Michael Stapelberg and contributors (see also: LICENSE) * * For more information on RandR, please see the X.org RandR specification at - * http://cgit.freedesktop.org/xorg/proto/randrproto/tree/randrproto.txt + * https://cgit.freedesktop.org/xorg/proto/randrproto/tree/randrproto.txt * (take your time to read it completely, it answers all questions). * */ #pragma once +#include + #include "data.h" #include @@ -27,7 +29,7 @@ typedef enum { * XRandR information to setup workspaces for each screen. * */ -void randr_init(int *event_base); +void randr_init(int *event_base, const bool disable_randr15); /** * Initializes a CT_OUTPUT Con (searches existing ones from inplace restart @@ -60,6 +62,12 @@ void init_ws_for_output(Output *output, Con *content); */ 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. * @@ -67,10 +75,11 @@ void randr_query_outputs(void); Output *get_first_output(void); /** - * Returns the output with the given name if it is active (!) or NULL. + * Returns the output with the given name or NULL. + * If require_active is true, only active outputs are considered. * */ -Output *get_output_by_name(const char *name); +Output *get_output_by_name(const char *name, const bool require_active); /** * Returns the active (!) output which contains the coordinates x, y or NULL @@ -79,15 +88,29 @@ Output *get_output_by_name(const char *name); */ Output *get_output_containing(unsigned int x, unsigned int y); -/* - * In contained_by_output, we check if any active output contains part of the container. +/** + * Returns the active output which contains the midpoint of the given rect. If + * such an output doesn't exist, returns the output which contains most of the + * rectangle or NULL if there is no output which intersects with it. + * + */ +Output *get_output_from_rect(Rect rect); + +/** + * 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 output_containing_rect, 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. + * Returns the output with the maximum intersecting area. * */ -bool contained_by_output(Rect rect); +Output *output_containing_rect(Rect rect); /** * Gets the output which is the next one in the given direction. @@ -114,8 +137,8 @@ Output *get_output_next(direction_t direction, Output *current, output_close_far */ Output *get_output_next_wrap(direction_t direction, Output *current); -/* +/** * Creates an output covering the root window. * */ -void create_root_output(xcb_connection_t *conn); +Output *create_root_output(xcb_connection_t *conn);