Differences

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

--- ubuntu:mouse:determine_the_mouse_properties [2021/10/26 12:39] – peter
+++ ubuntu:mouse:determine_the_mouse_properties [2021/10/26 13:01] (current) – peter
@@ Line 82: / Line 82: @@
 ===== Descriptions of the Mouse Properties =====
-libinput exports runtime-configurable options as properties. If a property listed below is not available, the matching configuration option is not available on the device. This however does not imply that the feature is not available on the device. The following properties are provided by the libinput driver.
 ^Property^Description^
+|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 ⎥|
+|:::|⎣ 0 0 1 ⎦|
 |libinput Accel Profiles Available|2 boolean values (8 bit, 0 or 1), in order "adaptive", "flat". Indicates which acceleration profiles are available on this device.|
 |libinput Accel Profile Enabled|2 boolean values (8 bit, 0 or 1), in order "adaptive", "flat". Indicates which acceleration profile is currently enabled on this device.|
@@ Line 91: / 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 105: / 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 114: / Line 116: @@
 <WRAP info>
 **NOTE:**  Most properties have a **libinput <property name> Default** equivalent that indicates the default value for this setting on this device.
+  * If a property is not listed against the device, does not imply that the feature is not available on the device.
+    * 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 136: / 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 144: / Line 191: @@
 https://wayland.freedesktop.org/libinput/doc/
+https://wiki.ubuntu.com/X/InputCoordinateTransformation
+https://www.mankier.com/4/libinput#Configuration_Details