fake_input protocol

org_kde_kwin_fake_input interface version 4

This interface allows other processes to provide fake input events. Purpose is on the one hand side to provide testing facilities like XTest on X11. But also to support use case like kdeconnect's mouse pad interface. A compositor should not trust the input received from this interface. Clients should not expect that the compositor honors the requests from this interface.

Requests

authenticate since version 0

authenticate(application string, reason string)

A client should use this request to tell the compositor why it wants to use this interface. The compositor might use the information to decide whether it wants to grant the request. The data might also be passed to the user to decide whether the application should get granted access to this very privileged interface.

Arguments

Name	Type	Description
application	string	user visible name of the application
reason	string	reason why the application wants to use this interface

pointer_motion since version 0

pointer_motion(delta_x fixed, delta_y fixed)

Arguments

Name	Type	Description
delta_x	fixed
delta_y	fixed

button since version 0

button(button uint, state uint)

Arguments

Name	Type	Description
button	uint
state	uint

axis since version 0

axis(axis uint, value fixed)

Arguments

Name	Type	Description
axis	uint
value	fixed

touch_down since version 2

touch_down(id uint, x fixed, y fixed)

A client should use this request to send touch down event at specific coordinates.

Arguments

Name	Type	Description
id	uint	unique id for touch down event
x	fixed	x coordinate for touch down event
y	fixed	y coordinate for touch down event

touch_motion since version 2

touch_motion(id uint, x fixed, y fixed)

A client should use this request to send touch motion to specific position.

Arguments

Name	Type	Description
id	uint	unique id for touch motion event
x	fixed	x coordinate for touch motion event
y	fixed	y coordinate for touch motion event

touch_up since version 2

touch_up(id uint)

A client should use this request to send touch up event.

Arguments

Name	Type	Description
id	uint	unique id for touch up event

touch_cancel since version 2

touch_cancel()

A client should use this request to cancel the current touch event.

touch_frame since version 2

touch_frame()

A client should use this request to send touch frame event.

pointer_motion_absolute since version 3

pointer_motion_absolute(x fixed, y fixed)

Arguments

Name	Type	Description
x	fixed
y	fixed

keyboard_key since version 4

keyboard_key(button uint, state uint)

Arguments

Name	Type	Description
button	uint
state	uint

SPDX-FileCopyrightText: 2015 Martin Gräßlin SPDX-License-Identifier: LGPL-2.1-or-later