\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pamoil User Manual" 0 "25 June 2001" "netpbm documentation"

.SH NAME

pamoil - turn a PAM image into an oil painting

.UN synopsis
.SH SYNOPSIS

\fBpamoil\fP

[\fB-n\fP \fIN\fP]

[\fIpamfile\fP]

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpamoil\fP reads a Netpbm image as input and does an "oil
transfer", and writes the same type of Netpbm image as output.
.PP
The oil transfer is described in "Beyond Photography" by
Holzmann, chapter 4, photo 7.  It's a sort of localized smearing.
.PP
The smearing works like this: First, assume a grayscale image.  For
each pixel in the image, \fBpamoil\fP looks at a square neighborhood
around it.  \fBpamoil\fP 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.
.PP
For color images, or any arbitrary multi-channel image,
\fBpamoil\fP computes each channel (e.g. red, green, and blue)
separately the same way as the grayscale case above.
.PP
At the edges of the image, where the regular neighborhood would run
off the edge of the image, \fBpamoil\fP uses a clipped neighborhood.

.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see 
.UR index.html#commonoptions
 Common Options
.UE
\&), \fBpamoil\fP recognizes the following
command line option:


.TP
\fB-n\fP \fIsize\fP
This is the size of the neighborhood used in the smearing.  The
neighborhood is this many pixels in all four directions.
.sp
The default is 3.



.UN seealso
.SH SEE ALSO
.BR "pgmbentley" (1)\c
\&,
.BR "ppmrelief" (1)\c
\&,
.BR "ppm" (1)\c
\&

.UN author
.SH AUTHOR
.PP
This program is based on pgmoil Copyright (C) 1990 by Wilson Bent
(\fIwhb@hoh-2.att.com\fP)
.PP
Modified to ppm by Chris Sheppard, June 25, 2001
.PP
Modified to pnm, using pam functions, by Bryan Henderson June 28,
2001.
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/pamoil.html
.PP