createTextureFromSurface method

Pointer<SdlTexture> createTextureFromSurface(
  1. Pointer<SdlSurface> surface
)

Create a texture from an existing surface.

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.

\param renderer the rendering context. \param surface the SDL_Surface structure containing pixel data used to fill the texture. \returns the created texture or NULL on failure; call SDL_GetError() for more information.

\threadsafety This function should only be called on the main thread.

\since This function is available since SDL 3.1.3.

\sa SDL_CreateTexture \sa SDL_CreateTextureWithProperties \sa SDL_DestroyTexture

extern SDL_DECLSPEC SDL_Texture * SDLCALL SDL_CreateTextureFromSurface(SDL_Renderer *renderer, SDL_Surface *surface)

Implementation

Pointer<SdlTexture> createTextureFromSurface(Pointer<SdlSurface> surface) {
  return sdlCreateTextureFromSurface(this, surface);
}