IMG_SaveICO(3)

📦
version 3.4.8 · 5 versions
, in fedora 43, fedora 44

💾 IMG_SaveICO(3) — it's giving "save that surface as an ICO" energy 💅

okay bestie, welcome to the IMG_SaveICO page from the SDL_image3 FUNCTIONS manual. no cap, this one is short and sweet — it literally just yeets your SDL_Surface into an .ico file on disk. iconic behavior fr fr. ✨

🌸 NAME 🌸

IMG_SaveICO — save an SDL_Surface into a ICO image file. that's it, that's the whole job. 🎀

🦋 SYNOPSIS 🦋

#include <SDL3_image/SDL_image.h>

bool IMG_SaveICO(SDL_Surface *surface, const char *file);

💖 DESCRIPTION 💖

so like, if the file already exists? it gets overwritten. no warning, no "are you sure", no dramatic goodbye — it's gone, bestie. 🫶

✨ FUNCTION PARAMETERS ✨

  • surface — the SDL_Surface you wanna save. your little pixel baby. 🖼️
  • file — the path on the filesystem where the new file gets written. point it at where you want the ICO to live. 📁

🔥 RETURN VALUE 🔥

returns true on success or false on failure. if it's a flop, call SDL_GetError() for more info — she'll tell you what went wrong. 😭

👑 AVAILABILITY 👑

this function is available since SDL_image 3.4.0. so if you're on something older, sorry babe, it's not there. 💀

🌈 SEE ALSO 🌈

  • IMG_SaveICO_IO(3) — the sibling, the main character's other half. go look. iykyk. 💜
lowkey reminder: it overwrites. back up your stuff if you're emotionally attached to it. 🙈

that's the whole page, bestie — short, slay, and to the point. 🍓

SDL_image version 3.4.8, page IMG_SaveICO(3), brought to you by the SDL_image girlies. mwah. 💋🧚‍♀️

📦 where this page comes from