1Pamoil User Manual(0)                                    Pamoil User Manual(0)
2
3
4

NAME

6       pamoil - turn a PAM image into an oil painting
7
8

SYNOPSIS

10       pamoil
11
12       [-n N]
13
14       [pamfile]
15
16

DESCRIPTION

18       This program is part of Netpbm(1).
19
20       pamoil  reads  a  Netpbm image as input and does an "oil transfer", and
21       writes the same type of Netpbm image as output.
22
23       The oil transfer is described  in  "Beyond  Photography"  by  Holzmann,
24       chapter 4, photo 7.  It's a sort of localized smearing.
25
26       The  smearing  works  like  this: First, assume a grayscale image.  For
27       each pixel in the image, pamoil looks at a square  neighborhood  around
28       it.   pamoil  determines what is the most common pixel intensity in the
29       neighborhood, and puts a pixel of that intensity into the output in the
30       same position as the input pixel.
31
32       For color images, or any arbitrary multi-channel image, pamoil computes
33       each channel (e.g. red, green, and blue) separately the same way as the
34       grayscale case above.
35
36       At the edges of the image, where the regular neighborhood would run off
37       the edge of the image, pamoil uses a clipped neighborhood.
38
39

OPTIONS

41       In addition to the options common to all programs  based  on  libnetpbm
42       (most notably -quiet, see
43        Common  Options  ⟨index.html#commonoptions⟩  ),  pamoil recognizes the
44       following command line option:
45
46
47
48       -n size
49              This is the size of the neighborhood used in the smearing.   The
50              neighborhood is this many pixels in all four directions.
51
52              The default is 3.
53
54
55
56

SEE ALSO

58       pgmbentley(1), ppmrelief(1), ppm(1)
59
60

AUTHOR

62       This  program  is  based  on  pgmoil  Copyright (C) 1990 by Wilson Bent
63       (whb@hoh-2.att.com)
64
65       Modified to ppm by Chris Sheppard, June 25, 2001
66
67       Modified to pnm, using pam functions, by Bryan Henderson June 28, 2001.
68

DOCUMENT SOURCE

70       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
71       source.  The master documentation is at
72
73              http://netpbm.sourceforge.net/doc/pamoil.html
74
75netpbm documentation             25 June 2001            Pamoil User Manual(0)