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

IMG_CreateAnimationEncoder_IO

Create an encoder to save a series of images to an IOStream.

Header File

Syntax

IMG_AnimationEncoder * IMG_CreateAnimationEncoder_IO(SDL_IOStream *dst, bool closeio, const char *type);

Function Parameters

SDL_IOStream *	dst	an SDL_IOStream that will be used to save the stream.
bool	closeio	true to close the SDL_IOStream when done, false to leave it open.
const char *	type	a filename extension that represent this data ("WEBP", etc).

Return Value

(IMG_AnimationEncoder *) Returns a new IMG_AnimationEncoder, or NULL on failure; call SDL_GetError() for more information.

Remarks

These animation types are currently supported:

ANI
APNG
AVIFS
GIF
WEBP

If closeio is true, dst will be closed before returning if this function fails, or when the animation encoder is closed if this function succeeds.

Version

This function is available since SDL_image 3.4.0.