about summary refs log tree commit diff
path: root/pnmstitch.html
blob: c87067a5e297de526c6b63b17e95a794078c360b (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML><HEAD><title>Pnmstitch User Manual</title></HEAD>

<BODY>
<H1>pnmstitch</H1>
Updated: July 2002
<BR>
<A HREF="#index">Table Of Contents</A>

<H2>NAME</H2>
pnmstitch - stitch together two panoramic (side-by-side) photographs

<H2 id="synopsis">SYNOPSIS</H2>

<B>pnmstitch</B>
[
[<i>left_filespec</i>] <i>right_filespec</i> |
<br>
<i>left_filespec</i> <i>right_filespec</i> <i>output_filespec</i>
]
<br>
[<b>-width=</b><i>width</i>]
[<b>-height=</b><i>height</i>]
[<b>-xrightpos=</b><i>column</i>]
[<b>-yrightpos=</b><i>row</i>]
[<b>-stitcher=</b>{<b>RotateSliver</b>,
<b>BiLinearSliver</b>,<b>LinearSliver</b>}]
[<b>-filter=</b>{<b>LineAtATime</b>,<b>HorizontalCrop</b>}]
[<b>-output=</b><i>output_filespec</i>]
[<b>-verbose</b>]

<P>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.

<H2 id="description">DESCRIPTION</H2>

<p>This program is part of <a href="index.html">Netpbm</a>.

<P><b>pnmstitch</b> 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, <b>pnmstitch</b> can join them
into one wide picture.

<p><b>pnmstitch</b> works only on side-by-side images, not top and bottom
(though you could certainly use <b>pamflip</b> in combination with
<b>pnmstitch</b> to achieve this).  It stitches together two images, but
you can use it repeatedly to stitch together as many as you need to.

<p>Your photographs must overlap in order for <b>pnmstitch</b> to
work, and the overlap should be substantial.  <b>pnmstitch</b> shifts
and stretches the right hand image to match it up the left hand image.
You probably want to crop the result with <b>pamcut</b> to make a nice
rectangular image.

<p>If you're just trying to join (concatenate) two images at their edges, use
<b>pnmcat</b>.

<p>The <i>left_filespec</i> and <i>right_filespec</i> arguments are the
specifications (names) of the PNM files containing the left hand and
right hand images.  If you specify only <i>right_filespec</i>, 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.

<p><i>output_filespec</i> is the specification (name) of the output PNM file.
The <b>-output</b> 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.


<H2 id="options">OPTIONS</H2>

<DL COMPACT>
<DT><B>-width=<i>width</i></B>
<DT><B>-height=<i>height</i></B>
<DT><B>-xrightpos=<i>column</i></B>
<DT><B>-yrightpos=<i>row</i></B>
<DD>
These are constraints on where <b>pnmstitch</b> stitches the images together.
For the <b>LinearSliver</b> method, <i>column</i> and <i>row</i> tell what
location in the right hand image matches up to the top right corner of the
left hand image.
     
<DT><b>-stitcher=</b>{<b>RotateSliver</b>,<b>BiLinearSliver</b>,
<b>LinearSliver</b>}

<DD>The default is <b>RotateSliver</b>.

<dt><b>-filter=</b>{<b>LineAtATime</b>,<b>HorizontalCrop</b>}

<DD>No details available.
     
<dt><b>-output=</b><i>output_filespec</i>

<DD>Name of output file.  If you don't specify this option, the output image
goes to Standard Output.

<DT><B>-verbose</B>

<DD>This option causes <b>pnmstitch</b> to issue messages to Standard Error
about the stitching process.
     
</DL>

<H2 id="seealso">SEE ALSO</H2>

<B><A HREF="pamcut.html">pamcut</A></B>,
<B><A HREF="pnmcat.html">pnmcat</A></B>,
<B><A HREF="pamflip.html">pamflip</A></B>,
<B><A HREF="pnm.html">pnm</A></B>,

<H2 id="history">HISTORY</H2>

<p>This program was added to Netpbm in Release 10.7 (August 2002).

<HR>
<H2 id="index">Table Of Contents</H2>
<UL>
<LI><A HREF="#synopsis">SYNOPSIS</A>
<LI><A HREF="#description">DESCRIPTION</A>
<LI><A HREF="#options">OPTIONS</A>
<LI><A HREF="#seealso">SEE ALSO</A>
<LI><A HREF="#history">HISTORY</A>
</UL>
</BODY>
</HTML>