NAME
SDL_DuplicateSurface - Creates a new surface identical to the existing surface.
HEADER FILE
Defined in SDL3/SDL_surface.h
SYNOPSIS
#include "SDL3/SDL.h"
SDL_Surface * SDL_DuplicateSurface(SDL_Surface *surface);
DESCRIPTION
If the original surface has alternate images, the new surface will have a reference to them as well.
The returned surface should be freed with
SDL_DestroySurface ().
FUNCTION PARAMETERS
- surface
-
the surface to duplicate.
RETURN VALUE
( SDL_Surface
*) Returns a copy of the surface or NULL on failure; call SDL_GetError () for more information.
THREAD SAFETY
This function is not thread safe.
AVAILABILITY
This function is available since SDL 3.2.0.
SEE ALSO
•(3), SDL_DestroySurface(3)