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


Save an SDL_Surface into JPEG image data, via an SDL_IOStream.

Header File

Defined in <SDL3_image/SDL_image.h>


int IMG_SaveJPG_IO(SDL_Surface *surface, SDL_IOStream *dst, int closeio, int quality);

Function Parameters

SDL_Surface * surface the SDL surface to save.
SDL_IOStream * dst the SDL_IOStream to save the image data to.
int closeio SDL_TRUE to close/free the SDL_IOStream before returning, SDL_FALSE to leave it open.
int quality [0; 33] is Lowest quality, [34; 66] is Middle quality, [67; 100] is Highest quality.

Return Value

(int) Returns 0 if successful, -1 on error.


If you just want to save to a filename, you can use IMG_SaveJPG() instead.

If closeio is SDL_TRUE, dst will be closed before returning, whether this function succeeds or not.


This function is available since SDL_image 3.0.0.

See Also

CategoryAPI, CategoryAPIFunction

[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

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