table of contents
- experimental 3.1.0+ds-1
SDL_CreateTextureFromSurface(3) | SDL3 FUNCTIONS | SDL_CreateTextureFromSurface(3) |
NAME¶
SDL_CreateTextureFromSurface - Create a texture from an existing surface.
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. Use SDL_QueryTexture () to query the pixel format of the texture.
FUNCTION PARAMETERS¶
RETURN VALUE¶
Returns the created texture or NULL on failure; call
SDL_GetError () for more information.
AVAILABILITY¶
This function is available since SDL 3.0.0.
SEE ALSO¶
SDL_CreateTexture(3), SDL_CreateTextureWithProperties(3), SDL_DestroyTexture(3), SDL_QueryTexture(3)
SDL 3.1.0 | SDL |