WINICONTOPPM(1)

💖 winicontoppm — the user manual 💖

okay so bestie, welcome to the Winicontoppm User Manual, straight out of the General Commands Manual section 🎀. Sit down, grab a boba, and let's get into it 💅

---

✨ NAME ✨

winicontoppm — the way that this converts a Windows .ico image into 1 or more PPM images 🦋 (yes, one or more, she's flexible like that)

---

🌸 SYNOPSIS 🌸

winicontoppm [-writeands] [-allicons|-bestqual] [-multippm] [-verbose]
[iconfile] [ppmdestfile]

literally the whole thing, no cap ✨

---

💜 DESCRIPTION 💜

This program is part of Netpbm(1). 💖

ngl, this program is essentially obsolete — the newer winicontopam is better. she's serving legacy realness and we respect her for it 🎀 but like, the newer one is the moment.

So what does she do? winicontoppm reads a Microsoft Windows .ico file and converts it to one or more PPMs. periodt 🔥

A Windows icon contains one or more images, at different resolutions and color depths. And the way that each image has an 'and' mask, which contains transparency data? iconic. every single one. 👑

By default, the output goes to Standard Output. But if you specify ppmdestfile, output goes into one or more files named as follows — ok pay attention bestie, this naming scheme is lowkey important:

• If it's just one file (i.e. you specify the -multippm option or don't specify -allicons), the file name is ppmdestfile.ppm.
• If it's multiple files, their file names are ppmdestfile_1.ppm, ppmdestfile_2.ppm, etc.

When you specify the -writeands option, the file names above are modified to include the string xor, as in ppmdestfile_xor.ppm or ppmdestfile_xor_1.ppm. 💫

winicontoppm can convert .ico images with 1, 4, 8, 24, or 32 bits per pixel. Before Netpbm 10.15 (April 2003), it could not handle 24 and 32 — like, those were the dark ages fr fr 😭

---

⭐ OPTIONS ⭐

In addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options), winicontoppm recognizes the following command line options. like, she's got range 🫶

• -writeands — For each icon written, also write the 'and' (transparency) mask as a separate PBM file. It's name is of the form ppmdestfile_and.pbm or ppmdestfile_and_1.pbm. 💅
• -allicons — Extract all images from the .ico file. the full collection, every single one, no gatekeeping 💖

If you specify neither this nor -bestqual, winicontoppm extracts the first image.

• -bestqual — Extract only the best quality (largest, then highest bpp) image from the .ico file. she's picking the main character and honestly? valid 👑

If you specify neither this nor -allicons, winicontoppm extracts the first image.

• -multippm — Write all PPMs to a single file. one file, all the vibes, efficiency slay ✨

---

🦋 SEE ALSO 🦋

winicontopam(1), pamtowinicon(1), bmptopnm(1), ppm(1)

go read those too bestie, the lore is deep 🌈

---

💀 AUTHOR 💀

Copyright (C) 2000, 2003 by Lee Benfield.

shoutout to Lee, an absolute icon 💖

---

🎀 DOCUMENT SOURCE 🎀

This manual page was generated by the Netpbm tool makeman from HTML source. The master documentation is at

http://netpbm.sourceforge.net/doc/winicontoppm.html

---

ok that's the whole page, no skips, no summaries, everything's in there 💯 iykyk

and that's a wrap babes 🌸 this was netpbm documentation, from back on 23 March 2003, filed under the Winicontoppm User Manual(1) — she's vintage, she's iconic, she ATE. mwah 💅💖✨