mirror of
https://gitlab.freedesktop.org/libinput/libinput.git
synced 2026-02-03 20:30:27 +01:00
read-only mirror of https://gitlab.freedesktop.org/libinput/libinput
6583f4bb53
Move mode control to libinput. This reduces some flexibility on what we can do with modes but makes it a lot easier for anyone to implement modes correctly and have the LEDs apply appropriately, etc. Let's go with the option to make the 95% use-case easy. Note: whether the mode is actually used is up to the caller, e.g. under Windows and OS X the mode only applies to the rings/strips, not the buttons. A tablet pad has 1 or more mode groups, all buttons/ring/strips are assigned to a mode group. That group has a numeric mode index and is hooked to the LEDs. libinput will switch the LEDs accordingly. The mode group is a separate object. This allows for better APIs when it comes to: * checking whether a button/ring/strip is part of a mode group * checking whether a button will trigger a mode transition and in the future potentially: * checking which mode transition will happen * setting which button should change the mode transition * changing what type of mode transition should happen. * moving a button from one mode group to the other This patch adds the basic scaffolding, without any real implementation. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Proofread-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Jason Gerecke <jason.gerecke@wacom.com> Reviewed-by: Carlos Garnacho <carlosg@gnome.org> |
||
|---|---|---|
| doc | ||
| include/linux | ||
| m4 | ||
| src | ||
| test | ||
| tools | ||
| udev | ||
| .gitignore | ||
| .vimdir | ||
| autogen.sh | ||
| CODING_STYLE | ||
| configure.ac | ||
| COPYING | ||
| Makefile.am | ||
| README.txt | ||
/*!@mainpage libinput ======== libinput is a library that handles input devices for display servers and other applications that need to directly deal with input devices. It provides device detection, device handling, input device event processing and abstraction so 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 pointer events from touchpads, pointer acceleration, etc. libinput originates from [weston](http://cgit.freedesktop.org/wayland/weston/), the Wayland reference compositor. Architecture ------------ libinput is not used directly by applications, rather it is used by the xf86-input-libinput X.Org driver or wayland compositors. The typical software stack for a system running Wayland is: @dotfile libinput-stack-wayland.gv Where the Wayland compositor may be Weston, mutter, KWin, etc. Note that Wayland encourages the use of toolkits, so the Wayland client (your application) does not usually talk directly to the compositor but rather employs a toolkit (e.g. GTK) to do so. The simplified software stack for a system running X.Org is: @dotfile libinput-stack-xorg.gv Again, on a modern system the application does not usually talk directly to the X server using Xlib but rather employs a toolkit to do so. Source code ----------- The source code of libinput can be found at: http://cgit.freedesktop.org/wayland/libinput For a list of current and past releases visit: http://www.freedesktop.org/wiki/Software/libinput/ Reporting Bugs -------------- Bugs can be filed in the libinput component of Wayland: https://bugs.freedesktop.org/enter_bug.cgi?product=Wayland&component=libinput Where possible, please provide an [evemu](http://www.freedesktop.org/wiki/Evemu/) recording of the input device and/or the event sequence in question. See @ref reporting_bugs for more info. Documentation ------------- Developer API documentation: http://wayland.freedesktop.org/libinput/doc/latest/modules.html High-level documentation about libinput's features: http://wayland.freedesktop.org/libinput/doc/latest/pages.html License ------- libinput is licensed under the MIT license. > 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](http://cgit.freedesktop.org/wayland/libinput/tree/COPYING) file for the full license information. */