(This function is part of SDL_image, a separate library from SDL.)

IMG_SavePNG

Save an SDL_Surface into a PNG image file.

Header File

Defined in <SDL3_image/SDL_image.h>

Syntax

bool IMG_SavePNG(SDL_Surface *surface, const char *file);

Function Parameters

SDL_Surface * surface the SDL surface to save.
const char * file path on the filesystem to write new file to.

Return Value

(bool) Returns true on success or false on failure; call SDL_GetError() for more information.

Remarks

If the file already exists, it will be overwritten.

Version

This function is available since SDL_image 3.0.0.

See Also

CategoryAPI, CategoryAPIFunction, CategorySDLImage