---
name: "SDL_SetRenderScale"
section: "3"
platform: "linux"
package: "libsdl3-doc"
version: "3.2.10+ds-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SDL_SetRenderScale"
---

# SDL\_SetRenderScale(3)

Set the drawing scale for rendering on the current target.

## NAME

SDL\_SetRenderScale - 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.

Each render target has its own scale. This function sets the scale for the current render target.

## 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)](/SDL_GetRenderScale/3.md)