SDL_GetFullscreenDisplayModes - Get a list of fullscreen display modes available on a display.
Contents
Availability
This function is available since SDL 3.2.0.
Description
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
Function 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.
Name
SDL_GetFullscreenDisplayModes - Get a list of fullscreen display modes available on a display.
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.
See Also
SDL_GetDisplays(3) Simple Directmedia Layer SDL 3.2.20 SDL_GetFullscreenDisplayModes(3)
Synopsis
#include<SDL3/SDL_video.h>SDL_DisplayMode**SDL_GetFullscreenDisplayModes(SDL_DisplayIDdisplayID,int*count);
Thread Safety
This function should only be called on the main thread.
