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_ConvertSurface - Copy an existing surface to a new surface of the specified format.

Availability

       This function is available since SDL 3.2.0.

Description

       This  function  is used to optimize images for faster repeat blitting. This is accomplished by converting
       the original and storing the result as a new surface. The new, optimized surface can then be used as  the
       source for future blits, making them faster.

       If you are converting to an indexed surface and want to map colors to a palette, you can use

       SDL_ConvertSurfaceAndColorspace () instead.

       If the original surface has alternate images, the new surface will have a reference to them as well.

Function Parameters

surface
              the existing SDL_Surface
               structure to convert.

       format the new pixel format.

Header File

       Defined in SDL3/SDL_surface.h

Name

       SDL_ConvertSurface - Copy an existing surface to a new surface of the specified format.

Return Value

       ( SDL_Surface
        *) Returns the new SDL_Surface

       structure that is created or NULL on failure; call

       SDL_GetError () for more information.

See Also

(3), SDL_ConvertSurfaceAndColorspace(3), (3), SDL_DestroySurface(3)

Simple Directmedia Layer                           SDL 3.2.10                              SDL_ConvertSurface(3)

Synopsis

#include"SDL3/SDL.h"SDL_Surface*SDL_ConvertSurface(SDL_Surface*surface,SDL_PixelFormatformat);

Thread Safety

       This function is not thread safe.

See Also