\
.\" 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 "Pamwipeout User Manual" 1 "26 February 2011" "netpbm documentation"

.SH NAME
pamwipeout - replace detail with smooth gradient from one edge to the other

.UN synopsis
.SH SYNOPSIS
\fBpamwipeout\fP
{\fB-lr | -tb\fP}
[\fB\fIfilename\fP\fP]
.PP
Minimum unique abbreviation of options is acceptable. 
You may use double hyphens instead of single hyphen to denote options.

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
The \fBpamwipeout\fP utility takes a Netpbm image as input and the uses
two opposite edges of the image to wipe out anything in between.  You can use
it in combination with \fBpamcut\fP and \fBpnmpaste\fP / \fBpamcomp\fP to
remove unwanted parts of a larger image.  The program replaces the pixels in
between the two edges with a gradient from one edge to the other.
.PP
In \fBtop-bottom\fP mode, the program reads the whole image into memory
before it can start processing.  In \fBleft-right\fP it will read the image a
row at the time, process that row and write it to the output file.  Therefore,
in case of very large images, it may be better to use instead of
"\fBpamwipeout -tb\fP" a pipe of "\fBpamflip -cw | pamwipeout -lr | pamflip
-ccw\fP".
.PP
In his blog at
 
.UR http://www.i-am.ws/entry/pnmblend_disappearing_act
www.i-am.ws
.UE
\&,
the author wrote about a predecessor of "pamwipeout" at the time named
"pnmblend". It shows a good example of what can be accomplished with this
utility.

.UN parameters
.SH PARAMETERS
.PP
\fB\fIFilename\fP\fP is the name of the input file. If you don't
specify this, \fBpamwipeout\fP reads the image from Standard Input.

.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see 
.UR index.html#commonoptions
 Common Options
.UE
\&), \fBpamwipeout\fP recognizes the following
command line options:


.TP
\fB-tb\fP | \fB-lr\fP
.sp
This option chooses between a vertical and a horizontal gradient.  You must
specify one of these, but not both.



.UN seealso
.SH SEE ALSO
.BR "pam" (1)\c
\& and
.BR "pamflip" (1)\c
\&,
.BR "pamcut" (1)\c
\&,
.BR "pamcomp" (1)\c
\&,
.BR "pnmpaste" (1)\c
\&.

.UN history
.SH HISTORY
.PP
\fBpamwipeout\fP was new in Netpbm 10.54 (March 2011).

.UN authors
.SH AUTHORS
.PP
\fIWillem van Schaik\fP
wrote this program in January 2011 and contributed it to Netpbm.
.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/pamwipeout.html
.PP