Skip to content

Commit eaa2cc1

Browse files
committed
Add information to detect Linux tablets/pens/styluses
1 parent cc66b8b commit eaa2cc1

File tree

2 files changed

+35
-2
lines changed

2 files changed

+35
-2
lines changed

tablet.md

Lines changed: 33 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
11
# Tablet
22

3+
## Windows
4+
35
Since Windows 8, Microsoft introduced a new API to use your tablet
4-
with Windows program: the pointer API. Since Aseprite v1.2.19.1 you
6+
with Windows programs: the pointer API. Since Aseprite v1.2.19.1 you
57
can configure what API do you prefer to use:
68

79
![Tablet section](tablet/tablet.png)
@@ -19,6 +21,36 @@ can configure what API do you prefer to use:
1921
Pressing the *OK*/*Apply* buttons will change the tablet settings
2022
immediately, there is no need to restart the program.
2123

24+
## Linux/X11
25+
26+
It looks like tablet/stylus/pen devices are detected by device
27+
name/brand name on X11, instead by device capabilities.
28+
29+
There are some pre-defined IDs to detect a stylus, but it might not be
30+
enough (as it's indicated in
31+
[#3176](https://github.com/aseprite/aseprite/issues/3176))
32+
33+
If Aseprite doesn't detect the pressure of your pen, since **Aseprite
34+
v1.2.35** you can try to do these steps:
35+
36+
1. Close Aseprite
37+
2. Run `xinput --list` in a terminal/console
38+
3. Check the output and see what device could be the one related to
39+
your stylus ([output example](https://github.com/aseprite/aseprite/issues/3176#issuecomment-1111799083))
40+
4. Open `aseprite.ini` file in the [preferences folder](preferences-folder.md)
41+
5. Search the `[general]` section and add the name of your stylus in a
42+
`x11_stylus_id` option (the name must appears just like in the
43+
first column of the `xinput --list` output):
44+
```
45+
[general]
46+
x11_stylus_id = Your Stylus Name
47+
```
48+
6. Save the file and start Aseprite
49+
50+
Please inform us if this does work for your case adding a new comment
51+
in [#3176](https://github.com/aseprite/aseprite/issues/3176)
52+
indicating the name of your device.
53+
2254
---
2355

2456
**SEE ALSO**

troubleshooting.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,8 @@ In case of crash, you might be able to [recover some sprites](data-recovery.md).
2525

2626
## Tablet Problems
2727

28-
In case your tablet doesn't work, please check the [tablet](tablet.md) page.
28+
In case your tablet (or the pressure of your tablet) doesn't work,
29+
please check the [tablet](tablet.md) page.
2930

3031
## macOS Rendering Problems
3132

0 commit comments

Comments
 (0)