#pragma section-numbers off
#pragma camelcase off
||<tablewidth="100%" style="color: #FF0000;" :> DRAFT||


##*^*^*^*^*See http://wiki.libsdl.org/moin.cgi/SGFunctions for details on editing this page*^*^*^*^*


= SDL_RenderSetScale =
Use this function to set the drawing scale for rendering on the current target.


<<TableOfContents()>>


== Syntax ==
{{{#!highlight cpp
int SDL_RenderSetScale(SDL_Renderer* renderer,
                       float         scaleX,
                       float         scaleY)
}}}


== Function Parameters ==
||'''renderer'''||a rendering context||
||'''scaleX'''||the horizontal scaling factor||
||'''scaleY'''||the vertical scaling factor||


== Return Value ==
Returns 0 on success or a negative error code on failure; call [[SDL_GetError]]() for more information.


== Code Examples ==
{{{#!highlight cpp
You can add your code example here
}}}

##Leave this section as-is unless you have a code example to put in.  In that case, replace You can add your code example here with your code example following the Style Guide instructions.  Leave the rest of the markup alone and delete this comment.


== Remarks ==
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.

== Version ==
This function is available since SDL 2.0.0.

== Related Functions ==
 .[[SDL_RenderGetScale]]
 .[[SDL_RenderSetLogicalSize]]

----
[[CategoryAPI]], [[CategoryRender]]
##See the Style Guide for instructions on editing the footer.