1
0
Fork 0
mutter-performance-source/data/dbus-interfaces/org.gnome.Mutter.RemoteDesktop.xml
Pascal Nowack ecd45d28ac remote-desktop: Unify codestyle in API
The code style in the remote-desktop API is currently a mess.
While, the overall code style in mutter and gnome-remote-desktop is to
use spaces as tabulator, the remote-desktop API is mixed with both
spaces as tabulators and actual tabulators.
In addition to that, the code style in the XDG desktop portal APIs uses
spaces as tabulators as well.

To unify the code style, replace all actual tabulators with spaces.

Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/2255>
2022-01-25 10:49:12 +00:00

353 lines
12 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>