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
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
|
############# Example Script ##########################
# to run PTOptimizer
#
#
# Only lines starting with 'p', 'v', 'i', or 'm' are read.
# So you can add comments and info as you like by using
# other line starting characters.
# Do not start a line with !, it is used by adjust plugin and scripts.
# the * character indicated the end of the script file.
# The script must contain:
# one 'p'- line describing the output image (eg Panorama)
# one 'i'-line for each input image
# one or several 'v'- lines listing the variables to be optimized.
# the 'm'-line is optional and allows you to specify modes for the optimization.
# one 'c'-line for each pair of control points
# 'p'-line options
# w1000 width in pixels
# h600 height in pixels (default: width/2)
# f0 projection format,
# 0 - Rectilinear (for printing and viewing)
# 1 - Cylindrical (for Printing and QTVR)
# 2 - Equirectangular ( for Spherical panos), default
# 3 - Fisheye Equidistance full-frame
# 4 - Fisheye Stereographic full-frame
# 5 - Mercator
# 6 - Transverse Mercator
# 7 - Sinusoidal
# 8 - Lambert Equal Area Cylindrical
# 9 - Lambert Azimuthal
# 10 - Albers Equal Area Conical
# 11 - Miller Cylindrical
# 12 - Panini (for wide angle printing and viewing)
# 13 - Architectural (combines Miller Cylindrical and Lambert Azimuthal)
# 14 - Fisheye Orthographic full-frame
# 15 - Fisheye Equisolid full-frame
#
# P"p1 p2 ..." Optional parameters for some projections
#
# for f10 - 0, 1 or 2 parameters corresponding to the
# standard parallels. If no parms specified
# defaults to <20,60>. If one given P1 == P2
#
# v360 horizontal field of view of panorama (default 360)
# nPICT Panorama file format, one of:
# PICT pict-file on macs, bmp-file on win (default)
# PSD single layer Photoshop file, 48bits supported
# PNG png-format, 48bits supported
# TIFF tiff-format, 48bits supported
# PSD_mask Photoshop file, one image per layer
# + shape mask & feathered clip mask at overlap center
# PSD_nomask Photoshop file, one image per layer,
# TIFF_mask tiff-format, multi-file, one image per file, 48bit supported
# alpha layer with feathered clip mask at overlap center
# TIFF_m tiff-format, multi-file, one image per file, 48bit supported
# alpha layer with non-feathered clip mask at image border
# + shape mask & non-feathered clip mask at image border
# JPEG Panoramic image in jpeg-format. Use with f1
# for IBM Hotmedia panoramas.
# PAN SmoothMove movie. Use only with f2.
# IVR LivePicture IVR movie
# cylindrical (format f1) or spherical (format f2)
# IVR_java LivePicture Java Panorama,
# cylindrical (format f1) or spherical (format f2)
# VRML VRML background node, use only with f2 for panoramas, or
# VRML-object for PTStereo
# QTVR Apple QTVR-panomovie. Use only with f1
# 3DMF 3DMF-object (PTStereo).
#
# n"QTVR w400 h300 c1" additional viewer options in a quoted string together with format
# the following options are recognized:
# w(width) and h(height) of viewer window (only QTVR on Macs)
# c(codec: 0-JPEG, 1-Cinepak, 2-Sorenson) (only QTVR on Macs)
# q(codec quality):
# 0-high,1-normal,2-low QTVR on Macs
# 0-100(highest) on other jpeg-formats (PAN, IVR, IVR_java, VRML)
# g progressive jpeg (0-no, 1-yes) (PAN, IVR, IVR_java, VRML)
# Optimized JPEG (0-on(default), 2-disabled), (3-progressive with optimized disabled)
# p initial pan angle ( QTVR on Macs, VRML, IVR)
# v field of view (QTVR, VRML, IVR)
#
# n"TIFF_m c:LZW r:CROP" additional viewer options in a quoted string together with format
# the following options are recognized for TIFF_m:
# c:LZW enable LZW compression
# r:CROP enable cropping to ROI (default)
# r:UNCROP disable cropping to ROI
#
# Many more options can be set by editing the viewer scripts
#
# -buf suppress buffer commands in the stitcher script generated by PTOptimizer.
# (buffer commands are now obsolete, -buf and +buf on i lines are now
# ignored when stitching) This option should be set if you wish
# to edit the final panoramic image, eg for the two PSD formats.
# a0.0 b1.0 c0.04 Options to create multiple images in PTInterpolate and PTMorpher.
# a denotes starting value,
# b end value
# c increment. 0 is left, 1 is right image.
# The above command interpolates/morphs two images and
# creates 25 intermediate frames.
# u10 width of feather for stitching all images. default:10
# k1 attempt color & brightness correction using image number as anchor
# b1 attempt brightness correction with no color change using image number as anchor
# d1 attempt color correction with no brightness change using image number as anchor
# Do not use more than one of k, d, b.This is new method of correcting
p w800 nPSD_mask -buf
# The 'i' lines describe input images. One line per image is required
# unneeded paramiters for optimizing but needed for stitching can be
# set here and the optimizer will automaticaly add them to the o lines
# ----------------
# f0 projection format,
# 0 - Rectilinear (normal lenses)
# 1 - Panoramic (Scanning cameras like Noblex)
# 2 - Fisheye Equidistance Circular
# 3 - Fisheye Equidistance full-frame
# 4 - Equirectangular (Spherical panos)
# 7 - Mirror
# 8 - Fisheye Orthographic (This is only allowed in PTStereo and
# for the first image. This indicates a map or ground plan)
# 10 - Fisheye Stereographic
# 19 - Fisheye Equisolid
# w600 width in pixels
# h1000 height in pixels
# v82 horizontal field of view of image (required, but ignored for f8)
# y0 initial yaw angle (required)
# p43 initial pitch angle (required)
# r0 initial roll angle (required)
# a,b,c initial lens correction coefficients (defaults a0 b0 c0, optional)
# (see http://www.fh-furtwangen.de/~dersch/barrel/barrel.html)
# d,e initial lens offset in pixels(defaults d0 e0, optional).
# Used to correct for offset from center of image
# d - horizontal offset,
# e - vertical offset
# g,t initial lens shear. Use to remove slight misalignment
# of the line scanner relative to the film transport
# g - horizontal shear
# t - vertical shear
# TiX,TiY,TiZ,TiS initial tilt. Use to correct for off NPP nadir images
# TiX the x offset of the camera (default TiX0)
# TiY the y offset of the camera (default TiY0)
# TiZ the z offset of the camera (default TiZ0)
# TiS the scale offset of the camera (default TiS1, valid for values > 0)
# TrX,TrY,TrZ initial mosaic mode translation offsets, alternative to Ti
# parameters
# Te0,Te1,Te2,Te3 Test parameters
# S100,600,100,800 Selection(l,r,t,b), Only pixels inside the rectangle will be used for conversion.
# Original image size is used for all image parameters
# (e.g. field-of-view) refer to the original image.
# C100,600,100,800 Crop(l,r,t,b), Only pixels inside the rectangle will be used for conversion.
# Cropped image size is used for all image parameters
# (e.g. field-of-view) refer to the cropped part of the image.
# m20 (obsolete, use S & C) ignore a frame 20 pixels wide. default: 0
# mx100 (obsolete, use S & C) crop to brightest rectangle with size 100x200;
# my200 (obsolete, use S & C) used only for circular fisheye images (f2)
# s0 (obsolete, ignored, always blend) specify placement of seam between buffer and image:
# 0-middle of overlap('blend' ,default)
# 1- at edge of image ('paste').
# o (the small letter). Morph-to-fit using control points.
# X10 World coordinates of camera position, only used for PTStereo
# Y200 If the camera is aligned (yaw = pitch = roll = 0.0),
# Z-13.5 X is coordinate to the right, Y vertically up and
# -Z is forward viewing direction.
# nName Name of image (ignored by PTOptimizer used in PTStitcher)
#
# Parameters in different images can be linked using '='
# followed by the image number starting with 0.
# Example 'v=0' sets horizontal field of view as in
# image number 0. This feature works for the variables
# v, a, b, c, (r, p, y with caution) d, e, g, and t
i f2 r0 p0 y0 v183 a0 b-0.1 c0 mx400 my400
i f2 r-0.5 p1 y182 v=0 a0 b-0.1 c0 mx400 my400
# 'v'-line options:
# -----------------
# Please note: the 'v'-line must come after the the 'i'-lines.
# Optimization variables are listed together with the image number
# starting at 0. There can be several v-lines.
#
# y0 Optimize yaw in image 0
# p1 Optimize pitch in image 1
# r2 Optimize roll in image 2
# v0 Optimize field of view in image 0
# a2 Optimize lens correction parameter 'a' in image 2
# b and c can be equally optimized.
# X1 Optimize x-coordinate of image 1, only for PTStereo
# Y2 Optimize y-coordinate of image 2, only for PTStereo
# Z6 Optimize z-coordinate of image 6, only for PTStereo
#
# If a image has a parameter linked to another image only
# need to optimize the master.
v v0 r0 p0 r1 p1 y1
#
# 'm'-line options
# ----------------
# Set mode for stitcher, not required
#
# g2.5 Set gamma value for internal computations (default 1.0)
# See <http://www.fh-furtwangen.de/~dersch/gamma/gamma.html>
# i2 Set interpolator, See <http://www.fh-furtwangen.de/~dersch/interpolator/interpolator.html>
# one of:
# 0 - poly3 (default)
# 1 - spline16,
# 2 - spline36,
# 3 - sinc256,
# 4 - spline64,
# 5 - bilinear,
# 6 - nearest neighbor,
# 7 - sinc1024
# \/ antialiasing filters \/ See <http://www.pano2qtvr.com/dll_patch/>
# 8 - Box
# 9 - Bartlett/Triangle
# 10 - Hermite
# 11 - Hanning
# 12 - Hamming
# 13 - Blackmann
# 14 - Gaussian 1/sqrt(2)
# 15 - Gaussian 1/2
# 16 - Quadardic
# 17 - Cubic
# 18 - Catmull-Rom
# 19 - Mitchell
# 20 - Lanczos2
# 21 - Lanczos3
# 22 - Blackman/Bessel
# 23 - Blackman/sinc
#
# p0 Create panorama after optimizing control points
# 0 no(default), 1 yes
#
# m0 use Huber m-estimator during second optimisation pass.
# This will reduce the weight of control points with higher errors
# It might help a little if a pano contains a few inaccurate or
# completely wrong control points.
# 0: no m-estimator (as in previous versions)
# Any other number is the sigma parameter of the huber m-estimator.
# Control points with errors higher than sigma will have less
# influence during the optimisation.
# A good value for sigma might be 2.
#
m g1.5 i6
#
# 'c' lines
# ----------------
# Control point lines
# One line per point pair
# about one pair of points per image per variable being optimized.
# The more variables being optimized the more control points needed.
#
# n0 first image
# N1 second image
# x1066.5 first image x point position
# y844.333 first image y point position
# X239.52 second image x point position
# Y804.64 second image y point position
# t0 type of control point (optional)
# 0 - normal (default)
# 1 - optimize horizontally only
# 2 - optimize vertically only
# 3+ (all other numbers) - straight line
*
Every thing after * is ignored.
|
