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

IMG_Save

Save an SDL_Surface into an image file.

Header File

Defined in <SDL3_image/SDL_image.h>

Syntax

bool IMG_Save(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.

For formats that accept a quality, a default quality of 90 will be used.

Version

This function is available since SDL_image 3.4.0.

See Also

• IMG_SaveTyped_IO
• IMG_SaveAVIF
• IMG_SaveBMP
• IMG_SaveGIF
• IMG_SaveJPG
• IMG_SavePNG
• IMG_SaveTGA
• IMG_SaveWEBP

---

CategoryAPI, CategoryAPIFunction, CategorySDLImage

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.