gpu/drm/drm_damage_helper.c

41  * specify a list of damage rectangles on a plane in framebuffer coordinates of
42  * the framebuffer attached to the plane. In current context damage is the area
52  * ignore damage clips property and in that case driver will do a full plane
53  * update. In case damage clips are provided then it is guaranteed that the area
54  * inside damage clips will be updated to plane. For efficiency driver can do
55  * full update or can update more than specified in damage clips. Since driver
58  * provides damage clips which doesn't encompass the actual damage to
63  * damage clips are not in 16.16 fixed point. Similar to plane src in
64  * framebuffer, damage clips cannot be negative. In damage clip, x1/y1 are
66  * damage clips, it is strongly discouraged.
68  * Drivers that are interested in damage interface for plane should enable
70  * Drivers implementing damage can use drm_atomic_helper_damage_iter_init() and
71  * drm_atomic_helper_damage_iter_next() helper iterator function to get damage
91  * drm_plane_enable_fb_damage_clips - Enables plane fb damage clips property.
92  * @plane: Plane on which to enable damage clips property.
94  * This function lets driver to enable the damage clips property on a plane.
107  * drm_atomic_helper_check_plane_damage - Verify plane damage on atomic_check.
109  * @plane_state: Plane state for which to verify damage.
111  * This helper function makes sure that damage from plane state is discarded
113  * plane update rather than processing individual damage regions, then those
118  * &drm_plane_state.src as damage.
149  * A helper to implement &drm_framebuffer_funcs.dirty using damage interface
166 	struct drm_property_blob *damage = NULL;  in drm_atomic_helper_dirtyfb()  local
201 		damage = drm_property_create_blob(fb->dev,  in drm_atomic_helper_dirtyfb()
204 		if (IS_ERR(damage)) {  in drm_atomic_helper_dirtyfb()
205 			ret = PTR_ERR(damage);  in drm_atomic_helper_dirtyfb()
206 			damage = NULL;  in drm_atomic_helper_dirtyfb()
231 					  damage);  in drm_atomic_helper_dirtyfb()
244 	drm_property_blob_put(damage);  in drm_atomic_helper_dirtyfb()
258  * drm_atomic_helper_damage_iter_init - Initialize the damage iterator.
261  * @state: Plane state from which to iterate the damage clips.
263  * Initialize an iterator, which clips plane damage
265  * returns full plane src in case damage is not present because either
268  * changed but that can be changed in future to return damage.
303  * drm_atomic_helper_damage_iter_next - Advance the damage iterator.
307  * Since plane src is in 16.16 fixed point and damage clips are whole number,
310  * off for full plane src, in case it's returned as damage. This iterator will
311  * skip damage clips outside of plane src.
345  * drm_atomic_helper_damage_merged - Merged plane damage
347  * @state: Plane state from which to iterate the damage clips.
348  * @rect: Returns the merged damage rectangle
350  * This function merges any valid plane damage clips into one rectangle and
357  * True if there is valid plane damage otherwise false.