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

Constant MAIN_CALLBACK_RATE

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

Request [SDL_AppIterate()] be called at a specific rate.

If this is set to a number, it represents Hz, so “60” means try to iterate 60 times per second. “0” means to iterate as fast as possible. Negative values are illegal, but reserved, in case they are useful in a future revision of SDL.

There are other strings that have special meaning. If set to “waitevent”, [SDL_AppIterate] will not be called until new event(s) have arrived (and been processed by [SDL_AppEvent]). This can be useful for apps that are completely idle except in response to input.

On some platforms, or if you are using [SDL_main] instead of [SDL_AppIterate], this hint is ignored. When the hint can be used, it is allowed to be changed at any time.

This defaults to 0, and specifying NULL for the hint’s value will restore the default.

This hint can be set anytime.

§Availability

This hint is available since SDL 3.2.0.