\
.\" 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 "Pnmstitch User Manual" 0 "July 2002" "netpbm documentation"

.SH NAME
pnmstitch - stitch together two panoramic (side-by-side) photographs

.UN synopsis
.SH SYNOPSIS

\fBpnmstitch\fP
[
[\fIleft_filespec\fP] \fIright_filespec\fP |
\fIleft_filespec\fP \fIright_filespec\fP \fIoutput_filespec\fP
]
[\fB-width=\fP\fIwidth\fP]
[\fB-height=\fP\fIheight\fP]
[\fB-xrightpos=\fP\fIcolumn\fP]
[\fB-yrightpos=\fP\fIrow\fP]
[\fB-stitcher=\fP{\fBRotateSliver\fP,
\fBBiLinearSliver\fP,\fBLinearSliver\fP}]
[\fB-filter=\fP{\fBLineAtATime\fP,\fBHorizontalCrop\fP}]
[\fB-output=\fP\fIoutput_filespec\fP]
[\fB-verbose\fP]
.PP
All options can be abbreviated to their shortest unique prefix.
You may use two hyphens instead of one.  You may separate an option
name and its value with white space instead of an equals sign.

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR Netpbm (1)
.
.PP
\fBpnmstitch\fP stitches together two panoramic photographs.  This
means if you have photographs of the left and right side of something
that is too big for a single camera frame, \fBpnmstitch\fP can join them
into one wide picture.
.PP
\fBpnmstitch\fP works only on side-by-side images, not top and bottom
(though you could certainly use \fBpamflip\fP in combination with
\fBpnmstitch\fP to achieve this).  It stitches together two images, but
you can use it repeatedly to stitch together as many as you need to.
.PP
Your photographs must overlap in order for \fBpnmstitch\fP to
work, and the overlap should be substantial.  \fBpnmstitch\fP shifts
and stretches the right hand image to match it up the left hand image.
You probably want to crop the result with \fBpamcut\fP to make a nice
rectangular image.
.PP
If you're just trying to join (concatenate) two images at their edges, use
\fBpnmcat\fP.
.PP
The \fIleft_filespec\fP and \fIright_filespec\fP arguments are the
specifications (names) of the PNM files containing the left hand and
right hand images.  If you specify only \fIright_filespec\fP, the
left hand image comes from Standard Input.  If you specify neither, both
images come from Standard Input as a multi-image file containing first the
left and then the right image.
.PP
\fIoutput_filespec\fP is the specification (name) of the output PNM file.
The \fB-output\fP option also specifies the output file.  You cannot specify
both the argument and the option.  If you specify neither, the output goes to
Standard Output.


.UN options
.SH OPTIONS


.TP
\fB-width=\fIwidth\fP\fP
.TP
\fB-height=\fIheight\fP\fP
.TP
\fB-xrightpos=\fIcolumn\fP\fP
.TP
\fB-yrightpos=\fIrow\fP\fP
These are constraints on where \fBpnmstitch\fP stitches the images together.
For the \fBLinearSliver\fP method, \fIcolumn\fP and \fIrow\fP tell what
location in the right hand image matches up to the top right corner of the
left hand image.
     
.TP
\fB-stitcher=\fP{\fBRotateSliver\fP,\fBBiLinearSliver\fP,
\fBLinearSliver\fP}
The default is \fBRotateSliver\fP.

.TP
\fB-filter=\fP{\fBLineAtATime\fP,\fBHorizontalCrop\fP}
No details available.
     
.TP
\fB-output=\fP\fIoutput_filespec\fP
Name of output file.  If you don't specify this option, the output image
goes to Standard Output.

.TP
\fB-verbose\fP
This option causes \fBpnmstitch\fP to issue messages to Standard Error
about the stitching process.
     


.UN seealso
.SH SEE ALSO
.BR pamcut (1)
,
.BR pnmcat (1)
,
.BR pamflip (1)
,
.BR pnm (5)
,

.UN history
.SH HISTORY
.PP
This program was added to Netpbm in Release 10.7 (August 2002).