#pragma section-numbers off
#pragma disable-camelcase

= SDL_SetRenderTarget =
Use this function to set a texture as the current rendering target.

<<TableOfContents()>>

== Syntax ==
{{{#!highlight cpp
int SDL_SetRenderTarget(SDL_Renderer* renderer,
                        SDL_Texture*  texture)
}}}

== Function Parameters ==
||'''renderer'''||the rendering context||
||'''texture'''||the targeted texture, which must be created with the [[SDL_TextureAccess|SDL_TEXTUREACCESS_TARGET]] flag, or NULL for the default render target||


== 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
}}}

== Remarks ==
Before using this function, you should check the SDL_RENDERER_TARGETTEXTURE bit in the flags of [[SDL_RendererInfo]] to see if render targets are supported.

The default render target is the window for which the renderer was created.

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

== Related Functions ==
 .[[SDL_GetRenderTarget]]

----
[[CategoryAPI]], [[CategoryRender]]