SDL_CreateTextureFromSurface - Man Page
Create a texture from an existing surface.
Header File
Defined in SDL3/SDL_render.h
Synopsis
#include "SDL3/SDL.h" SDL_Texture * SDL_CreateTextureFromSurface(SDL_Renderer *renderer, SDL_Surface *surface);
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.
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_CreateTexture(3), ·(3), SDL_CreateTextureWithProperties(3), ·(3), SDL_DestroyTexture(3)
Referenced By
SDL_CreateTexture(3), SDL_CreateTextureWithProperties(3), SDL_DestroyTexture(3), SDL_Texture.3type(3).