X-Git-Url: https://git.sur5r.net/?p=i3%2Fi3;a=blobdiff_plain;f=include%2Frandr.h;h=ec533a28045f92f4719c4f810efd8b56d0fa90f2;hp=55068316607e5e660b4b9e209280608f6a00ca5c;hb=HEAD;hpb=1994eea5da1c83f35e5793ef6ca72a91d09eb824 diff --git a/include/randr.h b/include/randr.h index 55068316..ec533a28 100644 --- a/include/randr.h +++ b/include/randr.h @@ -5,7 +5,7 @@ * © 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). * */ @@ -29,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 @@ -75,10 +75,11 @@ void randr_disable_output(Output *output); 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 @@ -87,6 +88,14 @@ Output *get_output_by_name(const char *name); */ Output *get_output_containing(unsigned int x, unsigned int y); +/** + * 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. @@ -94,15 +103,14 @@ Output *get_output_containing(unsigned int x, unsigned int y); */ Output *get_output_with_dimensions(Rect rect); -/* - * In contained_by_output, we check if any active output contains part of the container. +/** + * 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. @@ -129,7 +137,7 @@ 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. * */