devela::_dep::sdl3::hint::names

Constant MAC_OPTION_AS_ALT

pub const MAC_OPTION_AS_ALT: &'static str;
Available on crate feature dep_sdl3 only.
Expand description

A variable controlling whether the Option key on macOS should be remapped to act as the Alt key.

The variable can be set to the following values:

  • “none”: The Option key is not remapped to Alt. (default)
  • “only_left”: Only the left Option key is remapped to Alt.
  • “only_right”: Only the right Option key is remapped to Alt.
  • “both”: Both Option keys are remapped to Alt.

This will prevent the triggering of key compositions that rely on the Option key, but will still send the Alt modifier for keyboard events. In the case that both Alt and Option are pressed, the Option key will be ignored. This is particularly useful for applications like terminal emulators and graphical user interfaces (GUIs) that rely on Alt key functionality for shortcuts or navigation. This does not apply to [SDL_GetKeyFromScancode] and only has an effect if IME is enabled.

This hint can be set anytime.

§Availability

This hint is available since SDL 3.2.0.