1Panotools::Script::LineU:s:eIrmaCgoen(t3r)ibuted Perl DoPcaunmoetnotoaltsi:o:nScript::Line::Image(3)
2
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 w1000
15 h500 nona requires the width and height of input images wheras PTStitcher/mender don't
16 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 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 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 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 TiX,TiY,TiZ Tilt on x axis, y axis, z axis
55 TiS Scaling of field of view in the tilt transformation
56 TrX,TrY,TrZ Translation on x axis, y axis, z axis
58 Tpy,Tpp yaw and pitch of remapping plane for translation
60 Te0,Te1,Te2,Te3 Test parameters
62 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 default is additive correction: i_new = i + corr
73 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 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 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 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 nName file name of the input image.
103 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 Rotate transform the image, angles in degrees:
108 $i->Transform ($roll, $pitch, $yaw);
110 Each image attribute (v, a, b, c etc...) can be read like so:
112 $fov = $i->v;
114 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 $fov = $i->v ($pto);
121 Get the absolute path to the image file
123 $i->Path ('/path/to/project.pto');
125 If a .pto project isn't specified then paths are assumed to be relatve
127 to cwd
128 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 $coor = $i->To_Cartesian ($pto, [23,45]);
134 ($x, $y, $z) = @{$coor};
135 Query distance (radius) to photo in pixels:
137 $pix_radius = $i->Radius ($pto);
139perl v5.36.0 2023-01-20 Panotools::Script::Line::Image(3)