(This is the legacy documentation for SDL2, the previous stable version; SDL3 is the current stable version.)

SDL_CreateTexture

Create a texture for a rendering context.

Header File

Syntax

SDL_Texture * SDL_CreateTexture(SDL_Renderer * renderer,
                                Uint32 format,
                                int access, int w,
                                int h);

Function Parameters

SDL_Renderer *	renderer	the rendering context.
Uint32	format	one of the enumerated values in SDL_PixelFormatEnum.
int	access	one of the enumerated values in SDL_TextureAccess.
int	w	the width of the texture in pixels.
int	h	the height of the texture in pixels.

Return Value

(SDL_Texture *) Returns a pointer to the created texture or NULL if no rendering context was active, the format was unsupported, or the width or height were out of range; call SDL_GetError() for more information.

Remarks

You can set the texture scaling method by setting SDL_HINT_RENDER_SCALE_QUALITY before creating the texture.

Version

This function is available since SDL 2.0.0.