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, chapter 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
       neighborhood, 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  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

netpbm documentation                              25 June 2001                             Pamoil User Manual(1)