2018-07-13 12:40:56 +00:00
|
|
|
/*
|
|
|
|
* 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
|
|
|
|
|
2018-02-11 11:49:30 +00:00
|
|
|
#ifndef WLR_TYPES_WLR_OUTPUT_DAMAGE_H
|
|
|
|
#define WLR_TYPES_WLR_OUTPUT_DAMAGE_H
|
|
|
|
|
|
|
|
#include <pixman.h>
|
2018-02-12 20:29:23 +00:00
|
|
|
#include <time.h>
|
2018-02-11 12:07:00 +00:00
|
|
|
#include <wlr/types/wlr_output.h>
|
2018-02-11 11:49:30 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Damage tracking requires to keep track of previous frames' damage. To allow
|
|
|
|
* damage tracking to work with triple buffering, a history of two frames is
|
|
|
|
* required.
|
|
|
|
*/
|
|
|
|
#define WLR_OUTPUT_DAMAGE_PREVIOUS_LEN 2
|
|
|
|
|
2021-07-01 20:36:01 +00:00
|
|
|
struct wlr_box;
|
|
|
|
|
2018-02-11 12:04:00 +00:00
|
|
|
/**
|
|
|
|
* Tracks damage for an output.
|
|
|
|
*
|
2019-04-23 17:16:08 +00:00
|
|
|
* The `frame` event will be emitted when it is a good time for the compositor
|
|
|
|
* to submit a new frame.
|
|
|
|
*
|
|
|
|
* To render a new frame, compositors should call
|
|
|
|
* `wlr_output_damage_attach_render`, render and call `wlr_output_commit`. No
|
|
|
|
* rendering should happen outside a `frame` event handler or before
|
|
|
|
* `wlr_output_damage_attach_render`.
|
2018-02-11 12:04:00 +00:00
|
|
|
*/
|
2018-02-11 11:49:30 +00:00
|
|
|
struct wlr_output_damage {
|
|
|
|
struct wlr_output *output;
|
2018-05-05 13:28:55 +00:00
|
|
|
int max_rects; // max number of damaged rectangles
|
2018-02-11 11:49:30 +00:00
|
|
|
|
|
|
|
pixman_region32_t current; // in output-local coordinates
|
|
|
|
|
|
|
|
// circular queue for previous damage
|
|
|
|
pixman_region32_t previous[WLR_OUTPUT_DAMAGE_PREVIOUS_LEN];
|
|
|
|
size_t previous_idx;
|
|
|
|
|
2021-07-12 16:00:55 +00:00
|
|
|
bool pending_attach_render;
|
2021-01-10 16:07:31 +00:00
|
|
|
|
2018-02-11 11:49:30 +00:00
|
|
|
struct {
|
|
|
|
struct wl_signal frame;
|
|
|
|
struct wl_signal destroy;
|
|
|
|
} events;
|
|
|
|
|
|
|
|
struct wl_listener output_destroy;
|
|
|
|
struct wl_listener output_mode;
|
2019-04-23 17:22:42 +00:00
|
|
|
struct wl_listener output_needs_frame;
|
2020-03-12 12:08:57 +00:00
|
|
|
struct wl_listener output_damage;
|
2018-02-11 11:49:30 +00:00
|
|
|
struct wl_listener output_frame;
|
2021-01-10 16:07:31 +00:00
|
|
|
struct wl_listener output_precommit;
|
2019-04-23 17:16:08 +00:00
|
|
|
struct wl_listener output_commit;
|
2018-02-11 11:49:30 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
struct wlr_output_damage *wlr_output_damage_create(struct wlr_output *output);
|
|
|
|
void wlr_output_damage_destroy(struct wlr_output_damage *output_damage);
|
2018-02-11 12:04:00 +00:00
|
|
|
/**
|
2019-04-23 17:16:08 +00:00
|
|
|
* Attach the renderer's buffer to the output. Compositors must call this
|
|
|
|
* function before rendering. After they are done rendering, they should call
|
|
|
|
* `wlr_output_set_damage` and `wlr_output_commit` to submit the new frame.
|
2018-02-11 12:04:00 +00:00
|
|
|
*
|
2019-04-23 17:22:42 +00:00
|
|
|
* `needs_frame` will be set to true if a frame should be submitted. `damage`
|
2019-04-23 17:16:08 +00:00
|
|
|
* will be set to the region of the output that needs to be repainted, in
|
|
|
|
* output-buffer-local coordinates.
|
2019-04-25 16:49:59 +00:00
|
|
|
*
|
|
|
|
* The buffer damage region accumulates all damage since the buffer has last
|
|
|
|
* been swapped. This is not to be confused with the output surface damage,
|
|
|
|
* which only contains the changes between two frames.
|
2018-02-11 12:04:00 +00:00
|
|
|
*/
|
2019-04-23 17:16:08 +00:00
|
|
|
bool wlr_output_damage_attach_render(struct wlr_output_damage *output_damage,
|
2019-04-25 16:49:59 +00:00
|
|
|
bool *needs_frame, pixman_region32_t *buffer_damage);
|
2018-02-11 12:04:00 +00:00
|
|
|
/**
|
|
|
|
* Accumulates damage and schedules a `frame` event.
|
|
|
|
*/
|
2018-02-11 11:49:30 +00:00
|
|
|
void wlr_output_damage_add(struct wlr_output_damage *output_damage,
|
|
|
|
pixman_region32_t *damage);
|
2018-02-11 12:04:00 +00:00
|
|
|
/**
|
|
|
|
* Damages the whole output and schedules a `frame` event.
|
|
|
|
*/
|
2018-02-11 11:49:30 +00:00
|
|
|
void wlr_output_damage_add_whole(struct wlr_output_damage *output_damage);
|
2018-02-11 12:04:00 +00:00
|
|
|
/**
|
|
|
|
* Accumulates damage from a box and schedules a `frame` event.
|
|
|
|
*/
|
2018-02-11 11:49:30 +00:00
|
|
|
void wlr_output_damage_add_box(struct wlr_output_damage *output_damage,
|
|
|
|
struct wlr_box *box);
|
|
|
|
|
|
|
|
#endif
|