Lines Matching full:damage

1554  * DOC: damage tracking
1557 * specify a list of damage rectangles on a plane in framebuffer coordinates of
1558 * the framebuffer attached to the plane. In current context damage is the area
1568 * ignore damage clips property and in that case driver will do a full plane
1569 * update. In case damage clips are provided then it is guaranteed that the area
1570 * inside damage clips will be updated to plane. For efficiency driver can do
1571 * full update or can update more than specified in damage clips. Since driver
1574 * provides damage clips which doesn't encompass the actual damage to
1579 * damage clips are not in 16.16 fixed point. Similar to plane src in
1580 * framebuffer, damage clips cannot be negative. In damage clip, x1/y1 are
1582 * damage clips, it is strongly discouraged.
1584 * Drivers that are interested in damage interface for plane should enable
1586 * Drivers implementing damage can use drm_atomic_helper_damage_iter_init() and
1587 * drm_atomic_helper_damage_iter_next() helper iterator function to get damage
1590 * Note that there are two types of damage handling: frame damage and buffer
1591 * damage, the type of damage handling implemented depends on a driver's upload
1593 * handle frame damage, while drivers implementing a per-buffer upload target
1594 * need to handle buffer damage.
1596 * The existing damage helpers only support the frame damage type, there is no
1597 * buffer age support or similar damage accumulation algorithm implemented yet.
1599 * Only drivers handling frame damage can use the mentioned damage helpers to
1600 * iterate over the damaged regions. Drivers that handle buffer damage, must set
1602 * to know that damage clips should be ignored and return &drm_plane_state.src
1603 * as the damage rectangle, to force a full plane update.
1613 * can be improved in the future if support for frame damage is added to the DRM
1614 * damage helpers, similarly to how user-space already handle this case as it is
1618 * https://emersion.fr/blog/2019/intro-to-damage-tracking/
1622 * drm_plane_enable_fb_damage_clips - Enables plane fb damage clips property.
1623 * @plane: Plane on which to enable damage clips property.
1625 * This function lets driver to enable the damage clips property on a plane.
1638 * drm_plane_get_damage_clips_count - Returns damage clips count.
1662 * drm_plane_get_damage_clips - Returns damage clips.
1668 * the driver can only handle a single damage region at most.
1670 * Return: Damage clips in plane fb_damage_clips blob property.