Scroll to navigation

DRM_PRIMARY_HELPER_U(9) DRM Core DRM_PRIMARY_HELPER_U(9)

NAME

drm_primary_helper_update - Helper for primary plane update

SYNOPSIS

int drm_primary_helper_update(struct drm_plane * plane, struct drm_crtc * crtc, struct drm_framebuffer * fb, int crtc_x, int crtc_y, unsigned int crtc_w, unsigned int crtc_h, uint32_t src_x, uint32_t src_y, uint32_t src_w, uint32_t src_h);

ARGUMENTS

plane
plane object to update
crtc
owning CRTC of owning plane
fb
framebuffer to flip onto plane
crtc_x
x offset of primary plane on crtc
crtc_y
y offset of primary plane on crtc
crtc_w
width of primary plane rectangle on crtc
crtc_h
height of primary plane rectangle on crtc
src_x
x offset of fb for panning
src_y
y offset of fb for panning
src_w
width of source rectangle in fb
src_h
height of source rectangle in fb

DESCRIPTION

Provides a default plane update handler for primary planes. This is handler is called in response to a userspace SetPlane operation on the plane with a non-NULL framebuffer. We call the driver's modeset handler to update the framebuffer.
 
SetPlane on a primary plane of a disabled CRTC is not supported, and will return an error.
Note that we make some assumptions about hardware limitations that may not be true for all hardware -- 1) Primary plane cannot be repositioned. 2) Primary plane cannot be scaled. 3) Primary plane must cover the entire CRTC. 4) Subpixel positioning is not supported. Drivers for hardware that don't have these restrictions can provide their own implementation rather than using this helper.

RETURNS

Zero on success, error code on failure

AUTHORS

Jesse Barnes <jesse.barnes@intel.com>
 
Intel Corporation,
Initial version
Laurent Pinchart <laurent.pinchart@ideasonboard.com>
 
Ideas on board SPRL,
Driver internals
Daniel Vetter <daniel.vetter@ffwll.ch>
 
Intel Corporation,
Contributions all over the place

COPYRIGHT

February 2017 Kernel Hackers Manual 3.16