IMG_isTIF(3)

📦
version 3.4.4 · 8 versions
, in ubuntu stonking

💖 IMG_isTIF(3) — the TIFF detector, bestie 💖

okay so welcome to SDL_image3 FUNCTIONS, bestie — this page is literally all about IMG_isTIF(3), and it’s giving “tiny peek, big verdict” energy ✨

🌸 NAME 🌸

IMG_isTIF — detect TIFF image data on a readable/seekable SDL_IOStream.

✨ SYNOPSIS ✨

#include <SDL3_image/SDL_image.h>

bool IMG_isTIF(SDL_IOStream *src);

that’s the whole signature, no cap 💅

🦋 DESCRIPTION 🦋

so this function attempts to determine if a file is a given filetype — in this case, TIFF — and it reads the least amount possible from the SDL_IOStream (usually just a few bytes). tiny sniff, iconic behavior 🎀

there is no distinction made between “not the filetype in question” and basic i/o errors. like, it will not tattle about which one happened 😭

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. bestie-friendly chaining, periodt 🫶

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 this is a vibe check, not a mandatory step 🌈

💜 FUNCTION PARAMETERS 💜

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

🎀 RETURN VALUE 🎀

returns true if this is TIFF data, false otherwise. that’s the whole mood 💖

🦋 AVAILABILITY 🦋

this function is available since SDL_image 3.0.0.

🌈 SEE ALSO 🌈

go read these next, bestie:

okay that’s the whole page 💖 signing off from the footer tea: source is SDL_image, version is SDL_image 3.4.4, and the title is IMG_isTIF(3) — the footer didn’t give us a date, so we’re not inventing one, bestie 💀🫶

📦 where this page comes from