SGI(3pm)

💅 SGI(3pm) — like, the whole vibe

Okay bestie, quick heads up before we dive in: this page shows up in your man pages as SGI(3pm), and it lives in the User Contributed Perl Documentation section. Cute. Iconic. Slightly confusing naming, but we move. 🫶

---

✨ NAME ✨

Imager::File::ICO — read MS Icon files. That's the whole job. It reads them. Slay.

---

🌸 SYNOPSIS 🌸

Here's the group chat of code snippets — actual working examples, not me improvising:

use Imager;

my $img = Imager->new;
$img->read(file=>"foo.ico")
  or die $img->errstr;

my @imgs = Imager->read_multi(file => "foo.ico")
  or die Imager->errstr;

$img->write(file => "foo.ico")
  or die $img->errstr;

Imager->write_multi({ file => "foo.ico" }, @imgs)
  or die Imager->errstr;

Notice the or die on every single one? That's not decoration, that's self-care. Always check your errors, bestie. 😭

---

🦋 DESCRIPTION 🦋

So here's the thing — the actual documentation for Imager's MS Icon support? It's not here. It's in Imager::Files. This page is basically the ✨pointer✨, the little "go ask her, she knows" of the man page world. No cap.

---

👑 AUTHOR 👑

Tony Cook <tonyc@cpan.org> — the icon mastermind himself. Respect. 🎀

---

🌈 SEE ALSO 🌈

• Imager — the whole entire main character
• Imager::Files — where the real MS Icon lore lives, fr fr

---

Heads up: everything about how MS Icon files actually behave is documented over in Imager::Files. Don't come for this page looking for details it never claimed to have 💀

---

That's a wrap, babe — page SGI(3pm), perl v5.42.3, dated 2026-08-19. Go forth and read those .ico files, you absolute legend. 💜✨