carta
drm_plane_helper_check_update(9)

drm_plane_helper_check_update9

Check plane update for validity

Arguments

plane

plane object to update

crtc

owning CRTC of owning plane

fb

framebuffer to flip onto plane

src

source coordinates in 16.16 fixed point

dest

integer destination coordinates

clip

integer clipping coordinates

min_scale

minimum src:dest scaling factor in 16.16 fixed point

max_scale

maximum src:dest scaling factor in 16.16 fixed point

can_position

is it legal to position the plane such that it doesn't cover the entire crtc? This will generally only be false for primary planes.

can_update_disabled

can the plane be updated while the crtc is disabled?

visible

output parameter indicating whether plane is still visible after clipping

Overview

Checks that a desired plane update is valid. Drivers that provide their own plane handling rather than helper-provided implementations may still wish to call this function to avoid duplication of error checking code.

Returns

Zero if update appears valid, error code on failure

Authors

Jesse Barnes <[email protected]>
Intel Corporation,

Initial version

Laurent Pinchart <[email protected]>
Ideas on board SPRL,

Driver internals

Daniel Vetter <[email protected]>
Intel Corporation,

Contributions all over the place

From linux-manual-3.16 3.16.56-1+deb8u1 in Debian 8 (Jessie). Parsed by carta from the page's man source.