enum lfDistortionModel |
The lensdb library implements several lens distortion models.
This enum lists them. Distortion usually heavily depends on the focal distance, but does not depend on the aperture.
For a popular explanation of lens distortion see http://www.vanwalree.com/optics/distortion.html
LF_DIST_MODEL_NONE | Distortion parameters are unknown. |
LF_DIST_MODEL_POLY3 | 3rd order polynomial model: Ru = Rd * (1 + k1 * Rd^2) Ref: http://www.imatest.com/docs/distortion.html |
LF_DIST_MODEL_POLY5 | 5th order polynomial model: Ru = Rd * (1 + k1 * Rd^2 + k2 * Rd^4) |
LF_DIST_MODEL_FOV1 | Field-of-view lens model: Ru = tg (Rd * omega) / (2 * tg (omega/2)) Ref: ftp://ftp-sop.inria.fr/chir/publis/devernay-faugeras:01.pdf. |
LF_DIST_MODEL_PTLENS | PTLens rectilinear: Ru = Rd * (a * Rd^3 + b * Rd^2 + c * Rd + 1). |
enum lfLensType |
Lens type.
LF_UNKNOWN | Unknown lens type. |
LF_RECTILINEAR | A rectilinear lens - 99% of all lenses are of this type. |
LF_FISHEYE | Fisheye lens Ref: http://wiki.panotools.org/Fisheye_Projection. |
LF_PANORAMIC | Panoramic (cylindrical). |
LF_EQUIRECTANGULAR | Equirectangular (not that there are such lenses, but useful to convert images TO this type, especially fish-eye images. |
enum lfTCAModel |
The lensdb library supports several models for lens lateral chromatic aberrations (also called transversal chromatic aberrations, TCA).
TCAs depend on focal distance, but does not depend of the aperture.
For a popular explanation of chromatic aberrations see http://www.vanwalree.com/optics/chromatic.html
LF_TCA_MODEL_NONE | No TCA correction data is known. |
LF_TCA_MODEL_LINEAR | Linear lateral chromatic aberrations model: Rd(R) = Ru(R) * k1, Rd(B) = Ru(B) * k2 Ref: http://cipa.icomos.org/fileadmin/papers/Torino2005/403.pdf. |
enum lfVignettingModel |
The lensdb library supports several models for lens vignetting correction.
We focus on optical and natural vignetting since they can be generalized for all lenses of a certain type; mechanical vignetting is out of the scope of this library.
Vignetting is dependent on both focal distance and aperture.
For a popular explanation of vignetting see http://www.vanwalree.com/optics/vignetting.html
LF_VIGNETTING_MODEL_NONE | No vignetting correction data is known. |
LF_VIGNETTING_MODEL_PA | Pablo D'Angelo vignetting model (which is a more general variant of the cos^4 law): c = 1 + k1 * R^2 + k2 * R^4 + k3 * R^6 Ref: http://hugin.sourceforge.net/tech/. |
void lf_lens_destroy | ( | lfLens * | lens | ) |
Destroy a lfLens object.
This is equivalent to C++ "delete lens".
lens | The lens object to destroy. |
lfLens* lf_lens_new | ( | ) |