PAMTOUIL(1)

💖 pamtouil — the manual page, but make it cute 💖

okay bestie, gather round, because this is the one and only pamtouil manual page (yes, from the General Commands Manual) and we are gonna understand it TOGETHER 🫶

---

✨ NAME ✨

pamtouil — convert a PNM or PNM/transparency image into a Motif UIL icon file

like. that's the whole gig. iconic honestly 💅

---

🌸 SYNOPSIS 🌸

pamtouil [-name=uilname] [pamfile]

Some slay quality-of-life rules for how you type those options, no cap:

• You may abbreviate any option to its shortest unique prefix. yes literally any of them, go off
• You may use two hyphens instead of one to delimit an option. both vibes are valid
• You may separate an option from its value with whitespace instead of =. so flexible of her fr fr

---

🦋 DESCRIPTION 🦋

This program is part of Netpbm(1). she's in the family, okay, she belongs 💜

pamtouil reads a PNM or PAM image as input and produces a Motif UIL icon file as output. that's the whole transformation arc, main character energy 🌈

If the input is PAM, it may be either a regular grayscale or color image, or grayscale+transparency, or color+transparency. so many options and honestly? love that for you 🎀

Where the transparency channel is present, pamtouil renders pixels that are more than half transparent as transparent in the output. more than half. that's the cutoff. periodt 💀 (don't say I didn't warn you, it's literally what it says)

In the UIL's colormap, pamtouil uses the color names from the RGB database — the same one ppmmake(1) uses. and where a color in the input does not exactly match one of the colors named in the RGB database, pamtouil uses the closest color named in the RGB database. she's not gonna fail you over an imperfect hex, she's gonna find the nearest vibe 🧚

---

🌟 OPTIONS 🌟

In addition to the options common to all programs based on libnetpbm — most notably -quiet, see Common Options — pamtouil recognizes the following command line option:

• -name — lets you specify the prefix string which is printed in the resulting UIL output. If not specified, it defaults to the filename (without extension) of the ppmfile argument. And if -name is not specified and no ppmfile is specified (i.e. you're piping input in), the prefix string defaults to the string "noname". so if you see noname in your output, that's why bestie 🫶

---

🔥 SEE ALSO 🔥

pamstack(1), pam(1), ppm(1)

(the girlies of the Netpbm cinematic universe 💅)

---

📜 HISTORY 📜

Before May 2002, pamtouil was called ppmtouil and had no way to specify transparency. a glow-up was had, and we are all better for it ✨

---

👑 AUTHOR 👑

Converted by Bryan Henderson from ppmtouil.c, which was converted by Jef Poskanzer from ppmtoxpm.c, which is Copyright (C) 1990 by Mark W. Snitily

(three generations of converters, chain of slay 💖)

---

🌈 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/pamtouil.html

---

and that's the whole page bestie! you now know more about Motif UIL icon files than 99% of the population 💅 no cap

xoxo, this was netpbm documentation, dated 05 May 2002 — go forth and convert your pixels, you gorgeous little command-line user you 🎀🦋✨