fdo-mirrors/weston
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/wayland/weston.git synced 2026-05-05 01:48:00 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

compositor: Add some comments to paint node members

Browse source 
Just a bit of documentation.

Signed-off-by: Derek Foreman <derek.foreman@collabora.com>
This commit is contained in:
Derek Foreman 2025-10-15 13:31:17 -05:00
parent 9700ec3bc4
commit 5ee711d374
1 changed files with 24 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
libweston/libweston-internal.h
View file

@ -723,6 +723,14 @@ struct weston_paint_node {
uint32_t try_view_on_plane_failure_reasons;
bool is_fully_opaque;
bool is_fully_blended;
/* This node's contents are solid, either from a solid buffer or a
* placeholder.
*
* Care is taken to ensure that it is correct both during
* assign_planes and during render, even if the value is different
* for each during a single repaint.
*/
bool draw_solid;
/* This node's buffer or view alpha causes it to be completely
@ -735,7 +743,23 @@ struct weston_paint_node {
* as a placeholder, and draw_solid must be set.
*/
bool censored;
/* Only valid when draw_solid is true, this is the solid color of
* the paint node. It may simply be a copy of a solid buffer's
* values, or it may be a placeholder used to replace a buffer's
* content.
*
* It may change after assign_planes if plane assignment requires
* the renderer to use a placeholder.
*/
struct weston_solid_buffer_values solid;
/* need_hole means this paint node has been placed on a plane beneath
* the renderer's plane, so the renderer must draw a transparent hole
* for the paint node.
*
* This is set in the backend assign_planes callback.
*/
bool need_hole;
uint32_t psf_flags; /* presentation-feedback flags */
};