3c1f50a85e
Place the XML files in data/dbus-interfaces. Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/2126>
351 lines
11 KiB
XML
351 lines
11 KiB
XML
<!DOCTYPE node PUBLIC
|
|
'-//freedesktop//DTD D-BUS Object Introspection 1.0//EN'
|
|
'http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd'>
|
|
<node>
|
|
|
|
<!--
|
|
org.gnome.Mutter.RemoteDesktop:
|
|
@short_description: Remote desktop interface
|
|
|
|
This API is private and not intended to be used outside of the integrated
|
|
system that uses libmutter. No compatibility between versions are
|
|
promised.
|
|
-->
|
|
<interface name="org.gnome.Mutter.RemoteDesktop">
|
|
|
|
<!--
|
|
CreateSession:
|
|
@session_path: Path to the new session object
|
|
-->
|
|
<method name="CreateSession">
|
|
<arg name="session_path" type="o" direction="out" />
|
|
</method>
|
|
|
|
<!--
|
|
SupportedDeviceTypes:
|
|
@short_description: Bit mask of supported device types
|
|
|
|
Device types:
|
|
1: keyboard
|
|
2: pointer
|
|
4: touchscreen
|
|
-->
|
|
<property name="SupportedDeviceTypes" type="u" access="read" />
|
|
|
|
<!--
|
|
Version:
|
|
@short_description: API version
|
|
-->
|
|
<property name="Version" type="i" access="read" />
|
|
|
|
</interface>
|
|
|
|
<!--
|
|
org.gnome.Mutter.RemoteDesktop.Session:
|
|
@short_description: Remote desktop session
|
|
-->
|
|
<interface name="org.gnome.Mutter.RemoteDesktop.Session">
|
|
|
|
<!--
|
|
SessionId:
|
|
|
|
An identification string used for identifying a remote desktop session.
|
|
It can be used to associate screen cast sessions with a remote desktop session.
|
|
-->
|
|
<property name="SessionId" type="s" access="read" />
|
|
|
|
<!--
|
|
Start:
|
|
|
|
Start the remote desktop session
|
|
-->
|
|
<method name="Start" />
|
|
|
|
<!--
|
|
Stop:
|
|
|
|
Stop the remote desktop session
|
|
-->
|
|
<method name="Stop" />
|
|
|
|
<!--
|
|
Closed:
|
|
|
|
The session has closed.
|
|
|
|
A session doesn't have to have been started before it may be closed.
|
|
After it being closed, it can no longer be used.
|
|
-->
|
|
<signal name="Closed" />
|
|
|
|
<!--
|
|
NotifyKeyboardKeycode:
|
|
|
|
A key identified by an evdev keycode was pressed or released
|
|
-->
|
|
<method name="NotifyKeyboardKeycode">
|
|
<arg name="keycode" type="u" direction="in" />
|
|
<arg name="state" type="b" direction="in" />
|
|
</method>
|
|
|
|
<!--
|
|
NotifyKeyboardKeysym:
|
|
|
|
A key identified by a keysym was pressed or released
|
|
-->
|
|
<method name="NotifyKeyboardKeysym">
|
|
<arg name="keysym" type="u" direction="in" />
|
|
<arg name="state" type="b" direction="in" />
|
|
</method>
|
|
|
|
<!--
|
|
NotifyPointerButton:
|
|
|
|
A pointer button was pressed or released
|
|
-->
|
|
<method name="NotifyPointerButton">
|
|
<arg name="button" type="i" direction="in" />
|
|
<arg name="state" type="b" direction="in" />
|
|
</method>
|
|
|
|
<!--
|
|
NotifyPointerAxis:
|
|
|
|
A smooth pointer axis event notification. Relative motion deltas are to be
|
|
interpreted as pixel movement of a standardized mouse.
|
|
|
|
Additionally to the smooth pointer axis event notification, an emulated
|
|
discrete pointer axis event notification is emitted based on the submitted
|
|
accumulated smooth scrolling steps.
|
|
The base for these emulated discrete pointer axis event is the discrete step
|
|
with the value 10.0.
|
|
This means that for a delta dx (or dy) with the value 10.0 one emulated
|
|
discrete scrolling event is emitted.
|
|
For a high resolution smooth pointer axis event, a smaller value is submitted
|
|
for each scrolling step.
|
|
This means: For a double resolution mouse wheel one emulated discrete event
|
|
is emitted for 2 smooth pointer axis events with each having the value 5.0.
|
|
|
|
Possible @flags:
|
|
1: finish - scroll motion was finished (e.g. fingers lifted)
|
|
2: source_wheel - The scroll event is originated by a mouse wheel.
|
|
4: source_finger - The scroll event is originated by one or more fingers on
|
|
the device (eg. touchpads).
|
|
8: source_continuous - The scroll event is originated by the motion of some
|
|
device (eg. a scroll button is set).
|
|
|
|
Maximum one of the @flags 'source_wheel', 'source_finger',
|
|
'source_continuous' may be specified.
|
|
If no source flag is specified, `source_finger` is assumed.
|
|
-->
|
|
<method name="NotifyPointerAxis">
|
|
<arg name="dx" type="d" direction="in" />
|
|
<arg name="dy" type="d" direction="in" />
|
|
<arg name="flags" type="u" direction="in" />
|
|
</method>
|
|
|
|
<!--
|
|
NotifyPointerAxisDiscrete:
|
|
|
|
A discrete pointer axis event notification
|
|
-->
|
|
<method name="NotifyPointerAxisDiscrete">
|
|
<arg name="axis" type="u" direction="in" />
|
|
<arg name="steps" type="i" direction="in" />
|
|
</method>
|
|
|
|
<!--
|
|
NotifyPointerMotionRelative:
|
|
|
|
A relative pointer motion event notification
|
|
-->
|
|
<method name="NotifyPointerMotionRelative">
|
|
<arg name="dx" type="d" direction="in" />
|
|
<arg name="dy" type="d" direction="in" />
|
|
</method>
|
|
|
|
<!--
|
|
NotifyPointerMotionAbsolute:
|
|
|
|
A absolute pointer motion event notification
|
|
-->
|
|
<method name="NotifyPointerMotionAbsolute">
|
|
<arg name="stream" type="s" direction="in" />
|
|
<arg name="x" type="d" direction="in" />
|
|
<arg name="y" type="d" direction="in" />
|
|
</method>
|
|
|
|
<!--
|
|
NotifyTouchDown:
|
|
|
|
A absolute pointer motion event notification
|
|
-->
|
|
<method name="NotifyTouchDown">
|
|
<arg name="stream" type="s" direction="in" />
|
|
<arg name="slot" type="u" direction="in" />
|
|
<arg name="x" type="d" direction="in" />
|
|
<arg name="y" type="d" direction="in" />
|
|
</method>
|
|
|
|
<!--
|
|
NotifyTouchMotion:
|
|
|
|
A absolute pointer motion event notification
|
|
-->
|
|
<method name="NotifyTouchMotion">
|
|
<arg name="stream" type="s" direction="in" />
|
|
<arg name="slot" type="u" direction="in" />
|
|
<arg name="x" type="d" direction="in" />
|
|
<arg name="y" type="d" direction="in" />
|
|
</method>
|
|
|
|
<!--
|
|
NotifyTouchUp:
|
|
|
|
A absolute pointer motion event notification
|
|
-->
|
|
<method name="NotifyTouchUp">
|
|
<arg name="slot" type="u" direction="in" />
|
|
</method>
|
|
|
|
<!--
|
|
EnableClipboard:
|
|
@options: Options for the clipboard
|
|
|
|
Available @options include:
|
|
|
|
* "mime-types" (as): List of mime types, for which the clipboard of the
|
|
remote desktop client has content.
|
|
Each mime-type is in string form, e.g. "image/jpeg",
|
|
"text/plain", etc..
|
|
If this list is included in @options, then this call
|
|
is equivalent to calling 'EnableClipboard' and
|
|
'SetSelection' atomically.
|
|
|
|
Enables the clipboard for the remote desktop client which will allow it
|
|
to call the methods 'SetSelection', 'DisableClipboard', 'SelectionWrite',
|
|
'SelectionWriteDone', 'SelectionRead'.
|
|
The 'SelectionOwnerChanged' signal will also be emitted when the
|
|
selection owner changes to inform the API user of new clipboard mime
|
|
types, and the 'SelectionTransfer' signal will be emitted to request the
|
|
advertised clipboard content of a mime type.
|
|
-->
|
|
<method name="EnableClipboard">
|
|
<arg name="options" type="a{sv}" direction="in" />
|
|
</method>
|
|
|
|
<!--
|
|
DisableClipboard:
|
|
|
|
Unregisters all clipboard types that were advertised by the
|
|
remote desktop client.
|
|
The 'SelectionOwnerChanged' or 'SelectionTransfer' signals will not be
|
|
emitted any more.
|
|
Any 'SelectionTransfer' signals that weren't answered yet with a
|
|
'SelectionWriteDone' call, will be answered with a 'SelectionWriteDone'
|
|
call where 'success' is 'false'.
|
|
-->
|
|
<method name="DisableClipboard" />
|
|
|
|
<!--
|
|
SetSelection:
|
|
@options: Options for the clipboard selection
|
|
|
|
Available @options include:
|
|
|
|
* "mime-types" (as): List of mime types, for which the clipboard of the
|
|
remote desktop client has content.
|
|
Each mime-type is in string form, e.g. "image/jpeg",
|
|
"text/plain", etc..
|
|
|
|
Sets the owner of the clipboard formats in 'mime-types' in @options to
|
|
the remote desktop client, i.e. the remote desktop client has data for
|
|
these advertised clipboard formats.
|
|
-->
|
|
<method name="SetSelection">
|
|
<arg name="options" type="a{sv}" direction="in" />
|
|
</method>
|
|
|
|
<!--
|
|
SelectionWrite:
|
|
@serial: The serial of the request where this answer is directed to
|
|
@fd: The file descriptor where the data will be written to
|
|
|
|
Answer to 'SelectionTransfer' signal. Contains the fd where the clipboard
|
|
content will be written to.
|
|
-->
|
|
<method name="SelectionWrite">
|
|
<arg name="serial" type="u" direction="in" />
|
|
<annotation name="org.gtk.GDBus.C.UnixFD" value="true"/>
|
|
<arg name="fd" type="h" direction="out" />
|
|
</method>
|
|
|
|
<!--
|
|
SelectionWriteDone:
|
|
@serial: The serial of the request where this answer is directed to
|
|
@success: A boolean which indicates whether the transfer of the clipboard
|
|
data was successful ('true') or not ('false').
|
|
|
|
Notifies that the transfer of the clipboard data has either completed
|
|
successfully, or failed.
|
|
-->
|
|
<method name="SelectionWriteDone">
|
|
<arg name="serial" type="u" direction="in" />
|
|
<arg name="success" type="b" direction="in" />
|
|
</method>
|
|
|
|
<!--
|
|
SelectionRead:
|
|
@mime_type: The mime-type string of the requested format
|
|
@fd: The file descriptor where the data will be written to
|
|
|
|
Transfer the clipboard content given the specified mime type to the
|
|
method caller via a file descriptor.
|
|
It is the callee that creates the file descriptor.
|
|
-->
|
|
<method name="SelectionRead">
|
|
<arg name="mime_type" type="s" direction="in" />
|
|
<annotation name="org.gtk.GDBus.C.UnixFD" value="true"/>
|
|
<arg name="fd" type="h" direction="out" />
|
|
</method>
|
|
|
|
<!--
|
|
SelectionOwnerChanged:
|
|
@options: Options for the clipboard selection
|
|
|
|
Available @options include:
|
|
|
|
* "mime-types" (as): List of mime types, for which the clipboard of the
|
|
remote desktop client has content.
|
|
Each mime-type is in string form, e.g. "image/jpeg",
|
|
"text/plain", etc..
|
|
* "session-is-owner" (b): 'true', if the remote desktop clients clipboard
|
|
is already owner of these types, else 'false'.
|
|
|
|
Informs the remote desktop client of new clipboard formats that are
|
|
available.
|
|
-->
|
|
<signal name="SelectionOwnerChanged">
|
|
<arg name="options" type="a{sv}" direction="in" />
|
|
</signal>
|
|
|
|
<!--
|
|
SelectionTransfer:
|
|
@mime_type: The mime-type string of the requested format
|
|
@serial: The serial, that the answer of this particular request, MUST use
|
|
|
|
Requests the data for a clipboard format from the remote desktop client.
|
|
MUST NOT be called when the remote desktop clients clipboard is (already)
|
|
disabled.
|
|
-->
|
|
<signal name="SelectionTransfer">
|
|
<arg name="mime_type" type="s" direction="in" />
|
|
<arg name="serial" type="u" direction="in" />
|
|
</signal>
|
|
|
|
<property name="CapsLockState" type="b" access="read" />
|
|
<property name="NumLockState" type="b" access="read" />
|
|
|
|
</interface>
|
|
|
|
</node>
|