IMG_LoadXCF_IO(3)

🌸 NAME 🌸

bestie, this is IMG_LoadXCF_IO(3) from the SDL_image3 FUNCTIONS manual — the whole page is about IMG_LoadXCF_IO: load a XCF image directly. periodt. 💅

✨ SYNOPSIS ✨

#include <SDL3_image/SDL_image.h>

SDL_Surface * IMG_LoadXCF_IO(SDL_IOStream *src);

💖 DESCRIPTION 💖

Okay so if you know you definitely have a XCF image, you can call this function, and it will skip SDL_image's file format detection routines. It's giving “I already know what this file is, don't @ me.” 🦋

Generally it's better to use the abstract interfaces; also, heads up, there is only an SDL_IOStream interface available here. iykyk. 💖

🎀 FUNCTION PARAMETERS 🎀

• src — an SDL_IOStream to load image data from. That's the whole input vibe. 🎀

🦋 RETURN VALUE 🦋

Returns an SDL surface, or NULL on error. So bestie, vibe check that return value — NULL means error, no cap. 💀

🌈 AVAILABILITY 🌈

This function is available since SDL_image 3.0.0. iconic, honestly. 🌈

👑 SEE ALSO 👑

You already know the format-loading besties are all here:

• 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_LoadSVG_IO(3)
• IMG_LoadTGA_IO(3)
• IMG_LoadTIF_IO(3)
• IMG_LoadWEBP_IO(3)
• IMG_LoadXPM_IO(3)
• IMG_LoadXV_IO(3)

---

sign-off, bestie 🫶: source is SDL_image, version is SDL_image 3.4.4 — and the footer didn't give a date, so I'm not inventing one, fr fr 💅✨