2017-09-23 08:26:01 +00:00
|
|
|
#ifndef WLR_TYPES_WLR_OUTPUT_H
|
|
|
|
#define WLR_TYPES_WLR_OUTPUT_H
|
|
|
|
|
2018-02-12 20:29:23 +00:00
|
|
|
#include <pixman.h>
|
2017-11-01 19:08:15 +00:00
|
|
|
#include <stdbool.h>
|
2018-01-19 13:08:47 +00:00
|
|
|
#include <time.h>
|
2017-06-19 22:41:02 +00:00
|
|
|
#include <wayland-server.h>
|
2018-02-12 20:29:23 +00:00
|
|
|
#include <wayland-util.h>
|
2018-05-21 17:50:51 +00:00
|
|
|
#include <wlr/types/wlr_linux_dmabuf.h>
|
2017-06-19 22:41:02 +00:00
|
|
|
|
|
|
|
struct wlr_output_mode {
|
|
|
|
uint32_t flags; // enum wl_output_mode
|
|
|
|
int32_t width, height;
|
|
|
|
int32_t refresh; // mHz
|
2017-10-15 10:32:37 +00:00
|
|
|
struct wl_list link;
|
2017-06-19 22:41:02 +00:00
|
|
|
};
|
|
|
|
|
2017-10-29 08:09:21 +00:00
|
|
|
struct wlr_output_cursor {
|
|
|
|
struct wlr_output *output;
|
2017-11-04 05:35:12 +00:00
|
|
|
double x, y;
|
2017-11-02 10:37:43 +00:00
|
|
|
bool enabled;
|
2017-12-08 13:23:33 +00:00
|
|
|
bool visible;
|
2017-10-29 16:43:26 +00:00
|
|
|
uint32_t width, height;
|
2017-10-29 08:09:21 +00:00
|
|
|
int32_t hotspot_x, hotspot_y;
|
|
|
|
struct wl_list link;
|
|
|
|
|
2017-11-02 10:37:43 +00:00
|
|
|
// only when using a software cursor without a surface
|
2017-10-29 08:09:21 +00:00
|
|
|
struct wlr_texture *texture;
|
|
|
|
|
|
|
|
// only when using a cursor surface
|
|
|
|
struct wlr_surface *surface;
|
|
|
|
struct wl_listener surface_commit;
|
|
|
|
struct wl_listener surface_destroy;
|
2018-02-01 11:08:35 +00:00
|
|
|
|
|
|
|
struct {
|
|
|
|
struct wl_signal destroy;
|
|
|
|
} events;
|
2017-10-29 08:09:21 +00:00
|
|
|
};
|
|
|
|
|
2017-06-19 22:41:02 +00:00
|
|
|
struct wlr_output_impl;
|
|
|
|
|
2018-02-11 12:04:00 +00:00
|
|
|
/**
|
|
|
|
* A compositor output region. This typically corresponds to a monitor that
|
|
|
|
* displays part of the compositor space.
|
|
|
|
*
|
|
|
|
* Compositors should listen to the `frame` event to render an output. They
|
|
|
|
* should call `wlr_output_make_current`, render and then call
|
|
|
|
* `wlr_output_swap_buffers`. No rendering should happen outside a `frame` event
|
|
|
|
* handler.
|
|
|
|
*/
|
2017-06-19 22:41:02 +00:00
|
|
|
struct wlr_output {
|
|
|
|
const struct wlr_output_impl *impl;
|
2017-10-21 04:37:25 +00:00
|
|
|
struct wlr_backend *backend;
|
2018-01-04 11:46:15 +00:00
|
|
|
struct wl_display *display;
|
2017-08-13 14:51:50 +00:00
|
|
|
|
2017-06-22 18:26:02 +00:00
|
|
|
struct wl_global *wl_global;
|
2017-06-23 19:10:52 +00:00
|
|
|
struct wl_list wl_resources;
|
2017-06-19 22:41:02 +00:00
|
|
|
|
2018-04-05 04:58:23 +00:00
|
|
|
char name[24];
|
2017-06-19 22:41:02 +00:00
|
|
|
char make[48];
|
|
|
|
char model[16];
|
2017-11-11 18:09:34 +00:00
|
|
|
char serial[16];
|
2017-06-19 22:41:02 +00:00
|
|
|
int32_t phys_width, phys_height; // mm
|
2018-01-04 11:46:15 +00:00
|
|
|
|
2018-01-21 10:11:25 +00:00
|
|
|
// Note: some backends may have zero modes
|
|
|
|
struct wl_list modes;
|
|
|
|
struct wlr_output_mode *current_mode;
|
|
|
|
int32_t width, height;
|
|
|
|
int32_t refresh; // mHz, may be zero
|
|
|
|
|
2018-01-04 11:46:15 +00:00
|
|
|
bool enabled;
|
|
|
|
float scale;
|
2017-11-01 19:08:15 +00:00
|
|
|
enum wl_output_subpixel subpixel;
|
|
|
|
enum wl_output_transform transform;
|
2017-06-19 22:41:02 +00:00
|
|
|
|
2018-01-20 15:43:14 +00:00
|
|
|
bool needs_swap;
|
2018-01-26 21:11:09 +00:00
|
|
|
// damage for cursors and fullscreen surface, in output-local coordinates
|
|
|
|
pixman_region32_t damage;
|
2018-01-26 21:39:23 +00:00
|
|
|
bool frame_pending;
|
2018-03-15 14:33:58 +00:00
|
|
|
float transform_matrix[9];
|
2017-06-19 22:41:02 +00:00
|
|
|
|
|
|
|
struct {
|
|
|
|
struct wl_signal frame;
|
2018-01-20 15:43:14 +00:00
|
|
|
struct wl_signal needs_swap;
|
2018-05-23 08:02:19 +00:00
|
|
|
struct wl_signal swap_buffers; // wlr_output_event_swap_buffers
|
2018-01-04 13:51:36 +00:00
|
|
|
struct wl_signal enable;
|
2018-01-06 11:42:32 +00:00
|
|
|
struct wl_signal mode;
|
2017-12-12 20:58:00 +00:00
|
|
|
struct wl_signal scale;
|
|
|
|
struct wl_signal transform;
|
2017-08-30 17:28:50 +00:00
|
|
|
struct wl_signal destroy;
|
2017-06-19 22:41:02 +00:00
|
|
|
} events;
|
2017-06-26 05:34:15 +00:00
|
|
|
|
2018-01-30 13:45:02 +00:00
|
|
|
struct wl_event_source *idle_frame;
|
|
|
|
|
2017-11-20 16:27:36 +00:00
|
|
|
struct wlr_surface *fullscreen_surface;
|
|
|
|
struct wl_listener fullscreen_surface_commit;
|
|
|
|
struct wl_listener fullscreen_surface_destroy;
|
2018-01-30 21:06:10 +00:00
|
|
|
int fullscreen_width, fullscreen_height;
|
2017-11-20 16:27:36 +00:00
|
|
|
|
2017-10-29 08:09:21 +00:00
|
|
|
struct wl_list cursors; // wlr_output_cursor::link
|
|
|
|
struct wlr_output_cursor *hardware_cursor;
|
2017-08-11 18:23:53 +00:00
|
|
|
|
2017-10-19 16:57:45 +00:00
|
|
|
// the output position in layout space reported to clients
|
|
|
|
int32_t lx, ly;
|
|
|
|
|
2017-12-07 00:12:04 +00:00
|
|
|
struct wl_listener display_destroy;
|
|
|
|
|
2017-08-11 18:23:53 +00:00
|
|
|
void *data;
|
2017-06-19 22:41:02 +00:00
|
|
|
};
|
|
|
|
|
2018-05-23 08:02:19 +00:00
|
|
|
struct wlr_output_event_swap_buffers {
|
|
|
|
struct wlr_output *output;
|
|
|
|
struct timespec *when;
|
|
|
|
pixman_region32_t *damage;
|
|
|
|
};
|
|
|
|
|
2017-10-08 19:21:06 +00:00
|
|
|
struct wlr_surface;
|
|
|
|
|
2017-06-19 22:41:02 +00:00
|
|
|
void wlr_output_enable(struct wlr_output *output, bool enable);
|
2018-01-24 09:23:48 +00:00
|
|
|
void wlr_output_create_global(struct wlr_output *output);
|
|
|
|
void wlr_output_destroy_global(struct wlr_output *output);
|
2018-04-04 03:05:49 +00:00
|
|
|
/**
|
|
|
|
* Sets the output mode.
|
|
|
|
*/
|
2017-06-19 22:41:02 +00:00
|
|
|
bool wlr_output_set_mode(struct wlr_output *output,
|
2017-10-08 19:21:06 +00:00
|
|
|
struct wlr_output_mode *mode);
|
2018-04-04 03:05:49 +00:00
|
|
|
/**
|
|
|
|
* Sets a custom mode on the output. If modes are available, they are preferred.
|
|
|
|
* Setting `refresh` to zero lets the backend pick a preferred value.
|
|
|
|
*/
|
2017-12-11 11:14:23 +00:00
|
|
|
bool wlr_output_set_custom_mode(struct wlr_output *output, int32_t width,
|
|
|
|
int32_t height, int32_t refresh);
|
2017-12-12 20:58:00 +00:00
|
|
|
void wlr_output_set_transform(struct wlr_output *output,
|
2017-10-08 19:21:06 +00:00
|
|
|
enum wl_output_transform transform);
|
2017-10-19 16:57:45 +00:00
|
|
|
void wlr_output_set_position(struct wlr_output *output, int32_t lx, int32_t ly);
|
2017-12-15 00:00:03 +00:00
|
|
|
void wlr_output_set_scale(struct wlr_output *output, float scale);
|
2017-06-19 22:41:02 +00:00
|
|
|
void wlr_output_destroy(struct wlr_output *output);
|
2018-01-30 09:23:35 +00:00
|
|
|
/**
|
|
|
|
* Computes the transformed output resolution.
|
|
|
|
*/
|
|
|
|
void wlr_output_transformed_resolution(struct wlr_output *output,
|
|
|
|
int *width, int *height);
|
|
|
|
/**
|
|
|
|
* Computes the transformed and scaled output resolution.
|
|
|
|
*/
|
2017-06-19 22:41:02 +00:00
|
|
|
void wlr_output_effective_resolution(struct wlr_output *output,
|
2017-10-08 19:21:06 +00:00
|
|
|
int *width, int *height);
|
2018-01-20 23:06:35 +00:00
|
|
|
/**
|
2018-01-21 10:11:25 +00:00
|
|
|
* Makes the output rendering context current.
|
2018-01-20 23:06:35 +00:00
|
|
|
*
|
|
|
|
* `buffer_age` is set to the drawing buffer age in number of frames or -1 if
|
2018-01-21 10:11:25 +00:00
|
|
|
* unknown. This is useful for damage tracking.
|
2018-01-20 23:06:35 +00:00
|
|
|
*/
|
|
|
|
bool wlr_output_make_current(struct wlr_output *output, int *buffer_age);
|
2018-01-19 13:08:47 +00:00
|
|
|
/**
|
|
|
|
* Swaps the output buffers. If the time of the frame isn't known, set `when` to
|
|
|
|
* NULL. If the compositor doesn't support damage tracking, set `damage` to
|
|
|
|
* NULL.
|
2018-01-21 10:11:25 +00:00
|
|
|
*
|
|
|
|
* Swapping buffers schedules a `frame` event.
|
2018-01-19 13:08:47 +00:00
|
|
|
*/
|
2018-01-20 23:06:35 +00:00
|
|
|
bool wlr_output_swap_buffers(struct wlr_output *output, struct timespec *when,
|
2018-01-19 13:08:47 +00:00
|
|
|
pixman_region32_t *damage);
|
2018-01-26 21:39:23 +00:00
|
|
|
/**
|
|
|
|
* Manually schedules a `frame` event. If a `frame` event is already pending,
|
|
|
|
* it is a no-op.
|
|
|
|
*/
|
|
|
|
void wlr_output_schedule_frame(struct wlr_output *output);
|
2017-09-06 15:34:09 +00:00
|
|
|
void wlr_output_set_gamma(struct wlr_output *output,
|
2017-10-22 10:30:45 +00:00
|
|
|
uint32_t size, uint16_t *r, uint16_t *g, uint16_t *b);
|
|
|
|
uint32_t wlr_output_get_gamma_size(struct wlr_output *output);
|
2018-05-21 17:50:51 +00:00
|
|
|
bool wlr_output_export_dmabuf(struct wlr_output *output,
|
2018-05-31 11:33:27 +00:00
|
|
|
struct wlr_dmabuf_attributes *attribs);
|
2017-11-20 16:27:36 +00:00
|
|
|
void wlr_output_set_fullscreen_surface(struct wlr_output *output,
|
|
|
|
struct wlr_surface *surface);
|
2018-02-13 22:48:46 +00:00
|
|
|
struct wlr_output *wlr_output_from_resource(struct wl_resource *resource);
|
2017-10-07 17:01:11 +00:00
|
|
|
|
2018-01-21 10:11:25 +00:00
|
|
|
|
2017-10-29 08:09:21 +00:00
|
|
|
struct wlr_output_cursor *wlr_output_cursor_create(struct wlr_output *output);
|
2017-12-08 13:23:33 +00:00
|
|
|
/**
|
|
|
|
* Sets the cursor image. The image must be already scaled for the output.
|
|
|
|
*/
|
2017-10-29 08:09:21 +00:00
|
|
|
bool wlr_output_cursor_set_image(struct wlr_output_cursor *cursor,
|
|
|
|
const uint8_t *pixels, int32_t stride, uint32_t width, uint32_t height,
|
|
|
|
int32_t hotspot_x, int32_t hotspot_y);
|
|
|
|
void wlr_output_cursor_set_surface(struct wlr_output_cursor *cursor,
|
|
|
|
struct wlr_surface *surface, int32_t hotspot_x, int32_t hotspot_y);
|
2017-11-04 05:35:12 +00:00
|
|
|
bool wlr_output_cursor_move(struct wlr_output_cursor *cursor,
|
|
|
|
double x, double y);
|
2017-10-29 08:09:21 +00:00
|
|
|
void wlr_output_cursor_destroy(struct wlr_output_cursor *cursor);
|
|
|
|
|
2017-12-27 10:17:25 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the transform that, when composed with `tr`, gives
|
|
|
|
* `WL_OUTPUT_TRANSFORM_NORMAL`.
|
|
|
|
*/
|
2017-12-26 17:16:37 +00:00
|
|
|
enum wl_output_transform wlr_output_transform_invert(
|
|
|
|
enum wl_output_transform tr);
|
2017-12-27 10:17:25 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns a transform that, when applied, has the same effect as applying
|
|
|
|
* sequentially `tr_a` and `tr_b`.
|
|
|
|
*/
|
2017-12-26 17:16:37 +00:00
|
|
|
enum wl_output_transform wlr_output_transform_compose(
|
|
|
|
enum wl_output_transform tr_a, enum wl_output_transform tr_b);
|
2017-11-30 22:58:12 +00:00
|
|
|
|
2017-06-19 22:41:02 +00:00
|
|
|
#endif
|