SDL_ConvertSurfaceAndColorspace3
Copy an existing surface to a new surface of the specified format and colorspace.
Usage
#include "SDL3/SDL.h"
SDL_Surface * SDL_ConvertSurfaceAndColorspace(SDL_Surface *surface, SDL_PixelFormat format, SDL_Palette *palette, SDL_Colorspace colorspace, SDL_PropertiesID props);
Header file
Defined in SDL3/SDL_surface.h
Overview
This function converts an existing surface to a new format and colorspace and returns the new surface. This will perform any pixel format and colorspace conversion needed.
If the original surface has alternate images, the new surface will have a reference to them as well.
Function parameters
surface
|
the existing |
|---|---|
format
|
the new pixel format. |
palette
|
an optional palette to use for indexed formats, may be NULL. |
colorspace
|
the new colorspace. |
props
|
an |
Return value
( SDL_Surface
*) Returns the new SDL_Surface
structure that is created or NULL on failure; call
SDL_GetError () for more information.
Thread safety
This function is not thread safe.