SDL Wiki
(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)


Copy a portion of the source texture to the current rendering target, with rotation and flipping, at subpixel precision.

Header File

Defined in <SDL3/SDL_render.h>


int SDL_RenderTextureRotated(SDL_Renderer *renderer, SDL_Texture *texture,
                         const SDL_FRect *srcrect, const SDL_FRect *dstrect,
                         const double angle, const SDL_FPoint *center,
                         const SDL_FlipMode flip);

Function Parameters

SDL_Renderer * renderer the renderer which should copy parts of a texture.
SDL_Texture * texture the source texture.
const SDL_FRect * srcrect a pointer to the source rectangle, or NULL for the entire texture.
const SDL_FRect * dstrect a pointer to the destination rectangle, or NULL for the entire rendering target.
const double angle an angle in degrees that indicates the rotation that will be applied to dstrect, rotating it in a clockwise direction.
const SDL_FPoint * center a pointer to a point indicating the point around which dstrect will be rotated (if NULL, rotation will be done around dstrect.w/2, dstrect.h/2).
const SDL_FlipMode flip an SDL_FlipMode value stating which flipping actions should be performed on the texture.

Return Value

(int) Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.


This function is available since SDL 3.0.0.

See Also

CategoryAPI, CategoryAPIFunction, CategoryRender

[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.