IMG_LoadSVG_IO(3)

💅 IMG_LoadSVG_IO 💅

okay so real talk — this page lives in the SDL_image3 FUNCTIONS section of the SDL_image manual, and it's about loading a SVG image directly, no detective work involved ✨

🦋 SYNOPSIS 🦋

#include <SDL3_image/SDL_image.h>

SDL_Surface * IMG_LoadSVG_IO(SDL_IOStream *src);

🌸 DESCRIPTION 🌸

so bestie, here's the vibe: if you know you definitely have a SVG image — like, you're not guessing, you're not hoping, you're certain — you can call this function and it will skip SDL_image's file format detection routines entirely. no sniffing, no "hmm what could this be", just straight to SVG. main character energy tbh 👑

but like, generally it's better to use the abstract interfaces 🫶 — that's the recommended route. also important: there is only an SDL_IOStream interface available here, so that's the only door in. iykyk.

🎀 FUNCTION PARAMETERS 🎀

• src — an SDL_IOStream to load image data from. that's the source of truth, the whole entire vibe, the place the pixels come from 💖

⭐ RETURN VALUE ⭐

Returns SDL_Surface, or NULL on error. so if you get NULL, something went sideways — check it, don't just vibes-based-debug it 😭

🌈 AVAILABILITY 🌈

This function is available since SDL_image 3.0.0. it's been iconic for a minute, no cap 💅

👑 SEE ALSO 👑

the whole friend group, fr fr:

• IMG_LoadAVIF_IO(3)
• IMG_LoadBMP_IO(3)
• IMG_LoadCUR_IO(3)
• IMG_LoadGIF_IO(3)
• IMG_LoadICO_IO(3)
• IMG_LoadJPG_IO(3)
• IMG_LoadJXL_IO(3)
• IMG_LoadLBM_IO(3)
• IMG_LoadPCX_IO(3)
• IMG_LoadPNG_IO(3)
• IMG_LoadPNM_IO(3)
• IMG_LoadQOI_IO(3)
• IMG_LoadSizedSVG_IO(3)
• IMG_LoadTGA_IO(3)
• IMG_LoadTIF_IO(3)
• IMG_LoadWEBP_IO(3)
• IMG_LoadXCF_IO(3)
• IMG_LoadXPM_IO(3)
• IMG_LoadXV_IO(3)

---

and that's the page!! this slice of the SDL_image manual is brought to you by SDL_image 3.4.4 🧚 go forth and load your SVGs, bestie, you're gonna ate 💜