Update protocol for linux-dmabuf-unstable-v1
Just updates the text of the protocol, no new functionality. Change-Id: I08a09b2a3d37f61fc28967fbb1306f35a2921f0a Reviewed-by: David Edmundson <davidedmundson@kde.org> Reviewed-by: Pier Luigi Fiorini <pierluigi.fiorini@liri.io>
This commit is contained in:
parent
03414a616b
commit
7c181d3733
@ -28,6 +28,7 @@
|
|||||||
<description summary="factory for creating dmabuf-based wl_buffers">
|
<description summary="factory for creating dmabuf-based wl_buffers">
|
||||||
Following the interfaces from:
|
Following the interfaces from:
|
||||||
https://www.khronos.org/registry/egl/extensions/EXT/EGL_EXT_image_dma_buf_import.txt
|
https://www.khronos.org/registry/egl/extensions/EXT/EGL_EXT_image_dma_buf_import.txt
|
||||||
|
https://www.khronos.org/registry/EGL/extensions/EXT/EGL_EXT_image_dma_buf_import_modifiers.txt
|
||||||
and the Linux DRM sub-system's AddFb2 ioctl.
|
and the Linux DRM sub-system's AddFb2 ioctl.
|
||||||
|
|
||||||
This interface offers ways to create generic dmabuf-based
|
This interface offers ways to create generic dmabuf-based
|
||||||
@ -129,8 +130,16 @@
|
|||||||
binds to this interface. A roundtrip after binding guarantees that
|
binds to this interface. A roundtrip after binding guarantees that
|
||||||
the client has received all supported format-modifier pairs.
|
the client has received all supported format-modifier pairs.
|
||||||
|
|
||||||
|
For legacy support, DRM_FORMAT_MOD_INVALID (that is, modifier_hi ==
|
||||||
|
0x00ffffff and modifier_lo == 0xffffffff) is allowed in this event.
|
||||||
|
It indicates that the server can support the format with an implicit
|
||||||
|
modifier. When a plane has DRM_FORMAT_MOD_INVALID as its modifier, it
|
||||||
|
is as if no explicit modifier is specified. The effective modifier
|
||||||
|
will be derived from the dmabuf.
|
||||||
|
|
||||||
For the definition of the format and modifier codes, see the
|
For the definition of the format and modifier codes, see the
|
||||||
zwp_linux_buffer_params_v1::create request.
|
zwp_linux_buffer_params_v1::create and zwp_linux_buffer_params_v1::add
|
||||||
|
requests.
|
||||||
</description>
|
</description>
|
||||||
<arg name="format" type="uint" summary="DRM_FORMAT code"/>
|
<arg name="format" type="uint" summary="DRM_FORMAT code"/>
|
||||||
<arg name="modifier_hi" type="uint"
|
<arg name="modifier_hi" type="uint"
|
||||||
@ -197,6 +206,11 @@
|
|||||||
compression, etc. driver-specific modifications to the base format
|
compression, etc. driver-specific modifications to the base format
|
||||||
defined by the DRM fourcc code.
|
defined by the DRM fourcc code.
|
||||||
|
|
||||||
|
Warning: It should be an error if the format/modifier pair was not
|
||||||
|
advertised with the modifier event. This is not enforced yet because
|
||||||
|
some implementations always accept DRM_FORMAT_MOD_INVALID. Also
|
||||||
|
version 2 of this protocol does not have the modifier event.
|
||||||
|
|
||||||
This request raises the PLANE_IDX error if plane_idx is too large.
|
This request raises the PLANE_IDX error if plane_idx is too large.
|
||||||
The error PLANE_SET is raised if attempting to set a plane that
|
The error PLANE_SET is raised if attempting to set a plane that
|
||||||
was already set.
|
was already set.
|
||||||
|
@ -206,6 +206,8 @@ Copyright © 2015, 2016 Jan Arne Petersen"
|
|||||||
|
|
||||||
"Description": "The linux dmabuf protocol is a way to create dmabuf-based wl_buffers",
|
"Description": "The linux dmabuf protocol is a way to create dmabuf-based wl_buffers",
|
||||||
"Homepage": "https://wayland.freedesktop.org",
|
"Homepage": "https://wayland.freedesktop.org",
|
||||||
|
"Version": "unstable v1, version 3",
|
||||||
|
"DownloadLocation": "https://gitlab.freedesktop.org/wayland/wayland-protocols/raw/1.18/unstable/linux-dmabuf/linux-dmabuf-unstable-v1.xml",
|
||||||
"LicenseId": "MIT",
|
"LicenseId": "MIT",
|
||||||
"License": "MIT License",
|
"License": "MIT License",
|
||||||
"LicenseFile": "MIT_LICENSE.txt",
|
"LicenseFile": "MIT_LICENSE.txt",
|
||||||
|
Loading…
x
Reference in New Issue
Block a user