IMG_LoadTGA_IO(3)

📦
version 3.4.4 · 8 versions
, in ubuntu stonking

💅 IMG_LoadTGA_IO(3) — like, the TGA loader, bestie 💅

okay so real talk — this is a page from SDL_image3 FUNCTIONS, and it's all about IMG_LoadTGA_IO. she's niche, she's direct, she's got main character energy for exactly one file format. let's get into it 🎀

✨ NAME ✨

IMG_LoadTGA_IO — load a TGA image directly, no detours, no drama 💅

🌸 SYNOPSIS 🌸

#include <SDL3_image/SDL_image.h>

SDL_Surface * IMG_LoadTGA_IO(SDL_IOStream *src);

that's it. that's the whole vibe. one include, one function, one SDL_IOStream *. slay ✨

🦋 DESCRIPTION 🦋

okay so picture this: you already know you're holding a TGA image. like, you're not guessing, you're not doing a vibe check on the file header, you just know. in that case you can call this function, and it will skip SDL_image's file format detection routines entirely. no sniffing, no guessing, straight to business. iconic behavior honestly 💖

but ngl, generally it's better to use the abstract interfaces instead — that's the recommended move, fr fr. also, heads up: there is only an SDL_IOStream interface available here. that's the one and only option, no alternates, no ..._RW twin, periodt.

🎀 FUNCTION PARAMETERS 🎀

  • src — an SDL_IOStream to load the image data from. that's your source, your plug, your stream of image-y goodness 🫶

⭐ RETURN VALUE ⭐

Returns an SDL_Surface — your freshly loaded image, gorgeous 💜

or NULL on error 😭 (check your errors, bestie, don't just assume it worked)

🌈 AVAILABILITY 🌈

this function is available since SDL_image 3.0.0 — so if you're on anything older, she is not there for you, sorry 🙈

👑 SEE ALSO 👑

the whole IO-loading friend group, all here, all iconic:

lowkey the whole point: if you definitely have a TGA, this skips format detection and goes straight there. but abstract interfaces are still the better call in general — no cap 💀

and that's the page!! brought to you by SDL_image, version SDL_image 3.4.4, filed under IMG_LoadTGA_IO(3) in the SDL_image 3 docs. mwah, go load some TGAs bestie 🧚‍♀️💖✨

📦 where this page comes from