table of contents
SDL_GetRenderSafeArea(3) | SDL3 FUNCTIONS | SDL_GetRenderSafeArea(3) |
NAME¶
SDL_GetRenderSafeArea - Get the safe area for rendering within the current viewport.
HEADER FILE¶
Defined in SDL3/SDL_render.h
SYNOPSIS¶
#include "SDL3/SDL.h"
bool SDL_GetRenderSafeArea(SDL_Renderer *renderer, SDL_Rect *rect);
DESCRIPTION¶
Some devices have portions of the screen which are partially obscured or not interactive, possibly due to on-screen controls, curved edges, camera notches, TV overscan, etc. This function provides the area of the current viewport which is safe to have interactible content. You should continue rendering into the rest of the render target, but it should not contain visually important or interactible content.
FUNCTION PARAMETERS¶
RETURN VALUE¶
Returns true on success or false on failure; call
SDL_GetError () for more information.
THREAD SAFETY¶
You may only call this function from the main thread.
AVAILABILITY¶
This function is available since SDL 3.1.3.
SDL 3.1.6 | Simple Directmedia Layer |