randr.h

Go to the documentation of this file.

/*
 * vim:ts=4:sw=4:expandtab
 *
 * i3 - an improved dynamic tiling window manager
 * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
 *
 * 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>

TAILQ_HEAD(outputs_head, xoutput);
extern struct outputs_head outputs;

typedef enum {
    CLOSEST_OUTPUT = 0,
    FARTHEST_OUTPUT = 1
} output_close_far_t;

void randr_init(int *event_base, const bool disable_randr15);

void output_init_con(Output *output);

void init_ws_for_output(Output *output, Con *content);

//void initialize_output(xcb_connection_t *conn, Output *output, Workspace *workspace);

void randr_query_outputs(void);

void randr_disable_output(Output *output);

Output *get_first_output(void);

Output *get_output_by_name(const char *name, const bool require_active);

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.
 * 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);

Output *get_output_next(direction_t direction, Output *current, output_close_far_t close_far);

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);