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

Constant POLL_SENTINEL

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

A variable controlling the use of a sentinel event when polling the event queue.

When polling for events, [SDL_PumpEvents] is used to gather new events from devices. If a device keeps producing new events between calls to [SDL_PumpEvents], a poll loop will become stuck until the new events stop. This is most noticeable when moving a high frequency mouse.

The variable can be set to the following values:

  • “0”: Disable poll sentinels.
  • “1”: Enable poll sentinels. (default)

This hint can be set anytime.

§Availability

This hint is available since SDL 3.2.0.