mirrors/labwc
1
0
Fork 0
mirror of https://github.com/labwc/labwc.git synced 2026-03-06 01:40:15 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs: add mouse emulation section

Browse source 
Also clarify tablet button mapping restrictions.
This commit is contained in:
Jens Peters 2024-04-24 20:36:51 +02:00 • committed by Consolatis
parent 6d05bed883
commit 6a9564c18c
2 changed files with 32 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

28
docs/labwc-config.5.scd
View file

@ -617,7 +617,7 @@ extending outward from the snapped edge.
## TABLET ## TABLET
``` ```
<tablet mapToOutput="" rotate="0"> <tablet mapToOutput="" rotate="0" mouseEmulation="no">
<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" />
@ -657,21 +657,35 @@ extending outward from the snapped edge.
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 mouseEmulation="" />* [yes|no]
The tablet can be forced to always use mouse emulation. This prevents
tablet specific restrictions, e.g. no support for drag-and-drop, but
also omits tablet specific features like reporting pen pressure.
*<tablet><map button="" to="" />* *<tablet><map button="" to="" />*
Tablet buttons emulate regular mouse buttons. If not specified Pen buttons emulate regular mouse buttons. If not specified
otherwise, the tip (Tip) is mapped to left mouse click, the first pen otherwise, the first pen button (Stylus) is mapped to right mouse
button (Stylus) is mapped to right mouse button click and the second pen button click and the second pen button (Stylus2) emulates a middle
button (Stylus2) emulates a middle mouse button click. mouse button click. For mouse emulation, the tip (Tip) is mapped to
left mouse click.
Supported map *buttons* are: Supported map *buttons* are:
- Tip - Tip (mouse emulation only)
- Stylus - Stylus
- Stylus2 - Stylus2
- Stylus3 - Stylus3
- Pad - Pad
- Pad2..Pad9 - Pad2..Pad9
See mouse section above for all supported *to* mouse buttons. The stylus buttons (Stylus, Stylus2 and Stylus3) can be mapped *to*:
- Right
- Middle
- Side
The tablet pad buttons can be mapped to all available mouse buttons.
When using mouse emulation only, the tip and stylus buttons can also be
mapped to all available mouse buttons.
See mouse section above for all supported mouse buttons.
## LIBINPUT ## LIBINPUT

15
docs/rc.xml.all
View file

@ -497,11 +497,18 @@
height are omitted or default (0.0), width/height will be set to height are omitted or default (0.0), width/height will be set to
the remaining width/height seen from top/left. the remaining width/height seen from top/left.
Tablet buttons emulate regular mouse buttons. The tablet *button* can The tablet can be forced to always use mouse emulation. This prevents
be set to any of [Tip|Stylus|Stylus2|Stylus3|Pad|Pad2|Pad3|..|Pad9]. tablet specific restrictions, e.g. no support for drag&drop, but also
Valid *to* mouse buttons are [Left|Right|Middle]. omits tablet specific features like reporting pen pressure.
Pen buttons emulate regular mouse buttons. The pen *button* can be any
of [Stylus|Stylus2|Stylus3] and can be mapped to mouse buttons
[Right|Middle|Side]. Tablet pad buttons [Pad|Pad2|Pad3|..|Pad9] also
emulate regular mouse buttons and can be mapped to any mouse button.
When using mouse emulation, the pen tip [tip] and the stylus buttons
can be set to any available mouse button [Left|Right|Middle|..|Task].
--> -->
<tablet mapToOutput="" rotate="0"> <tablet mapToOutput="" rotate="0" mouseEmulation="no">
<!-- 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" />