Differences

This shows you the differences between two versions of the page.

--- ubuntu:mouse:determine_the_mouse_properties [2021/10/26 12:55] – [Descriptions of the Mouse Properties] peter
+++ ubuntu:mouse:determine_the_mouse_properties [2021/10/26 13:01] (current) – peter
@@ Line 96: / Line 96: @@
 |libinput Click Methods Available|2 boolean values (8 bit, 0 or 1), in order "buttonareas", "clickfinger". Indicates which click methods are available on this device.|
 |libinput Click Methods Enabled|2 boolean values (8 bit, 0 or 1), in order "buttonareas", "clickfinger". Indicates which click methods are enabled on this device.|
-|libinput Drag Lock Buttons|Either one 8-bit value specifying the meta drag lock button, or a list of button pairs. See section Button Drag Lock for details.|
+|libinput Drag Lock Buttons|Either one 8-bit value specifying the meta drag lock button, or a list of button pairs. See section below **Button Drag Lock** for details.|
 |libinput Horizontal Scrolling Enabled|1 boolean value (8 bit, 0 or 1). Indicates whether horizontal scrolling events are enabled or not.|
 |libinput Left Handed Enabled|1 boolean value (8 bit, 0 or 1). Indicates if left-handed mode is enabled or disabled.|
@@ Line 108: / Line 108: @@
 |libinput Send Events Mode Enabled|2 boolean values (8 bit, 0 or 1), in order "disabled" and "disabled-on-external-mouse". Indicates which send-event modes is currently enabled on this device.|
 |libinput Tablet Tool Pressurecurve|4 32-bit float values [0.0 to 1.0]. See section below **Tablet Tool Pressure Curve**.|
-|libinput Tablet Tool Area Ratio|2 32-bit values, corresponding to width and height. Special value 0, 0 resets to the default ratio. See section Tablet Tool Area Ratio for more information.|
+|libinput Tablet Tool Area Ratio|2 32-bit values, corresponding to width and height. Special value 0, 0 resets to the default ratio. See section below **Tablet Tool Area Ratio** for more information.|
 |libinput Tapping Enabled|1 boolean value (8 bit, 0 or 1). 1 enables tapping.|
 |libinput Tapping Button Mapping Enabled|2 boolean value (8 bit, 0 or 1), in order "lrm" and "lmr". Indicates which button mapping is currently enabled on this device.|
@@ Line 124: / Line 124: @@
 ----
+===== Button Drag Lock =====
+Button drag lock holds a button logically down even when the button itself has been physically released since.
+Button drag lock comes in two modes:
+  - **meta mode**:  A meta button click activates drag lock for the next button press of any other button.
+    * A button click in the future will keep that button held logically down until a subsequent click of that same button.
+    * The meta button events themselves are discarded.
+    * A separate meta button click is required each time a drag lock should be activated for a button in the future.
+  - **pairs mode**:  Each button can be assigned a target locking button.
+    * On button click, the target lock button is held logically down until the next click of the same button.
+    * The button events themselves are discarded and only the target button events are sent.
+<WRAP info>
+**NOTE:**  This feature is provided by this driver, not by libinput.
+</WRAP>
+----
 ===== Tablet Tool Pressurecurve =====
@@ Line 143: / Line 162: @@
   * a slightly raised curve (softer) might  be "0.0/0.0 0.0/0.05 0.95/1.0 1.0/1.0".
-This feature is provided by this driver, not by libinput.
+<WRAP info>
+**NOTE:**  This feature is provided by this driver, not by libinput.
+</WRAP>
+----
+===== Tablet Tool Area Ratio =====
+By default, a tablet tool can access the whole sensor area and the tablet area is mapped to the available screen area.
+  * For external tablets, the height:width ratio of the tablet may be different to that of the monitor, causing the skew of input data.
+To avoid this skew of input data, an area ratio may be set to match the ratio of the screen device.
+  * For example, a ratio of 4:3 will reduce the available area of the tablet to the largest available area with a ratio of 4:3.
+  * Events within this area will scale to the tablets announced axis range, the area ratio is thus transparent to the X server.
+  * Any events outside this area will send events equal to the maximum value of that axis.
+  * The area always starts at the devices origin in its current rotation, i.e. it takes left-handed-ness into account.
+<WRAP info>
+**NOTE:**  This feature is provided by this driver, not by libinput.
+</WRAP>
 ----
@@ Line 153: / Line 193: @@
 https://wiki.ubuntu.com/X/InputCoordinateTransformation
+https://www.mankier.com/4/libinput#Configuration_Details