[832b36]: src / hugin1 / hugin / xrc / data / help_en_EN / Fulla.html Maximize Restore History

Download this file

Fulla.html    140 lines (114 with data), 9.6 kB

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="generator" content="MediaWiki 1.14.0" />
<meta name="keywords" content="Fulla,Barrel distortion,Chromatic aberration,HDR,Hugin,Lens correction model,Nona,PTLens,Panorama Tools,Pincushion distortion,TIFF" />
<title>Fulla - PanoTools.org Wiki</title>
<!--[if lt IE 5.5000]><![endif]-->
<!--[if IE 5.5000]><![endif]-->
<!--[if IE 6]><![endif]-->
<!--[if IE 7]><![endif]-->
<!--[if lt IE 7]>
<meta http-equiv="imagetoolbar" content="no" /><![endif]-->
<style media="screen" type="text/css" title="Screen style sheet"> @import url(manual.css); </style>
</head>
<body class="mediawiki ltr ns-0 ns-subject page-Fulla skin-monobook">
<div id="globalWrapper">
<div id="column-content">
<div id="content">
<a name="top" id="top"></a>
<h1 id="firstHeading" class="firstHeading">Fulla</h1>
<div id="bodyContent">
<!-- start content -->
<p><b>fulla</b> is a command-line tool distributed with <a href="Hugin.html" title="Hugin">hugin</a> 0.6 and later. It can correct chromatic aberration, lens distortion, and vignetting.
</p>
<a name="About_fulla" id="About_fulla"></a><h2> <span class="mw-headline"> About fulla </span></h2>
<p>fulla is suitable for batch correction of:
</p>
<dl><dt><a href="Chromatic_aberration.html" title="Chromatic aberration">Chromatic aberration</a></dt><dd> See tutorial in <a href="Fulla.html#External_links" title="">external links</a>.
</dd><dt><a href="Lens_correction_model.html" title="Lens correction model">Lens distortion</a></dt><dd> <a href="Barrel_distortion.html" title="Barrel distortion">Barrel</a> or <a href="Pincushion_distortion.html" title="Pincushion distortion">pincushion distortion</a> can be corrected using the same a, b, c and d parameters as other Panorama Tools<a class="external" href="http://wiki.panotools.org/Panorama_Tools">[*]</a> derived programs.
</dd><dt><a href="Vignetting.html" title="Vignetting">Vignetting</a></dt><dd> Polynomial correction by division, addition or flatfield images. <a href="Hugin.html" title="Hugin">hugin</a> contains a vignetting calculator that can use a series of overlapping photographs to determine the likely polynomial required to correct common vignetting problems.
</dd></dl>
<p>fulla can work with the same range of image types as <a href="Nona.html" title="Nona">nona</a>, including 8bit and 16bit <a href="TIFF.html" title="TIFF">TIFF</a> and 32bit floating-point <a href="HDR.html" title="HDR">HDR</a> TIFF data.
</p>
<a name="Command-line_usage" id="Command-line_usage"></a><h2> <span class="mw-headline"> Command-line usage </span></h2>
<pre> Usage: fulla [options] inputfile(s)
option are:
-g a:b:c:d Radial distortion coefficient for all channels, (a, b, c, d)
-b a:b:c:d Radial distortion coefficients for blue channel, (a, b, c, d)
this is applied on top of the -g distortion coefficients,
use for TCA corr
-r a:b:c:d Radial distortion coefficients for red channel, (a, b, c, d)
this is applied on top of the -g distortion coefficients,
use for TCA corr
-p Try to read radial distortion coefficients for green
channel from PTLens database
-m Canon Camera manufacturer, for PTLens database query
-n Camera Camera name, for PTLens database query
-l Lens Lens name, for PTLens database query
if not specified, a list of possible lenses is displayed
-d 50 specify focal length in mm, for PTLens database query
-s do not rescale the image to avoid black borders.
-f filename Vignetting correction by flatfield division
I = I / c, c = flatfield / mean(flatfield)
-c a:b:c:d radial vignetting correction by division:
I = I / c, c = a + b*r^2 + c*r^4 + d*r^6
-a Correct vignetting by addition, rather than by division
I = I + c
-i value gamma of input data. used for gamma correction
before and after flatfield correction
-t n Number of threads that should be used during processing
-h Display help (this text)
-o name set output filename. If more than one image is given,
the name will be uses as suffix (default suffix: _corr)
-v Verbose
</pre>
<a name="Status" id="Status"></a><h2> <span class="mw-headline"> Status </span></h2>
<p>As of Hugin 2010.0.0, vignetting correction seems to be broken<a class="external" href="http://sourceforge.net/tracker/?func=detail&amp;aid=3057742&amp;group_id=77506&amp;atid=550441">[*]</a>. Resizing during correction is not available<a class="external" href="http://sourceforge.net/tracker/?func=detail&amp;aid=3057758&amp;group_id=77506&amp;atid=550444">[*]</a> - 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<a class="external" href="http://lensfun.berlios.de/">[*]</a>-based program (e.g., UFRaw<a class="external" href="http://ufraw.sourceforge.net/">[*]</a> or digiKam<a class="external" href="http://www.digikam.org/drupal/node/319">[*]</a>) these days. Lensfun also comes with a more up to date lens correction parameters database.
</p>
<a name="Notes" id="Notes"></a><h2> <span class="mw-headline"> Notes </span></h2>
<p>Finding the correct lens correction parameters can be done using several approaches (see <a href="Lens_correction_model.html" title="Lens correction model">Lens correction model</a> 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.
</p>
<a name="Windows_batch_usage" id="Windows_batch_usage"></a><h2> <span class="mw-headline"> Windows batch usage </span></h2>
<p>Once you have calculated fulla parameters as described above, you can create a custom <i>droplet</i>
for batch correcting photos like so:
</p>
<ul><li> Create a <i>Shortcut to fulla.exe</i> by dragging the <i>fulla</i> icon to another directory in Windows explorer
</li><li> Edit <i>properties</i>
</li><li> Change the <i>target</i> to include your correction parameters:
</li></ul>
<pre> "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
</pre>
<ul><li> Rename the shortcut to something descriptive like <i>fulla-peleng</i>
</li><li> Now you can correct photos by dragging and dropping them onto the icon
</li></ul>
<p>Expanding on the above example is to create a batchfile in the hugin directory called "fulla.bat" containing the line:
</p>
<pre>FOR&nbsp;%%I IN (%1) DO C:\Program Files\hugin\fulla.exe -p -v -l Standard&nbsp;%%1
</pre>
<p>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)
</p>
<a name="PTLens_database_lookup" id="PTLens_database_lookup"></a><h2> <span class="mw-headline"> PTLens database lookup </span></h2>
<p>fulla will look-up your camera in a PTLens<a class="external" href="http://wiki.panotools.org/PTLens">[*]</a> database and try to automatically determine <a href="Lens_correction_model.html" title="Lens correction model">Lens correction parameters</a> for your pictures. An older free version of the database is required which can be downloaded from sourceforge (see <a href="Fulla.html#External_links" title="">external links</a>).
</p><p>Use the PTLENS_PROFILE environment variable to specify the location of the PTLens database, for example on Linux or OS X:
</p>
<pre> PTLENS_PROFILE=$HOME/.ptlens/profile.txt
</pre>
<p>On Windows something like this should work for a PTLens standard install:
</p>
<pre> set PTLENS_PROFILE=%ProgramFiles%\PTLens\profile.txt
</pre>
<p>otherwise enter the full path.
</p>
<a name="External_links" id="External_links"></a><h2> <span class="mw-headline"> External links </span></h2>
<ul><li> Correcting TCA with hugin and fulla<a class="external" href="http://hugin.sourceforge.net/tutorials/tca/en.shtml">[*]</a>
</li><li> PTLens database download<a class="external" href="http://sourceforge.net/project/showfiles.php?group_id=77506&amp;package_id=187932">[*]</a> (April 2006)
<ul><li> Lensfun<a class="external" href="http://lensfun.berlios.de/">[*]</a> SVN<a class="external" href="http://svn.berlios.de/wsvn/lensfun/trunk/data/db/">[*]</a> includes parameters for many more lenses
</li></ul>
</li><li> How to determine lens correction parameters<a class="external" href="http://lensfun.berlios.de/lens-calibration/lens-calibration.html">[*]</a> - from Lensfun documentation
</li></ul>
<div class="printfooter">
Retrieved from "<a href="Fulla.html">http://wiki.panotools.org/Fulla</a>"</div>
</div></div></div></div></body></html>