mirrors/linux
2
0
Fork 0
mirror of https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git synced 2026-08-23 07:15:57 -04:00
Code Issues Packages Projects Releases Wiki Activity

drm: writeback: Document behaviour for framebuffer size mismatch

Browse Source 
Currently we have not explicitly defined the behaviour when the width
and height of the writeback framebuffer do not match the width and
height of the attached CRTC.

Allow the driver to perform a scale operation to fit the content, so
systems with scaling blocks in the writeback path can easily expose them.
A partially filled buffer should never be returned, so failure remains
an option for all the systems that don't have a scaler, or when scaler
limits are exceeded.

Cropping would make less sense, as the region to crop is underspecified
without some other properties to define an origin.

Signed-off-by: Derek Foreman <derek.foreman@collabora.com>
Link: https://patch.msgid.link/20260602191754.79047-1-derek.foreman@collabora.com
Signed-off-by: Daniel Stone <daniels@collabora.com>
Reviewed-by: Daniel Stone <daniels@collabora.com>
This commit is contained in:
Derek Foreman
2026-06-02 14:17:53 -05:00
committed by Daniel Stone
parent 2693c9572e
commit a2646fdfbc
1 changed files with 6 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
drivers/gpu/drm/drm_writeback.c
View File

@@ -58,6 +58,12 @@
* framebuffer to be written by the writeback connector. This property is
* similar to the FB_ID property on planes, but will always read as zero
* and is not preserved across commits.
* If the width and height of the framebuffer do not match those of the
* attached CRTC, the driver must either fail or scale (not crop) the
* content to exactly fit the framebuffer.
* If the driver is unable to exactly fill the framebuffer for any reason,
* such as hardware scaler constraints or an odd width for a sub-sampled
* format, the writeback must fail instead of partially filling the buffer.
* Userspace must set this property to an output buffer every time it
* wishes the buffer to get filled.
*