Differences

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

--- ubuntu:mouse:determine_the_mouse_properties [2021/10/26 12:45] – peter
+++ ubuntu:mouse:determine_the_mouse_properties [2021/10/26 13:01] (current) – peter
@@ Line 84: / Line 84: @@
 ^Property^Description^
-|Coordinate Transformation Matrix|This is a 3x3 coordinate transformation matrix.  It is encoded in row-major order, so the matrix would look like the following:|
+|Coordinate Transformation Matrix|This is a 3x3 coordinate transformation matrix.  See [[https://wiki.ubuntu.com/X/InputCoordinateTransformation|Coordinate Transformation Matrix]]. It is encoded in row-major order, so the matrix would look like the following:|
 |:::|⎡ 1 0 0 ⎤|
 |:::|⎜ 0 1 0 ⎥|
@@ Line 93: / Line 93: @@
 |libinput Button Scrolling Button|1 32-bit value. Sets the button number to use for button scrolling. This setting is independent of the scroll method, to enable button scrolling the method must be set to button-scrolling and a valid button must be set.|
 |libinput Button Scrolling Button Lock Enabled|1 boolean value. If true, the scroll button lock is enabled.  This setting is independent of the scroll method or the scroll button, to enable button scrolling the method must be set to button-scrolling and a valid button must be set.|
-|libinput Calibration Matrix|9 32-bit float values, representing a 3x3 calibration matrix, order is row 1, row 2, row 3|
+|libinput Calibration Matrix|9 32-bit float values, representing a 3x3 calibration matrix, order is row 1, row 2, row 3.|
 |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 107: / Line 107: @@
 |libinput Send Events Modes Available|2 boolean values (8 bit, 0 or 1), in order "disabled" and "disabled-on-external-mouse". Indicates which send-event modes are available on this device.|
 |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 TABLET TOOL PRESSURE CURVE.|
+|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 120: / Line 120: @@
     * It the property is not showing, usually mean that this same option can not be changed or configured.
+</WRAP>
+----
+===== 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>
@@ Line 142: / 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 150: / Line 191: @@
 https://wayland.freedesktop.org/libinput/doc/
+https://wiki.ubuntu.com/X/InputCoordinateTransformation
+https://www.mankier.com/4/libinput#Configuration_Details