SDL_HINT_PEN_NOT_MOUSE(3)

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.