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
As of Hugin 2010.0.0, vignetting correction seems to be broken. Resizing during correction is not available - this may cause important image parts to get cropped. Few changes have been committed to fulla since the beginning of 2008. If you want to correct individual images, best use a lensfun-based program (e.g., UFRaw or digiKam) these days. Lensfun also comes with a more up to date lens correction parameters database.
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)
PTLens database lookup
fulla will look-up your camera in a PTLens database and try to automatically determine Lens correction parameters for your pictures. An older free version of the database is required which can be downloaded from sourceforge (see external links).
Use the PTLENS_PROFILE environment variable to specify the location of the PTLens database, for example on Linux or OS X:
On Windows something like this should work for a PTLens standard install:
otherwise enter the full path.