SDL_GetDisplays(3)

Usage

#include "SDL3/SDL.h"

SDL_DisplayID * SDL_GetDisplays(int *count);

Header file

Defined in SDL3/SDL_video.h

Function parameters

count: a pointer filled in with the number of displays returned, may be NULL.

Return value

( SDL_DisplayID
*) Returns a 0 terminated array of display instance IDs or NULL on failure; call SDL_GetError () for more information. This should be freed with SDL_free () when it is no longer needed.

Thread safety

This function should only be called on the main thread.

Referred to by

SDL_GetDisplayName(3) Get the name of a display in UTF-8 encoding. SDL_GetDisplayBounds(3) Get the desktop area represented by a display. SDL_GetDisplayForRect(3) Get the display primarily containing a rect. SDL_GetPrimaryDisplay(3) Return the primary display. SDL_GetDisplayForPoint(3) Get the display containing a point. SDL_GetDisplayForWindow(3) Get the display associated with a window. SDL_GetCurrentDisplayMode(3) Get information about the current display mode. SDL_GetDesktopDisplayMode(3) Get information about the desktop's display mode. SDL_GetDisplayContentScale(3) Get the content scale of a display. SDL_GetDisplayUsableBounds(3) Get the usable desktop area represented by a display, in screen coordinates. SDL_GetFullscreenDisplayModes(3) Get a list of fullscreen display modes available on a display. SDL_GetCurrentDisplayOrientation(3) Get the orientation of a display. SDL_GetNaturalDisplayOrientation(3) Get the orientation of a display when it is unrotated. SDL_GetClosestFullscreenDisplayMode(3) Get the closest match to the requested display mode.