1
2
3=head1 NAME
4
5fulla - Correct lens distortion, vignetting and chromatic aberration
6
7=head1 SYNOPSIS
8
9B<fulla> [options] I<inputfile(s)>
10
11
12=head1 DESCRIPTION
13
14Apply radial or flat-field vignetting correction as well as geometrical radial
15distortion and transversal chromatic aberration correction.
16
17fulla can be used to batch correct a large number of files. Radial distortion coefficients can be read from a lens database.
18
19Vignetting correction is done the same way as described in the nona script file documentation, or from lens database.
20Vignetting correction can be done based on a flat-field or a radial scaling.
21
22Vignetting correction by flat-field division:
23                        I = I / c,    c = flat-field / mean(flat-field)
24
25Radial vignetting correction:
26                        I = I / c,    c = a + b*r^2 + c*r^4 + d*r^6
27
28
29The radial distortion correction is identical to the one implemented by PanoTools:
30
31r_new = a*r^4 + b*r^3 + c*r^2 + d*r   [1]
32
33Since transversal chromatic aberrations (TCA) leads to differently scaled objects in the
34red, green and blue channel, it can be corrected by scaling the red and blue channel
35so that they match the green channel. Most applications, like Photoshop or Picture Window Pro
36offer TCA correction by linear scaling. This is equal to varying the d parameter in equation [1].
37
38See http://hugin.sf.net/tutorials/tca for a method to determine these parameters.
39
40
41=head1 OPTIONS
42
43=over
44
45=item B<--green=db|a:b:c:d>
46
47Correct radial distortion coefficient for all channels, (a, b, c, d)
48Specify 'db' for database lookup or the 4 coefficients a:b:c:d
49
50=item B<--blue=db|a:b:c:d>
51
52Correct radial distortion coefficients for blue channel, (a, b, c, d). This is
53applied on top of the B<--green> distortion coefficients, use for TCA corr
54Specify 'db' for database lookup or the 4 coefficients a:b:c:d
55
56=item B<--red=db|a:b:c:d>
57
58Correct radial distortion coefficients for red channel, (a, b, c, d). This is
59applied on top of the B<--green> distortion coefficients, use for TCA corr
60Specify 'db' for database lookup or the 4 coefficients a:b:c:d
61
62
63=item B<--camera-maker=Maker>
64
65Camera manufacturer, for database query
66
67=item B<--camera-model=Cam>
68
69Camera name, for database query
70
71=item B<--lensname=Lens>
72
73Lens name, for database query
74
75=over
76
77Specify --camera-maker and --camera-model for fixed lens cameras or --lensname for interchangeable lenses.
78
79=back
80
81=item B<--focallength=50>
82
83Specify focal length in mm, for database query
84
85=item B<--aperature=3.5>
86
87Specify aperture for vignetting data database query
88
89=item B<--dont-rescale>
90
91Do not rescale the image to avoid black borders.
92
93=item B<--flatfield=filename>
94
95Vignetting correction by flatfield division
96I = I / c, c = flatfield / mean(flatfield)
97
98=item B<--vignetting=db|a:b:c:d>
99
100Correct vignetting (by division)
101Specify db for database look up or the the 4 coefficients a:b:c:d
102I = I / ( a + b*r^2 + c*r^4 + d*r^6)
103
104=item B<--linear>
105
106Do vignetting correction in linear color space
107
108=item B<--gamma=value>
109
110Gamma of input data.
111Used for gamma correction before and after flatfield correction
112
113=item B<threads=n>
114
115Number of threads that should be used
116
117=item B<-h|--help>
118
119Display help
120
121=item B<--output=name>
122
123Set output filename. If more than one image is given, the name will be used as suffix.
124(default suffix: _corr)
125
126=item B<--compression=value>
127
128Compression of the output files.
129For jpeg output: 0-100
130For tiff output: PACKBITS, DEFLATE, LZW
131
132=item B<--offset=X:Y>
133
134Horizontal and vertical shift
135
136=item B<--verbose>
137
138Verbose
139
140=back
141
142
143=head1 AUTHORS
144
145Written by Pablo d'Angelo. Also contains contributions from Douglas Wilkins, Ippei Ukai, Ed Halley, Bruno Postle, Gerry Patterson, Brent Townshend and Thomas Modes.
146
147