NAME¶

SDL_HINT_MAC_USE_GCMOUSE - A variable controlling whether the GCMouse API will be used on macOS.

SYNOPSIS¶

#include <SDL3/SDL_hints.h>

#define SDL_HINT_MAC_USE_GCMOUSE "SDL_MAC_USE_GCMOUSE"

DESCRIPTION¶

On supported versions of macOS, GCMouse is usually a better way to read mouse input, but may cause problems in some scenarios (remote control software that wants to send non-GCMouse input events, etc).

When GCMouse is disabled, SDL will use standard Cocoa mouse events.

The variable can be set to the following values:

• "0": GCMouse won't be used.

• "1": GCMouse will be used if available. (default)

This hint needs to be set before SDL_Init().

AVAILABILITY¶

This hint is available since SDL 3.6.0.