149 lines
4.6 KiB
C
149 lines
4.6 KiB
C
/*
|
|
* This an unstable interface of wlroots. No guarantees are made regarding the
|
|
* future consistency of this API.
|
|
*/
|
|
#ifndef WLR_USE_UNSTABLE
|
|
#error "Add -DWLR_USE_UNSTABLE to enable unstable wlroots features"
|
|
#endif
|
|
|
|
#ifndef WLR_TYPES_WLR_OUTPUT_LAYOUT_H
|
|
#define WLR_TYPES_WLR_OUTPUT_LAYOUT_H
|
|
|
|
#include <stdbool.h>
|
|
#include <wayland-util.h>
|
|
#include <wlr/types/wlr_output.h>
|
|
#include <wlr/util/addon.h>
|
|
|
|
struct wlr_box;
|
|
|
|
/**
|
|
* Helper to arrange outputs in a 2D coordinate space. The output effective
|
|
* resolution is used, see wlr_output_effective_resolution().
|
|
*
|
|
* Outputs added to the output layout are automatically exposed to clients (see
|
|
* wlr_output_create_global()). They are no longer exposed when removed from the
|
|
* layout.
|
|
*/
|
|
struct wlr_output_layout {
|
|
struct wl_list outputs;
|
|
|
|
struct {
|
|
struct wl_signal add;
|
|
struct wl_signal change;
|
|
struct wl_signal destroy;
|
|
} events;
|
|
|
|
void *data;
|
|
};
|
|
|
|
struct wlr_output_layout_output_state;
|
|
|
|
struct wlr_output_layout_output {
|
|
struct wlr_output *output;
|
|
int x, y;
|
|
struct wl_list link;
|
|
struct wlr_output_layout_output_state *state;
|
|
|
|
struct wlr_addon addon;
|
|
struct {
|
|
struct wl_signal destroy;
|
|
} events;
|
|
};
|
|
|
|
struct wlr_output_layout *wlr_output_layout_create(void);
|
|
|
|
void wlr_output_layout_destroy(struct wlr_output_layout *layout);
|
|
|
|
/**
|
|
* Get the output layout for the specified output. Returns NULL if no output
|
|
* matches.
|
|
*/
|
|
struct wlr_output_layout_output *wlr_output_layout_get(
|
|
struct wlr_output_layout *layout, struct wlr_output *reference);
|
|
|
|
/**
|
|
* Get the output at the specified layout coordinates. Returns NULL if no
|
|
* output matches the coordinates.
|
|
*/
|
|
struct wlr_output *wlr_output_layout_output_at(struct wlr_output_layout *layout,
|
|
double lx, double ly);
|
|
|
|
/**
|
|
* Add the output to the layout at the specified coordinates. If the output is
|
|
* already part of the output layout, this moves the output.
|
|
*/
|
|
void wlr_output_layout_add(struct wlr_output_layout *layout,
|
|
struct wlr_output *output, int lx, int ly);
|
|
|
|
void wlr_output_layout_move(struct wlr_output_layout *layout,
|
|
struct wlr_output *output, int lx, int ly);
|
|
|
|
void wlr_output_layout_remove(struct wlr_output_layout *layout,
|
|
struct wlr_output *output);
|
|
|
|
/**
|
|
* Given x and y in layout coordinates, adjusts them to local output
|
|
* coordinates relative to the given reference output.
|
|
*/
|
|
void wlr_output_layout_output_coords(struct wlr_output_layout *layout,
|
|
struct wlr_output *reference, double *lx, double *ly);
|
|
|
|
bool wlr_output_layout_contains_point(struct wlr_output_layout *layout,
|
|
struct wlr_output *reference, int lx, int ly);
|
|
|
|
bool wlr_output_layout_intersects(struct wlr_output_layout *layout,
|
|
struct wlr_output *reference, const struct wlr_box *target_lbox);
|
|
|
|
/**
|
|
* Get the closest point on this layout from the given point from the reference
|
|
* output. If reference is NULL, gets the closest point from the entire layout.
|
|
*/
|
|
void wlr_output_layout_closest_point(struct wlr_output_layout *layout,
|
|
struct wlr_output *reference, double lx, double ly, double *dest_lx,
|
|
double *dest_ly);
|
|
|
|
/**
|
|
* Get the box of the layout for the given reference output in layout
|
|
* coordinates. If `reference` is NULL, the box will be for the extents of the
|
|
* entire layout. If the output isn't in the layout, the box will be empty.
|
|
*/
|
|
void wlr_output_layout_get_box(struct wlr_output_layout *layout,
|
|
struct wlr_output *reference, struct wlr_box *dest_box);
|
|
|
|
/**
|
|
* Add an auto configured output to the layout. This will place the output in a
|
|
* sensible location in the layout. The coordinates of the output in the layout
|
|
* may adjust dynamically when the layout changes. If the output is already in
|
|
* the layout, it will become auto configured. If the position of the output is
|
|
* set such as with wlr_output_layout_move(), the output will become manually
|
|
* configured.
|
|
*/
|
|
void wlr_output_layout_add_auto(struct wlr_output_layout *layout,
|
|
struct wlr_output *output);
|
|
|
|
/**
|
|
* Get the output closest to the center of the layout extents.
|
|
*/
|
|
struct wlr_output *wlr_output_layout_get_center_output(
|
|
struct wlr_output_layout *layout);
|
|
|
|
enum wlr_direction {
|
|
WLR_DIRECTION_UP = 1 << 0,
|
|
WLR_DIRECTION_DOWN = 1 << 1,
|
|
WLR_DIRECTION_LEFT = 1 << 2,
|
|
WLR_DIRECTION_RIGHT = 1 << 3,
|
|
};
|
|
|
|
/**
|
|
* Get the closest adjacent output to the reference output from the reference
|
|
* point in the given direction.
|
|
*/
|
|
struct wlr_output *wlr_output_layout_adjacent_output(
|
|
struct wlr_output_layout *layout, enum wlr_direction direction,
|
|
struct wlr_output *reference, double ref_lx, double ref_ly);
|
|
struct wlr_output *wlr_output_layout_farthest_output(
|
|
struct wlr_output_layout *layout, enum wlr_direction direction,
|
|
struct wlr_output *reference, double ref_lx, double ref_ly);
|
|
|
|
#endif
|