NAME

       SDL_CreateTextureFromSurface - 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)

Simple Directmedia Layer                            SDL 3.2.8                    SDL_CreateTextureFromSurface(3)