<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.15"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>lensfun: Lens calibration data format</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<script type="text/x-mathjax-config">
MathJax.Hub.Config({
extensions: ["tex2jax.js"],
jax: ["input/TeX","output/HTML-CSS"],
});
MathJax.Hub.Config({
messageStyle: "none"
});
</script><script type="text/javascript" async="async" src="http://lensfun.sourceforge.net/mathjax/MathJax.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">lensfun
 <span id="projectnumber">0.3.2.0</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.15 -->
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
$(function() {
initMenu('',false,false,'search.php','Search');
});
/* @license-end */</script>
<div id="main-nav"></div>
</div><!-- top -->
<div class="PageDoc"><div class="header">
<div class="headertitle">
<div class="title">Lens calibration data format </div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>Possible embedded elements: </p><dl>
<dt><distortion focal="number" model="name" k1="number" k2="number" k3="number" a="number" b="number" c="number" /> </dt>
<dd>Declares the image distortion model for this lens. Distortion is specific for every focal length (in mm), so you can declare multiple distortion entries with different focal values; the library will interpolate the parameters for intermediate focal lengths. The model name may be "none", "poly3", "poly5", or "ptlens". <dl class="section see"><dt>See also</dt><dd><a class="el" href="group__Lens.html#gaa505e04666a189274ba66316697e308e" title="The Lensfun library implements several lens distortion models. This enum lists them.">lfDistortionModel</a> </dd></dl>
</dd>
<dt><tca focal="number" model="name" kr="number" kb="number" /> </dt>
<dd>Declares the Transversal Chromatic Aberrations model for this lens, depending on focal length. The library will interpolate the parameters for intermediate focal lengths. The model name may be "none", "linear", or "poly3". <dl class="section see"><dt>See also</dt><dd><a class="el" href="group__Lens.html#ga0b8deda1887fb5543a2038669ed344b4" title="The Lensfun library supports several models for lens lateral chromatic aberrations (also called trans...">lfTCAModel</a> </dd></dl>
</dd>
<dt><vignetting focal="number" aperture="number" distance="number" model="name" k1="number" k2="number" k3="number" /> </dt>
<dd>Declares the vignetting model for this lens at given focal length (in mm), given aperture (as f-number), and given distance to subject in focus (in meters). This kind of calibration requires relatively many sample points since it depends on three variables. The library will interpolate the parameters for between the sample points if necessary. The model name may be "none" or "pa". <dl class="section see"><dt>See also</dt><dd><a class="el" href="group__Lens.html#ga3fd9e8dbe500297bdda2d6458745b481" title="The Lensfun library supports several models for lens vignetting correction.">lfVignettingModel</a> </dd></dl>
</dd>
<dt><crop focal="number" mode="name" left="number" right="number" top="number" bottom="number" /> </dt>
<dd>Declares the image crop for this lens. Crop can be specific for every focal length (in mm), so you can declare multiple crop entries with different focal values; the library will interpolate the parameters for intermediate focal lengths. The mode name may be "no_crop", "crop_rectangle", or "crop_circle". <dl class="section see"><dt>See also</dt><dd><a class="el" href="group__Lens.html#ga7cf279be3d271de4d5af11d278dc9873" title="Different crop modes.">lfCropMode</a> </dd></dl>
</dd>
<dt><real-focal-length focal="number" real-focal="number" /> </dt>
<dd><p class="startdd">Declares the <em>real</em> focal length of the lens in the <a href="http://en.wikipedia.org/wiki/Paraxial_approximation">paraxial approximation</a>, in contrast to the <em>nominal</em> focal length used in all "focal" attributes. Especially for fisheye lenses, both values can differ significantly. Lensfun itself needs the real focal length for lens type transformations. It uses the nominal focal length as a fallback.</p>
<p class="enddd">The real focal length can be determined reliably only with a 360° panorama, e.g. with Hugin. However, Hugin's results <a href="https://bugs.launchpad.net/hugin/+bug/1307457">need to be rectified</a>. The real focal length must correspond to the distortion coefficients. Typically, they are the result of the very same parameter optimisation. </p>
</dd>
</dl>
</div></div><!-- PageDoc -->
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Thu Oct 3 2019 15:07:50 for lensfun by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.15
</small></address>
</body>
</html>
distrib
>
Mageia
>
7
>
i586
>
media
>
core-updates
>
by-pkgid
>
9b2eec216777f0c505d4f747f9ee0e8f
>
files
>
33
