SDL_GetWindowDisplayScale - Man Page

Get the content display scale relative to a window's pixel size.

Synopsis

#include <SDL3/SDL_video.h>

float SDL_GetWindowDisplayScale(SDL_Window *window);

Description

This is a combination of the window pixel density and the display content scale, and is the expected scale for displaying content in this window. For example, if a 3840x2160 window had a display scale of 2.0, the user expects the content to take twice as many pixels and be the same physical size as if it were being displayed in a 1920x1080 window with a display scale of 1.0.

Conceptually this value corresponds to the scale display setting, and is updated when that setting is changed, or the window moves to a display with a different scale setting.

Function Parameters

window

the window to query.

Return Value

for more information.

Thread Safety

This function should only be called on the main thread.

Availability

This function is available since SDL 3.2.0.

Referenced By

SDL_GetDisplayContentScale(3), SDL_GetWindowPixelDensity(3).

SDL 3.2.16 Simple Directmedia Layer SDL3 FUNCTIONS