SDL_CreateTextureFromSurface - Create a texture from an existing surface.
Contents
Availability
This function is available since SDL 3.2.0.
Description
The surface is not modified or freed by this function.
The SDL_TextureAccess hint for the created texture is SDL_TEXTUREACCESS_STATIC.
The pixel format of the created texture may be different from the pixel format of the surface, and can be
queried using the SDL_PROP_TEXTURE_FORMAT_NUMBER property.
Function Parameters
renderer
the rendering context.
surface
the SDL_Surface structure containing pixel data used to fill the texture.
Name
SDL_CreateTextureFromSurface - Create a texture from an existing surface.
Return Value
Returns the created texture or NULL on failure; call SDL_GetError() for more information.
See Also
SDL_CreateTexture(3), SDL_CreateTextureWithProperties(3), SDL_DestroyTexture(3) Simple Directmedia Layer SDL 3.2.20 SDL_CreateTextureFromSurface(3)
Synopsis
#include<SDL3/SDL_render.h>SDL_Texture*SDL_CreateTextureFromSurface(SDL_Renderer*renderer,SDL_Surface*surface);
Thread Safety
This function should only be called on the main thread.
