Update SDL_image to 3.4.0

5 files changed, 1625 insertions, 311 deletions

diff --git a/vendor/sdl3/image/LICENSE.txt b/vendor/sdl3/image/LICENSE.txt
index 52d0ed38b..acaf5b21b 100644
--- a/vendor/sdl3/image/LICENSE.txt
+++ b/vendor/sdl3/image/LICENSE.txt
@@ -1,4 +1,4 @@
-Copyright (C) 1997-2025 Sam Lantinga <slouken@libsdl.org>
+Copyright (C) 1997-2026 Sam Lantinga <slouken@libsdl.org>
 
 This software is provided 'as-is', without any express or implied
 warranty.  In no event will the authors be held liable for any damages
diff --git a/vendor/sdl3/image/SDL3_image.dll b/vendor/sdl3/image/SDL3_image.dll
index 2ba20a7cf..ea48dab75 100644
--- a/vendor/sdl3/image/SDL3_image.dll
+++ b/vendor/sdl3/image/SDL3_image.dll
diff --git a/vendor/sdl3/image/SDL3_image.lib b/vendor/sdl3/image/SDL3_image.lib
index 4e9913b4c..7db2f734a 100644
--- a/vendor/sdl3/image/SDL3_image.lib
+++ b/vendor/sdl3/image/SDL3_image.lib
diff --git a/vendor/sdl3/image/include/SDL_image.h b/vendor/sdl3/image/include/SDL_image.h
index 60d041fe6..19d9f2e02 100644
--- a/vendor/sdl3/image/include/SDL_image.h
+++ b/vendor/sdl3/image/include/SDL_image.h
@@ -1,6 +1,6 @@
 /*
   SDL_image:  An example image loading library for use with SDL
-  Copyright (C) 1997-2025 Sam Lantinga <slouken@libsdl.org>
+  Copyright (C) 1997-2026 Sam Lantinga <slouken@libsdl.org>
 
   This software is provided 'as-is', without any express or implied
   warranty.  In no event will the authors be held liable for any damages
@@ -44,8 +44,8 @@ extern "C" {
  * Printable format: "%d.%d.%d", MAJOR, MINOR, MICRO
  */
 #define SDL_IMAGE_MAJOR_VERSION 3
-#define SDL_IMAGE_MINOR_VERSION 2
-#define SDL_IMAGE_MICRO_VERSION 4
+#define SDL_IMAGE_MINOR_VERSION 4
+#define SDL_IMAGE_MICRO_VERSION 0
 
 /**
  * This is the version number macro for the current SDL_image version.
@@ -71,7 +71,7 @@ extern "C" {
 extern SDL_DECLSPEC int SDLCALL IMG_Version(void);
 
 /**
- * Load an image from an SDL data source into a software surface.
+ * Load an image from a filesystem path into a software surface.
  *
  * An SDL_Surface is a buffer of pixels in memory accessible by the CPU. Use
  * this if you plan to hand the data to something else or manipulate it
@@ -91,49 +91,31 @@ extern SDL_DECLSPEC int SDLCALL IMG_Version(void);
  * by calling: SDL_SetSurfaceColorKey(image, SDL_RLEACCEL,
  * image->format->colorkey);
  *
- * If `closeio` is true, `src` will be closed before returning, whether this
- * function succeeds or not. SDL_image reads everything it needs from `src`
- * during this call in any case.
- *
- * Even though this function accepts a file type, SDL_image may still try
- * other decoders that are capable of detecting file type from the contents of
- * the image data, but may rely on the caller-provided type string for formats
- * that it cannot autodetect. If `type` is NULL, SDL_image will rely solely on
- * its ability to guess the format.
- *
- * There is a separate function to read files from disk without having to deal
- * with SDL_IOStream: `IMG_Load("filename.jpg")` will call this function and
- * manage those details for you, determining the file type from the filename's
- * extension.
- *
- * There is also IMG_Load_IO(), which is equivalent to this function except
- * that it will rely on SDL_image to determine what type of data it is
- * loading, much like passing a NULL for type.
+ * There is a separate function to read files from an SDL_IOStream, if you
+ * need an i/o abstraction to provide data from anywhere instead of a simple
+ * filesystem read; that function is IMG_Load_IO().
  *
  * If you are using SDL's 2D rendering API, there is an equivalent call to
  * load images directly into an SDL_Texture for use by the GPU without using a
- * software surface: call IMG_LoadTextureTyped_IO() instead.
+ * software surface: call IMG_LoadTexture() instead.
  *
  * When done with the returned surface, the app should dispose of it with a
- * call to SDL_DestroySurface().
+ * call to
+ * [SDL_DestroySurface](https://wiki.libsdl.org/SDL3/SDL_DestroySurface)
+ * ().
  *
- * \param src an SDL_IOStream that data will be read from.
- * \param closeio true to close/free the SDL_IOStream before returning, false
- *                to leave it open.
- * \param type a filename extension that represent this data ("BMP", "GIF",
- *             "PNG", etc).
+ * \param file a path on the filesystem to load an image from.
  * \returns a new SDL surface, or NULL on error.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
- * \sa IMG_Load
+ * \sa IMG_LoadTyped_IO
  * \sa IMG_Load_IO
- * \sa SDL_DestroySurface
  */
-extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadTyped_IO(SDL_IOStream *src, bool closeio, const char *type);
+extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_Load(const char *file);
 
 /**
- * Load an image from a filesystem path into a software surface.
+ * Load an image from an SDL data source into a software surface.
  *
  * An SDL_Surface is a buffer of pixels in memory accessible by the CPU. Use
  * this if you plan to hand the data to something else or manipulate it
@@ -153,29 +135,37 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadTyped_IO(SDL_IOStream *src, bo
  * by calling: SDL_SetSurfaceColorKey(image, SDL_RLEACCEL,
  * image->format->colorkey);
  *
- * There is a separate function to read files from an SDL_IOStream, if you
- * need an i/o abstraction to provide data from anywhere instead of a simple
- * filesystem read; that function is IMG_Load_IO().
+ * If `closeio` is true, `src` will be closed before returning, whether this
+ * function succeeds or not. SDL_image reads everything it needs from `src`
+ * during this call in any case.
+ *
+ * There is a separate function to read files from disk without having to deal
+ * with SDL_IOStream: `IMG_Load("filename.jpg")` will call this function and
+ * manage those details for you, determining the file type from the filename's
+ * extension.
+ *
+ * There is also IMG_LoadTyped_IO(), which is equivalent to this function
+ * except a file extension (like "BMP", "JPG", etc) can be specified, in case
+ * SDL_image cannot autodetect the file format.
  *
  * If you are using SDL's 2D rendering API, there is an equivalent call to
  * load images directly into an SDL_Texture for use by the GPU without using a
- * software surface: call IMG_LoadTexture() instead.
+ * software surface: call IMG_LoadTexture_IO() instead.
  *
  * When done with the returned surface, the app should dispose of it with a
- * call to
- * [SDL_DestroySurface](https://wiki.libsdl.org/SDL3/SDL_DestroySurface)
- * ().
+ * call to SDL_DestroySurface().
  *
- * \param file a path on the filesystem to load an image from.
+ * \param src an SDL_IOStream that data will be read from.
+ * \param closeio true to close/free the SDL_IOStream before returning, false
+ *                to leave it open.
  * \returns a new SDL surface, or NULL on error.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_Load
  * \sa IMG_LoadTyped_IO
- * \sa IMG_Load_IO
- * \sa SDL_DestroySurface
  */
-extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_Load(const char *file);
+extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_Load_IO(SDL_IOStream *src, bool closeio);
 
 /**
  * Load an image from an SDL data source into a software surface.
@@ -202,18 +192,24 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_Load(const char *file);
  * function succeeds or not. SDL_image reads everything it needs from `src`
  * during this call in any case.
  *
+ * Even though this function accepts a file type, SDL_image may still try
+ * other decoders that are capable of detecting file type from the contents of
+ * the image data, but may rely on the caller-provided type string for formats
+ * that it cannot autodetect. If `type` is NULL, SDL_image will rely solely on
+ * its ability to guess the format.
+ *
  * There is a separate function to read files from disk without having to deal
  * with SDL_IOStream: `IMG_Load("filename.jpg")` will call this function and
  * manage those details for you, determining the file type from the filename's
  * extension.
  *
- * There is also IMG_LoadTyped_IO(), which is equivalent to this function
- * except a file extension (like "BMP", "JPG", etc) can be specified, in case
- * SDL_image cannot autodetect the file format.
+ * There is also IMG_Load_IO(), which is equivalent to this function except
+ * that it will rely on SDL_image to determine what type of data it is
+ * loading, much like passing a NULL for type.
  *
  * If you are using SDL's 2D rendering API, there is an equivalent call to
  * load images directly into an SDL_Texture for use by the GPU without using a
- * software surface: call IMG_LoadTexture_IO() instead.
+ * software surface: call IMG_LoadTextureTyped_IO() instead.
  *
  * When done with the returned surface, the app should dispose of it with a
  * call to SDL_DestroySurface().
@@ -221,18 +217,19 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_Load(const char *file);
  * \param src an SDL_IOStream that data will be read from.
  * \param closeio true to close/free the SDL_IOStream before returning, false
  *                to leave it open.
+ * \param type a filename extension that represent this data ("BMP", "GIF",
+ *             "PNG", etc).
  * \returns a new SDL surface, or NULL on error.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_Load
- * \sa IMG_LoadTyped_IO
- * \sa SDL_DestroySurface
+ * \sa IMG_Load_IO
  */
-extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_Load_IO(SDL_IOStream *src, bool closeio);
+extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadTyped_IO(SDL_IOStream *src, bool closeio, const char *type);
 
 /**
- * Load an image from a filesystem path into a GPU texture.
+ * Load an image from a filesystem path into a texture.
  *
  * An SDL_Texture represents an image in GPU memory, usable by SDL's 2D Render
  * API. This can be significantly more efficient than using a CPU-bound
@@ -255,7 +252,7 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_Load_IO(SDL_IOStream *src, bool cl
  * When done with the returned texture, the app should dispose of it with a
  * call to SDL_DestroyTexture().
  *
- * \param renderer the SDL_Renderer to use to create the GPU texture.
+ * \param renderer the SDL_Renderer to use to create the texture.
  * \param file a path on the filesystem to load an image from.
  * \returns a new texture, or NULL on error.
  *
@@ -267,7 +264,7 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_Load_IO(SDL_IOStream *src, bool cl
 extern SDL_DECLSPEC SDL_Texture * SDLCALL IMG_LoadTexture(SDL_Renderer *renderer, const char *file);
 
 /**
- * Load an image from an SDL data source into a GPU texture.
+ * Load an image from an SDL data source into a texture.
  *
  * An SDL_Texture represents an image in GPU memory, usable by SDL's 2D Render
  * API. This can be significantly more efficient than using a CPU-bound
@@ -299,7 +296,7 @@ extern SDL_DECLSPEC SDL_Texture * SDLCALL IMG_LoadTexture(SDL_Renderer *renderer
  * When done with the returned texture, the app should dispose of it with a
  * call to SDL_DestroyTexture().
  *
- * \param renderer the SDL_Renderer to use to create the GPU texture.
+ * \param renderer the SDL_Renderer to use to create the texture.
  * \param src an SDL_IOStream that data will be read from.
  * \param closeio true to close/free the SDL_IOStream before returning, false
  *                to leave it open.
@@ -309,12 +306,11 @@ extern SDL_DECLSPEC SDL_Texture * SDLCALL IMG_LoadTexture(SDL_Renderer *renderer
  *
  * \sa IMG_LoadTexture
  * \sa IMG_LoadTextureTyped_IO
- * \sa SDL_DestroyTexture
  */
 extern SDL_DECLSPEC SDL_Texture * SDLCALL IMG_LoadTexture_IO(SDL_Renderer *renderer, SDL_IOStream *src, bool closeio);
 
 /**
- * Load an image from an SDL data source into a GPU texture.
+ * Load an image from an SDL data source into a texture.
  *
  * An SDL_Texture represents an image in GPU memory, usable by SDL's 2D Render
  * API. This can be significantly more efficient than using a CPU-bound
@@ -352,7 +348,7 @@ extern SDL_DECLSPEC SDL_Texture * SDLCALL IMG_LoadTexture_IO(SDL_Renderer *rende
  * When done with the returned texture, the app should dispose of it with a
  * call to SDL_DestroyTexture().
  *
- * \param renderer the SDL_Renderer to use to create the GPU texture.
+ * \param renderer the SDL_Renderer to use to create the texture.
  * \param src an SDL_IOStream that data will be read from.
  * \param closeio true to close/free the SDL_IOStream before returning, false
  *                to leave it open.
@@ -364,12 +360,152 @@ extern SDL_DECLSPEC SDL_Texture * SDLCALL IMG_LoadTexture_IO(SDL_Renderer *rende
  *
  * \sa IMG_LoadTexture
  * \sa IMG_LoadTexture_IO
- * \sa SDL_DestroyTexture
  */
 extern SDL_DECLSPEC SDL_Texture * SDLCALL IMG_LoadTextureTyped_IO(SDL_Renderer *renderer, SDL_IOStream *src, bool closeio, const char *type);
 
 /**
- * Detect AVIF image data on a readable/seekable SDL_IOStream.
+ * Load an image from a filesystem path into a GPU texture.
+ *
+ * An SDL_GPUTexture represents an image in GPU memory, usable by SDL's GPU
+ * API. Regardless of the source format of the image, this function will
+ * create a GPU texture with the format SDL_GPU_TEXTUREFORMAT_R8G8B8A8_UNORM
+ * with no mip levels. It can be bound as a sampled texture from a graphics or
+ * compute pipeline and as a a readonly storage texture in a compute pipeline.
+ *
+ * There is a separate function to read files from an SDL_IOStream, if you
+ * need an i/o abstraction to provide data from anywhere instead of a simple
+ * filesystem read; that function is IMG_LoadGPUTexture_IO().
+ *
+ * When done with the returned texture, the app should dispose of it with a
+ * call to SDL_ReleaseGPUTexture().
+ *
+ * \param device the SDL_GPUDevice to use to create the GPU texture.
+ * \param copy_pass the SDL_GPUCopyPass to use to upload the loaded image to
+ *                  the GPU texture.
+ * \param file a path on the filesystem to load an image from.
+ * \param width a pointer filled in with the width of the GPU texture. may be
+ *              NULL.
+ * \param height a pointer filled in with the width of the GPU texture. may be
+ *               NULL.
+ * \returns a new GPU texture, or NULL on error.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_LoadGPUTextureTyped_IO
+ * \sa IMG_LoadGPUTexture_IO
+ */
+extern SDL_DECLSPEC SDL_GPUTexture * SDLCALL IMG_LoadGPUTexture(SDL_GPUDevice *device, SDL_GPUCopyPass *copy_pass, const char *file, int *width, int *height);
+
+/**
+ * Load an image from an SDL data source into a GPU texture.
+ *
+ * An SDL_GPUTexture represents an image in GPU memory, usable by SDL's GPU
+ * API. Regardless of the source format of the image, this function will
+ * create a GPU texture with the format SDL_GPU_TEXTUREFORMAT_R8G8B8A8_UNORM
+ * with no mip levels. It can be bound as a sampled texture from a graphics or
+ * compute pipeline and as a a readonly storage texture in a compute pipeline.
+ *
+ * If `closeio` is true, `src` will be closed before returning, whether this
+ * function succeeds or not. SDL_image reads everything it needs from `src`
+ * during this call in any case.
+ *
+ * There is a separate function to read files from disk without having to deal
+ * with SDL_IOStream: `IMG_LoadGPUTexture(device, copy_pass, "filename.jpg",
+ * width, height) will call this function and manage those details for you,
+ * determining the file type from the filename's extension.
+ *
+ * There is also IMG_LoadGPUTextureTyped_IO(), which is equivalent to this
+ * function except a file extension (like "BMP", "JPG", etc) can be specified,
+ * in case SDL_image cannot autodetect the file format.
+ *
+ * When done with the returned texture, the app should dispose of it with a
+ * call to SDL_ReleaseGPUTexture().
+ *
+ * \param device the SDL_GPUDevice to use to create the GPU texture.
+ * \param copy_pass the SDL_GPUCopyPass to use to upload the loaded image to
+ *                  the GPU texture.
+ * \param src an SDL_IOStream that data will be read from.
+ * \param closeio true to close/free the SDL_IOStream before returning, false
+ *                to leave it open.
+ * \param width a pointer filled in with the width of the GPU texture. may be
+ *              NULL.
+ * \param height a pointer filled in with the width of the GPU texture. may be
+ *               NULL.
+ * \returns a new GPU texture, or NULL on error.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_LoadGPUTexture
+ * \sa IMG_LoadGPUTextureTyped_IO
+ */
+extern SDL_DECLSPEC SDL_GPUTexture * SDLCALL IMG_LoadGPUTexture_IO(SDL_GPUDevice *device, SDL_GPUCopyPass *copy_pass, SDL_IOStream *src, bool closeio, int *width, int *height);
+
+/**
+ * Load an image from an SDL data source into a GPU texture.
+ *
+ * An SDL_GPUTexture represents an image in GPU memory, usable by SDL's GPU
+ * API. Regardless of the source format of the image, this function will
+ * create a GPU texture with the format SDL_GPU_TEXTUREFORMAT_R8G8B8A8_UNORM
+ * with no mip levels. It can be bound as a sampled texture from a graphics or
+ * compute pipeline and as a a readonly storage texture in a compute pipeline.
+ *
+ * If `closeio` is true, `src` will be closed before returning, whether this
+ * function succeeds or not. SDL_image reads everything it needs from `src`
+ * during this call in any case.
+ *
+ * Even though this function accepts a file type, SDL_image may still try
+ * other decoders that are capable of detecting file type from the contents of
+ * the image data, but may rely on the caller-provided type string for formats
+ * that it cannot autodetect. If `type` is NULL, SDL_image will rely solely on
+ * its ability to guess the format.
+ *
+ * There is a separate function to read files from disk without having to deal
+ * with SDL_IOStream: `IMG_LoadGPUTexture(device, copy_pass, "filename.jpg",
+ * width, height) will call this function and manage those details for you,
+ * determining the file type from the filename's extension.
+ *
+ * There is also IMG_LoadGPUTexture_IO(), which is equivalent to this function
+ * except that it will rely on SDL_image to determine what type of data it is
+ * loading, much like passing a NULL for type.
+ *
+ * When done with the returned texture, the app should dispose of it with a
+ * call to SDL_ReleaseGPUTexture().
+ *
+ * \param device the SDL_GPUDevice to use to create the GPU texture.
+ * \param copy_pass the SDL_GPUCopyPass to use to upload the loaded image to
+ *                  the GPU texture.
+ * \param src an SDL_IOStream that data will be read from.
+ * \param closeio true to close/free the SDL_IOStream before returning, false
+ *                to leave it open.
+ * \param type a filename extension that represent this data ("BMP", "GIF",
+ *             "PNG", etc).
+ * \param width a pointer filled in with the width of the GPU texture. may be
+ *              NULL.
+ * \param height a pointer filled in with the width of the GPU texture. may be
+ *               NULL.
+ * \returns a new GPU texture, or NULL on error.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_LoadGPUTexture
+ * \sa IMG_LoadGPUTexture_IO
+ */
+extern SDL_DECLSPEC SDL_GPUTexture * SDLCALL IMG_LoadGPUTextureTyped_IO(SDL_GPUDevice *device, SDL_GPUCopyPass *copy_pass, SDL_IOStream *src, bool closeio, const char *type, int *width, int *height);
+
+/**
+ * Get the image currently in the clipboard.
+ *
+ * When done with the returned surface, the app should dispose of it with a
+ * call to SDL_DestroySurface().
+ *
+ * \returns a new SDL surface, or NULL if no supported image is available.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ */
+extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_GetClipboardImage(void);
+
+/**
+ * Detect ANI animated cursor data on a readable/seekable SDL_IOStream.
  *
  * This function attempts to determine if a file is a given filetype, reading
  * the least amount possible from the SDL_IOStream (usually a few bytes).
@@ -387,33 +523,33 @@ extern SDL_DECLSPEC SDL_Texture * SDLCALL IMG_LoadTextureTyped_IO(SDL_Renderer *
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is AVIF data, zero otherwise.
+ * \returns true if this is ANI animated cursor data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_isAVIF
- * \sa IMG_isICO
- * \sa IMG_isCUR
  * \sa IMG_isBMP
+ * \sa IMG_isCUR
  * \sa IMG_isGIF
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isLBM
  * \sa IMG_isPCX
  * \sa IMG_isPNG
  * \sa IMG_isPNM
- * \sa IMG_isSVG
  * \sa IMG_isQOI
+ * \sa IMG_isSVG
  * \sa IMG_isTIF
+ * \sa IMG_isWEBP
  * \sa IMG_isXCF
  * \sa IMG_isXPM
  * \sa IMG_isXV
- * \sa IMG_isWEBP
  */
-extern SDL_DECLSPEC bool SDLCALL IMG_isAVIF(SDL_IOStream *src);
+extern SDL_DECLSPEC bool SDLCALL IMG_isANI(SDL_IOStream *src);
 
 /**
- * Detect ICO image data on a readable/seekable SDL_IOStream.
+ * Detect AVIF image data on a readable/seekable SDL_IOStream.
  *
  * This function attempts to determine if a file is a given filetype, reading
  * the least amount possible from the SDL_IOStream (usually a few bytes).
@@ -431,29 +567,30 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isAVIF(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is ICO data, zero otherwise.
+ * \returns true if this is AVIF data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
- * \sa IMG_isAVIF
- * \sa IMG_isCUR
+ * \sa IMG_isANI
  * \sa IMG_isBMP
+ * \sa IMG_isCUR
  * \sa IMG_isGIF
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isLBM
  * \sa IMG_isPCX
  * \sa IMG_isPNG
  * \sa IMG_isPNM
- * \sa IMG_isSVG
  * \sa IMG_isQOI
+ * \sa IMG_isSVG
  * \sa IMG_isTIF
+ * \sa IMG_isWEBP
  * \sa IMG_isXCF
  * \sa IMG_isXPM
  * \sa IMG_isXV
- * \sa IMG_isWEBP
  */
-extern SDL_DECLSPEC bool SDLCALL IMG_isICO(SDL_IOStream *src);
+extern SDL_DECLSPEC bool SDLCALL IMG_isAVIF(SDL_IOStream *src);
 
 /**
  * Detect CUR image data on a readable/seekable SDL_IOStream.
@@ -474,27 +611,28 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isICO(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is CUR data, zero otherwise.
+ * \returns true if this is CUR data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isANI
  * \sa IMG_isAVIF
- * \sa IMG_isICO
  * \sa IMG_isBMP
  * \sa IMG_isGIF
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isLBM
  * \sa IMG_isPCX
  * \sa IMG_isPNG
  * \sa IMG_isPNM
- * \sa IMG_isSVG
  * \sa IMG_isQOI
+ * \sa IMG_isSVG
  * \sa IMG_isTIF
+ * \sa IMG_isWEBP
  * \sa IMG_isXCF
  * \sa IMG_isXPM
  * \sa IMG_isXV
- * \sa IMG_isWEBP
  */
 extern SDL_DECLSPEC bool SDLCALL IMG_isCUR(SDL_IOStream *src);
 
