Debian Codegraph @

upstream/debian-unstable/man1/pamsharpmap.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 "Pamsharpmap User Manual" 1 "07 February 2004" "netpbm documentation"
7
8 .SH NAME
9 pamsharpmap - create map of sharpness in a PNM/PAM image
10
11 .UN synopsis
12 .SH SYNOPSIS
13 \fBpamsharpmap\fP [\fIimagefile\fP]
14
15 .UN description
16 .SH DESCRIPTION
17 .PP
18 This program is part of
19 .BR "Netpbm" (1)\c
20 \&.
21 .PP
22 \fBpamsharpmap\fP reads a Netpbm image (PNM or PAM) and produces
23 an image that shows how sharp it is at each location.
24 .PP
25 Sharpness is a measure of how suddenly (in space) colors change in
26 the image. \fBpamsharpmap\fP computes the sharpness of each
27 component color (R, G, B) separately and produces a pixel whose
28 intensity of each component color is directly proportional to the
29 sharpness of that component color at the same location in the input
30 image. Thus, at a point where the image is very sharp in its red and
31 green components, but dull in its blue component, you will see a
32 yellow pixel in the output.
33 .PP
34 \fBpamsharpmap\fP computes sharpness at a point simply as the
35 average difference in intensity between the pixel at that point and
36 the 8 pixels surrounding it.
37 .PP
38 At the edges of the image, where there are not 8 pixels surrounding
39 a pixel, \fBpamsharpmap\fP assumes the image is extended with a black
40 border.
41 .PP
42 \fBpamsharpmap\fP assumes that the image is a PNM or PNM
43 equivalent PAM. If it isn't, the results are not necessarily
44 meaningful.
45 .PP
46 The output image is the same dimensions, depth, and tuple type as
47 the input, and has maxval 255.
48
49 .UN options
50 .SH OPTIONS
51 .PP
52 There are no command line options defined specifically
53 for \fBpamsharpmap\fP, but it recognizes the options common to all
54 programs based on libnetpbm (See
55 .UR index.html#commonoptions
56 Common Options
57 .UE
58 \&.)
59
60 .UN seealso
61 .SH SEE ALSO
62 .BR "pamsharpness" (1)\c
63 \&,
64 .BR "pammasksharpen" (1)\c
65 \&,
66 .BR "pamedge" (1)\c
67 \&,
68 .BR "pam" (1)\c
69 \&,
70 .BR "pnm" (1)\c
71 \&
72
73 .UN history
74 .SH HISTORY
75 .PP
76 \fBpamsharpmap\fP was added to Netpbm in Release 10.21 (March
77 2004). Bryan Henderson derived it from the program \fBpnmsharp\fP by
78 B.W. van Schooten and distributed as part of the Photopnmtools
79 package.
80 .SH DOCUMENT SOURCE
81 This manual page was generated by the Netpbm tool 'makeman' from HTML
82 source. The master documentation is at
83 .IP
84 .B http://netpbm.sourceforge.net/doc/pamsharpmap.html
85 .PP