SDL_SetRenderScale - Man Page
Set the drawing scale for rendering on the current target.
Header File
Defined in SDL3/SDL_render.h
Synopsis
#include "SDL3/SDL.h" bool SDL_SetRenderScale(SDL_Renderer *renderer, float scaleX, float scaleY);
Description
The drawing coordinates are scaled by the x/y scaling factors before they are used by the renderer. This allows resolution independent drawing with a single coordinate system.
If this results in scaling or subpixel drawing by the rendering backend, it will be handled using the appropriate quality hints. For best results use integer scaling factors.
Function Parameters
- renderer
the rendering context.
- scaleX
the horizontal scaling factor.
- scaleY
the vertical scaling factor.
Return Value
Returns true on success or false on failure; call
SDL_GetError () 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.
See Also
·(3), SDL_GetRenderScale(3)
Referenced By
SDL_GetRenderScale(3), SDL_RenderCoordinatesFromWindow(3), SDL_RenderCoordinatesToWindow(3).