SDL_LoadPNG_IO - Man Page
Load a PNG image from a seekable SDL data stream.
Synopsis
#include <SDL3/SDL_surface.h> SDL_Surface * SDL_LoadPNG_IO(SDL_IOStream *src, bool closeio);
Description
This is intended as a convenience function for loading images from trusted sources. If you want to load arbitrary images you should use libpng or another image loading library designed with security in mind.
The new surface should be freed with SDL_DestroySurface(). Not doing so will result in a memory leak.
Function Parameters
- src
the data stream for the surface.
- closeio
if true, calls SDL_CloseIO() on src before returning, even in the case of an error.
Return Value
Returns a pointer to a new SDL_Surface structure or NULL on failure; call SDL_GetError() for more information.
Thread Safety
It is safe to call this function from any thread.
Availability
This function is available since SDL 3.4.0.
See Also
Referenced By
SDL_LoadPNG(3), SDL_SavePNG_IO(3).
SDL 3.4.0 Simple Directmedia Layer SDL3 FUNCTIONS