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
|
############# Example Script ##########################
# for nona
#
# This document describes the script supported by the nona stitcher.
#
# Based on the PTStitcher documentation
#
#
# Only lines starting with 'p','o', i', 'm' or 'k' are read,
# so you can add comments and info as you like by using
# other line starting characters.
# The stitcher script must contain:
# one 'p'-line describing the output image (eg Panorama)
# one 'i'-line for each input image
# one 'm'-line for global options
#
# 'p'-line options
# w1000 width in pixels
# h600 height in pixels
# f0 projection format,
# 0 - rectilinear (for printing and viewing)
# 1 - Cylindrical (for Printing and QTVR)
# 2 - Equirectangular ( for Spherical panos), default
# 3 - full-frame fisheye
# 4 - Stereographic
# 5 - Mercator
# 6 - Transverse Mercator
# 7 - Sinusoidal
# 8 - Lambert Cylindrical Equal Area
# 9 - Lambert Equal Area Azimuthal
# 10 - Albers Equal Area Conic
# 11 - Miller Cylindrical
# 12 - Panini
# 13 - Architectural
# 14 - Orthographic
# 15 - Equisolid
# 16 - Equirectangular Panini
# 17 - Biplane
# 18 - Triplane
# 19 - Panini General
# 20 - Thoby Projection
# 21 - Hammer-Aitoff Projection
# v360 horizontal field of view of panorama (default 360)
# nPICT Panorama file format, one of:
# PNG png-format, 8 & 16 bit supported
# PNG_m png-format, multi-file, one image per file
# alpha layer with non-feathered clip mask at image border
# TIFF tiff-format, all tiff types supported (8,16,32 bit int, float, double)
# TIFF_m tiff-format, multi-file, one image per file
# alpha layer with non-feathered clip mask at image border
# TIFF_multilayer tiff-format, multi-image-file, all files in one image
# alpha layer with non-feathered clip mask at image border
# This filetype is supported by The GIMP
# JPEG Panoramic image in jpeg-format.
# JPEG_m jpeg-format, multi-file, one image per file
# without alpha layer, not suitable for further blending or fusing
# some more supported file formats (mostly only 8 bit support)
# PNM, PGM, BMP, SUN, VIFF
#
# Special options for TIFF output:
# n"TIFF c:NONE"
# c - select TIFF compression, possible options: NONE, LZW, DEFLATE
#
# Special options for TIFF_m and TIFF_multilayer output:
# n"TIFF c:NONE r:CROP"
# c - TIFF compression, possible options NONE, LZW, DEFLATE
# r - output only used image area (cropped output). The crop offsets
# are stored in the POSITIONX and POSITONY tiff tags
# p1 - save coordinate images (useful for further programs, like vignetting correction)
#
# Special options for JPEG output:
# n"JPEG q95"
# q - jpeg quality
#
# E12.3 exposure value for final panorama
# R1 stitching mode: 0: normal LDR mode, 1: HDR mode
# T"UINT8" bitdepth of output images, possible values are
# UINT8 - 8 bit unsigned
# UINT16 - 16 bit unsigned
# FLOAT - 32 bit floating point
# By default the bit depth of the input images is use.
#
# S100,600,100,800 Selection(left,right,top,bottom), Only pixels inside the rectangle
# will be rendered. Images that do not contain pixels in this area
# are not rendered/created.
#
# k1 Image number of reference image for photometric correction
#
# P"100 12" Parameters for tuning projection, number of parameters depends on projection
#
p w1000 h600 f0 v360 E12.3
# The 'i' lines describe input images (nona also accepts 'o' line image descriptions)
#
# f0 projection format,
# 0 - rectilinear (normal lenses)
# 1 - Panoramic (Scanning cameras like Noblex)
# 2 - Circular fisheye
# 3 - full-frame fisheye
# 4 - Equirectangular (spherical panos)
# 8 - orthographic fisheye
# 10 - stereographic fisheye
# 21 - Equisolid fisheye
# 20 - Fisheye Thoby (Nikkor 10.5)
# v82 horizontal field of view of image (required)
# y0 yaw angle (required)
# p43 pitch angle (required)
# r0 roll angle (required)
# a,b,c lens correction coefficients (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
#
# Eev exposure of image in EV (exposure values)
# Er white balance factor for red channel
# Eb white balance factor for blue channel
#
# Vm vignetting correction mode (default 5):
# 0: no vignetting correction
# 1: radial vignetting correction (see Va, Vb, Vc, Vd options)
# 2: flatfield vignetting correction (see Vf option)
# 4: proportional correction: i_new = i / corr.
#
# default is additive correction: i_new = i + corr
# Both radial and flatfield correction can be combined with the
# proportional correction by adding 4.
# Examples: Vm1 - radial polynomial correction by addition.
# The coefficients Va, Vb, Vc, Vd must be specified.
# Vm5 - radial polynomial correction by division.
# The coefficients Va, Vb, Vc, Vd must be specified.
# Vm6 - flatfield correction by division.
# The flatfield image should be specified with the Vf option
#
# Va,Vb,Vc,Vd vignetting correction coefficients. (defaults: 1,0,0,0)
# ( 0, 2, 4, 6 order polynomial coefficients):
# corr = ( i + j*r^2 + k*r^4 + l*r^6), where r is the distance from the image center
# The corrected pixel value is calculated with: i_new = i_old + corr
# if additive correction is used.
# for proportional correction (Vm5): i_new = i_old / corr;
#
# Vx,Vy radial vignetting correction offset in pixels (defaults Vx0 Vy0, optional).
# Used to correct for offset from center of image
# Vx - horizontal offset
# Vy - vertical offset
#
# Vf filename of flatfield image.
# For additive correction the image will be used as it is.
# In the case of correction by division, the flatfield will be divided by
# its mean value.
#
# Ra,Rb,Rc,Rd,Re EMoR photometric model parameters. (defaults: 0,0,0,0,0)
#
# TrX,TrY,TrZ mosaic mode translation offsets.
#
# Tpy, Tpp orientation of remapping plane for translation offsets.
# (have no effect if TrX, TrY and TrZ are zero)
#
# 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.
# Selection can be outside image dimension.
# The selection will be circular for circular fisheye images, and
# rectangular for all other projection formats
#
# j0 stack number
#
# nName file name of the input image.
#
# 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. You can only refer to images before the
# current image.
i f2 r0 p0 y0 v183 a0 b-0.1 c0 S100,600,100,800 n"photo1.jpg"
i f2 r0 p0 y180 v183 a0 b-0.1 c0 S100,600,100,800 n"photo1.jpg"
# 'm'-line options
# ----------------
# Set mode for stitcher, not required
#
# 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
#
m i2
# 'v'-line options
# ----------------
# Indicate i-line parameters to optimise
# nona ignores all 'v' lines, these lines are used by autooptimiser
# (a,b,c,d,e,v,r,p,y geometric parameters) and vig_optimize
# (Eev,Er,Eb,Va,Vb,Vc,Vd,Vx,Vy,Ra,Rb,Rc,Rd,Re photometric parameters)
#
# 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
#
# If a image has a parameter linked to another image only
# need to optimize the master.
#
v v0 r0 p0 r1 p1 y1
# 'k'-line options
# ----------------
# Optional image masks are described by a 'k' line
#
# i2 Set image number this mask applies to
#
# t0 Type for mask:
# 0 - negative (exclude region)
# 1 - positive (include region)
# 2 - negative, stack aware (exclude region from stack)
# 3 - positive, stack aware (include region from stack)
# 4 - negative, lens (exclude region from all images of same lens)
#
# p"1262 2159 1402 2065 1468 2003" List of node coordinates
# Coordinates are in pairs, at least three pairs are required
k i2 t0 p"1262 2159 1402 2065 1468 2003"
# 'c'-lines
# ----------------
# Control point lines
# nona ignores all 'c' lines, these lines are used by autooptimiser
#
# 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
c n0 N1 x1066.5 y844.333 X239.52 Y804.64 t0
|
