PAMOIL(1)

💅 PAMOIL — it's giving oil painting ✨

okay bestie, welcome to the Pamoil User Manual, section 1 of the General Commands Manual 🎀 — this is the page where we turn boring pixels into art, no cap.

---

✨ NAME ✨

pamoil — turn a PAM image into an oil painting 🖼️

---

🌸 SYNOPSIS 🌸

pamoil

[-n N]

[pamfile]

---

💖 DESCRIPTION 💖

This program is part of Netpbm(1). 🫶

So basically, pamoil reads a Netpbm image as input, does an "oil transfer" on it, and writes out the same type of Netpbm image as output. Iconic behavior honestly.

The oil transfer is described in "Beyond Photography" by Holzmann, chapter 4, photo 7. It's a sort of localized smearing. That's the vibe. 🔥

Here's how the smearing actually works, step by step: first, assume a grayscale image. For each pixel in the image, pamoil looks at a square neighborhood around it. Then pamoil figures out what the most common pixel intensity in that neighborhood is, and puts a pixel of that intensity into the output in the same position as the input pixel. Slay. 👑

For color images, or literally any arbitrary multi-channel image, pamoil computes each channel separately (so like: red, green, and blue) using the exact same method as the grayscale case above. Every channel gets the same treatment, no favoritism. 🌈

And at the edges of the image, where the regular neighborhood would run off the edge — because bestie, the math can't just keep going — pamoil uses a clipped neighborhood instead. Not me being careful about boundaries 💀

---

🎀 OPTIONS 🎀

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

• -n size — This is the size of the neighborhood used in the smearing 👀 The neighborhood is this many pixels in all four directions. The default is 3.

---

🦋 SEE ALSO 🦋

• pgmbentley(1)
• ppmrelief(1)
• ppm(1)

---

💜 AUTHOR 💜

This program is based on pgmoil Copyright (C) 1990 by Wilson Bent (whb@hoh-2.att.com)

Modified to ppm by Chris Sheppard, June 25, 2001

Modified to pnm, using pam functions, by Bryan Henderson June 28, 2001.

---

📜 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/pamoil.html

---

and that's the whole thing, bestie 💖 this was netpbm documentation, dated 25 June 2001, and it lives in the Pamoil User Manual(1) — go make some oil paintings, you main character 🎨✨🫶