SDL_GetRenderSafeArea - Get the safe area for rendering within the current viewport.
Contents
Availability
This function is available since SDL 3.2.0.
Simple Directmedia Layer SDL 3.2.10 SDL_GetRenderSafeArea(3)
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
renderer
the rendering context.
rect a pointer filled in with the area that is safe for interactive content.
Header File
Defined in SDL3/SDL_render.h
Name
SDL_GetRenderSafeArea - Get the safe area for rendering within the current viewport.
Return Value
Returns true on success or false on failure; call
SDL_GetError () for more information.
Synopsis
#include"SDL3/SDL.h"boolSDL_GetRenderSafeArea(SDL_Renderer*renderer,SDL_Rect*rect);
Thread Safety
This function should only be called on the main thread.
