mirror of
https://gitlab.freedesktop.org/libinput/libinput.git
synced 2025-12-20 04:30:06 +01:00
9e37bc0cfa
This patch adds support for Lua scripts to modify evdev devices and
event frames before libinput sees those events.
Plugins in Lua are sandboxed and restricted in what they can do: no IO,
no network, not much of anything else.
A plugin is notified about a new device before libinput handles it and
it can thus modify that device (changes are passed through to our libevdev
context). A plugin can then also connect an evdev frame handler which
gives it access to the evdev frames before libinput processes them. The
example plugin included shows how to swap left/right mouse buttons:
libinput:register({1})
function frame(device, frame)
for _, v in ipairs(frame.events) do
if v.usage == evdev.BTN_RIGHT then
v.usage = evdev.BTN_LEFT
elseif v.usage == evdev.BTN_LEFT then
v.usage = evdev.BTN_RIGHT
end
end
return frame
end
function device_new(plugin, device)
local usages = device:usages()
if usages[evdev.BTN_LEFT] and usages[evdev.BTN_RIGHT] then
device:connect("evdev-frame", frame)
end
end
libinput:connect("new-evdev-device", device_new)
A few other example plugins are included in this patch
Part-of: <https://gitlab.freedesktop.org/libinput/libinput/-/merge_requests/1192>
74 lines
2.1 KiB
ReStructuredText
74 lines
2.1 KiB
ReStructuredText
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
:hidden:
|
|
|
|
what-is-libinput
|
|
features
|
|
configuration
|
|
building
|
|
faqs
|
|
reporting-bugs
|
|
troubleshooting
|
|
contributing
|
|
development
|
|
lua-plugins
|
|
API documentation <@HTTP_DOC_LINK@/api/>
|
|
|
|
|
|
++++++++++++++++++++++++++++++
|
|
libinput
|
|
++++++++++++++++++++++++++++++
|
|
|
|
libinput is a library that provides a full input stack for display servers
|
|
and other applications that need to handle input devices provided by the
|
|
kernel.
|
|
|
|
libinput provides device detection, event handling and abstraction to
|
|
minimize the amount of custom input code the user of libinput need to
|
|
provide the common set of functionality that users expect. Input event
|
|
processing includes scaling touch coordinates, generating
|
|
relative pointer events from touchpads, pointer acceleration, etc.
|
|
|
|
libinput is not used directly by applications. Think of it more as a device
|
|
driver than an application library. See :ref:`what_is_libinput` for more details.
|
|
|
|
--------------------
|
|
Users and Developers
|
|
--------------------
|
|
|
|
Please use the side-bar to navigate through the various documentation items.
|
|
|
|
-----------------
|
|
API documentation
|
|
-----------------
|
|
|
|
The API documentation is available here:
|
|
https://wayland.freedesktop.org/libinput/doc/latest/api/
|
|
|
|
.. note:: This documentation is generally only needed by authors of Wayland
|
|
compositors or other developers dealing with input events directly.
|
|
|
|
-------
|
|
License
|
|
-------
|
|
|
|
libinput is licensed under the MIT license
|
|
|
|
.. code-block:: none
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a
|
|
copy of this software and associated documentation files (the "Software"),
|
|
to deal in the Software without restriction, including without limitation
|
|
the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
and/or sell copies of the Software, and to permit persons to whom the
|
|
Software is furnished to do so, subject to the following conditions: [...]
|
|
|
|
See the
|
|
`COPYING <https://gitlab.freedesktop.org/libinput/libinput/tree/master/COPYING>`_
|
|
file for the full license information.
|
|
|
|
.....
|
|
About
|
|
.....
|
|
Documentation generated from |git_version|
|