Debian Codegraph @

upstream/debian-unstable/man1/pamoil.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Pamoil User Manual" 1 "25 June 2001" "netpbm documentation"
7
8 .SH NAME
9
10 pamoil - turn a PAM image into an oil painting
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBpamoil\fP
16
17 [\fB-n\fP \fIN\fP]
18
19 [\fIpamfile\fP]
20
21 .UN description
22 .SH DESCRIPTION
23 .PP
24 This program is part of
25 .BR "Netpbm" (1)\c
26 \&.
27 .PP
28 \fBpamoil\fP reads a Netpbm image as input and does an "oil
29 transfer", and writes the same type of Netpbm image as output.
30 .PP
31 The oil transfer is described in "Beyond Photography" by
32 Holzmann, chapter 4, photo 7. It's a sort of localized smearing.
33 .PP
34 The smearing works like this: First, assume a grayscale image. For
35 each pixel in the image, \fBpamoil\fP looks at a square neighborhood
36 around it. \fBpamoil\fP determines what is the most common pixel
37 intensity in the neighborhood, and puts a pixel of that intensity into
38 the output in the same position as the input pixel.
39 .PP
40 For color images, or any arbitrary multi-channel image,
41 \fBpamoil\fP computes each channel (e.g. red, green, and blue)
42 separately the same way as the grayscale case above.
43 .PP
44 At the edges of the image, where the regular neighborhood would run
45 off the edge of the image, \fBpamoil\fP uses a clipped neighborhood.
46
47 .UN options
48 .SH OPTIONS
49 .PP
50 In addition to the options common to all programs based on libnetpbm
51 (most notably \fB-quiet\fP, see
52 .UR index.html#commonoptions
53 Common Options
54 .UE
55 \&), \fBpamoil\fP recognizes the following
56 command line option:
57
58
59 .TP
60 \fB-n\fP \fIsize\fP
61 This is the size of the neighborhood used in the smearing. The
62 neighborhood is this many pixels in all four directions.
63 .sp
64 The default is 3.
65
66
67
68 .UN seealso
69 .SH SEE ALSO
70 .BR "pgmbentley" (1)\c
71 \&,
72 .BR "ppmrelief" (1)\c
73 \&,
74 .BR "ppm" (1)\c
75 \&
76
77 .UN author
78 .SH AUTHOR
79 .PP
80 This program is based on pgmoil Copyright (C) 1990 by Wilson Bent
81 (\[email protected]\fP)
82 .PP
83 Modified to ppm by Chris Sheppard, June 25, 2001
84 .PP
85 Modified to pnm, using pam functions, by Bryan Henderson June 28,
86 2001.
87 .SH DOCUMENT SOURCE
88 This manual page was generated by the Netpbm tool 'makeman' from HTML
89 source. The master documentation is at
90 .IP
91 .B http://netpbm.sourceforge.net/doc/pamoil.html
92 .PP