Debian Codegraph @

upstream/debian-unstable/man1/pnmstitch.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 "Pnmstitch User Manual" 1 "July 2002" "netpbm documentation"
7
8 .SH NAME
9 pnmstitch - stitch together two panoramic (side-by-side) photographs
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpnmstitch\fP
15 [
16 [\fIleft_filespec\fP] \fIright_filespec\fP |
17 \fIleft_filespec\fP \fIright_filespec\fP \fIoutput_filespec\fP
18 ]
19 [\fB-width=\fP\fIwidth\fP]
20 [\fB-height=\fP\fIheight\fP]
21 [\fB-xrightpos=\fP\fIcolumn\fP]
22 [\fB-yrightpos=\fP\fIrow\fP]
23 [\fB-stitcher=\fP{\fBRotateSliver\fP,
24 \fBBiLinearSliver\fP,\fBLinearSliver\fP}]
25 [\fB-filter=\fP{\fBLineAtATime\fP,\fBHorizontalCrop\fP}]
26 [\fB-output=\fP\fIoutput_filespec\fP]
27 [\fB-verbose\fP]
28 .PP
29 All options can be abbreviated to their shortest unique prefix.
30 You may use two hyphens instead of one. You may separate an option
31 name and its value with white space instead of an equals sign.
32
33 .UN description
34 .SH DESCRIPTION
35 .PP
36 This program is part of
37 .BR "Netpbm" (1)\c
38 \&.
39 .PP
40 \fBpnmstitch\fP stitches together two panoramic photographs. This
41 means if you have photographs of the left and right side of something
42 that is too big for a single camera frame, \fBpnmstitch\fP can join them
43 into one wide picture.
44 .PP
45 \fBpnmstitch\fP works only on side-by-side images, not top and bottom
46 (though you could certainly use \fBpamflip\fP in combination with
47 \fBpnmstitch\fP to achieve this). It stitches together two images, but
48 you can use it repeatedly to stitch together as many as you need to.
49 .PP
50 Your photographs must overlap in order for \fBpnmstitch\fP to
51 work, and the overlap should be substantial. \fBpnmstitch\fP shifts
52 and stretches the right hand image to match it up the left hand image.
53 You probably want to crop the result with \fBpamcut\fP to make a nice
54 rectangular image.
55 .PP
56 If you're just trying to join (concatenate) two images at their edges, use
57 \fBpamcat\fP.
58 .PP
59 The \fIleft_filespec\fP and \fIright_filespec\fP arguments are the
60 specifications (names) of the PNM files containing the left hand and
61 right hand images. If you specify only \fIright_filespec\fP, the
62 left hand image comes from Standard Input. If you specify neither, both
63 images come from Standard Input as a multi-image file containing first the
64 left and then the right image.
65 .PP
66 \fIoutput_filespec\fP is the specification (name) of the output PNM file.
67 The \fB-output\fP option also specifies the output file. You cannot specify
68 both the argument and the option. If you specify neither, the output goes to
69 Standard Output.
70
71
72 .UN options
73 .SH OPTIONS
74 .PP
75 In addition to the options common to all programs based on libnetpbm
76 (most notably \fB-quiet\fP, see
77 .UR index.html#commonoptions
78 Common Options
79 .UE
80 \&), \fBpnmstitch\fP recognizes the following
81 command line options:
82
83
84 .TP
85 \fB-width=\fIwidth\fP\fP
86 .TP
87 \fB-height=\fIheight\fP\fP
88 .TP
89 \fB-xrightpos=\fIcolumn\fP\fP
90 .TP
91 \fB-yrightpos=\fIrow\fP\fP
92 These are constraints on where \fBpnmstitch\fP stitches the images together.
93 For the \fBLinearSliver\fP method, \fIcolumn\fP and \fIrow\fP tell what
94 location in the right hand image matches up to the top right corner of the
95 left hand image.
96
97 .TP
98 \fB-stitcher=\fP{\fBRotateSliver\fP,\fBBiLinearSliver\fP,
99 \fBLinearSliver\fP}
100 The default is \fBRotateSliver\fP.
101
102 .TP
103 \fB-filter=\fP{\fBLineAtATime\fP,\fBHorizontalCrop\fP}
104 No details available.
105
106 .TP
107 \fB-output=\fP\fIoutput_filespec\fP
108 Name of output file. If you don't specify this option, the output image
109 goes to Standard Output.
110
111 .TP
112 \fB-verbose\fP
113 This option causes \fBpnmstitch\fP to issue messages to Standard Error
114 about the stitching process.
115
116
117
118 .UN seealso
119 .SH SEE ALSO
120 .BR "pamcut" (1)\c
121 \&,
122 .BR "pamcat" (1)\c
123 \&,
124 .BR "pamflip" (1)\c
125 \&,
126 .BR "pnm" (1)\c
127 \&,
128
129 .UN history
130 .SH HISTORY
131 .PP
132 This program was added to Netpbm in Release 10.7 (August 2002).
133 .SH DOCUMENT SOURCE
134 This manual page was generated by the Netpbm tool 'makeman' from HTML
135 source. The master documentation is at
136 .IP
137 .B http://netpbm.sourceforge.net/doc/pnmstitch.html
138 .PP