From 5f818a4457c985eaa0065b4826f0e375de95c636 Mon Sep 17 00:00:00 2001
From: samnyan <4137880+samnyan@users.noreply.github.com>
Date: Tue, 21 Apr 2026 12:03:19 +0800
Subject: [PATCH] doc: add usage notes for [touch] config

---
 dist/fgo/segatools.ini | 11 ++++++-----
 doc/config/common.md   | 36 +++++++++++++++++++++++++++++-------
 2 files changed, 35 insertions(+), 12 deletions(-)

diff --git a/dist/fgo/segatools.ini b/dist/fgo/segatools.ini
index b833a1a..b1739f7 100644
--- a/dist/fgo/segatools.ini
+++ b/dist/fgo/segatools.ini
@@ -111,8 +111,9 @@ framed=0
 dpiAware=1
 
 [touch]
-; WinTouch emulation setting.
+; WinTouch emulation setting. (set to 0 for native touchscreens)
 enable=1
+; Enable coordinate remapping (set to 0 if windowed mode cursor offset occurs)
 remap=1
 cursor=1
 
@@ -178,7 +179,7 @@ coin=0x72
 mode=xinput
 
 [xinput]
-; XInput bindings 
+; XInput bindings
 ;
 ; Left Stick           Joystick
 ; Left Stick Click     Reset Camera
@@ -201,13 +202,13 @@ down=0x53
 left=0x41
 right=0x44
 
-; Dash button. Default is the Left Shift, 
+; Dash button. Default is the Left Shift,
 dash=0xA0
 ; Cycle Target button. Default is the F key.
 target=0x46
-; Attack button, Default is the Right Mouse Button. 
+; Attack button, Default is the Right Mouse Button.
 attack=0x02
-; Noble Phantasm button. Default is the Spacebar 
+; Noble Phantasm button. Default is the Spacebar
 np=0x20
 ; Center Camera, Default is the C key
 camera=0x43
diff --git a/doc/config/common.md b/doc/config/common.md
index 3956a65..045f719 100644
--- a/doc/config/common.md
+++ b/doc/config/common.md
@@ -59,7 +59,7 @@ This is required for some games (e.g. Chunithm) but not others (e.g. WACCA).
 
 Default: `1`
 
-Changes the Aime card reader generation, this will also change the LED info 
+Changes the Aime card reader generation, this will also change the LED info
 provided for the game.
 
 - `1`: TN32MSEC003S H/W Ver3.0 / TN32MSEC003S F/W Ver1.2
@@ -198,7 +198,7 @@ resolves to one).
 
 Default: `title`
 
-Leave it as `title` to use the title server returned by ALL.Net. Rewrites 
+Leave it as `title` to use the title server returned by ALL.Net. Rewrites
 the title server hostname for certain games, such as crossbeats REV.
 
 ### `router`
@@ -485,9 +485,9 @@ integer `modelType` setting, but they are combined here for convenience.
 - `ACA`: ALLS UX/HX/MX
 
 `modelType` is one of the following:
-- `1`: Server (SV) 
-- `2`: Satalite (ST) 
-- `3`: Live (LV) 
+- `1`: Server (SV)
+- `2`: Satalite (ST)
+- `3`: Live (LV)
 - `4`: Terminal (TN)
 
 It's safe to assume that every game you'll be playing with these tools will be a Satalite.
@@ -513,7 +513,7 @@ Values are:
 
 Default: `DEVICE\\ca.crt`
 
-Set the billing certificate path. This has to match the one used for the 
+Set the billing certificate path. This has to match the one used for the
 SSL billing server. The DER certificate must fit in 1024 bytes so it must be
 small.
 
@@ -635,6 +635,28 @@ Default `DEVICE\sram.bin`
 
 Path to the storage file for SRAM emulation.
 
+### `[touch]`
+
+Configure WinTouch emulation for mouse input.
+
+#### `enable`
+
+Default: `1`
+
+Enable WinTouch touchscreen emulation for the mouse. Disable to use a native WinTouch-compatible touchscreen.
+
+#### `remap`
+
+Default: `1`
+
+Enable coordinate remapping. Disable this if you running in windowed mode and find the touch position shifted when moving the window.
+
+#### `cursor`
+
+Default: `1`
+
+Display a cursor to indicate touch position.
+
 ## `[vfs]`
 
 Configure Windows path redirection hooks.
@@ -748,7 +770,7 @@ The Windows directory is always excluded from virtualization.
 
 ## `[misc]`
 
-Configure miscellaneous hooks and features. 
+Configure miscellaneous hooks and features.
 
 ### `allowMasterKeyWrite`