ICO(3pm)

💖 ICO(3pm) — the one about MS Icon files 💖

Okay bestie, so this is ICO(3pm), a little Perl module doc from the perl v5.42.3 days (dated 2026-08-19, we love a timestamped queen). It's the manual page for Imager::File::ICO — the piece of Imager that handles Microsoft Icon files. Short page, but it eats, no cap. 🎀

---

✨ NAME ✨

Imager::File::ICO — literally just reads MS Icon files. That's the whole vibe. 🦋

---

🧚 SYNOPSIS 🧚

Here's the group chat receipts — this is how you actually use it:

  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;

So like — you can read one icon into a single $img, read multiple icons out of one .ico with read_multi (it gives you back @imgs, icon files can hold several sizes, main character energy fr), write a single image back out to foo.ico, or write a whole pile of them with write_multi. Every single one of those has an or die because we check our errors in this house. 💅

---

🌸 DESCRIPTION 🌸

Bestie, this page is lowkey a redirect — Imager's MS Icon support is documented over in Imager::Files. That's it. That's the description. Go read that one for the actual details, iykyk. 🙈

---

👑 AUTHOR 👑

Tony Cook <tonyc@cpan.org> — the icon overlord. Respect the name. 🫶

---

🌈 SEE ALSO 🌈

• Imager — the big one, the parent, the main character.
• Imager::Files — where the actual MS Icon documentation lives, go look 👀

---

💀 Real talk: don't come to this page expecting deep lore about icon internals. It points, it doesn't spill.

---

That's the whole page, bestie — short and slay. ✨ This cutie shipped as part of perl v5.42.3, dated 2026-08-19, and yes it's the ICO(3pm) page, so now you know exactly where it came from. Mwah. 💜🎀🦋