man-pages/man1/pamoil.1.html
2021-03-31 01:06:50 +01:00

120 lines
2.7 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of pamoil</TITLE>
</HEAD><BODY>
<H1>pamoil</H1>
Section: User Commands (1)<BR>Updated: 25 June 2001<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="ixAAB"></A>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
pamoil - turn a PAM image into an oil painting
<P>
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>pamoil</B>
[<B>-n</B>
<I>N</I>]
[<I>pamfile</I>]
<P>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
Reads a Netpbm image as input.
Does an &quot;oil transfer&quot;, and writes the same type of Netpbm image as output.
<A NAME="ixAAC"></A>
<P>
The oil transfer is described in &quot;Beyond Photography&quot; by Holzmann,
chapter 4, photo 7.
It's a sort of localized smearing.
<P>
The smearing works like this: First, assume a grayscale image. For
each pixel in the image,
<B>pamoil</B>
looks at a square neighborhood around it.
<B>pamoil</B>
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.
<P>
For color images, or any arbitrary multi-channel image,
<B>pamoil</B>
computes each channel (e.g. red, green, and blue) separately the same
way as the grayscale case above.
<P>
At the edges of the image, where the regular neighborhood would run off
the edge of the image,
<B>pamoil</B>
uses a clipped neighborhood.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-n </B><I>size</I>
<DD>
This is the size of the neighborhood used in the smearing. The neighborhood
is this many pixels in all four directions.
<P>
The default is 3.
<P>
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+pgmbentley">pgmbentley</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+ppmrelief">ppmrelief</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?5+ppm">ppm</A></B>(5)
<P>
<A NAME="lbAG">&nbsp;</A>
<H2>AUTHOR</H2>
Based on pgmoil Copyright (C) 1990 by Wilson Bent (<A HREF="mailto:whb@hoh-2.att.com">whb@hoh-2.att.com</A>)
<P>
Modified to ppm by Chris Sheppard, June 25, 2001
<P>
Modified to pnm, using pam functions, by Bryan Henderson June 28, 2001.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="2"><A HREF="#lbAB">NAME</A><DD>
<DT id="3"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="4"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="5"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="6"><A HREF="#lbAF">SEE ALSO</A><DD>
<DT id="7"><A HREF="#lbAG">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:21 GMT, March 31, 2021
</BODY>
</HTML>