@@ -517,27 +655,28 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isCUR(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is BMP data, zero otherwise.
+ * \returns true if this is BMP data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isANI
  * \sa IMG_isAVIF
- * \sa IMG_isICO
  * \sa IMG_isCUR
  * \sa IMG_isGIF
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isLBM
  * \sa IMG_isPCX
  * \sa IMG_isPNG
  * \sa IMG_isPNM
- * \sa IMG_isSVG
  * \sa IMG_isQOI
+ * \sa IMG_isSVG
  * \sa IMG_isTIF
+ * \sa IMG_isWEBP
  * \sa IMG_isXCF
  * \sa IMG_isXPM
  * \sa IMG_isXV
- * \sa IMG_isWEBP
  */
 extern SDL_DECLSPEC bool SDLCALL IMG_isBMP(SDL_IOStream *src);
 
@@ -560,32 +699,33 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isBMP(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is GIF data, zero otherwise.
+ * \returns true if this is GIF data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isANI
  * \sa IMG_isAVIF
- * \sa IMG_isICO
- * \sa IMG_isCUR
  * \sa IMG_isBMP
+ * \sa IMG_isCUR
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isLBM
  * \sa IMG_isPCX
  * \sa IMG_isPNG
  * \sa IMG_isPNM
- * \sa IMG_isSVG
  * \sa IMG_isQOI
+ * \sa IMG_isSVG
  * \sa IMG_isTIF
+ * \sa IMG_isWEBP
  * \sa IMG_isXCF
  * \sa IMG_isXPM
  * \sa IMG_isXV
- * \sa IMG_isWEBP
  */
 extern SDL_DECLSPEC bool SDLCALL IMG_isGIF(SDL_IOStream *src);
 
 /**
- * Detect JPG image data on a readable/seekable SDL_IOStream.
+ * Detect ICO image data on a readable/seekable SDL_IOStream.
  *
  * This function attempts to determine if a file is a given filetype, reading
  * the least amount possible from the SDL_IOStream (usually a few bytes).
@@ -603,27 +743,72 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isGIF(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is JPG data, zero otherwise.
+ * \returns true if this is ICO data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isANI
  * \sa IMG_isAVIF
- * \sa IMG_isICO
- * \sa IMG_isCUR
  * \sa IMG_isBMP
+ * \sa IMG_isCUR
  * \sa IMG_isGIF
+ * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isLBM
  * \sa IMG_isPCX
  * \sa IMG_isPNG
  * \sa IMG_isPNM
- * \sa IMG_isSVG
  * \sa IMG_isQOI
+ * \sa IMG_isSVG
  * \sa IMG_isTIF
+ * \sa IMG_isWEBP
  * \sa IMG_isXCF
  * \sa IMG_isXPM
  * \sa IMG_isXV
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_isICO(SDL_IOStream *src);
+
+/**
+ * Detect JPG image data on a readable/seekable SDL_IOStream.
+ *
+ * This function attempts to determine if a file is a given filetype, reading
+ * the least amount possible from the SDL_IOStream (usually a few bytes).
+ *
+ * There is no distinction made between "not the filetype in question" and
+ * basic i/o errors.
+ *
+ * This function will always attempt to seek `src` back to where it started
+ * when this function was called, but it will not report any errors in doing
+ * so, but assuming seeking works, this means you can immediately use this
+ * with a different IMG_isTYPE function, or load the image without further
+ * seeking.
+ *
+ * You do not need to call this function to load data; SDL_image can work to
+ * determine file type in many cases in its standard load functions.
+ *
+ * \param src a seekable/readable SDL_IOStream to provide image data.
+ * \returns true if this is JPG data, false otherwise.
+ *
+ * \since This function is available since SDL_image 3.0.0.
+ *
+ * \sa IMG_isANI
+ * \sa IMG_isAVIF
+ * \sa IMG_isBMP
+ * \sa IMG_isCUR
+ * \sa IMG_isGIF
+ * \sa IMG_isICO
+ * \sa IMG_isJXL
+ * \sa IMG_isLBM
+ * \sa IMG_isPCX
+ * \sa IMG_isPNG
+ * \sa IMG_isPNM
+ * \sa IMG_isQOI
+ * \sa IMG_isSVG
+ * \sa IMG_isTIF
  * \sa IMG_isWEBP
+ * \sa IMG_isXCF
+ * \sa IMG_isXPM
+ * \sa IMG_isXV
  */
 extern SDL_DECLSPEC bool SDLCALL IMG_isJPG(SDL_IOStream *src);
 
@@ -646,27 +831,28 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isJPG(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is JXL data, zero otherwise.
+ * \returns true if this is JXL data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isANI
  * \sa IMG_isAVIF
- * \sa IMG_isICO
- * \sa IMG_isCUR
  * \sa IMG_isBMP
+ * \sa IMG_isCUR
  * \sa IMG_isGIF
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isLBM
  * \sa IMG_isPCX
  * \sa IMG_isPNG
  * \sa IMG_isPNM
- * \sa IMG_isSVG
  * \sa IMG_isQOI
+ * \sa IMG_isSVG
  * \sa IMG_isTIF
+ * \sa IMG_isWEBP
  * \sa IMG_isXCF
  * \sa IMG_isXPM
  * \sa IMG_isXV
- * \sa IMG_isWEBP
  */
 extern SDL_DECLSPEC bool SDLCALL IMG_isJXL(SDL_IOStream *src);
 
@@ -689,27 +875,28 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isJXL(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is LBM data, zero otherwise.
+ * \returns true if this is LBM data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isANI
  * \sa IMG_isAVIF
- * \sa IMG_isICO
- * \sa IMG_isCUR
  * \sa IMG_isBMP
+ * \sa IMG_isCUR
  * \sa IMG_isGIF
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isPCX
  * \sa IMG_isPNG
  * \sa IMG_isPNM
- * \sa IMG_isSVG
  * \sa IMG_isQOI
+ * \sa IMG_isSVG
  * \sa IMG_isTIF
+ * \sa IMG_isWEBP
  * \sa IMG_isXCF
  * \sa IMG_isXPM
  * \sa IMG_isXV
- * \sa IMG_isWEBP
  */
 extern SDL_DECLSPEC bool SDLCALL IMG_isLBM(SDL_IOStream *src);
 
@@ -732,27 +919,28 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isLBM(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is PCX data, zero otherwise.
+ * \returns true if this is PCX data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isANI
  * \sa IMG_isAVIF
- * \sa IMG_isICO
- * \sa IMG_isCUR
  * \sa IMG_isBMP
+ * \sa IMG_isCUR
  * \sa IMG_isGIF
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isLBM
  * \sa IMG_isPNG
  * \sa IMG_isPNM
- * \sa IMG_isSVG
  * \sa IMG_isQOI
+ * \sa IMG_isSVG
  * \sa IMG_isTIF
+ * \sa IMG_isWEBP
  * \sa IMG_isXCF
  * \sa IMG_isXPM
  * \sa IMG_isXV
- * \sa IMG_isWEBP
  */
 extern SDL_DECLSPEC bool SDLCALL IMG_isPCX(SDL_IOStream *src);
 
@@ -775,27 +963,28 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isPCX(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is PNG data, zero otherwise.
+ * \returns true if this is PNG data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isANI
  * \sa IMG_isAVIF
- * \sa IMG_isICO
- * \sa IMG_isCUR
  * \sa IMG_isBMP
+ * \sa IMG_isCUR
  * \sa IMG_isGIF
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isLBM
  * \sa IMG_isPCX
  * \sa IMG_isPNM
- * \sa IMG_isSVG
  * \sa IMG_isQOI
+ * \sa IMG_isSVG
  * \sa IMG_isTIF
+ * \sa IMG_isWEBP
  * \sa IMG_isXCF
  * \sa IMG_isXPM
  * \sa IMG_isXV
- * \sa IMG_isWEBP
  */
 extern SDL_DECLSPEC bool SDLCALL IMG_isPNG(SDL_IOStream *src);
 
@@ -818,32 +1007,33 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isPNG(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is PNM data, zero otherwise.
+ * \returns true if this is PNM data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isANI
  * \sa IMG_isAVIF
- * \sa IMG_isICO
- * \sa IMG_isCUR
  * \sa IMG_isBMP
+ * \sa IMG_isCUR
  * \sa IMG_isGIF
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isLBM
  * \sa IMG_isPCX
  * \sa IMG_isPNG
- * \sa IMG_isSVG
  * \sa IMG_isQOI
+ * \sa IMG_isSVG
  * \sa IMG_isTIF
+ * \sa IMG_isWEBP
  * \sa IMG_isXCF
  * \sa IMG_isXPM
  * \sa IMG_isXV
- * \sa IMG_isWEBP
  */
 extern SDL_DECLSPEC bool SDLCALL IMG_isPNM(SDL_IOStream *src);
 
 /**
- * Detect SVG image data on a readable/seekable SDL_IOStream.
+ * Detect QOI image data on a readable/seekable SDL_IOStream.
  *
  * This function attempts to determine if a file is a given filetype, reading
  * the least amount possible from the SDL_IOStream (usually a few bytes).
@@ -861,32 +1051,33 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isPNM(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is SVG data, zero otherwise.
+ * \returns true if this is QOI data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isANI
  * \sa IMG_isAVIF
- * \sa IMG_isICO
- * \sa IMG_isCUR
  * \sa IMG_isBMP
+ * \sa IMG_isCUR
  * \sa IMG_isGIF
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isLBM
  * \sa IMG_isPCX
  * \sa IMG_isPNG
  * \sa IMG_isPNM
- * \sa IMG_isQOI
+ * \sa IMG_isSVG
  * \sa IMG_isTIF
+ * \sa IMG_isWEBP
  * \sa IMG_isXCF
  * \sa IMG_isXPM
  * \sa IMG_isXV
- * \sa IMG_isWEBP
  */
-extern SDL_DECLSPEC bool SDLCALL IMG_isSVG(SDL_IOStream *src);
+extern SDL_DECLSPEC bool SDLCALL IMG_isQOI(SDL_IOStream *src);
 
 /**
- * Detect QOI image data on a readable/seekable SDL_IOStream.
+ * Detect SVG image data on a readable/seekable SDL_IOStream.
  *
  * This function attempts to determine if a file is a given filetype, reading
  * the least amount possible from the SDL_IOStream (usually a few bytes).
@@ -904,29 +1095,30 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isSVG(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is QOI data, zero otherwise.
+ * \returns true if this is SVG data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isANI
  * \sa IMG_isAVIF
- * \sa IMG_isICO
- * \sa IMG_isCUR
  * \sa IMG_isBMP
+ * \sa IMG_isCUR
  * \sa IMG_isGIF
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isLBM
  * \sa IMG_isPCX
  * \sa IMG_isPNG
  * \sa IMG_isPNM
- * \sa IMG_isSVG
+ * \sa IMG_isQOI
  * \sa IMG_isTIF
+ * \sa IMG_isWEBP
  * \sa IMG_isXCF
  * \sa IMG_isXPM
  * \sa IMG_isXV
- * \sa IMG_isWEBP
  */
-extern SDL_DECLSPEC bool SDLCALL IMG_isQOI(SDL_IOStream *src);
+extern SDL_DECLSPEC bool SDLCALL IMG_isSVG(SDL_IOStream *src);
 
 /**
  * Detect TIFF image data on a readable/seekable SDL_IOStream.
@@ -947,32 +1139,33 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isQOI(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is TIFF data, zero otherwise.
+ * \returns true if this is TIFF data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isANI
  * \sa IMG_isAVIF
- * \sa IMG_isICO
- * \sa IMG_isCUR
  * \sa IMG_isBMP
+ * \sa IMG_isCUR
  * \sa IMG_isGIF
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isLBM
  * \sa IMG_isPCX
  * \sa IMG_isPNG
  * \sa IMG_isPNM
- * \sa IMG_isSVG
  * \sa IMG_isQOI
+ * \sa IMG_isSVG
+ * \sa IMG_isWEBP
  * \sa IMG_isXCF
  * \sa IMG_isXPM
  * \sa IMG_isXV
- * \sa IMG_isWEBP
  */
 extern SDL_DECLSPEC bool SDLCALL IMG_isTIF(SDL_IOStream *src);
 
 /**
- * Detect XCF image data on a readable/seekable SDL_IOStream.
+ * Detect WEBP image data on a readable/seekable SDL_IOStream.
  *
  * This function attempts to determine if a file is a given filetype, reading
  * the least amount possible from the SDL_IOStream (usually a few bytes).
@@ -990,32 +1183,33 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isTIF(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is XCF data, zero otherwise.
+ * \returns true if this is WEBP data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isANI
  * \sa IMG_isAVIF
- * \sa IMG_isICO
- * \sa IMG_isCUR
  * \sa IMG_isBMP
+ * \sa IMG_isCUR
  * \sa IMG_isGIF
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isLBM
  * \sa IMG_isPCX
  * \sa IMG_isPNG
  * \sa IMG_isPNM
- * \sa IMG_isSVG
  * \sa IMG_isQOI
+ * \sa IMG_isSVG
  * \sa IMG_isTIF
+ * \sa IMG_isXCF
  * \sa IMG_isXPM
  * \sa IMG_isXV
- * \sa IMG_isWEBP
  */
-extern SDL_DECLSPEC bool SDLCALL IMG_isXCF(SDL_IOStream *src);
+extern SDL_DECLSPEC bool SDLCALL IMG_isWEBP(SDL_IOStream *src);
 
 /**
- * Detect XPM image data on a readable/seekable SDL_IOStream.
+ * Detect XCF image data on a readable/seekable SDL_IOStream.
  *
  * This function attempts to determine if a file is a given filetype, reading
  * the least amount possible from the SDL_IOStream (usually a few bytes).
@@ -1033,32 +1227,33 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isXCF(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is XPM data, zero otherwise.
+ * \returns true if this is XCF data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isANI
  * \sa IMG_isAVIF
- * \sa IMG_isICO
- * \sa IMG_isCUR
  * \sa IMG_isBMP
+ * \sa IMG_isCUR
  * \sa IMG_isGIF
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isLBM
  * \sa IMG_isPCX
  * \sa IMG_isPNG
  * \sa IMG_isPNM
- * \sa IMG_isSVG
  * \sa IMG_isQOI
+ * \sa IMG_isSVG
  * \sa IMG_isTIF
- * \sa IMG_isXCF
- * \sa IMG_isXV
  * \sa IMG_isWEBP
+ * \sa IMG_isXPM
+ * \sa IMG_isXV
  */
-extern SDL_DECLSPEC bool SDLCALL IMG_isXPM(SDL_IOStream *src);
+extern SDL_DECLSPEC bool SDLCALL IMG_isXCF(SDL_IOStream *src);
 
 /**
- * Detect XV image data on a readable/seekable SDL_IOStream.
+ * Detect XPM image data on a readable/seekable SDL_IOStream.
  *
  * This function attempts to determine if a file is a given filetype, reading
  * the least amount possible from the SDL_IOStream (usually a few bytes).
@@ -1076,32 +1271,33 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isXPM(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is XV data, zero otherwise.
+ * \returns true if this is XPM data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isANI
  * \sa IMG_isAVIF
- * \sa IMG_isICO
- * \sa IMG_isCUR
  * \sa IMG_isBMP
+ * \sa IMG_isCUR
  * \sa IMG_isGIF
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isLBM
  * \sa IMG_isPCX
  * \sa IMG_isPNG
  * \sa IMG_isPNM
- * \sa IMG_isSVG
  * \sa IMG_isQOI
+ * \sa IMG_isSVG
  * \sa IMG_isTIF
- * \sa IMG_isXCF
- * \sa IMG_isXPM
  * \sa IMG_isWEBP
+ * \sa IMG_isXCF
+ * \sa IMG_isXV
  */
-extern SDL_DECLSPEC bool SDLCALL IMG_isXV(SDL_IOStream *src);
+extern SDL_DECLSPEC bool SDLCALL IMG_isXPM(SDL_IOStream *src);
 
 /**
- * Detect WEBP image data on a readable/seekable SDL_IOStream.
+ * Detect XV image data on a readable/seekable SDL_IOStream.
  *
  * This function attempts to determine if a file is a given filetype, reading
  * the least amount possible from the SDL_IOStream (usually a few bytes).
@@ -1119,29 +1315,30 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isXV(SDL_IOStream *src);
  * determine file type in many cases in its standard load functions.
  *
  * \param src a seekable/readable SDL_IOStream to provide image data.
- * \returns non-zero if this is WEBP data, zero otherwise.
+ * \returns true if this is XV data, false otherwise.
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isANI
  * \sa IMG_isAVIF
- * \sa IMG_isICO
- * \sa IMG_isCUR
  * \sa IMG_isBMP
+ * \sa IMG_isCUR
  * \sa IMG_isGIF
+ * \sa IMG_isICO
  * \sa IMG_isJPG
  * \sa IMG_isJXL
  * \sa IMG_isLBM
  * \sa IMG_isPCX
  * \sa IMG_isPNG
  * \sa IMG_isPNM
- * \sa IMG_isSVG
  * \sa IMG_isQOI
+ * \sa IMG_isSVG
  * \sa IMG_isTIF
+ * \sa IMG_isWEBP
  * \sa IMG_isXCF
  * \sa IMG_isXPM
- * \sa IMG_isXV
  */
-extern SDL_DECLSPEC bool SDLCALL IMG_isWEBP(SDL_IOStream *src);
+extern SDL_DECLSPEC bool SDLCALL IMG_isXV(SDL_IOStream *src);
 
 /**
  * Load a AVIF image directly.
@@ -1156,31 +1353,31 @@ extern SDL_DECLSPEC bool SDLCALL IMG_isWEBP(SDL_IOStream *src);
  *
  * \since This function is available since SDL_image 3.0.0.
  *
- * \sa IMG_LoadICO_IO
- * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadBMP_IO
+ * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
  * \sa IMG_LoadPCX_IO
  * \sa IMG_LoadPNG_IO
  * \sa IMG_LoadPNM_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
+ * \sa IMG_LoadWEBP_IO
  * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadXV_IO
- * \sa IMG_LoadWEBP_IO
  */
 extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadAVIF_IO(SDL_IOStream *src);
 
 /**
- * Load a ICO image directly.
+ * Load a BMP image directly.
  *
- * If you know you definitely have a ICO image, you can call this function,
+ * If you know you definitely have a BMP image, you can call this function,
  * which will skip SDL_image's file format detection routines. Generally it's
  * better to use the abstract interfaces; also, there is only an SDL_IOStream
  * interface available here.
@@ -1192,24 +1389,24 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadAVIF_IO(SDL_IOStream *src);
  *
  * \sa IMG_LoadAVIF_IO
  * \sa IMG_LoadCUR_IO
- * \sa IMG_LoadBMP_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
  * \sa IMG_LoadPCX_IO
  * \sa IMG_LoadPNG_IO
  * \sa IMG_LoadPNM_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
+ * \sa IMG_LoadWEBP_IO
  * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadXV_IO
- * \sa IMG_LoadWEBP_IO
  */
-extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadICO_IO(SDL_IOStream *src);
+extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadBMP_IO(SDL_IOStream *src);
 
 /**
  * Load a CUR image directly.
@@ -1225,30 +1422,30 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadICO_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
  * \sa IMG_LoadBMP_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
  * \sa IMG_LoadPCX_IO
  * \sa IMG_LoadPNG_IO
  * \sa IMG_LoadPNM_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
+ * \sa IMG_LoadWEBP_IO
  * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadXV_IO
- * \sa IMG_LoadWEBP_IO
  */
 extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadCUR_IO(SDL_IOStream *src);
 
 /**
- * Load a BMP image directly.
+ * Load a GIF image directly.
  *
- * If you know you definitely have a BMP image, you can call this function,
+ * If you know you definitely have a GIF image, you can call this function,
  * which will skip SDL_image's file format detection routines. Generally it's
  * better to use the abstract interfaces; also, there is only an SDL_IOStream
  * interface available here.
@@ -1259,30 +1456,30 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadCUR_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
+ * \sa IMG_LoadBMP_IO
  * \sa IMG_LoadCUR_IO
- * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
  * \sa IMG_LoadPCX_IO
  * \sa IMG_LoadPNG_IO
  * \sa IMG_LoadPNM_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
+ * \sa IMG_LoadWEBP_IO
  * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadXV_IO
- * \sa IMG_LoadWEBP_IO
  */
-extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadBMP_IO(SDL_IOStream *src);
+extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadGIF_IO(SDL_IOStream *src);
 
 /**
- * Load a GIF image directly.
+ * Load a ICO image directly.
  *
- * If you know you definitely have a GIF image, you can call this function,
+ * If you know you definitely have a ICO image, you can call this function,
  * which will skip SDL_image's file format detection routines. Generally it's
  * better to use the abstract interfaces; also, there is only an SDL_IOStream
  * interface available here.
@@ -1293,25 +1490,25 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadBMP_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
- * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadBMP_IO
+ * \sa IMG_LoadCUR_IO
+ * \sa IMG_LoadGIF_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
  * \sa IMG_LoadPCX_IO
  * \sa IMG_LoadPNG_IO
  * \sa IMG_LoadPNM_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
+ * \sa IMG_LoadWEBP_IO
  * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadXV_IO
- * \sa IMG_LoadWEBP_IO
  */
-extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadGIF_IO(SDL_IOStream *src);
+extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadICO_IO(SDL_IOStream *src);
 
 /**
  * Load a JPG image directly.
@@ -1327,23 +1524,23 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadGIF_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
- * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadBMP_IO
+ * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
  * \sa IMG_LoadPCX_IO
  * \sa IMG_LoadPNG_IO
  * \sa IMG_LoadPNM_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
+ * \sa IMG_LoadWEBP_IO
  * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadXV_IO
- * \sa IMG_LoadWEBP_IO
  */
 extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadJPG_IO(SDL_IOStream *src);
 
@@ -1361,23 +1558,23 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadJPG_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
- * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadBMP_IO
+ * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadLBM_IO
  * \sa IMG_LoadPCX_IO
  * \sa IMG_LoadPNG_IO
  * \sa IMG_LoadPNM_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
+ * \sa IMG_LoadWEBP_IO
  * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadXV_IO
- * \sa IMG_LoadWEBP_IO
  */
 extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadJXL_IO(SDL_IOStream *src);
 
@@ -1395,23 +1592,23 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadJXL_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
- * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadBMP_IO
+ * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadPCX_IO
  * \sa IMG_LoadPNG_IO
  * \sa IMG_LoadPNM_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
+ * \sa IMG_LoadWEBP_IO
  * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadXV_IO
- * \sa IMG_LoadWEBP_IO
  */
 extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadLBM_IO(SDL_IOStream *src);
 
@@ -1429,23 +1626,23 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadLBM_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
- * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadBMP_IO
+ * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
  * \sa IMG_LoadPNG_IO
  * \sa IMG_LoadPNM_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
+ * \sa IMG_LoadWEBP_IO
  * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadXV_IO
- * \sa IMG_LoadWEBP_IO
  */
 extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadPCX_IO(SDL_IOStream *src);
 
@@ -1463,23 +1660,23 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadPCX_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
- * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadBMP_IO
+ * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
  * \sa IMG_LoadPCX_IO
  * \sa IMG_LoadPNM_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
+ * \sa IMG_LoadWEBP_IO
  * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadXV_IO
- * \sa IMG_LoadWEBP_IO
  */
 extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadPNG_IO(SDL_IOStream *src);
 
@@ -1497,23 +1694,23 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadPNG_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
- * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadBMP_IO
+ * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
  * \sa IMG_LoadPCX_IO
  * \sa IMG_LoadPNG_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
+ * \sa IMG_LoadWEBP_IO
  * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadXV_IO
- * \sa IMG_LoadWEBP_IO
  */
 extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadPNM_IO(SDL_IOStream *src);
 
@@ -1531,10 +1728,10 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadPNM_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
- * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadBMP_IO
+ * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
@@ -1542,16 +1739,40 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadPNM_IO(SDL_IOStream *src);
  * \sa IMG_LoadPNG_IO
  * \sa IMG_LoadPNM_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSizedSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
+ * \sa IMG_LoadWEBP_IO
  * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadXV_IO
- * \sa IMG_LoadWEBP_IO
  */
 extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadSVG_IO(SDL_IOStream *src);
 
 /**
+ * Load an SVG image, scaled to a specific size.
+ *
+ * Since SVG files are resolution-independent, you specify the size you would
+ * like the output image to be and it will be generated at those dimensions.
+ *
+ * Either width or height may be 0 and the image will be auto-sized to
+ * preserve aspect ratio.
+ *
+ * When done with the returned surface, the app should dispose of it with a
+ * call to SDL_DestroySurface().
+ *
+ * \param src an SDL_IOStream to load SVG data from.
+ * \param width desired width of the generated surface, in pixels.
+ * \param height desired height of the generated surface, in pixels.
+ * \returns a new SDL surface, or NULL on error.
+ *
+ * \since This function is available since SDL_image 3.0.0.
+ *
+ * \sa IMG_LoadSVG_IO
+ */
+extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadSizedSVG_IO(SDL_IOStream *src, int width, int height);
+
+/**
  * Load a QOI image directly.
  *
  * If you know you definitely have a QOI image, you can call this function,
@@ -1565,10 +1786,10 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadSVG_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
- * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadBMP_IO
+ * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
@@ -1578,10 +1799,10 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadSVG_IO(SDL_IOStream *src);
  * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
+ * \sa IMG_LoadWEBP_IO
  * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadXV_IO
- * \sa IMG_LoadWEBP_IO
  */
 extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadQOI_IO(SDL_IOStream *src);
 
@@ -1599,23 +1820,23 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadQOI_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
- * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadBMP_IO
+ * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
  * \sa IMG_LoadPCX_IO
  * \sa IMG_LoadPNG_IO
  * \sa IMG_LoadPNM_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTIF_IO
+ * \sa IMG_LoadWEBP_IO
  * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadXV_IO
- * \sa IMG_LoadWEBP_IO
  */
 extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadTGA_IO(SDL_IOStream *src);
 
@@ -1633,30 +1854,30 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadTGA_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
- * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadBMP_IO
+ * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
  * \sa IMG_LoadPCX_IO
  * \sa IMG_LoadPNG_IO
  * \sa IMG_LoadPNM_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
+ * \sa IMG_LoadWEBP_IO
  * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadXV_IO
- * \sa IMG_LoadWEBP_IO
  */
 extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadTIF_IO(SDL_IOStream *src);
 
 /**
- * Load a XCF image directly.
+ * Load a WEBP image directly.
  *
- * If you know you definitely have a XCF image, you can call this function,
+ * If you know you definitely have a WEBP image, you can call this function,
  * which will skip SDL_image's file format detection routines. Generally it's
  * better to use the abstract interfaces; also, there is only an SDL_IOStream
  * interface available here.
@@ -1667,30 +1888,30 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadTIF_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
- * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadBMP_IO
+ * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
  * \sa IMG_LoadPCX_IO
  * \sa IMG_LoadPNG_IO
  * \sa IMG_LoadPNM_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
+ * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadXV_IO
- * \sa IMG_LoadWEBP_IO
  */
-extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadXCF_IO(SDL_IOStream *src);
+extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadWEBP_IO(SDL_IOStream *src);
 
 /**
- * Load a XPM image directly.
+ * Load a XCF image directly.
  *
- * If you know you definitely have a XPM image, you can call this function,
+ * If you know you definitely have a XCF image, you can call this function,
  * which will skip SDL_image's file format detection routines. Generally it's
  * better to use the abstract interfaces; also, there is only an SDL_IOStream
  * interface available here.
@@ -1701,30 +1922,30 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadXCF_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
- * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadBMP_IO
+ * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
  * \sa IMG_LoadPCX_IO
  * \sa IMG_LoadPNG_IO
  * \sa IMG_LoadPNM_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
- * \sa IMG_LoadXCF_IO
- * \sa IMG_LoadXV_IO
  * \sa IMG_LoadWEBP_IO
+ * \sa IMG_LoadXPM_IO
+ * \sa IMG_LoadXV_IO
  */
-extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadXPM_IO(SDL_IOStream *src);
+extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadXCF_IO(SDL_IOStream *src);
 
 /**
- * Load a XV image directly.
+ * Load a XPM image directly.
  *
- * If you know you definitely have a XV image, you can call this function,
+ * If you know you definitely have a XPM image, you can call this function,
  * which will skip SDL_image's file format detection routines. Generally it's
  * better to use the abstract interfaces; also, there is only an SDL_IOStream
  * interface available here.
@@ -1735,30 +1956,30 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadXPM_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
- * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadBMP_IO
+ * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
  * \sa IMG_LoadPCX_IO
  * \sa IMG_LoadPNG_IO
  * \sa IMG_LoadPNM_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
- * \sa IMG_LoadXCF_IO
- * \sa IMG_LoadXPM_IO
  * \sa IMG_LoadWEBP_IO
+ * \sa IMG_LoadXCF_IO
+ * \sa IMG_LoadXV_IO
  */
-extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadXV_IO(SDL_IOStream *src);
+extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadXPM_IO(SDL_IOStream *src);
 
 /**
- * Load a WEBP image directly.
+ * Load a XV image directly.
  *
- * If you know you definitely have a WEBP image, you can call this function,
+ * If you know you definitely have a XV image, you can call this function,
  * which will skip SDL_image's file format detection routines. Generally it's
  * better to use the abstract interfaces; also, there is only an SDL_IOStream
  * interface available here.
@@ -1769,46 +1990,25 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadXV_IO(SDL_IOStream *src);
  * \since This function is available since SDL_image 3.0.0.
  *
  * \sa IMG_LoadAVIF_IO
- * \sa IMG_LoadICO_IO
- * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadBMP_IO
+ * \sa IMG_LoadCUR_IO
  * \sa IMG_LoadGIF_IO
+ * \sa IMG_LoadICO_IO
  * \sa IMG_LoadJPG_IO
  * \sa IMG_LoadJXL_IO
  * \sa IMG_LoadLBM_IO
  * \sa IMG_LoadPCX_IO
  * \sa IMG_LoadPNG_IO
  * \sa IMG_LoadPNM_IO
- * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadQOI_IO
+ * \sa IMG_LoadSVG_IO
  * \sa IMG_LoadTGA_IO
  * \sa IMG_LoadTIF_IO
+ * \sa IMG_LoadWEBP_IO
  * \sa IMG_LoadXCF_IO
  * \sa IMG_LoadXPM_IO
- * \sa IMG_LoadXV_IO
  */
-extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadWEBP_IO(SDL_IOStream *src);
-
-/**
- * Load an SVG image, scaled to a specific size.
- *
- * Since SVG files are resolution-independent, you specify the size you would
- * like the output image to be and it will be generated at those dimensions.
- *
- * Either width or height may be 0 and the image will be auto-sized to
- * preserve aspect ratio.
- *
- * When done with the returned surface, the app should dispose of it with a
- * call to SDL_DestroySurface().
- *
- * \param src an SDL_IOStream to load SVG data from.
- * \param width desired width of the generated surface, in pixels.
- * \param height desired height of the generated surface, in pixels.
- * \returns a new SDL surface, or NULL on error.
- *
- * \since This function is available since SDL_image 3.0.0.
- */
-extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadSizedSVG_IO(SDL_IOStream *src, int width, int height);
+extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_LoadXV_IO(SDL_IOStream *src);
 
 /**
  * Load an XPM image from a memory array.
@@ -1849,6 +2049,67 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_ReadXPMFromArray(char **xpm);
 extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_ReadXPMFromArrayToRGB888(char **xpm);
 
 /**
+ * Save an SDL_Surface into an image file.
+ *
+ * If the file already exists, it will be overwritten.
+ *
+ * For formats that accept a quality, a default quality of 90 will be used.
+ *
+ * \param surface the SDL surface to save.
+ * \param file path on the filesystem to write new file to.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveTyped_IO
+ * \sa IMG_SaveAVIF
+ * \sa IMG_SaveBMP
+ * \sa IMG_SaveCUR
+ * \sa IMG_SaveGIF
+ * \sa IMG_SaveICO
+ * \sa IMG_SaveJPG
+ * \sa IMG_SavePNG
+ * \sa IMG_SaveTGA
+ * \sa IMG_SaveWEBP
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_Save(SDL_Surface *surface, const char *file);
+
+/**
+ * Save an SDL_Surface into formatted image data, via an SDL_IOStream.
+ *
+ * If you just want to save to a filename, you can use IMG_Save() instead.
+ *
+ * If `closeio` is true, `dst` will be closed before returning, whether this
+ * function succeeds or not.
+ *
+ * For formats that accept a quality, a default quality of 90 will be used.
+ *
+ * \param surface the SDL surface to save.
+ * \param dst the SDL_IOStream to save the image data to.
+ * \param closeio true to close/free the SDL_IOStream before returning, false
+ *                to leave it open.
+ * \param type a filename extension that represent this data ("BMP", "GIF",
+ *             "PNG", etc).
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_Save
+ * \sa IMG_SaveAVIF_IO
+ * \sa IMG_SaveBMP_IO
+ * \sa IMG_SaveCUR_IO
+ * \sa IMG_SaveGIF_IO
+ * \sa IMG_SaveICO_IO
+ * \sa IMG_SaveJPG_IO
+ * \sa IMG_SavePNG_IO
+ * \sa IMG_SaveTGA_IO
+ * \sa IMG_SaveWEBP_IO
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveTyped_IO(SDL_Surface *surface, SDL_IOStream *dst, bool closeio, const char *type);
+
+/**
  * Save an SDL_Surface into a AVIF image file.
  *
  * If the file already exists, it will be overwritten.
@@ -1890,7 +2151,7 @@ extern SDL_DECLSPEC bool SDLCALL IMG_SaveAVIF(SDL_Surface *surface, const char *
 extern SDL_DECLSPEC bool SDLCALL IMG_SaveAVIF_IO(SDL_Surface *surface, SDL_IOStream *dst, bool closeio, int quality);
 
 /**
- * Save an SDL_Surface into a PNG image file.
+ * Save an SDL_Surface into a BMP image file.
  *
  * If the file already exists, it will be overwritten.
  *
@@ -1899,16 +2160,16 @@ extern SDL_DECLSPEC bool SDLCALL IMG_SaveAVIF_IO(SDL_Surface *surface, SDL_IOStr
  * \returns true on success or false on failure; call SDL_GetError() for more
  *          information.
  *
- * \since This function is available since SDL_image 3.0.0.
+ * \since This function is available since SDL_image 3.4.0.
  *
- * \sa IMG_SavePNG_IO
+ * \sa IMG_SaveBMP_IO
  */
-extern SDL_DECLSPEC bool SDLCALL IMG_SavePNG(SDL_Surface *surface, const char *file);
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveBMP(SDL_Surface *surface, const char *file);
 
 /**
- * Save an SDL_Surface into PNG image data, via an SDL_IOStream.
+ * Save an SDL_Surface into BMP image data, via an SDL_IOStream.
  *
- * If you just want to save to a filename, you can use IMG_SavePNG() instead.
+ * If you just want to save to a filename, you can use IMG_SaveBMP() instead.
  *
  * If `closeio` is true, `dst` will be closed before returning, whether this
  * function succeeds or not.
@@ -1920,11 +2181,122 @@ extern SDL_DECLSPEC bool SDLCALL IMG_SavePNG(SDL_Surface *surface, const char *f
  * \returns true on success or false on failure; call SDL_GetError() for more
  *          information.
  *
- * \since This function is available since SDL_image 3.0.0.
+ * \since This function is available since SDL_image 3.4.0.
  *
- * \sa IMG_SavePNG
+ * \sa IMG_SaveBMP
  */
-extern SDL_DECLSPEC bool SDLCALL IMG_SavePNG_IO(SDL_Surface *surface, SDL_IOStream *dst, bool closeio);
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveBMP_IO(SDL_Surface *surface, SDL_IOStream *dst, bool closeio);
+
+/**
+ * Save an SDL_Surface into a CUR image file.
+ *
+ * If the file already exists, it will be overwritten.
+ *
+ * \param surface the SDL surface to save.
+ * \param file path on the filesystem to write new file to.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveCUR_IO
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveCUR(SDL_Surface *surface, const char *file);
+
+/**
+ * Save an SDL_Surface into CUR image data, via an SDL_IOStream.
+ *
+ * If you just want to save to a filename, you can use IMG_SaveCUR() instead.
+ *
+ * If `closeio` is true, `dst` will be closed before returning, whether this
+ * function succeeds or not.
+ *
+ * \param surface the SDL surface to save.
+ * \param dst the SDL_IOStream to save the image data to.
+ * \param closeio true to close/free the SDL_IOStream before returning, false
+ *                to leave it open.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveCUR
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveCUR_IO(SDL_Surface *surface, SDL_IOStream *dst, bool closeio);
+
+/**
+ * Save an SDL_Surface into a GIF image file.
+ *
+ * If the file already exists, it will be overwritten.
+ *
+ * \param surface the SDL surface to save.
+ * \param file path on the filesystem to write new file to.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveGIF_IO
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveGIF(SDL_Surface *surface, const char *file);
+
+/**
+ * Save an SDL_Surface into GIF image data, via an SDL_IOStream.
+ *
+ * If you just want to save to a filename, you can use IMG_SaveGIF() instead.
+ *
+ * If `closeio` is true, `dst` will be closed before returning, whether this
+ * function succeeds or not.
+ *
+ * \param surface the SDL surface to save.
+ * \param dst the SDL_IOStream to save the image data to.
+ * \param closeio true to close/free the SDL_IOStream before returning, false
+ *                to leave it open.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveGIF
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveGIF_IO(SDL_Surface *surface, SDL_IOStream *dst, bool closeio);
+
+/**
+ * Save an SDL_Surface into a ICO image file.
+ *
+ * If the file already exists, it will be overwritten.
+ *
+ * \param surface the SDL surface to save.
+ * \param file path on the filesystem to write new file to.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveICO_IO
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveICO(SDL_Surface *surface, const char *file);
+
+/**
+ * Save an SDL_Surface into ICO image data, via an SDL_IOStream.
+ *
+ * If you just want to save to a filename, you can use IMG_SaveICO() instead.
+ *
+ * If `closeio` is true, `dst` will be closed before returning, whether this
+ * function succeeds or not.
+ *
+ * \param surface the SDL surface to save.
+ * \param dst the SDL_IOStream to save the image data to.
+ * \param closeio true to close/free the SDL_IOStream before returning, false
+ *                to leave it open.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveICO
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveICO_IO(SDL_Surface *surface, SDL_IOStream *dst, bool closeio);
 
 /**
  * Save an SDL_Surface into a JPEG image file.
@@ -1968,16 +2340,134 @@ extern SDL_DECLSPEC bool SDLCALL IMG_SaveJPG(SDL_Surface *surface, const char *f
 extern SDL_DECLSPEC bool SDLCALL IMG_SaveJPG_IO(SDL_Surface *surface, SDL_IOStream *dst, bool closeio, int quality);
 
 /**
- * Animated image support
+ * Save an SDL_Surface into a PNG image file.
+ *
+ * If the file already exists, it will be overwritten.
+ *
+ * \param surface the SDL surface to save.
+ * \param file path on the filesystem to write new file to.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.0.0.
+ *
+ * \sa IMG_SavePNG_IO
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SavePNG(SDL_Surface *surface, const char *file);
+
+/**
+ * Save an SDL_Surface into PNG image data, via an SDL_IOStream.
+ *
+ * If you just want to save to a filename, you can use IMG_SavePNG() instead.
+ *
+ * If `closeio` is true, `dst` will be closed before returning, whether this
+ * function succeeds or not.
+ *
+ * \param surface the SDL surface to save.
+ * \param dst the SDL_IOStream to save the image data to.
+ * \param closeio true to close/free the SDL_IOStream before returning, false
+ *                to leave it open.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.0.0.
+ *
+ * \sa IMG_SavePNG
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SavePNG_IO(SDL_Surface *surface, SDL_IOStream *dst, bool closeio);
+
+/**
+ * Save an SDL_Surface into a TGA image file.
+ *
+ * If the file already exists, it will be overwritten.
+ *
+ * \param surface the SDL surface to save.
+ * \param file path on the filesystem to write new file to.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveTGA_IO
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveTGA(SDL_Surface *surface, const char *file);
+
+/**
+ * Save an SDL_Surface into TGA image data, via an SDL_IOStream.
+ *
+ * If you just want to save to a filename, you can use IMG_SaveTGA() instead.
  *
- * Currently only animated GIFs and WEBP images are supported.
+ * If `closeio` is true, `dst` will be closed before returning, whether this
+ * function succeeds or not.
+ *
+ * \param surface the SDL surface to save.
+ * \param dst the SDL_IOStream to save the image data to.
+ * \param closeio true to close/free the SDL_IOStream before returning, false
+ *                to leave it open.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveTGA
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveTGA_IO(SDL_Surface *surface, SDL_IOStream *dst, bool closeio);
+
+/**
+ * Save an SDL_Surface into a WEBP image file.
+ *
+ * If the file already exists, it will be overwritten.
+ *
+ * \param surface the SDL surface to save.
+ * \param file path on the filesystem to write the new file to.
+ * \param quality between 0 and 100. For lossy, 0 gives the smallest size and
+ *                100 the largest. For lossless, this parameter is the amount
+ *                of effort put into the compression: 0 is the fastest but
+ *                gives larger files compared to the slowest, but best, 100.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveWEBP_IO
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveWEBP(SDL_Surface *surface, const char *file, float quality);
+
+/**
+ * Save an SDL_Surface into WEBP image data, via an SDL_IOStream.
+ *
+ * If you just want to save to a filename, you can use IMG_SaveWEBP() instead.
+ *
+ * If `closeio` is true, `dst` will be closed before returning, whether this
+ * function succeeds or not.
+ *
+ * \param surface the SDL surface to save.
+ * \param dst the SDL_IOStream to save the image data to.
+ * \param closeio true to close/free the SDL_IOStream before returning, false
+ *                to leave it open.
+ * \param quality between 0 and 100. For lossy, 0 gives the smallest size and
+ *                100 the largest. For lossless, this parameter is the amount
+ *                of effort put into the compression: 0 is the fastest but
+ *                gives larger files compared to the slowest, but best, 100.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveWEBP
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveWEBP_IO(SDL_Surface *surface, SDL_IOStream *dst, bool closeio, float quality);
+
+/**
+ * Animated image support
  */
 typedef struct IMG_Animation
 {
-	int w, h;
-	int count;
-	SDL_Surface **frames;
-	int *delays;
+    int w;                  /**< The width of the frames */
+    int h;                  /**< The height of the frames */
+    int count;              /**< The number of frames */
+    SDL_Surface **frames;   /**< An array of frames */
+    int *delays;            /**< An array of frame delays, in milliseconds */
 } IMG_Animation;
 
 /**
@@ -1991,6 +2481,14 @@ typedef struct IMG_Animation
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_CreateAnimatedCursor
+ * \sa IMG_LoadAnimation_IO
+ * \sa IMG_LoadAnimationTyped_IO
+ * \sa IMG_LoadANIAnimation_IO
+ * \sa IMG_LoadAPNGAnimation_IO
+ * \sa IMG_LoadAVIFAnimation_IO
+ * \sa IMG_LoadGIFAnimation_IO
+ * \sa IMG_LoadWEBPAnimation_IO
  * \sa IMG_FreeAnimation
  */
 extern SDL_DECLSPEC IMG_Animation * SDLCALL IMG_LoadAnimation(const char *file);
@@ -2012,12 +2510,20 @@ extern SDL_DECLSPEC IMG_Animation * SDLCALL IMG_LoadAnimation(const char *file);
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_CreateAnimatedCursor
+ * \sa IMG_LoadAnimation
+ * \sa IMG_LoadAnimationTyped_IO
+ * \sa IMG_LoadANIAnimation_IO
+ * \sa IMG_LoadAPNGAnimation_IO
+ * \sa IMG_LoadAVIFAnimation_IO
+ * \sa IMG_LoadGIFAnimation_IO
+ * \sa IMG_LoadWEBPAnimation_IO
  * \sa IMG_FreeAnimation
  */
 extern SDL_DECLSPEC IMG_Animation * SDLCALL IMG_LoadAnimation_IO(SDL_IOStream *src, bool closeio);
 
 /**
- * Load an animation from an SDL datasource
+ * Load an animation from an SDL_IOStream.
  *
  * Even though this function accepts a file type, SDL_image may still try
  * other decoders that are capable of detecting file type from the contents of
@@ -2040,26 +2546,101 @@ extern SDL_DECLSPEC IMG_Animation * SDLCALL IMG_LoadAnimation_IO(SDL_IOStream *s
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_CreateAnimatedCursor
  * \sa IMG_LoadAnimation
  * \sa IMG_LoadAnimation_IO
+ * \sa IMG_LoadANIAnimation_IO
+ * \sa IMG_LoadAPNGAnimation_IO
+ * \sa IMG_LoadAVIFAnimation_IO
+ * \sa IMG_LoadGIFAnimation_IO
+ * \sa IMG_LoadWEBPAnimation_IO
  * \sa IMG_FreeAnimation
  */
 extern SDL_DECLSPEC IMG_Animation * SDLCALL IMG_LoadAnimationTyped_IO(SDL_IOStream *src, bool closeio, const char *type);
 
 /**
- * Dispose of an IMG_Animation and free its resources.
+ * Load an ANI animation directly from an SDL_IOStream.
  *
- * The provided `anim` pointer is not valid once this call returns.
+ * If you know you definitely have an ANI image, you can call this function,
+ * which will skip SDL_image's file format detection routines. Generally, it's
+ * better to use the abstract interfaces; also, there is only an SDL_IOStream
+ * interface available here.
  *
- * \param anim IMG_Animation to dispose of.
+ * When done with the returned animation, the app should dispose of it with a
+ * call to IMG_FreeAnimation().
  *
- * \since This function is available since SDL_image 3.0.0.
+ * \param src an SDL_IOStream from which data will be read.
+ * \returns a new IMG_Animation, or NULL on error.
  *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_isANI
  * \sa IMG_LoadAnimation
  * \sa IMG_LoadAnimation_IO
  * \sa IMG_LoadAnimationTyped_IO
+ * \sa IMG_LoadAPNGAnimation_IO
+ * \sa IMG_LoadAVIFAnimation_IO
+ * \sa IMG_LoadGIFAnimation_IO
+ * \sa IMG_LoadWEBPAnimation_IO
+ * \sa IMG_FreeAnimation
  */
-extern SDL_DECLSPEC void SDLCALL IMG_FreeAnimation(IMG_Animation *anim);
+extern SDL_DECLSPEC IMG_Animation *SDLCALL IMG_LoadANIAnimation_IO(SDL_IOStream *src);
+
+/**
+ * Load an APNG animation directly from an SDL_IOStream.
+ *
+ * If you know you definitely have an APNG image, you can call this function,
+ * which will skip SDL_image's file format detection routines. Generally, it's
+ * better to use the abstract interfaces; also, there is only an SDL_IOStream
+ * interface available here.
+ *
+ * When done with the returned animation, the app should dispose of it with a
+ * call to IMG_FreeAnimation().
+ *
+ * \param src an SDL_IOStream from which data will be read.
+ * \returns a new IMG_Animation, or NULL on error.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_isPNG
+ * \sa IMG_LoadAnimation
+ * \sa IMG_LoadAnimation_IO
+ * \sa IMG_LoadAnimationTyped_IO
+ * \sa IMG_LoadANIAnimation_IO
+ * \sa IMG_LoadAVIFAnimation_IO
+ * \sa IMG_LoadGIFAnimation_IO
+ * \sa IMG_LoadWEBPAnimation_IO
+ * \sa IMG_FreeAnimation
+ */
+extern SDL_DECLSPEC IMG_Animation *SDLCALL IMG_LoadAPNGAnimation_IO(SDL_IOStream *src);
+
+/**
+ * Load an AVIF animation directly from an SDL_IOStream.
+ *
+ * If you know you definitely have an AVIF animation, you can call this
+ * function, which will skip SDL_image's file format detection routines.
+ * Generally it's better to use the abstract interfaces; also, there is only
+ * an SDL_IOStream interface available here.
+ *
+ * When done with the returned animation, the app should dispose of it with a
+ * call to IMG_FreeAnimation().
+ *
+ * \param src an SDL_IOStream that data will be read from.
+ * \returns a new IMG_Animation, or NULL on error.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_isAVIF
+ * \sa IMG_LoadAnimation
+ * \sa IMG_LoadAnimation_IO
+ * \sa IMG_LoadAnimationTyped_IO
+ * \sa IMG_LoadANIAnimation_IO
+ * \sa IMG_LoadAPNGAnimation_IO
+ * \sa IMG_LoadGIFAnimation_IO
+ * \sa IMG_LoadWEBPAnimation_IO
+ * \sa IMG_FreeAnimation
+ */
+extern SDL_DECLSPEC IMG_Animation *SDLCALL IMG_LoadAVIFAnimation_IO(SDL_IOStream *src);
 
 /**
  * Load a GIF animation directly.
@@ -2074,9 +2655,14 @@ extern SDL_DECLSPEC void SDLCALL IMG_FreeAnimation(IMG_Animation *anim);
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isGIF
  * \sa IMG_LoadAnimation
  * \sa IMG_LoadAnimation_IO
  * \sa IMG_LoadAnimationTyped_IO
+ * \sa IMG_LoadANIAnimation_IO
+ * \sa IMG_LoadAPNGAnimation_IO
+ * \sa IMG_LoadAVIFAnimation_IO
+ * \sa IMG_LoadWEBPAnimation_IO
  * \sa IMG_FreeAnimation
  */
 extern SDL_DECLSPEC IMG_Animation * SDLCALL IMG_LoadGIFAnimation_IO(SDL_IOStream *src);
@@ -2094,13 +2680,643 @@ extern SDL_DECLSPEC IMG_Animation * SDLCALL IMG_LoadGIFAnimation_IO(SDL_IOStream
  *
  * \since This function is available since SDL_image 3.0.0.
  *
+ * \sa IMG_isWEBP
  * \sa IMG_LoadAnimation
  * \sa IMG_LoadAnimation_IO
  * \sa IMG_LoadAnimationTyped_IO
+ * \sa IMG_LoadANIAnimation_IO
+ * \sa IMG_LoadAPNGAnimation_IO
+ * \sa IMG_LoadAVIFAnimation_IO
+ * \sa IMG_LoadGIFAnimation_IO
  * \sa IMG_FreeAnimation
  */
 extern SDL_DECLSPEC IMG_Animation * SDLCALL IMG_LoadWEBPAnimation_IO(SDL_IOStream *src);
 
+/**
+ * Save an animation to a file.
+ *
+ * For formats that accept a quality, a default quality of 90 will be used.
+ *
+ * \param anim the animation to save.
+ * \param file path on the filesystem containing an animated image.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveAnimationTyped_IO
+ * \sa IMG_SaveANIAnimation_IO
+ * \sa IMG_SaveAPNGAnimation_IO
+ * \sa IMG_SaveAVIFAnimation_IO
+ * \sa IMG_SaveGIFAnimation_IO
+ * \sa IMG_SaveWEBPAnimation_IO
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveAnimation(IMG_Animation *anim, const char *file);
+
+/**
+ * Save an animation to an SDL_IOStream.
+ *
+ * If you just want to save to a filename, you can use IMG_SaveAnimation()
+ * instead.
+ *
+ * If `closeio` is true, `dst` will be closed before returning, whether this
+ * function succeeds or not.
+ *
+ * For formats that accept a quality, a default quality of 90 will be used.
+ *
+ * \param anim the animation to save.
+ * \param dst an SDL_IOStream that data will be written to.
+ * \param closeio true to close/free the SDL_IOStream before returning, false
+ *                to leave it open.
+ * \param type a filename extension that represent this data ("GIF", etc).
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveAnimation
+ * \sa IMG_SaveANIAnimation_IO
+ * \sa IMG_SaveAPNGAnimation_IO
+ * \sa IMG_SaveAVIFAnimation_IO
+ * \sa IMG_SaveGIFAnimation_IO
+ * \sa IMG_SaveWEBPAnimation_IO
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveAnimationTyped_IO(IMG_Animation *anim, SDL_IOStream *dst, bool closeio, const char *type);
+
+/**
+ * Save an animation in ANI format to an SDL_IOStream.
+ *
+ * If `closeio` is true, `dst` will be closed before returning, whether this
+ * function succeeds or not.
+ *
+ * \param anim the animation to save.
+ * \param dst an SDL_IOStream from which data will be written to.
+ * \param closeio true to close/free the SDL_IOStream before returning, false
+ *                to leave it open.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveAnimation
+ * \sa IMG_SaveAnimationTyped_IO
+ * \sa IMG_SaveAPNGAnimation_IO
+ * \sa IMG_SaveAVIFAnimation_IO
+ * \sa IMG_SaveGIFAnimation_IO
+ * \sa IMG_SaveWEBPAnimation_IO
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveANIAnimation_IO(IMG_Animation *anim, SDL_IOStream *dst, bool closeio);
+
+/**
+ * Save an animation in APNG format to an SDL_IOStream.
+ *
+ * If `closeio` is true, `dst` will be closed before returning, whether this
+ * function succeeds or not.
+ *
+ * \param anim the animation to save.
+ * \param dst an SDL_IOStream from which data will be written to.
+ * \param closeio true to close/free the SDL_IOStream before returning, false
+ *                to leave it open.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveAnimation
+ * \sa IMG_SaveAnimationTyped_IO
+ * \sa IMG_SaveANIAnimation_IO
+ * \sa IMG_SaveAVIFAnimation_IO
+ * \sa IMG_SaveGIFAnimation_IO
+ * \sa IMG_SaveWEBPAnimation_IO
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveAPNGAnimation_IO(IMG_Animation *anim, SDL_IOStream *dst, bool closeio);
+
+/**
+ * Save an animation in AVIF format to an SDL_IOStream.
+ *
+ * If `closeio` is true, `dst` will be closed before returning, whether this
+ * function succeeds or not.
+ *
+ * \param anim the animation to save.
+ * \param dst an SDL_IOStream from which data will be written to.
+ * \param closeio true to close/free the SDL_IOStream before returning, false
+ *                to leave it open.
+ * \param quality the desired quality, ranging between 0 (lowest) and 100
+ *                (highest).
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveAnimation
+ * \sa IMG_SaveAnimationTyped_IO
+ * \sa IMG_SaveANIAnimation_IO
+ * \sa IMG_SaveAPNGAnimation_IO
+ * \sa IMG_SaveGIFAnimation_IO
+ * \sa IMG_SaveWEBPAnimation_IO
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveAVIFAnimation_IO(IMG_Animation *anim, SDL_IOStream *dst, bool closeio, int quality);
+
+/**
+ * Save an animation in GIF format to an SDL_IOStream.
+ *
+ * If `closeio` is true, `dst` will be closed before returning, whether this
+ * function succeeds or not.
+ *
+ * \param anim the animation to save.
+ * \param dst an SDL_IOStream from which data will be written to.
+ * \param closeio true to close/free the SDL_IOStream before returning, false
+ *                to leave it open.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveAnimation
+ * \sa IMG_SaveAnimationTyped_IO
+ * \sa IMG_SaveANIAnimation_IO
+ * \sa IMG_SaveAPNGAnimation_IO
+ * \sa IMG_SaveAVIFAnimation_IO
+ * \sa IMG_SaveWEBPAnimation_IO
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveGIFAnimation_IO(IMG_Animation *anim, SDL_IOStream *dst, bool closeio);
+
+/**
+ * Save an animation in WEBP format to an SDL_IOStream.
+ *
+ * If `closeio` is true, `dst` will be closed before returning, whether this
+ * function succeeds or not.
+ *
+ * \param anim the animation to save.
+ * \param dst an SDL_IOStream from which data will be written to.
+ * \param closeio true to close/free the SDL_IOStream before returning, false
+ *                to leave it open.
+ * \param quality between 0 and 100. For lossy, 0 gives the smallest size and
+ *                100 the largest. For lossless, this parameter is the amount
+ *                of effort put into the compression: 0 is the fastest but
+ *                gives larger files compared to the slowest, but best, 100.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_SaveAnimation
+ * \sa IMG_SaveAnimationTyped_IO
+ * \sa IMG_SaveANIAnimation_IO
+ * \sa IMG_SaveAPNGAnimation_IO
+ * \sa IMG_SaveAVIFAnimation_IO
+ * \sa IMG_SaveGIFAnimation_IO
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_SaveWEBPAnimation_IO(IMG_Animation *anim, SDL_IOStream *dst, bool closeio, int quality);
+
+/**
+ * Create an animated cursor from an animation.
+ *
+ * \param anim an animation to use to create an animated cursor.
+ * \param hot_x the x position of the cursor hot spot.
+ * \param hot_y the y position of the cursor hot spot.
+ * \returns the new cursor on success or NULL on failure; call SDL_GetError()
+ *          for more information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_LoadAnimation
+ * \sa IMG_LoadAnimation_IO
+ * \sa IMG_LoadAnimationTyped_IO
+ */
+extern SDL_DECLSPEC SDL_Cursor * SDLCALL IMG_CreateAnimatedCursor(IMG_Animation *anim, int hot_x, int hot_y);
+
+/**
+ * Dispose of an IMG_Animation and free its resources.
+ *
+ * The provided `anim` pointer is not valid once this call returns.
+ *
+ * \param anim IMG_Animation to dispose of.
+ *
+ * \since This function is available since SDL_image 3.0.0.
+ *
+ * \sa IMG_LoadAnimation
+ * \sa IMG_LoadAnimation_IO
+ * \sa IMG_LoadAnimationTyped_IO
+ * \sa IMG_LoadANIAnimation_IO
+ * \sa IMG_LoadAPNGAnimation_IO
+ * \sa IMG_LoadAVIFAnimation_IO
+ * \sa IMG_LoadGIFAnimation_IO
+ * \sa IMG_LoadWEBPAnimation_IO
+ */
+extern SDL_DECLSPEC void SDLCALL IMG_FreeAnimation(IMG_Animation *anim);
+
+/**
+ * An object representing the encoder context.
+ */
+typedef struct IMG_AnimationEncoder IMG_AnimationEncoder;
+
+/**
+ * Create an encoder to save a series of images to a file.
+ *
+ * These animation types are currently supported:
+ *
+ * - ANI
+ * - APNG
+ * - AVIFS
+ * - GIF
+ * - WEBP
+ *
+ * The file type is determined from the file extension, e.g. "file.webp" will
+ * be encoded using WEBP.
+ *
+ * \param file the file where the animation will be saved.
+ * \returns a new IMG_AnimationEncoder, or NULL on failure; call
+ *          SDL_GetError() for more information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_CreateAnimationEncoder_IO
+ * \sa IMG_CreateAnimationEncoderWithProperties
+ * \sa IMG_AddAnimationEncoderFrame
+ * \sa IMG_CloseAnimationEncoder
+ */
+extern SDL_DECLSPEC IMG_AnimationEncoder * SDLCALL IMG_CreateAnimationEncoder(const char *file);
+
+/**
+ * Create an encoder to save a series of images to an IOStream.
+ *
+ * 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.
+ *
+ * \param dst an SDL_IOStream that will be used to save the stream.
+ * \param closeio true to close the SDL_IOStream when done, false to leave it
+ *                open.
+ * \param type a filename extension that represent this data ("WEBP", etc).
+ * \returns a new IMG_AnimationEncoder, or NULL on failure; call
+ *          SDL_GetError() for more information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_CreateAnimationEncoder
+ * \sa IMG_CreateAnimationEncoderWithProperties
+ * \sa IMG_AddAnimationEncoderFrame
+ * \sa IMG_CloseAnimationEncoder
+ */
+extern SDL_DECLSPEC IMG_AnimationEncoder * SDLCALL IMG_CreateAnimationEncoder_IO(SDL_IOStream *dst, bool closeio, const char *type);
+
+/**
+ * Create an animation encoder with the specified properties.
+ *
+ * These animation types are currently supported:
+ *
+ * - ANI
+ * - APNG
+ * - AVIFS
+ * - GIF
+ * - WEBP
+ *
+ * These are the supported properties:
+ *
+ * - `IMG_PROP_ANIMATION_ENCODER_CREATE_FILENAME_STRING`: the file to save, if
+ *   an SDL_IOStream isn't being used. This is required if
+ *   `IMG_PROP_ANIMATION_ENCODER_CREATE_IOSTREAM_POINTER` isn't set.
+ * - `IMG_PROP_ANIMATION_ENCODER_CREATE_IOSTREAM_POINTER`: an SDL_IOStream
+ *   that will be used to save the stream. This should not be closed until the
+ *   animation encoder is closed. This is required if
+ *   `IMG_PROP_ANIMATION_ENCODER_CREATE_FILENAME_STRING` isn't set.
+ * - `IMG_PROP_ANIMATION_ENCODER_CREATE_IOSTREAM_AUTOCLOSE_BOOLEAN`: true if
+ *   closing the animation encoder should also close the associated
+ *   SDL_IOStream.
+ * - `IMG_PROP_ANIMATION_ENCODER_CREATE_TYPE_STRING`: the output file type,
+ *   e.g. "webp", defaults to the file extension if
+ *   `IMG_PROP_ANIMATION_ENCODER_CREATE_FILENAME_STRING` is set.
+ * - `IMG_PROP_ANIMATION_ENCODER_CREATE_QUALITY_NUMBER`: the compression
+ *   quality, in the range of 0 to 100. The higher the number, the higher the
+ *   quality and file size. This defaults to a balanced value for compression
+ *   and quality.
+ * - `IMG_PROP_ANIMATION_ENCODER_CREATE_TIMEBASE_NUMERATOR_NUMBER`: the
+ *   numerator of the fraction used to multiply the pts to convert it to
+ *   seconds. This defaults to 1.
+ * - `IMG_PROP_ANIMATION_ENCODER_CREATE_TIMEBASE_DENOMINATOR_NUMBER`: the
+ *   denominator of the fraction used to multiply the pts to convert it to
+ *   seconds. This defaults to 1000.
+ *
+ * \param props the properties of the animation encoder.
+ * \returns a new IMG_AnimationEncoder, or NULL on failure; call
+ *          SDL_GetError() for more information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_CreateAnimationEncoder
+ * \sa IMG_CreateAnimationEncoder_IO
+ * \sa IMG_AddAnimationEncoderFrame
+ * \sa IMG_CloseAnimationEncoder
+ */
+extern SDL_DECLSPEC IMG_AnimationEncoder * SDLCALL IMG_CreateAnimationEncoderWithProperties(SDL_PropertiesID props);
+
+#define IMG_PROP_ANIMATION_ENCODER_CREATE_FILENAME_STRING                "SDL_image.animation_encoder.create.filename"
+#define IMG_PROP_ANIMATION_ENCODER_CREATE_IOSTREAM_POINTER               "SDL_image.animation_encoder.create.iostream"
+#define IMG_PROP_ANIMATION_ENCODER_CREATE_IOSTREAM_AUTOCLOSE_BOOLEAN     "SDL_image.animation_encoder.create.iostream.autoclose"
+#define IMG_PROP_ANIMATION_ENCODER_CREATE_TYPE_STRING                    "SDL_image.animation_encoder.create.type"
+#define IMG_PROP_ANIMATION_ENCODER_CREATE_QUALITY_NUMBER                 "SDL_image.animation_encoder.create.quality"
+#define IMG_PROP_ANIMATION_ENCODER_CREATE_TIMEBASE_NUMERATOR_NUMBER      "SDL_image.animation_encoder.create.timebase.numerator"
+#define IMG_PROP_ANIMATION_ENCODER_CREATE_TIMEBASE_DENOMINATOR_NUMBER    "SDL_image.animation_encoder.create.timebase.denominator"
+
+#define IMG_PROP_ANIMATION_ENCODER_CREATE_AVIF_MAX_THREADS_NUMBER        "SDL_image.animation_encoder.create.avif.max_threads"
+#define IMG_PROP_ANIMATION_ENCODER_CREATE_AVIF_KEYFRAME_INTERVAL_NUMBER  "SDL_image.animation_encoder.create.avif.keyframe_interval"
+#define IMG_PROP_ANIMATION_ENCODER_CREATE_GIF_USE_LUT_BOOLEAN            "SDL_image.animation_encoder.create.gif.use_lut"
+
+/**
+ * Add a frame to an animation encoder.
+ *
+ * \param encoder the receiving images.
+ * \param surface the surface to add as the next frame in the animation.
+ * \param duration the duration of the frame, usually in milliseconds but can
+ *                 be other units if the
+ *                 `IMG_PROP_ANIMATION_ENCODER_CREATE_TIMEBASE_DENOMINATOR_NUMBER`
+ *                 property is set when creating the encoder.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_CreateAnimationEncoder
+ * \sa IMG_CreateAnimationEncoder_IO
+ * \sa IMG_CreateAnimationEncoderWithProperties
+ * \sa IMG_CloseAnimationEncoder
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_AddAnimationEncoderFrame(IMG_AnimationEncoder *encoder, SDL_Surface *surface, Uint64 duration);
+
+/**
+ * Close an animation encoder, finishing any encoding.
+ *
+ * Calling this function frees the animation encoder, and returns the final
+ * status of the encoding process.
+ *
+ * \param encoder the encoder to close.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_CreateAnimationEncoder
+ * \sa IMG_CreateAnimationEncoder_IO
+ * \sa IMG_CreateAnimationEncoderWithProperties
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_CloseAnimationEncoder(IMG_AnimationEncoder *encoder);
+
+/**
+ * An enum representing the status of an animation decoder.
+ *
+ * \since This enum is available since SDL_image 3.4.0.
+ */
+typedef enum IMG_AnimationDecoderStatus
+{
+    IMG_DECODER_STATUS_INVALID = -1,    /**< The decoder is invalid */
+    IMG_DECODER_STATUS_OK,              /**< The decoder is ready to decode the next frame */
+    IMG_DECODER_STATUS_FAILED,          /**< The decoder failed to decode a frame, call SDL_GetError() for more information. */
+    IMG_DECODER_STATUS_COMPLETE         /**< No more frames available */
+} IMG_AnimationDecoderStatus;
+
+/**
+ * An object representing animation decoder.
+ */
+typedef struct IMG_AnimationDecoder IMG_AnimationDecoder;
+
+/**
+ * Create a decoder to read a series of images from a file.
+ *
+ * These animation types are currently supported:
+ *
+ * - ANI
+ * - APNG
+ * - AVIFS
+ * - GIF
+ * - WEBP
+ *
+ * The file type is determined from the file extension, e.g. "file.webp" will
+ * be decoded using WEBP.
+ *
+ * \param file the file containing a series of images.
+ * \returns a new IMG_AnimationDecoder, or NULL on failure; call
+ *          SDL_GetError() for more information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_CreateAnimationDecoder_IO
+ * \sa IMG_CreateAnimationDecoderWithProperties
+ * \sa IMG_GetAnimationDecoderFrame
+ * \sa IMG_ResetAnimationDecoder
+ * \sa IMG_CloseAnimationDecoder
+ */
+extern SDL_DECLSPEC IMG_AnimationDecoder * SDLCALL IMG_CreateAnimationDecoder(const char *file);
+
+/**
+ * Create a decoder to read a series of images from an IOStream.
+ *
+ * These animation types are currently supported:
+ *
+ * - ANI
+ * - APNG
+ * - AVIFS
+ * - GIF
+ * - WEBP
+ *
+ * If `closeio` is true, `src` will be closed before returning if this
+ * function fails, or when the animation decoder is closed if this function
+ * succeeds.
+ *
+ * \param src an SDL_IOStream containing a series of images.
+ * \param closeio true to close the SDL_IOStream when done, false to leave it
+ *                open.
+ * \param type a filename extension that represent this data ("WEBP", etc).
+ * \returns a new IMG_AnimationDecoder, or NULL on failure; call
+ *          SDL_GetError() for more information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_CreateAnimationDecoder
+ * \sa IMG_CreateAnimationDecoderWithProperties
+ * \sa IMG_GetAnimationDecoderFrame
+ * \sa IMG_ResetAnimationDecoder
+ * \sa IMG_CloseAnimationDecoder
+ */
+extern SDL_DECLSPEC IMG_AnimationDecoder * SDLCALL IMG_CreateAnimationDecoder_IO(SDL_IOStream *src, bool closeio, const char *type);
+
+/**
+ * Create an animation decoder with the specified properties.
+ *
+ * These animation types are currently supported:
+ *
+ * - ANI
+ * - APNG
+ * - AVIFS
+ * - GIF
+ * - WEBP
+ *
+ * These are the supported properties:
+ *
+ * - `IMG_PROP_ANIMATION_DECODER_CREATE_FILENAME_STRING`: the file to load, if
+ *   an SDL_IOStream isn't being used. This is required if
+ *   `IMG_PROP_ANIMATION_DECODER_CREATE_IOSTREAM_POINTER` isn't set.
+ * - `IMG_PROP_ANIMATION_DECODER_CREATE_IOSTREAM_POINTER`: an SDL_IOStream
+ *   containing a series of images. This should not be closed until the
+ *   animation decoder is closed. This is required if
+ *   `IMG_PROP_ANIMATION_DECODER_CREATE_FILENAME_STRING` isn't set.
+ * - `IMG_PROP_ANIMATION_DECODER_CREATE_IOSTREAM_AUTOCLOSE_BOOLEAN`: true if
+ *   closing the animation decoder should also close the associated
+ *   SDL_IOStream.
+ * - `IMG_PROP_ANIMATION_DECODER_CREATE_TYPE_STRING`: the input file type,
+ *   e.g. "webp", defaults to the file extension if
+ *   `IMG_PROP_ANIMATION_DECODER_CREATE_FILENAME_STRING` is set.
+ *
+ * \param props the properties of the animation decoder.
+ * \returns a new IMG_AnimationDecoder, or NULL on failure; call
+ *          SDL_GetError() for more information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_CreateAnimationDecoder
+ * \sa IMG_CreateAnimationDecoder_IO
+ * \sa IMG_GetAnimationDecoderFrame
+ * \sa IMG_ResetAnimationDecoder
+ * \sa IMG_CloseAnimationDecoder
+ */
+extern SDL_DECLSPEC IMG_AnimationDecoder * SDLCALL IMG_CreateAnimationDecoderWithProperties(SDL_PropertiesID props);
+
+#define IMG_PROP_ANIMATION_DECODER_CREATE_FILENAME_STRING                "SDL_image.animation_decoder.create.filename"
+#define IMG_PROP_ANIMATION_DECODER_CREATE_IOSTREAM_POINTER               "SDL_image.animation_decoder.create.iostream"
+#define IMG_PROP_ANIMATION_DECODER_CREATE_IOSTREAM_AUTOCLOSE_BOOLEAN     "SDL_image.animation_decoder.create.iostream.autoclose"
+#define IMG_PROP_ANIMATION_DECODER_CREATE_TYPE_STRING                    "SDL_image.animation_decoder.create.type"
+#define IMG_PROP_ANIMATION_DECODER_CREATE_TIMEBASE_NUMERATOR_NUMBER      "SDL_image.animation_decoder.create.timebase.numerator"
+#define IMG_PROP_ANIMATION_DECODER_CREATE_TIMEBASE_DENOMINATOR_NUMBER    "SDL_image.animation_decoder.create.timebase.denominator"
+
+#define IMG_PROP_ANIMATION_DECODER_CREATE_AVIF_MAX_THREADS_NUMBER        "SDL_image.animation_decoder.create.avif.max_threads"
+#define IMG_PROP_ANIMATION_DECODER_CREATE_AVIF_ALLOW_INCREMENTAL_BOOLEAN "SDL_image.animation_decoder.create.avif.allow_incremental"
+#define IMG_PROP_ANIMATION_DECODER_CREATE_AVIF_ALLOW_PROGRESSIVE_BOOLEAN "SDL_image.animation_decoder.create.avif.allow_progressive"
+#define IMG_PROP_ANIMATION_DECODER_CREATE_GIF_TRANSPARENT_COLOR_INDEX_NUMBER "SDL_image.animation_encoder.create.gif.transparent_color_index"
+#define IMG_PROP_ANIMATION_DECODER_CREATE_GIF_NUM_COLORS_NUMBER          "SDL_image.animation_encoder.create.gif.num_colors"
+
+/**
+ * Get the properties of an animation decoder.
+ *
+ * This function returns the properties of the animation decoder, which holds
+ * information about the underlying image such as description, copyright text
+ * and loop count.
+ *
+ * \param decoder the animation decoder.
+ * \returns the properties ID of the animation decoder, or 0 if there are no
+ *          properties; call SDL_GetError() for more information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_CreateAnimationDecoder
+ * \sa IMG_CreateAnimationDecoder_IO
+ * \sa IMG_CreateAnimationDecoderWithProperties
+ */
+extern SDL_DECLSPEC SDL_PropertiesID SDLCALL IMG_GetAnimationDecoderProperties(IMG_AnimationDecoder* decoder);
+
+#define IMG_PROP_METADATA_IGNORE_PROPS_BOOLEAN                 "SDL_image.metadata.ignore_props"
+#define IMG_PROP_METADATA_DESCRIPTION_STRING                   "SDL_image.metadata.description"
+#define IMG_PROP_METADATA_COPYRIGHT_STRING                     "SDL_image.metadata.copyright"
+#define IMG_PROP_METADATA_TITLE_STRING                         "SDL_image.metadata.title"
+#define IMG_PROP_METADATA_AUTHOR_STRING                        "SDL_image.metadata.author"
+#define IMG_PROP_METADATA_CREATION_TIME_STRING                 "SDL_image.metadata.creation_time"
+#define IMG_PROP_METADATA_FRAME_COUNT_NUMBER                   "SDL_image.metadata.frame_count"
+#define IMG_PROP_METADATA_LOOP_COUNT_NUMBER                    "SDL_image.metadata.loop_count"
+
+/**
+ * Get the next frame in an animation decoder.
+ *
+ * This function decodes the next frame in the animation decoder, returning it
+ * as an SDL_Surface. The returned surface should be freed with
+ * SDL_FreeSurface() when no longer needed.
+ *
+ * If the animation decoder has no more frames or an error occurred while
+ * decoding the frame, this function returns false. In that case, please call
+ * SDL_GetError() for more information. If SDL_GetError() returns an empty
+ * string, that means there are no more available frames. If SDL_GetError()
+ * returns a valid string, that means the decoding failed.
+ *
+ * \param decoder the animation decoder.
+ * \param frame a pointer filled in with the SDL_Surface for the next frame in
+ *              the animation.
+ * \param duration the duration of the frame, usually in milliseconds but can
+ *                 be other units if the
+ *                 `IMG_PROP_ANIMATION_DECODER_CREATE_TIMEBASE_DENOMINATOR_NUMBER`
+ *                 property is set when creating the decoder.
+ * \returns true on success or false on failure and when no more frames are
+ *          available; call IMG_GetAnimationDecoderStatus() or SDL_GetError()
+ *          for more information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_CreateAnimationDecoder
+ * \sa IMG_CreateAnimationDecoder_IO
+ * \sa IMG_CreateAnimationDecoderWithProperties
+ * \sa IMG_GetAnimationDecoderStatus
+ * \sa IMG_ResetAnimationDecoder
+ * \sa IMG_CloseAnimationDecoder
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_GetAnimationDecoderFrame(IMG_AnimationDecoder *decoder, SDL_Surface **frame, Uint64 *duration);
+
+/**
+ * Get the decoder status indicating the current state of the decoder.
+ *
+ * \param decoder the decoder to get the status of.
+ * \returns the status of the underlying decoder, or
+ *          IMG_DECODER_STATUS_INVALID if the given decoder is invalid.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_GetAnimationDecoderFrame
+ */
+extern SDL_DECLSPEC IMG_AnimationDecoderStatus SDLCALL IMG_GetAnimationDecoderStatus(IMG_AnimationDecoder *decoder);
+
+/**
+ * Reset an animation decoder.
+ *
+ * Calling this function resets the animation decoder, allowing it to start
+ * from the beginning again. This is useful if you want to decode the frame
+ * sequence again without creating a new decoder.
+ *
+ * \param decoder the decoder to reset.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_CreateAnimationDecoder
+ * \sa IMG_CreateAnimationDecoder_IO
+ * \sa IMG_CreateAnimationDecoderWithProperties
+ * \sa IMG_GetAnimationDecoderFrame
+ * \sa IMG_CloseAnimationDecoder
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_ResetAnimationDecoder(IMG_AnimationDecoder *decoder);
+
+/**
+ * Close an animation decoder, finishing any decoding.
+ *
+ * Calling this function frees the animation decoder, and returns the final
+ * status of the decoding process.
+ *
+ * \param decoder the decoder to close.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \since This function is available since SDL_image 3.4.0.
+ *
+ * \sa IMG_CreateAnimationDecoder
+ * \sa IMG_CreateAnimationDecoder_IO
+ * \sa IMG_CreateAnimationDecoderWithProperties
+ */
+extern SDL_DECLSPEC bool SDLCALL IMG_CloseAnimationDecoder(IMG_AnimationDecoder *decoder);
+
 /* Ends C function definitions when using C++ */
 #ifdef __cplusplus
 }
diff --git a/vendor/sdl3/image/sdl_image.odin b/vendor/sdl3/image/sdl_image.odin
index 098d21de7..820a7c4da 100644
--- a/vendor/sdl3/image/sdl_image.odin
+++ b/vendor/sdl3/image/sdl_image.odin
@@ -11,8 +11,8 @@ when ODIN_OS == .Windows {
 }
 
 MAJOR_VERSION :: 3
-MINOR_VERSION :: 2
-PATCHLEVEL    :: 4
+MINOR_VERSION :: 4
+PATCHLEVEL    :: 0
 
 Animation :: struct {
 	w, h:   c.int,
@@ -21,6 +21,51 @@ Animation :: struct {
 	delays: [^]c.int,
 }
 
+AnimationEncoder :: struct {}
+
+PROP_ANIMATION_ENCODER_CREATE_FILENAME_STRING             :: "SDL_image.animation_encoder.create.filename"
+PROP_ANIMATION_ENCODER_CREATE_IOSTREAM_POINTER            :: "SDL_image.animation_encoder.create.iostream"
+PROP_ANIMATION_ENCODER_CREATE_IOSTREAM_AUTOCLOSE_BOOLEAN  :: "SDL_image.animation_encoder.create.iostream.autoclose"
+PROP_ANIMATION_ENCODER_CREATE_TYPE_STRING                 :: "SDL_image.animation_encoder.create.type"
+PROP_ANIMATION_ENCODER_CREATE_QUALITY_NUMBER              :: "SDL_image.animation_encoder.create.quality"
+PROP_ANIMATION_ENCODER_CREATE_TIMEBASE_NUMERATOR_NUMBER   :: "SDL_image.animation_encoder.create.timebase.numerator"
+PROP_ANIMATION_ENCODER_CREATE_TIMEBASE_DENOMINATOR_NUMBER :: "SDL_image.animation_encoder.create.timebase.denominator"
+
+PROP_ANIMATION_ENCODER_CREATE_AVIF_MAX_THREADS_NUMBER       :: "SDL_image.animation_encoder.create.avif.max_threads"
+PROP_ANIMATION_ENCODER_CREATE_AVIF_KEYFRAME_INTERVAL_NUMBER :: "SDL_image.animation_encoder.create.avif.keyframe_interval"
+PROP_ANIMATION_ENCODER_CREATE_GIF_USE_LUT_BOOLEAN           :: "SDL_image.animation_encoder.create.gif.use_lut"
+
+AnimationDecoderStatus :: enum c.int {
+	INVALID = -1,
+	OK,
+	FAILED,
+	COMPLETE,
+}
+
+AnimationDecoder :: struct {}
+
+PROP_ANIMATION_DECODER_CREATE_FILENAME_STRING             :: "SDL_image.animation_decoder.create.filename"
+PROP_ANIMATION_DECODER_CREATE_IOSTREAM_POINTER            :: "SDL_image.animation_decoder.create.iostream"
+PROP_ANIMATION_DECODER_CREATE_IOSTREAM_AUTOCLOSE_BOOLEAN  :: "SDL_image.animation_decoder.create.iostream.autoclose"
+PROP_ANIMATION_DECODER_CREATE_TYPE_STRING                 :: "SDL_image.animation_decoder.create.type"
+PROP_ANIMATION_DECODER_CREATE_TIMEBASE_NUMERATOR_NUMBER   :: "SDL_image.animation_decoder.create.timebase.numerator"
+PROP_ANIMATION_DECODER_CREATE_TIMEBASE_DENOMINATOR_NUMBER :: "SDL_image.animation_decoder.create.timebase.denominator"
+
+PROP_ANIMATION_DECODER_CREATE_AVIF_MAX_THREADS_NUMBER            :: "SDL_image.animation_decoder.create.avif.max_threads"
+PROP_ANIMATION_DECODER_CREATE_AVIF_ALLOW_INCREMENTAL_BOOLEAN     :: "SDL_image.animation_decoder.create.avif.allow_incremental"
+PROP_ANIMATION_DECODER_CREATE_AVIF_ALLOW_PROGRESSIVE_BOOLEAN     :: "SDL_image.animation_decoder.create.avif.allow_progressive"
+PROP_ANIMATION_DECODER_CREATE_GIF_TRANSPARENT_COLOR_INDEX_NUMBER :: "SDL_image.animation_encoder.create.gif.transparent_color_index"
+PROP_ANIMATION_DECODER_CREATE_GIF_NUM_COLORS_NUMBER              :: "SDL_image.animation_encoder.create.gif.num_colors"
+
+PROP_METADATA_IGNORE_PROPS_BOOLEAN :: "SDL_image.metadata.ignore_props"
+PROP_METADATA_DESCRIPTION_STRING   :: "SDL_image.metadata.description"
+PROP_METADATA_COPYRIGHT_STRING     :: "SDL_image.metadata.copyright"
+PROP_METADATA_TITLE_STRING         :: "SDL_image.metadata.title"
+PROP_METADATA_AUTHOR_STRING        :: "SDL_image.metadata.author"
+PROP_METADATA_CREATION_TIME_STRING :: "SDL_image.metadata.creation_time"
+PROP_METADATA_FRAME_COUNT_NUMBER   :: "SDL_image.metadata.frame_count"
+PROP_METADATA_LOOP_COUNT_NUMBER    :: "SDL_image.metadata.loop_count"
+
 @(default_calling_convention="c", link_prefix="IMG_")
 foreign lib {
 	Version :: proc() -> c.int ---
@@ -43,7 +88,16 @@ foreign lib {
 	LoadTexture_IO       :: proc(renderer: ^SDL.Renderer, src: ^SDL.IOStream, closeio: bool) -> ^SDL.Texture ---
 	LoadTextureTyped_IO  :: proc(renderer: ^SDL.Renderer, src: ^SDL.IOStream, closeio: bool, type: cstring) -> ^SDL.Texture ---
 
+	/* Load an image directly into a GPU texture. */
+	LoadGPUTexture         :: proc(device: ^SDL.GPUDevice, copy_pass: ^SDL.GPUCopyPass, file: cstring, width: ^c.int, height: ^c.int) -> ^SDL.GPUTexture ---
+	LoadGPUTexture_IO      :: proc(device: ^SDL.GPUDevice, copy_pass: ^SDL.GPUCopyPass, src: ^SDL.IOStream, closeio: bool, width: ^c.int, height: ^c.int) -> ^SDL.GPUTexture ---
+	LoadGPUTextureTyped_IO :: proc(device: ^SDL.GPUDevice, copy_pass: ^SDL.GPUCopyPass, src: ^SDL.IOStream, closeio: bool, type: cstring, width: ^c.int, height: ^c.int) -> ^SDL.GPUTexture ---
+
+	/* Get the image currently in the clipboard. */
+	GetClipboardImage :: proc() -> ^SDL.Surface ---
+
 	/* Functions to detect a file type, given a seekable source */
+	isANI  :: proc(src: ^SDL.IOStream) -> bool ---
 	isAVIF :: proc(src: ^SDL.IOStream) -> bool ---
 	isICO  :: proc(src: ^SDL.IOStream) -> bool ---
 	isCUR  :: proc(src: ^SDL.IOStream) -> bool ---
@@ -90,19 +144,63 @@ foreign lib {
 	ReadXPMFromArrayToRGB888 :: proc(xpm: [^]cstring) -> ^SDL.Surface ---
 
 	/* Individual saving functions */
-	SaveAVIF    :: proc(surface: ^SDL.Surface, file: cstring, quality: c.int) -> c.bool ---
-	SaveAVIF_IO :: proc(surface: ^SDL.Surface, dst: ^SDL.IOStream, closeio: bool, quality: c.int) -> c.bool ---
-	SavePNG     :: proc(surface: ^SDL.Surface, file: cstring) -> c.bool ---
-	SavePNG_IO  :: proc(surface: ^SDL.Surface, dst: ^SDL.IOStream, closeio: bool) -> c.bool ---
-	SaveJPG     :: proc(surface: ^SDL.Surface, file: cstring, quality: c.int) -> c.bool ---
-	SaveJPG_IO  :: proc(surface: ^SDL.Surface, dst: ^SDL.IOStream, closeio: bool, quality: c.int) -> c.bool ---
+	Save         :: proc(surface: ^SDL.Surface, file: cstring) -> c.bool ---
+	SaveTyped_IO :: proc(surface: ^SDL.Surface, dst: ^SDL.IOStream, closeio: bool, type: cstring) -> c.bool ---
+	SaveAVIF     :: proc(surface: ^SDL.Surface, file: cstring, quality: c.int) -> c.bool ---
+	SaveAVIF_IO  :: proc(surface: ^SDL.Surface, dst: ^SDL.IOStream, closeio: bool, quality: c.int) -> c.bool ---
+	SaveBMP      :: proc(surface: ^SDL.Surface, file: cstring) -> c.bool ---
+	SaveBMP_IO   :: proc(surface: ^SDL.Surface, dst: ^SDL.IOStream, closeio: bool) -> c.bool ---
+	SaveCUR      :: proc(surface: ^SDL.Surface, file: cstring) -> c.bool ---
+	SaveCUR_IO   :: proc(surface: ^SDL.Surface, dst: ^SDL.IOStream, closeio: bool) -> c.bool ---
+	SaveGIF      :: proc(surface: ^SDL.Surface, file: cstring) -> c.bool ---
+	SaveGIF_IO   :: proc(surface: ^SDL.Surface, dst: ^SDL.IOStream, closeio: bool) -> c.bool ---
+	SaveICO      :: proc(surface: ^SDL.Surface, file: cstring) -> c.bool ---
+	SaveICO_IO   :: proc(surface: ^SDL.Surface, dst: ^SDL.IOStream, closeio: bool) -> c.bool ---
+	SaveJPG      :: proc(surface: ^SDL.Surface, file: cstring, quality: c.int) -> c.bool ---
+	SaveJPG_IO   :: proc(surface: ^SDL.Surface, dst: ^SDL.IOStream, closeio: bool, quality: c.int) -> c.bool ---
+	SavePNG      :: proc(surface: ^SDL.Surface, file: cstring) -> c.bool ---
+	SavePNG_IO   :: proc(surface: ^SDL.Surface, dst: ^SDL.IOStream, closeio: bool) -> c.bool ---
+	SaveTGA      :: proc(surface: ^SDL.Surface, file: cstring) -> c.bool ---
+	SaveTGA_IO   :: proc(surface: ^SDL.Surface, dst: ^SDL.IOStream, closeio: bool) -> c.bool ---
+	SaveWEBP     :: proc(surface: ^SDL.Surface, file: cstring, quality: f32) -> c.bool ---
+	SaveWEBP_IO  :: proc(surface: ^SDL.Surface, dst: ^SDL.IOStream, closeio: bool, quality: f32) -> c.bool ---
 
 	LoadAnimation         :: proc(file: cstring) -> ^Animation ---
 	LoadAnimation_IO      :: proc(src: ^SDL.IOStream, closeio: bool) -> ^Animation ---
 	LoadAnimationTyped_IO :: proc(src: ^SDL.IOStream, closeio: bool, type: cstring) -> ^Animation ---
+	SaveAnimation         :: proc(anim: ^Animation, file: cstring) -> c.bool ---
+	SaveAnimationTyped_IO :: proc(anim: ^Animation, dst: ^SDL.IOStream, closeio: bool, type: cstring) -> c.bool ---
+	CreateAnimatedCursor  :: proc(anim: ^Animation, hot_x: c.int, hot_y: c.int) -> ^SDL.Cursor ---
 	FreeAnimation         :: proc(anim: ^Animation) ---
 
+	/* Animation encoder functions */
+	CreateAnimationEncoder               :: proc(file: cstring) -> ^AnimationEncoder ---
+	CreateAnimationEncoder_IO            :: proc(dst: ^SDL.IOStream, closeio: bool, type: cstring) -> ^AnimationEncoder ---
+	CreateAnimationEncoderWithProperties :: proc(props: SDL.PropertiesID) -> ^AnimationEncoder ---
+	AddAnimationEncoderFrame             :: proc(encoder: ^AnimationEncoder, surface: ^SDL.Surface, duration: u64) -> c.bool ---
+	CloseAnimationEncoder                :: proc(encoder: ^AnimationEncoder) -> c.bool ---
+
+	/* Animation decoder functions */
+	CreateAnimationDecoder               :: proc(file: cstring) -> ^AnimationDecoder ---
+	CreateAnimationDecoder_IO            :: proc(src: ^SDL.IOStream, closeio: bool, type: cstring) -> ^AnimationDecoder ---
+	CreateAnimationDecoderWithProperties :: proc(props: SDL.PropertiesID) -> ^AnimationDecoder ---
+	GetAnimationDecoderProperties        :: proc(decoder: ^AnimationDecoder) -> SDL.PropertiesID ---
+	GetAnimationDecoderFrame             :: proc(decoder: ^AnimationDecoder, frame: ^^SDL.Surface, duration: ^u64) -> c.bool ---
+	GetAnimationDecoderStatus            :: proc(decoder: ^AnimationDecoder) -> AnimationDecoderStatus ---
+	ResetAnimationDecoder                :: proc(decoder: ^AnimationDecoder) -> c.bool ---
+	CloseAnimationDecoder                :: proc(decoder: ^AnimationDecoder) -> c.bool ---
+
 	/* Individual loading functions */
+	LoadANIAnimation_IO   :: proc(src: ^SDL.IOStream) -> ^Animation ---
+	LoadAPNGAnimation_IO  :: proc(src: ^SDL.IOStream) -> ^Animation ---
+	LoadAVIFAnimation_IO  :: proc(src: ^SDL.IOStream) -> ^Animation ---
 	LoadGIFAnimation_IO :: proc(src: ^SDL.IOStream) -> ^Animation ---
 	LoadWEBPAnimation_IO :: proc(src: ^SDL.IOStream) -> ^Animation ---
+
+	/* Individual saving functions */
+	SaveANIAnimation_IO   :: proc(anim: ^Animation, dst: ^SDL.IOStream, closeio: bool) -> c.bool ---
+	SaveAPNGAnimation_IO  :: proc(anim: ^Animation, dst: ^SDL.IOStream, closeio: bool) -> c.bool ---
+	SaveAVIFAnimation_IO  :: proc(anim: ^Animation, dst: ^SDL.IOStream, closeio: bool, quality: c.int) -> c.bool ---
+	SaveGIFAnimation_IO   :: proc(anim: ^Animation, dst: ^SDL.IOStream, closeio: bool) -> c.bool ---
+	SaveWEBPAnimation_IO  :: proc(anim: ^Animation, dst: ^SDL.IOStream, closeio: bool, quality: c.int) -> c.bool ---
 }