IMG_isJXL(3)

🌸 NAME 🌸

IMG_isJXL(3) is a page from the SDL_image3 FUNCTIONS fam. IMG_isJXL — detect JXL image data on a readable/seekable SDL_IOStream. 💖

✨ SYNOPSIS ✨

#include <SDL3_image/SDL_image.h>

bool IMG_isJXL(SDL_IOStream *src);

🎀 DESCRIPTION 🎀

Okay so here’s the tea: this function tries to determine if a file is a given filetype, and it reads the least amount possible from the SDL_IOStream — usually just a few bytes. ✨

It makes no distinction between “not the filetype in question” and basic i/o errors. None. Zero. The audacity 😭.

Basically, a basic i/o error can look exactly like “nope, not this filetype” — messy, but that’s the deal 💀

On the seek side: it 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. Assuming seeking works, that means you can immediately use this with a different IMG_isTYPE function, or load the image without further seeking. Slay. 💅

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. So it’s a vibe-check helper, not a mandatory step. 🫶

🦋 FUNCTION PARAMETERS 🦋

• src — a seekable/readable SDL_IOStream to provide image data. 🎀

🌈 RETURN VALUE 🌈

Returns true if this is JXL data, false otherwise. Iconic binary behavior, no notes. 💅

⭐ AVAILABILITY ⭐

This function is available since SDL_image 3.0.0. ✨

👑 SEE ALSO 👑

• IMG_isANI(3)
• IMG_isAVIF(3)
• IMG_isBMP(3)
• IMG_isCUR(3)
• IMG_isGIF(3)
• IMG_isICO(3)
• IMG_isJPG(3)
• IMG_isLBM(3)
• IMG_isPCX(3)
• IMG_isPNG(3)
• IMG_isPNM(3)
• IMG_isQOI(3)
• IMG_isSVG(3)
• IMG_isTIF(3)
• IMG_isWEBP(3)
• IMG_isXCF(3)
• IMG_isXPM(3)
• IMG_isXV(3)

---

Alright bestie, that’s the page! Big sparkly thanks to the SDL_image 3.4.4 footer for the source/version; the original footer doesn’t show a date, so I’m not making one up. 💖🎀✨