devela::_dep::sdl3::sys::video

Function SDL_GetFullscreenDisplayModes

pub unsafe extern "C" fn SDL_GetFullscreenDisplayModes(
    displayID: u32,
    count: *mut i32,
) -> *mut *mut SDL_DisplayMode
Available on crate feature dep_sdl3 only.
Expand description

Get a list of fullscreen display modes available on a display.

The display modes are sorted in this priority:

  • w -> largest to smallest
  • h -> largest to smallest
  • bits per pixel -> more colors to fewer colors
  • packed pixel layout -> largest to smallest
  • refresh rate -> highest to lowest
  • pixel density -> lowest to highest

§Parameters

  • displayID: the instance ID of the display to query.
  • count: a pointer filled in with the number of display modes returned, may be NULL.

§Return value

Returns a NULL terminated array of display mode pointers or NULL on failure; call SDL_GetError() for more information. This is a single allocation that should be freed with SDL_free() when it is no longer needed.

§Thread safety

This function should only be called on the main thread.

§Availability

This function is available since SDL 3.2.0.

§See also