mirror of
https://github.com/brl/mutter.git
synced 2024-11-27 18:40:40 -05:00
67acf99314
Will be used by remote desktop services that want to try to affect the end result of these. We cannot let it set these directly, as these needs to be done using virtual key events to not cause issues in all the XKB state tracking, so remote desktop services try to deal with this themself if they need to. Closes: https://gitlab.gnome.org/GNOME/mutter/-/issues/1342 Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1739>
352 lines
11 KiB
XML
352 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>
|