Manual: pamoil

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, 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) sep‐
       arately 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)