Merge branch 'workspace' into 'main'

ext-image-capture-source-v1: new interface

See merge request wayland/wayland-protocols!463
This commit is contained in:
YaoBing Xiao 2025-12-16 17:37:27 +08:00
commit 53d853eccb

View file

@ -106,4 +106,40 @@
</description>
</request>
</interface>
<interface name="ext_workspace_image_capture_source_manager_v1" version="1">
<description summary="image capture source manager for workspaces">
A manager for creating image capture source objects for workspace handles.
This allows clients to capture the entire content of a workspace, including
all windows and desktop elements within that workspace.
</description>
<request name="create_source">
<description summary="create source object for workspace">
Creates a source object for a workspace handle. Images captured from
this source will show the content of the workspace as determined by
the compositor. This may include windows, and other elements visible
in that workspace. Some elements may be omitted, such as cursors and
overlays that have been marked as transparent to capturing.
The exact content included in the capture is compositor policy.
Compositors may choose to include or exclude specific elements such
as panels, docks, desktop background, or other UI components.
The captured content represents the workspace as it would appear if
it were the currently active workspace, regardless of whether it is
actually visible to the user at the time of capture.
</description>
<arg name="source" type="new_id" interface="ext_image_capture_source_v1"/>
<arg name="workspace_handle" type="object" interface="ext_workspace_handle_v1"/>
</request>
<request name="destroy" type="destructor">
<description summary="delete this object">
Destroys the manager. This request may be sent at any time by the client
and objects created by the manager will remain valid after its
destruction.
</description>
</request>
</interface>
</protocol>