Changeset View
Changeset View
Standalone View
Standalone View
src/client/protocols/fake-input.xml
Show All 10 Lines | 3 | <copyright><![CDATA[ | |||
---|---|---|---|---|---|
11 | This program is distributed in the hope that it will be useful, | 11 | This program is distributed in the hope that it will be useful, | ||
12 | but WITHOUT ANY WARRANTY; without even the implied warranty of | 12 | but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | 13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | ||
14 | GNU Lesser General Public License for more details. | 14 | GNU Lesser General Public License for more details. | ||
15 | 15 | | |||
16 | You should have received a copy of the GNU Lesser General Public License | 16 | You should have received a copy of the GNU Lesser General Public License | ||
17 | along with this program. If not, see <http://www.gnu.org/licenses/>. | 17 | along with this program. If not, see <http://www.gnu.org/licenses/>. | ||
18 | ]]></copyright> | 18 | ]]></copyright> | ||
19 | <interface name="org_kde_kwin_fake_input" version="1"> | 19 | <interface name="org_kde_kwin_fake_input" version="2"> | ||
graesslin: when you add new requests to a protocol you need to increase the version number. This requires… | |||||
20 | <description summary="Fake input manager"> | 20 | <description summary="Fake input manager"> | ||
21 | This interface allows other processes to provide fake input events. | 21 | This interface allows other processes to provide fake input events. | ||
22 | Purpose is on the one hand side to provide testing facilities like XTest on X11. | 22 | Purpose is on the one hand side to provide testing facilities like XTest on X11. | ||
23 | But also to support use case like kdeconnect's mouse pad interface. | 23 | But also to support use case like kdeconnect's mouse pad interface. | ||
24 | 24 | | |||
25 | A compositor should not trust the input received from this interface. | 25 | A compositor should not trust the input received from this interface. | ||
26 | Clients should not expect that the compositor honors the requests from this | 26 | Clients should not expect that the compositor honors the requests from this | ||
27 | interface. | 27 | interface. | ||
Show All 16 Lines | |||||
44 | <request name="button"> | 44 | <request name="button"> | ||
45 | <arg name="button" type="uint"/> | 45 | <arg name="button" type="uint"/> | ||
46 | <arg name="state" type="uint"/> | 46 | <arg name="state" type="uint"/> | ||
47 | </request> | 47 | </request> | ||
48 | <request name="axis"> | 48 | <request name="axis"> | ||
49 | <arg name="axis" type="uint"/> | 49 | <arg name="axis" type="uint"/> | ||
50 | <arg name="value" type="fixed"/> | 50 | <arg name="value" type="fixed"/> | ||
51 | </request> | 51 | </request> | ||
52 | <request name="touch_down" since="2"> | ||||
53 | <description summary="touch down event"> | ||||
54 | A client should use this request to send touch down event at specific | ||||
55 | co-ordinates. | ||||
56 | </description> | ||||
57 | <arg name="id" type="uint" description="unique id for touch down event"/> | ||||
58 | <arg name="x" type="fixed" description="x coordinate for touch down event"/> | ||||
59 | <arg name="y" type="fixed" description="y coordinate for touch down event"/> | ||||
60 | </request> | ||||
61 | <request name="touch_motion" since="2"> | ||||
62 | <description summary="touch motion event"> | ||||
63 | A client should use this request to send touch motion to specific position. | ||||
64 | </description> | ||||
65 | <arg name="id" type="uint" description="unique id for touch motion event"/> | ||||
66 | <arg name="x" type="fixed" description="x coordinate for touch motion event"/> | ||||
67 | <arg name="y" type="fixed" description="y coordinate for touch motion event"/> | ||||
68 | </request> | ||||
if you have a new enough wayland-scanner installed this should generate errors because it expects documentation. I'm aware that the existing interface is missing documentation, but I think for new code we should make sure that wayland-scanner is happy. graesslin: if you have a new enough wayland-scanner installed this should generate errors because it… | |||||
69 | <request name="touch_up" since="2"> | ||||
70 | <description summary="touch up event"> | ||||
71 | A client should use this request to send touch up event. | ||||
72 | </description> | ||||
73 | <arg name="id" type="uint" description="unique id for touch up event"/> | ||||
74 | </request> | ||||
75 | <request name="touch_cancel" since="2"> | ||||
76 | <description summary="touch cancel event"> | ||||
77 | A client should use this request to cancel the current | ||||
78 | touch event. | ||||
79 | </description> | ||||
80 | </request> | ||||
81 | <request name="touch_frame" since="2"> | ||||
82 | <description summary="touch frame event"> | ||||
83 | A client should use this request to send touch frame event. | ||||
84 | </description> | ||||
85 | </request> | ||||
52 | </interface> | 86 | </interface> | ||
53 | </protocol> | 87 | </protocol> |
when you add new requests to a protocol you need to increase the version number. This requires changes at a few more places. For reference on what needs to be changed check D1417