logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

SDL_CreateTextureFromSurface - Create a texture from an existing surface.

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.

See Also