SDL_GetSurfaceImages - Get an array including all versions of a surface.
Contents
Availability
This function is available since SDL 3.2.0.
Description
This returns all versions of a surface, with the surface being queried as the first element in the
returned array.
Freeing the array of surfaces does not affect the surfaces in the array. They are still referenced by the
surface being queried and will be cleaned up normally.
Function Parameters
surface
the SDL_Surface structure to query.
count a pointer filled in with the number of surface pointers returned, may be NULL.
Name
SDL_GetSurfaceImages - Get an array including all versions of a surface.
Return Value
Returns a NULL terminated array of SDL_Surface pointers or NULL on failure; call SDL_GetError() for more
information. This should be freed with SDL_free() when it is no longer needed.
See Also
SDL_AddSurfaceAlternateImage(3), SDL_RemoveSurfaceAlternateImages(3), SDL_SurfaceHasAlternateImages(3) Simple Directmedia Layer SDL 3.2.20 SDL_GetSurfaceImages(3)
Synopsis
#include<SDL3/SDL_surface.h>SDL_Surface**SDL_GetSurfaceImages(SDL_Surface*surface,int*count);
Thread Safety
This function is not thread safe.
