SDL_CreateTexture - Man Page
Create a texture for a rendering context.
Header File
Defined in SDL3/SDL_render.h
Synopsis
#include "SDL3/SDL.h" SDL_Texture * SDL_CreateTexture(SDL_Renderer *renderer, SDL_PixelFormat format, SDL_TextureAccess access, int w, int h);
Description
The contents of a texture when first created are not defined.
Function Parameters
- renderer
the rendering context.
- format
one of the enumerated values in SDL_PixelFormat .
- access
one of the enumerated values in SDL_TextureAccess .
- w
the width of the texture in pixels.
- h
the height of the texture in pixels.
Return Value
( SDL_Texture
*) Returns the created texture or NULL 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_CreateTextureFromSurface(3), ·(3), SDL_CreateTextureWithProperties(3), ·(3), SDL_DestroyTexture(3), ·(3), SDL_GetTextureSize(3), ·(3), SDL_UpdateTexture(3)
Referenced By
SDL_CreateTextureFromSurface(3), SDL_CreateTextureWithProperties(3), SDL_DestroyTexture(3), SDL_Texture.3type(3).