1FULLA(1)                          User Manual                         FULLA(1)
2
3
4

NAME

6       fulla  - Perform vignetting, radial distortion and chromatic abberation
7       correction
8

SYNOPSIS

10       fulla [options] input files
11

DESCRIPTION

13       Apply radial or flatfield vignetting correction as well as  geometrical
14       radial distortion and transversal chromatic abberation correction.
15
16       fulla can be used to batch correct a large number of files. Radial dis‐
17       tortion coefficients can be read from a PTLens database (only  database
18       version 4.2 is supported).
19
20       Vignetting  correction  is  done  the same way as described in the nona
21       script file documentation.  Vignetting correction can be done based  on
22       a flatfield or a radial scaling.
23
24       Vignetting correction by flatfield division:
25                               I = I / c,    c = flatfield / mean(flatfield)
26
27       Radial vignetting correction:
28                               I = I / c,    c = a + b*r^2 + c*r^4 + d*r^6
29
30       Correct vignetting by addition, rather than by division:
31                               I = I + c
32
33
34
35       The radial correction is identical to the one implemented by panotools:
36
37       r_new = a*r^4 + b*r^3 + c*r^2 + d*r   [1]
38
39       Since  transversal  chromatic  aberations  (TCA)  leads  to differently
40       scaled objects in the red, green and blue channel, it can be  corrected
41       by  scaling the red and blue channel so that they match the green chan‐
42       nel. Most applications, like Photoshop or Picture Window Pro offer  TCA
43       correction  by linear scaling. This is equal to varying the d parameter
44       in equation [1].
45
46       See http://hugin.sf.net/tutorials/tca for a method to  determine  these
47       parameters.
48
49

OPTIONS

51       -o output filename
52              Specify  the  output  filename.  If more than one input image is
53              given, this string will be used as suffix (default: _corr)
54
55       -g a:b:c:d
56              Radial distortion coefficient for all channels, (a,  b,  c,  d).
57              By default no correction is done.
58
59       -b a:b:c:d
60              Radial  distortion  coefficents  for blue channel, (a, b, c, d).
61              this is applied after the global distortion  correction(supplied
62              by -g).
63
64       -r a:b:c:d
65              Radial  distortion  coefficents  for  red channel, (a, b, c, d).
66              this is applied after the global distortion  correction(supplied
67              by -g).
68
69       -f filename
70              Filename  of  the flatfield image. Enables vignetting correction
71              by flatfield division
72
73       -c a:b:c:d
74              radial vignetting correction by division:
75
76       -a     Correct vignetting by addition, rather than by division I = I  +
77              c
78
79       -p     Try  to  read  radial  distortion coefficients (usually supplied
80              using -g) from the PTLens  database.  The  environment  variable
81              PTLENS_PROFILE should point to the profile.txt file. Since newer
82              version of the PTLens  database  are  incompatible  with  fulla,
83              download  the PTLens database from the hugin sourceforge website
84              instead: http://www.sf.net/projects/hugin
85
86       -m Manufacturer
87              Camera manufacturer, for PTLens database query. EXIF data inside
88              jpg files is read, if this option is not given
89
90       -n CameraName
91              Camera  name,  for  PTLens  database query. EXIF data inside jpg
92              files is read, if this option is not given.
93
94       -l LensName
95              Lens name, for PTLens database query. If not specified,  a  list
96              of possible lenses is displayed
97
98       -t n   Number of threads that should be used during processing
99
100       -v     Verbose execution
101
102       -h     Display help text
103
104

BUGS

106       No  bugs known, if you find any, please send a bug report to me. I will
107       try to fix it.
108

AUTHOR

110       Pablo d Angelo <pablo dot dangelo at web dot de>
111

SEE ALSO

113       nona(1),hugin(1),clens(1)
114
115
116
117hugin                              MAY 2006                           FULLA(1)
Impressum