> For the complete documentation index, see [llms.txt](https://docs.sevenpens.com/devnotes/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sevenpens.com/devnotes/misc/krita-and-qt/qt-pen-api-implementation-notes.md).

# Qt pen api implementation notes

## Overview

The key Qt pieces are:

* `QNativeInterface::Private::QWindowsApplication` 
  * Declares `isWinTabEnabled()` 
  * calls `setWinTabEnabled(bool)`. ([Code Browser](https://codebrowser.dev/qt6/qtbase/src/gui/kernel/qguiapplication_p.h.html?utm_source=chatgpt.com))
* The Windows platform plugin
  *  `QWindowsApplication::setWinTabEnabled()` is implemented by asking `QWindowsContext` to either `initTablet()` or `disposeTablet()`.
* `QWindowsContext::initTablet()` 
  * creates `QWindowsTabletSupport`;
  * `disposeTablet()` destroys it.

For WM\_POINTER:

```
WM_POINTER 
  -> QWindowsPointerHandler
  -> QWindowSystemInterface
  -> QTabletEvent / Qt input events
```

while while for WinTab:

```
WinTab
  -> QWindowsTabletSupport
  -> QWindowSystemInterface
  -> QTabletEvent / Qt input events
```

## WinTab inside Qt

The WinTab implementation lives in:

* `src/plugins/platforms/windows/qwindowstabletsupport.cpp`
* plus the bundled WinTab headers mentioned by Qt’s attribution page: `src/3rdparty/wintab/pktdef.h` and `wintab.h`. ([Qt Documentation](https://doc.qt.io/qt-6/qtgui-attribution-wintab.html?utm_source=chatgpt.com))

What happens:

1. Loads `wintab32.dll`
2. Creates a hidden dummy window
3. Opens a WinTab context with `WTOpenW`
4. Receives `WT_PROXIMITY` and `WT_PACKET`
5. Converts packet data into Qt tablet events via `QWindowSystemInterface::handleTabletEvent(...)`

## WM\_POINTER inside Qt

* The Windows event dispatcher path in `qwindowscontext.cpp` includes `qwindowspointerhandler.h`, 
* Routes `PointerEvent` / `NonClientPointerEvent` to `QWindowsPointerHandler::translatePointerEvent(...)`. 
* Mouse events go through the same pointer handler’s mouse translation path.