From: SnowNF <SnowNF@outlook.com>
Date: Wed, 20 Mar 2024 04:17:21 +0000 (+0800)
Subject: docs: add calibrationMatrix section for libinput
X-Git-Url: https://git.mdlowis.com/?a=commitdiff_plain;h=e311ff6466026574e3c40f79e132fc9ba3d185fd;p=proto%2Flabwc.git

docs: add calibrationMatrix section for libinput
---

diff --git a/docs/labwc-config.5.scd b/docs/labwc-config.5.scd
index d21db03b..ee734433 100644
--- a/docs/labwc-config.5.scd
+++ b/docs/labwc-config.5.scd
@@ -629,6 +629,7 @@ extending outward from the snapped edge.
     <disableWhileTyping></disableWhileTyping>
     <clickMethod></clickMethod>
     <sendEventsMode></sendEventsMode>
+    <calibrationMatrix></calibrationMatrix>
   </device>
 </libinput>
 ```
@@ -734,6 +735,24 @@ extending outward from the snapped edge.
 
 	By default, this setting is not configured.
 
+*<libinput><device><calibrationMatrix>* [six float values split by space]
+	Apply the 3x3 transformation matrix to absolute device coordinates. This
+	matrix has no effect on relative events.
+
+	Given a 6-element array [a b c d e f], the matrix is applied as
+	[ a  b  c ]   [ x ]
+	[ d  e  f ] * [ y ]
+	[ 0  0  1 ]   [ 1 ]
+
+	The most common matrices are:
+	90 deg cw:		180 deg cw:		270 deg cw: 	reflect along y axis:
+	[ 0 -1 1]		[ -1  0 1]		[  0 1 0 ] 		[ -1 0 1 ]
+	[ 1  0 0]		[  0 -1 1]		[ -1 0 1 ]		[  1 0 0 ]
+	[ 0  0 1]		[  0  0 1]		[  0 0 1 ]		[  0 0 1 ]
+
+	visit https://wayland.freedesktop.org/libinput/doc/latest/absolute-axes.html#calibration-of-absolute-devices
+	for more information
+
 ## WINDOW RULES
 
 Two types of window rules are supported, actions and properties. They are
diff --git a/docs/rc.xml.all b/docs/rc.xml.all
index 546ee010..4de36af1 100644
--- a/docs/rc.xml.all
+++ b/docs/rc.xml.all
@@ -504,9 +504,7 @@
       - tapButtonMap [lrm|lmr]
       - clickMethod [none|buttonAreas|clickfinger]
       - sendEventsMode [yes|no|disabledOnExternalMouse]
-      - calibrationMatrix [six float values split by space],
-      visit https://wayland.freedesktop.org/libinput/doc/latest/absolute-axes.html#calibration-of-absolute-devices
-      for more information
+      - calibrationMatrix [six float values split by space]
   -->
   <libinput>
     <device category="default">