\
.\" 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 "Pamsharpmap User Manual" 1 "07 February 2004" "netpbm documentation"

.SH NAME
pamsharpmap - create map of sharpness in a PNM/PAM image

.UN synopsis
.SH SYNOPSIS
\fBpamsharpmap\fP [\fIimagefile\fP]

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpamsharpmap\fP reads a Netpbm image (PNM or PAM) and produces
an image that shows how sharp it is at each location.
.PP
Sharpness is a measure of how suddenly (in space) colors change in
the image.  \fBpamsharpmap\fP computes the sharpness of each
component color (R, G, B) separately and produces a pixel whose
intensity of each component color is directly proportional to the
sharpness of that component color at the same location in the input
image.  Thus, at a point where the image is very sharp in its red and
green components, but dull in its blue component, you will see a
yellow pixel in the output.
.PP
\fBpamsharpmap\fP computes sharpness at a point simply as the
average difference in intensity between the pixel at that point and
the 8 pixels surrounding it.
.PP
At the edges of the image, where there are not 8 pixels surrounding
a pixel, \fBpamsharpmap\fP assumes the image is extended with a black
border.
.PP
\fBpamsharpmap\fP assumes that the image is a PNM or PNM
equivalent PAM.  If it isn't, the results are not necessarily
meaningful.
.PP
The output image is the same dimensions, depth, and tuple type as
the input, and has maxval 255.

.UN options
.SH OPTIONS
.PP
There are no command line options defined specifically
for \fBpamsharpmap\fP, but it recognizes the options common to all
programs based on libnetpbm (See 
.UR index.html#commonoptions
 Common Options
.UE
\&.)

.UN seealso
.SH SEE ALSO
.BR "pamsharpness" (1)\c
\&,
.BR "pammasksharpen" (1)\c
\&,
.BR "pamedge" (1)\c
\&,
.BR "pam" (1)\c
\&,
.BR "pnm" (1)\c
\&

.UN history
.SH HISTORY
.PP
\fBpamsharpmap\fP was added to Netpbm in Release 10.21 (March
2004).  Bryan Henderson derived it from the program \fBpnmsharp\fP by
B.W. van Schooten and distributed as part of the Photopnmtools
package.
.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/pamsharpmap.html
.PP