78 lines
3.3 KiB
XML
78 lines
3.3 KiB
XML
|
<?xml version="1.0" encoding="UTF-8"?>
|
||
|
|
<protocol name="ext_image_source_v1">
|
||
|
|
<copyright>
|
||
|
|
Copyright © 2022 Andri Yngvason
|
||
|
|
|
||
|
|
Permission is hereby granted, free of charge, to any person obtaining a
|
||
|
|
copy of this software and associated documentation files (the "Software"),
|
||
|
|
to deal in the Software without restriction, including without limitation
|
||
|
|
the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
||
|
|
and/or sell copies of the Software, and to permit persons to whom the
|
||
|
|
Software is furnished to do so, subject to the following conditions:
|
||
|
|
|
||
|
|
The above copyright notice and this permission notice (including the next
|
||
|
|
paragraph) shall be included in all copies or substantial portions of the
|
||
|
|
Software.
|
||
|
|
|
||
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
||
|
|
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
||
|
|
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
||
|
|
DEALINGS IN THE SOFTWARE.
|
||
|
|
</copyright>
|
||
|
|
|
||
|
|
<description summary="opaque image source objects">
|
||
|
|
This protocol serves as an intermediary between screen capturing protocols
|
||
|
|
and potential image sources such as outputs and toplevels.
|
||
|
|
|
||
|
|
This protocol may be extended to support more image sources in the future,
|
||
|
|
thereby adding those image sources to other protocols that use the image
|
||
|
|
source object without having to modify those protocols.
|
||
|
|
</description>
|
||
|
|
|
||
|
|
<interface name="ext_image_source_manager_v1" version="1">
|
||
|
|
<description summary="opaque image source manager">
|
||
|
|
A manager for creating image source objects for standard objects. Sources
|
||
|
|
may also be created from elsewhere.
|
||
|
|
</description>
|
||
|
|
|
||
|
|
<request name="create_output_source">
|
||
|
|
<description summary="create source object for output">
|
||
|
|
Creates a source object for an output. Images captured from this source
|
||
|
|
will show the same image as the output. Some elements may be omitted,
|
||
|
|
such as cursors and overlays that have been marked as transparent to
|
||
|
|
capturing.
|
||
|
|
</description>
|
||
|
|
<arg name="source" type="new_id" interface="ext_image_source_v1"/>
|
||
|
|
<arg name="output" type="object" interface="wl_output"/>
|
||
|
|
</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>
|
||
|
|
|
||
|
|
<interface name="ext_image_source_v1" version="1">
|
||
|
|
<description summary="opaque image source object">
|
||
|
|
The image source object is an opaque descriptor for a capturable resource.
|
||
|
|
This resource may be any sort of entity from which an image may be
|
||
|
|
derived.
|
||
|
|
|
||
|
|
This interface may not be extended.
|
||
|
|
</description>
|
||
|
|
|
||
|
|
<request name="destroy" type="destructor">
|
||
|
|
<description summary="delete this object">
|
||
|
|
Destroys the image source. This request may be sent at any time by the
|
||
|
|
client.
|
||
|
|
</description>
|
||
|
|
</request>
|
||
|
|
</interface>
|
||
|
|
</protocol>
|