FULLA("1")

💅 FULLA("1") — the HUGIN one, bestie

okay so real talk, this is the manual page for fulla, and it ships with HUGIN (yes, that Hugin). Strap in, because this little icon fixes your lenses and it does NOT miss. 🎀

---

✨ NAME ✨

fulla — correct lens distortion, vignetting and chromatic aberration. that's the whole vibe. it takes your wonky pictures and makes them behave. 🦋

---

✨ SYNOPSIS ✨

fulla [options] inputfile(s)

---

🌸 DESCRIPTION 🌸

so basically fulla applies radial or flat-field vignetting correction plus geometrical radial distortion and transversal chromatic aberration correction. three jobs, one main character. 👑

like, fulla can be used to batch correct a large number of files. not me running it on 400 photos at 2am 🙈. and the radial distortion coefficients? they can be read straight from a lens database. it's giving convenience, it's giving slay.

Vignetting correction is done the same way as described in the nona script file documentation, or from lens database. and it can be done based on a flat-field or a radial scaling. both valid, both iconic. ✨

Vignetting correction by flat-field division:

I = I / c,    c = flat-field / mean(flat-field)

Radial vignetting correction:

I = I / c,    c = a + b*r^2 + c*r^4 + d*r^6

The radial distortion correction is identical to the one implemented by PanoTools:

r_new = a*r^4 + b*r^3 + c*r^2 + d*r   [1]

lowkey a little math moment, but stay with me. 🧮

Since transversal chromatic aberrations (TCA) leads to differently scaled objects in the red, green and blue channel, it can be corrected by scaling the red and blue channel so that they match the green channel. green is the main character here, red and blue are just matching her energy. 💚

Most applications, like Photoshop or Picture Window Pro, offer TCA correction by linear scaling. This is equal to varying the d parameter in equation [1]. so yeah, same thing, different app.

See http://hugin.sf.net/tutorials/tca for a method to determine these parameters. (that link is literally in the original, no cap — go read it 🫶)

---

🎀 OPTIONS 🎀

• --green=db|a:b:c:d — Correct radial distortion coefficient for all channels, (a, b, c, d). Specify 'db' for database lookup or the 4 coefficients a:b:c:d. the green channel is the boss of the trio, so this one does all three. 👑
• --blue=db|a:b:c:d — Correct radial distortion coefficients for blue channel, (a, b, c, d). This is applied on top of the --green distortion coefficients, use for TCA corr. Specify 'db' for database lookup or the 4 coefficients a:b:c:d. 💙
• --red=db|a:b:c:d — Correct radial distortion coefficients for red channel, (a, b, c, d). This is applied on top of the --green distortion coefficients, use for TCA corr. Specify '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. iykyk — pick the right combo, bestie, the database is literally right there. 💅

• --focallength=50 — Specify focal length in mm, for database query. 📏
• --aperature=3.5 — Specify aperture for vignetting data database query. (yes, it's spelled --aperature in the original — that's not a typo on my end, that's canon, don't @ me 💀)
• --dont-rescale — Do not rescale the image to avoid black borders. so like, if you want the black borders, this is your moment. 🖤
• --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 ). yes okay the dark corners are getting fixed. ✨
• --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. (no leading dashes in the original, so no leading dashes here — we do not "fix" things 🫶) 🧵
• -h, --help — Display help. the classic. 💖
• --output=name — Set output filename. If more than one image is given, the name will be used 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. nudge nudge. 🦋
• --verbose — Verbose. she talks more. we love her for it. 💬

---

👑 AUTHORS 👑

Written by Pablo d'Angelo. Also contains contributions from Douglas Wilkins, Ippei Ukai, Ed Halley, Bruno Postle, Gerry Patterson, Brent Townshend and Thomas Modes. a whole group chat of legends, fr fr. 🫶

---

genuine reminder bestie: the equations and coefficients are real, and --dont-rescale really does keep those black borders. no invented lore allowed. 🧚

and that's the whole page! 💜

okay last thing — this is Version: 2025.0.1, dated 2026-09-22. or as I like to call it, the FULLA("1") era. slay, bye! ✨🌸🎀