NAME¶

SDL_HINT_PEN_NOT_MOUSE - A variable controlling whether to treat pen movement as separate from mouse movement.

HEADER FILE¶

Defined in SDL3/SDL_hints.h

SYNOPSIS¶

#include "SDL3/SDL.h"

#define SDL_HINT_PEN_NOT_MOUSE    SDL_PEN_NOT_MOUSE"

DESCRIPTION¶

By default, pens report both SDL_MouseMotionEvent

and SDL_PenMotionEvent
updates (analogously for button presses). This hint allows decoupling mouse and pen updates.

This variable toggles between the following behaviour:

• "0": Pen acts as a mouse with mouse ID

SDL_PEN_MOUSEID . (default) Use case: client
application is not pen aware, user wants to use pen instead of mouse to
interact.

• "1": Pen reports mouse clicks and movement events but does not update
SDL-internal mouse state (buttons pressed, current mouse location). Use
case: client application is not pen aware, user frequently alternates
between pen and "real" mouse.

• "2": Pen reports no mouse events. Use case: pen-aware client application
uses this hint to allow user to toggle between pen+mouse mode ("2") and
pen-only mode ("1" or "0").

This hint can be set anytime.

AVAILABILITY¶

This hint is available since SDL 3.0.0.