Skip to content

Commit df5f744

Browse files
committed
Add new tablet page and some re-wording for wintab
1 parent 126cf04 commit df5f744

File tree

4 files changed

+54
-15
lines changed

4 files changed

+54
-15
lines changed

tablet.md

+27
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
# Tablet
2+
3+
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
5+
can configure what API do you prefer to use:
6+
7+
![Tablet section](tablet/tablet.png)
8+
9+
* *Windows 8/10 Pointer API*: This option might be enough for most
10+
modern devices, you can give a try how your tablet works with this
11+
(might work better with this option than with Wintab)
12+
* *[Wintab](wintab.md)*: This is the default option at the moment to
13+
support pressure sensitivity on older systems (Windows Vista/7) and
14+
older devices.
15+
* *Wintab (direct packet processing)*: This option might not work well
16+
in some devices, but might be useful in other devices to avoid
17+
losing packets and getting smoother strokes.
18+
19+
Pressing the *OK*/*Apply* buttons will change the tablet settings
20+
immediately, there is no need to restart the program.
21+
22+
---
23+
24+
**SEE ALSO**
25+
26+
[Wintab](wintab.md) |
27+
[Troubleshooting](troubleshooting.md)

tablet/tablet.png

5.27 KB
Loading

troubleshooting.md

+6-1
Original file line numberDiff line numberDiff line change
@@ -23,10 +23,15 @@ You might also try to find your problem on:
2323

2424
In case of crash, you might be able to [recover some sprites](data-recovery.md).
2525

26+
## Tablet Problems
27+
28+
In case your tablet doesn't work, please check the [tablet](tablet.md) page.
29+
2630
---
2731

2832
**SEE ALSO**
2933

3034
[Reset Preferences](reset-preferences.md) |
3135
[Data Recovery](data-recovery.md) |
32-
[Debug](debug.md)
36+
[Debug](debug.md) |
37+
[Tablet](tablet.md)

wintab.md

+21-14
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,31 @@
1-
# WinTab
2-
3-
`WinTab32.dll` is a library/DLL/API used to communicate with your
4-
stylus/tablet (Wacom, etc.). Sometimes, when we load this DLL the
5-
program just hangs or doesn't work properly. We don't know why this
6-
happen, but there are few users experimenting this (maybe a buggy
7-
`WinTab32.dll`, or maybe a buggy Aseprite).
8-
9-
Sometimes the problem is solved reinstalling the driver, sometimes the
10-
problem persists. As a first attempt, if you can execute Aseprite
11-
correctly, you can disable the driver going to *Edit > Preferences > Experimental*:
1+
# Wintab
2+
3+
Wintab (`WinTab32.dll`) is an ancient API created by Wacom to
4+
communicate tablet-like devices with Windows programs. Before Windows 8,
5+
this was the "de facto" standard used to access pressure
6+
information from tablets created by Wacom and other brands. Since
7+
Windows 8, Microsoft introduced a new official API: the Pointer
8+
API/Windows Ink.
9+
10+
Sometimes, when we load this DLL the program just hangs or doesn't
11+
work properly. You might solve this reinstalling drivers or restarting
12+
Windows. If the problem persists one first attempt would be to use the
13+
Pointer API from [Tablet options](tablet.md), or disabling Wintab
14+
usage from *Edit > Preferences > Tablet* (or *Edit > Preferences >
15+
Experimental* in old versions):
1216

1317
![Don't load the WinTab driver](wintab/disable-wintab.png)
1418

19+
## Aseprite doesn't start
20+
1521
If you cannot even start the program, you can execute Aseprite with
1622
the `-disable-wintab` parameter (available since Aseprite v1.2):
1723

1824
"C:\Program Files\Aseprite\Aseprite.exe" -disable-wintab
1925

20-
This will bypass the `WinTab32.dll` loading process. Your stylus might
21-
not work correctly, but at least Aseprite can be executed and used
22-
with your mouse/trackpad.
26+
This will avoid loading `WinTab32.dll` file. Your tablet might not
27+
work correctly, but at least Aseprite can be executed and used with
28+
your mouse/trackpad (or again, you can try the [Windows Pointer API](tablet.md)).
2329

2430
## Steam
2531

@@ -41,4 +47,5 @@ On Steam you can add the `-disable-wintab` option in the Aseprite launch options
4147

4248
**SEE ALSO**
4349

50+
[Tablet](tablet.md) |
4451
[Troubleshooting](troubleshooting.md)

0 commit comments

Comments
 (0)