1Panotools::Script::LineU:s:eIrmaCgoen(t3r)ibuted Perl DoPcaunmoetnotoaltsi:o:nScript::Line::Image(3)
2
3
4
6 Panotools::Script::Line::Image - Panotools input image
7
9 A single input image is described by an 'i' line
10
12 Basically the same format as an 'o' line.
13
14 w1000
15 h500 nona requires the width and height of input images wheras PTStitcher/mender don't
16
17 f0 projection format,
18 0 - rectilinear (normal lenses)
19 1 - Panoramic (Scanning cameras like Noblex)
20 2 - Circular fisheye
21 3 - full-frame fisheye
22 4 - PSphere, equirectangular
23 7 - Mirror (a spherical mirror)
24 8 - Orthographic fisheye
25 10 - Stereographic fisheye
26 21 - Equisolid fisheye
27
28 v82 horizontal field of view of image (required)
29 y0 yaw angle (required)
30 p43 pitch angle (required)
31 r0 roll angle (required)
32 a,b,c lens correction coefficients (optional)
33 (see http://www.fh-furtwangen.de/~dersch/barrel/barrel.html)
34 d,e initial lens offset in pixels(defaults d0 e0, optional).
35 Used to correct for offset from center of image
36 d - horizontal offset,
37 e - vertical offset
38 g,t initial lens shear. Use to remove slight misalignment
39 of the line scanner relative to the film transport
40 g - horizontal shear
41 t - vertical shear
42 j stack number
43
44 Eev exposure of image in EV (exposure values)
45 Er white balance factor for red channel
46 Eb white balance factor for blue channel
47
48 Ra EMoR response model from the Computer Vision Lab at Columbia University
49 Rb This models the camera response curve
50 Rc
51 Rd
52 Re
53
54 TiX,TiY,TiZ Tilt on x axis, y axis, z axis
55 TiS Scaling of field of view in the tilt transformation
56
57 TrX,TrY,TrZ Translation on x axis, y axis, z axis
58
59 Tpy,Tpp yaw and pitch of remapping plane for translation
60
61 Te0,Te1,Te2,Te3 Test parameters
62
63 Vm vignetting correction mode (default 0):
64 0: no vignetting correction
65 1: radial vignetting correction (see j,k,l,o options)
66 2: flatfield vignetting correction (see p option)
67 4: proportional correction: i_new = i / corr.
68 This mode is recommended for use with linear data.
69 If the input data is gamma corrected, try adding g2.2
70 to the m line.
71
72 default is additive correction: i_new = i + corr
73
74 Both radial and flatfield correction can be combined with the
75 proportional correction by adding 4.
76 Examples: i1 - radial polynomial correction by addition.
77 The coefficients j,k,l,o must be specified.
78 i5 - radial polynomial correction by division.
79 The coefficients j,k,l,o must be specified.
80 i6 - flatfield correction by division.
81 The flatfield image should be specified with the p option
82
83 Va,Vb,Vc,Vd vignetting correction coefficients. (defaults: 0,0,0,0)
84 ( 0, 2, 4, 6 order polynomial coefficients):
85 corr = ( i + j*r^2 + k*r^4 + l*r^6), where r is the distance from the image center
86 The corrected pixel value is calculated with: i_new = i_old + corr
87 if additive correction is used (default)
88 for proportional correction (h5): i_new = i_old / corr;
89
90 Vx,Vy radial vignetting correction offset in pixels (defaults q0 w0, optional).
91 Used to correct for offset from center of image
92 Vx - horizontal offset
93 Vy - vertical offset
94
95 S100,600,100,800 Selection(l,r,t,b), Only pixels inside the rectangle will be used for conversion.
96 Original image size is used for all image parameters
97 (e.g. field-of-view) refer to the original image.
98 Selection can be outside image dimension.
99 The selection will be circular for circular fisheye images, and
100 rectangular for all other projection formats
101
102 nName file name of the input image.
103
104 i f2 r0 p0 y0 v183 a0 b-0.1 c0 S100,600,100,800 n"photo1.jpg"
105 i f2 r0 p0 y180 v183 a0 b-0.1 c0 S100,600,100,800 n"photo1.jpg"
106
107 Rotate transform the image, angles in degrees:
108
109 $i->Transform ($roll, $pitch, $yaw);
110
111 Each image attribute (v, a, b, c etc...) can be read like so:
112
113 $fov = $i->v;
114
115 Note that this will return either the value (56.7) or a reference to
116 another image (=0). If you supply a Panotools::Script object as a
117 parameter then the reference will be resolved and you will always get
118 the value:
119
120 $fov = $i->v ($pto);
121
122 Get the absolute path to the image file
123
124 $i->Path ('/path/to/project.pto');
125
126 If a .pto project isn't specified then paths are assumed to be relatve
127 to cwd
128
129 For any given coordinate in this image (top left is 0,0), calculate an
130 x,y,z cartesian coordinate, accounting for lens distortion, projection
131 and rotation.
132
133 $coor = $i->To_Cartesian ($pto, [23,45]);
134 ($x, $y, $z) = @{$coor};
135
136 Query distance (radius) to photo in pixels:
137
138 $pix_radius = $i->Radius ($pto);
139
140
141
142perl v5.28.2 2014-03-02 Panotools::Script::Line::Image(3)