Pamoil User Manual(1) General Commands Manual Pamoil User Manual(1)
NAME
pamoil - turn a PAM image into an oil painting
SYNOPSIS
pamoil
[-n N]
[pamfile]
DESCRIPTION
This program is part of Netpbm(1).
pamoil reads a Netpbm image as input and does an "oil transfer", and
writes the same type of Netpbm image as output.
The oil transfer is described in "Beyond Photography" by Holzmann, chap-
ter 4, photo 7. It's a sort of localized smearing.
The smearing works like this: First, assume a grayscale image. For each
pixel in the image, pamoil looks at a square neighborhood around it.
pamoil determines what is the most common pixel intensity in the neigh-
borhood, and puts a pixel of that intensity into the output in the same
position as the input pixel.
For color images, or any arbitrary multi-channel image, pamoil computes
each channel (e.g. red, green, and blue) separately the same way as the
grayscale case above.
At the edges of the image, where the regular neighborhood would run off
the edge of the image, pamoil uses a clipped neighborhood.
OPTIONS
In addition to the options common to all programs based on libnetpbm
(most notably -quiet, see ]8;;index.html#commonoptions\ Common Options]8;;\ ), pamoil recognizes the fol-
lowing 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
netpbm documentation 25 June 2001 Pamoil User Manual(1)
Generated by dwww version 1.16 on Tue Dec 16 06:18:32 CET 2025.