fulla is a command-line tool distributed with hugin 0.6 and later. It can correct chromatic aberration, lens distortion, and vignetting.
fulla is suitable for batch correction of:
- Chromatic aberration
- See tutorial in external links.
- Lens distortion
- Barrel or pincushion distortion can be corrected using the same a, b, c and d parameters as other Panorama Tools derived programs.
- Polynomial correction by division, addition or flatfield images. hugin contains a vignetting calculator that can use a series of overlapping photographs to determine the likely polynomial required to correct common vignetting problems.
Usage: fulla [options] inputfile(s) option are: --green=db|a:b:c:d Correct radial distortion for all channels Specifiy 'db' for database lookup or the 4 coefficients a:b:c:d --blue=db|a:b:c:d Correct radial distortion for blue channel, this is applied on top of the --green distortion coefficients, use for TCA corr Specifiy 'db' for database lookup or the 4 coefficients a:b:c:d --red=db|a:b:c:d Correct radial distortion for red channel, this is applied on top of the --green distortion coefficients, use for TCA corr Specifiy 'db' for database lookup or the 4 coefficients a:b:c:d --camera-maker=Maker Camera manufacturer, for database query --camera-model=Cam Camera name, for database query --lensname=Lens Lens name, for database query Specify --camera-maker and --camera-model for fixed lens cameras or --lensname for interchangeable lenses. --focallength=50 Specify focal length in mm, for database query --aperture=3.5 Specify aperture for vignetting data database query --dont-rescale Do not rescale the image to avoid black borders. --flatfield=filename Vignetting correction by flatfield division I = I / c, c = flatfield / mean(flatfield) --vignetting=db|a:b:c:d Correct vignetting (by division) Specify db for database look up or the the 4 coefficients a:b:c:d I = I / ( a + b*r^2 + c*r^4 + d*r^6) --linear Do vignetting correction in linear color space --gamma=value Gamma of input data. used for gamma correction before and after flatfield correction --threads=n Number of threads that should be used --help Display help (this text) --output=name Set output filename. If more than one image is given, the name will be uses as suffix (default suffix: _corr) --compression=value Compression of the output files For jpeg output: 0-100 For tiff output: PACKBITS, DEFLATE, LZW --offset=X:Y Horizontal and vertical shift --verbose Verbose
Finding the correct lens correction parameters can be done using several approaches (see Lens correction model and external links for details). Note parameter d for radial distortion (default 1.0) is not available in GUI frontends - the d mentioned in frontends is typically a different parameter related to image shift.
Windows batch usage
Once you have calculated fulla parameters as described above, you can create a custom droplet for batch correcting photos like so:
- Create a Shortcut to fulla.exe by dragging the fulla icon to another directory in Windows explorer
- Edit properties
- Change the target to include your correction parameters:
"C:\Program Files\hugin\fulla.exe" -r 0:0:0.00056:1.00015 -b 0:0:-0.00026:1.0011 -c 1:0.20:-0.51:0.2
- Rename the shortcut to something descriptive like fulla-peleng
- Now you can correct photos by dragging and dropping them onto the icon
Expanding on the above example is to create a batchfile in the hugin directory called "fulla.bat" containing the line:
FOR %%I IN (%1) DO C:\Program Files\hugin\fulla.exe -p -v -l Standard %%1
Assuming the name of the lens in the PTLens Database (see below) is "Standard" (as most are). Now, upon calling from any directory containing pics you can run "C:\Program Files\hugin\fulla.bat *.jpg" having fulla correcting all pics using the parameters retrieved from the PTLens Database mentioned below (don't forget to SET PTLENS_PROFILE)