docs: extend tablet section

Also change order to be in line with the xml elements.
This commit is contained in:
Jens Peters 2024-01-09 06:58:42 +01:00 committed by Johan Malm
parent 17e15ed987
commit cc8f4f943a
2 changed files with 20 additions and 11 deletions

View file

@ -448,7 +448,7 @@ windows using the mouse.
## TABLET ## TABLET
``` ```
<tablet rotate="0"> <tablet mapToOutput="" rotate="0">
<area top="0.0" left="0.0" width="0.0" height="0.0"> <area top="0.0" left="0.0" width="0.0" height="0.0">
<map button="Tip" to="Left" /> <map button="Tip" to="Left" />
<map button="Stylus" to="Right" /> <map button="Stylus" to="Right" />
@ -456,6 +456,16 @@ windows using the mouse.
</tablet> </tablet>
``` ```
*<tablet mapToOutput="" />*
The tablet cursor movement can be restricted to a single output.
If the output name is left empty or the output does not exists, the
tablet will span all outputs.
*<tablet rotate="" />* [0|90|180|270]
The tablet orientation can be changed in 90 degree steps. Default is
no rotation (0). Rotation will be applied after applying tablet area
transformation.
*<tablet><area top="mm" left="mm" width="mm" height="mm" />* *<tablet><area top="mm" left="mm" width="mm" height="mm" />*
By default the complete tablet area is mapped to the full output. By default the complete tablet area is mapped to the full output.
The *area* element can be used to truncate the active area of the The *area* element can be used to truncate the active area of the
@ -475,11 +485,6 @@ windows using the mouse.
additionally setting top to "12.5", the active area is centered additionally setting top to "12.5", the active area is centered
vertically on the tablet surface. vertically on the tablet surface.
*<tablet rotate="" />* [0|90|180|270]
The tablet orientation can be changed in 90 degree steps. Default is
no rotation (0). Rotation will be applied after applying tablet area
transformation.
*<tablet><map button="" to="" />* *<tablet><map button="" to="" />*
Tablet buttons emulate regular mouse buttons. If not specified otherwise, Tablet buttons emulate regular mouse buttons. If not specified otherwise,
the tip (Tip) is mapped to left mouse click, the first pen button (Stylus) the tip (Tip) is mapped to left mouse click, the first pen button (Stylus)

View file

@ -395,20 +395,24 @@
</mouse> </mouse>
<!-- <!--
The active tablet area can be specified by setting the *top*/*left* The tablet cursor movement can be restricted to a single output.
coordinate (in mm) and/or *width*/*height* (in mm). If width or If output is left empty or the output does not exists, the tablet
height are omitted or default (0.0), width/height will be set to will span all outputs.
the remaining width/height seen from top/left.
The tablet orientation can be changed in 90 degree steps, thus The tablet orientation can be changed in 90 degree steps, thus
*rotate* can be set to [0|90|180|270]. Rotation will be applied *rotate* can be set to [0|90|180|270]. Rotation will be applied
after applying tablet area transformation. after applying tablet area transformation.
The active tablet area can be specified by setting the *top*/*left*
coordinate (in mm) and/or *width*/*height* (in mm). If width or
height are omitted or default (0.0), width/height will be set to
the remaining width/height seen from top/left.
Tablet buttons emulate regular mouse buttons. The tablet *button* can Tablet buttons emulate regular mouse buttons. The tablet *button* can
be set to any of [Tip|Stylus|Stylus2|Stylus3|Pad|Pad2|Pad3|..|Pad9]. be set to any of [Tip|Stylus|Stylus2|Stylus3|Pad|Pad2|Pad3|..|Pad9].
Valid *to* mouse buttons are [Left|Right|Middle]. Valid *to* mouse buttons are [Left|Right|Middle].
--> -->
<tablet rotate="0"> <tablet mapToOutput="" rotate="0">
<!-- Active area dimensions are in mm --> <!-- Active area dimensions are in mm -->
<area top="0.0" left="0.0" width="0.0" height="0.0"> <area top="0.0" left="0.0" width="0.0" height="0.0">
<map button="Tip" to="Left" /> <map button="Tip" to="Left" />