(This is the legacy documentation for SDL2, the previous stable version; SDL3 is the current stable version.)

SDL_HINT_GAMECONTROLLER_USE_BUTTON_LABELS

If set, game controller face buttons report their values according to their labels instead of their positional layout.

Header File

Defined in SDL_hints.h

Syntax

#define SDL_HINT_GAMECONTROLLER_USE_BUTTON_LABELS "SDL_GAMECONTROLLER_USE_BUTTON_LABELS"

Remarks

For example, on Nintendo Switch controllers, normally you'd get:

     (Y)
 (X)     (B)
     (A)

but if this hint is set, you'll get:

     (X)
 (Y)     (A)
     (B)

The variable can be set to the following values:

• "0": Report the face buttons by position, as though they were on an Xbox controller.
• "1": Report the face buttons by label instead of position

The default value is "1". This hint may be set at any time.

---

CategoryAPI, CategoryAPIMacro, CategoryHints

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.