manual: add touchscreen settings section

commit 444c9ce4bd692f2c992790bc42a40018cc76aed3
Author: Aidan MacDonald <[email protected]>
Date:   Tue Aug 11 12:18:28 2026 +0100

    manual: add touchscreen settings section
    
    Change-Id: I5b9196fb79e7b67a4ac013fe10b8ad462cb8bfa8

diff --git a/manual/configure_rockbox/display_options.tex b/manual/configure_rockbox/display_options.tex
index 4b48b768a9..f8b1344961 100755
--- a/manual/configure_rockbox/display_options.tex
+++ b/manual/configure_rockbox/display_options.tex
@@ -287,4 +287,38 @@
       uses a different codepage and you are getting garbled extended characters
       you should adjust this settings. In most cases sticking to
       ``ISO-8859-1'' would be sufficient.
+%
+  \opt{touchscreen}{
+  \item[Touchscreen Settings.]
+    Options related to touchscreen behavior.
+    \begin{description}
+    \item[Touchscreen Mode.]
+      Rockbox supports two touchscreen modes. \setting{Absolute Point} behaves
+      like a normal touchscreen and allows you to select items by tapping on
+      them directly. \setting{3x3 Grid} divides the touchscreen into thirds to
+      emulate a grid of 9 buttons: eg. tapping on the center of the screen is
+      interpreted as a virtual ``center'' button.
+      \note{Some parts of the UI only support \setting{3x3 Grid} mode and will
+        fall back to it even if \setting{Absolute Point} mode is selected. In
+        particular, \setting{3x3 Grid} mode will be used in the WPS unless the
+        theme supports touch interaction; the default ``Cabbie v2.0'' theme
+        does not include touch support.}
+    \item[Line Padding In Lists.]
+      This option affects the amount of padding added to list entries, which
+      makes them larger on screen and easier to select with a touchscreen.
+      \setting{Auto} will calculate a reasonable amount of padding based on
+      the standard line height and the screen DPI. \setting{Off} disables the
+      feature and will not add any padding. Other values allow you to set the
+      number of pixels of padding to be added to the standard line height.
+    \item[Calibrate.]
+      Allows you to change the touchscreen calibration by touching on three
+      points on the screen to correct for any offset or rotation of the touch
+      overlay compared to the display. This calibration method is useful for
+      older devices that use a physically separate touch overlay panels, which
+      may be slightly mis-aligned to the display.
+    \item[Reset Calibration.]
+      Select this option to clear calibration data set by the
+      \setting{Calibrate} option.
+    \end{description}
+  }
   \end{description}
-- 
rockbox-cvs mailing list
[email protected]
https://lists.haxx.se/mailman/listinfo/rockbox-cvs