Learn how easy it is to sync an existing GitHub or Google Code repo to a SourceForge project! See Demo

Close

[d8e66f]: src / hugin1 / hugin / xrc / data / help_en_EN / Hugin_FAQ.html Maximize Restore History

Download this file

Hugin_FAQ.html    362 lines (337 with data), 40.0 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
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
<!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="Hugin FAQ,Autopano-sift-C Compiling OSX,Colour profile,Control points,Enblend,Enblend Compiling OSX,Equirectangular Projection,Gimp,Heads,Hugin,Hugin Compiling Fedora" />
<title>Hugin FAQ - 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]-->
<!-- Head Scripts -->
</head>
<body class="mediawiki ltr ns-0 ns-subject page-Hugin_FAQ skin-monobook">
<div id="globalWrapper">
<div id="column-content">
<div id="content">
<a name="top" id="top"></a>
<h1 id="firstHeading" class="firstHeading">Hugin FAQ</h1>
<div id="bodyContent">
<div id="contentSub"></div>
<!-- start content -->
<a name="Common_error_messages" id="Common_error_messages"></a><h2> <span class="mw-headline"> Common error messages </span></h2>
<a name="enblend:_no_input_files_specified" id="enblend:_no_input_files_specified"></a><h3> <span class="mw-headline"> enblend: no input files specified </span></h3>
<p>There are no input images relevant to the output 'panorama' so hugin had nothing to do, probably because all the input images are outside the panorama 'frame' or disabled. Open the <a href="Hugin_Preview_window.html" title="Hugin Preview window">Hugin Preview window</a> or <a href="Hugin_Fast_Preview_window.html" title="Hugin Fast Preview window">Hugin Fast Preview window</a> to adjust the view, enable some images inside the panorama frame and/or adjust the crop.
</p><p>Note also that hugin versions up to and including 2009.2.0 allow you to draw an inverted crop frame where the top is below the bottom, this is easy to see in the Preview window as the entire panorama is 'greyed'. A crop frame drawn like this will result in an empty panorama and the above error message.
</p>
<a name="enblend:_excessive_overlap_detected" id="enblend:_excessive_overlap_detected"></a><h3> <span class="mw-headline"> enblend: excessive overlap detected </span></h3>
<p>This is an error new to enblend-4.0. Photos that nearly entirely overlap won't blend very well, enblend now fails instead of attempting to blend them. There are various workarounds:
</p>
<ul><li> Follow the error message and remove the suggested image from the set, you probably don't need it to complete the panorama.
</li><li> Switch back to enblend-3.2.
</li><li> Hugin will merge stacked images before blending if you select 'Exposure fusion' in the <a href="Hugin_Stitcher_tab.html" title="Hugin Stitcher tab">Hugin Stitcher tab</a>. This error will go away, but Hugin will take a very different approach to variable exposure between photos.
</li></ul>
<a name="enblend:_error_writing_to_image_swap_file" id="enblend:_error_writing_to_image_swap_file"></a><h3> <span class="mw-headline"> enblend: error writing to image swap file </span></h3>
<p><a href="Enblend.html" title="Enblend">enblend</a> needs a lot of memory and uses its own swap routine to store picture data on the disk, this message indicates that you have run out of disk space. The data is stored in the system temp folder which is specified by TMP, TEMP or TMPDIR environment variables, note that this temp folder may be on a different physical disk to your photos and panorama output.
</p>
<a name="execvp.28make_....29_failed_with_error_2" id="execvp.28make_....29_failed_with_error_2"></a><h3> <span class="mw-headline"> execvp(make ...) failed with error 2 </span></h3>
<p>Hugin requires the 'make' utility to stitch, you need to install it and/or report the problem to whoever supplied Hugin to you.
</p>
<a name="false_--compression_NONE" id="false_--compression_NONE"></a><h3> <span class="mw-headline"> false --compression NONE </span></h3>
<p>This error is caused by a bug in the 0.7.0 release that is fixed in 0.8.0. The problem is that your preferences are messed-up, the workaround for 0.7.0 is to go to File -&gt; Preferences -&gt; Enblend and click Load Defaults -&gt; Yes -&gt; Ok
</p>
<a name="Enblend_error:_Mask_is_entirely_black.2C_but_white_image_was_not_identified_as_redundant" id="Enblend_error:_Mask_is_entirely_black.2C_but_white_image_was_not_identified_as_redundant"></a><h3> <span class="mw-headline"> Enblend error: Mask is entirely black, but white image was not identified as redundant </span></h3>
<p>This is a well known "error" for <a href="Enblend.html" title="Enblend">enblend</a>. Try to use the additional enblend parameter "--fine-mask" to get rid of the error. The parameter will result in generation of masks in higher resolution that will fix the problem in most cases. Sometimes the "--fine-mask" parameter may result in memory errors (malloc: ...), which are the result of not enough memory available due to the (much) bigger masks that are used.
</p><p>An alternative workaround would be to set the enblend --no-optimize parameter, this will place the seam directly along the middle of the image overlaps regardless of image content. This option is also considerably faster and uses less memory.
</p><p>This error also occurs when one photo is completely covered by another, try removing redundant photos.
</p><p>Note also that for the same reasons this error often appears when rendering a scene with extreme distortion such as a stereographic 'little planet'. For this and other reasons, such as overall speed, it is always preferable to render a 'normal' 360�� <a href="Equirectangular_Projection.html" title="Equirectangular Projection">Equirectangular Projection</a> panorama first, then load this as a single source image into a new project and render whatever views you need.
</p><p>Note (Jan 2010): This should be fixed in the latest <a href="Enblend.html" title="Enblend">enblend</a> 4.0 release.
</p>
<a name="enblend:_illegal_option_--_compression" id="enblend:_illegal_option_--_compression"></a><h3> <span class="mw-headline"> enblend: illegal option -- compression </span></h3>
<p>hugin 0.7.0 and later versions require at least <a href="Enblend.html" title="Enblend">enblend</a> version 3.2. This error indicates that you need to upgrade enblend.
</p>
<a name="enblend:_Error_-1073741795" id="enblend:_Error_-1073741795"></a><h3> <span class="mw-headline"> enblend: Error -1073741795 </span></h3>
<p>See <a href="Hugin_FAQ.html#Enblend:_The_system_cannot_execute_the_specified_command" title="">#Enblend: The system cannot execute the specified command</a>, in particular if you are a Windows user try switching to the 'nosse' enblend-enfuse.
</p>
<a name="Makefile:_target_pattern_contains_no_.25" id="Makefile:_target_pattern_contains_no_.25"></a><h3> <span class="mw-headline"> Makefile: target pattern contains no&nbsp;% </span></h3>
<p>This is a message generated by w:Make_(software) (which <a href="Hugin.html" title="Hugin">Hugin</a> uses to manage the stitching sequence). The error is caused by a <b>:</b> or <b>#</b> character in one of the file paths. The workaround is to rename to remove any 'special' shell characters and try again.
</p>
<a name="gnumake:_.2A.2A.2A_No_rule_to_make_target" id="gnumake:_.2A.2A.2A_No_rule_to_make_target"></a><h3> <span class="mw-headline"> gnumake: *** No rule to make target </span></h3>
<p>This is a message generated by w:Make_(software) (which <a href="Hugin.html" title="Hugin">Hugin</a> uses to manage the stitching sequence). The error is caused by a <b>:</b> or <b>#</b> character in one of the file paths. The workaround is to rename to remove any 'special' shell characters and try again.
</p>
<a name="nona:_GL_error:_Framebuffer_incomplete.2C_incomplete_attachment_in:" id="nona:_GL_error:_Framebuffer_incomplete.2C_incomplete_attachment_in:"></a><h3> <span class="mw-headline"> nona: GL error: Framebuffer incomplete, incomplete attachment in: </span></h3>
<p>This is a message generated by nona when using the GPU for stitching (feature available starting with Hugin-2009.2.0). See section below about <a href="Hugin_FAQ.html#GPU-stitching_.28nona.29" title="">GPU-stitching</a>.
</p>
<a name="make:_enfuse:_command_not_found" id="make:_enfuse:_command_not_found"></a><h3> <span class="mw-headline"> make: enfuse: command not found </span></h3>
<p>This is a message generated by make when assembling your panorama. It most likely means that enfuse is not on your computer. Enfuse is part of the enblend package, but many Linux distributions, even recent ones, ship with an older version of enblend that does not contain enfuse. You need to install enblend-3.2 or later.
</p>
<a name="Enblend:_The_system_cannot_execute_the_specified_command" id="Enblend:_The_system_cannot_execute_the_specified_command"></a><h3> <span class="mw-headline"> Enblend: The system cannot execute the specified command </span></h3>
<p>This message could be generated by either
</p>
<ul><li> the lack of Microsoft Visual C++ 2008 Redistributable Package (x86) that is necessary to run an OpenMP enabled version of Enblend. Download here.
</li><li> the lack of SSE2 support. Use a non-SSE build of Enblend. See also <a href="Hugin_FAQ.html#Enblend-Enfuse_OpenMP_SSE_GPU:_which_one_is_the_right_one_for_me.3F" title=""> types of Enblend-Enfuse binaries</a> or <a href="Hugin_FAQ.html#Selecting_right_version_of_enblend-enfuse_binary_for_Windows" title=""> types of Enblend-Enfuse binaries for Windows </a>
</li></ul>
<a name="Known_Limitations" id="Known_Limitations"></a><h2> <span class="mw-headline"> Known Limitations </span></h2>
<a name="Linux:_Compiz" id="Linux:_Compiz"></a><h3> <span class="mw-headline"> Linux: Compiz </span></h3>
<p>Linux: Compiz interferes with the <a href="Hugin_Fast_Preview_window.html" title="Hugin Fast Preview window">hugin Fast Preview window</a>. This is not a hugin specific issue. Research shows all direct rendered stuff will have various problems under Compiz: <a href="https://bugs.launchpad.net/ubuntu/+source/xorg-server/+bug/96991" class="external free" title="https://bugs.launchpad.net/ubuntu/+source/xorg-server/+bug/96991" rel="nofollow">https://bugs.launchpad.net/ubuntu/+source/xorg-server/+bug/96991</a>
</p><p>This problem is fixed with DRI2, e.g with fedora 11 and intel graphics hardware you can have a 'wobbly' Fast Preview window if you really want.
</p><p>It's not an issue with NVidia's proprietry driver.
</p><p>If you're affected, the workaround is to not use Compiz.
</p>
<a name="Windows:_International_Characters_in_Path" id="Windows:_International_Characters_in_Path"></a><h3> <span class="mw-headline"> Windows: International Characters in Path </span></h3>
<p>Hugin is fully internationalised and can cope with special characters in file paths. However, hugin apparently fails on some Windows systems with Polish, Japanese, Russian or Czech codepages, the workaround is to use shell-safe ascii characters in file and folder names: <b>A B C D E F G H I J K L M N O P Q R S T U V W X Y Z a b c d e f g h i j k l m n o p q r s t u v w x y z 0 1 2 3 4 5 6 7 8 9 - _ .</b> This includes the path for the temporary folder which is named after your username on Windows systems.
</p>
<a name="OSX:_error_when_clicking_on_the_help_button" id="OSX:_error_when_clicking_on_the_help_button"></a><h3> <span class="mw-headline"> OSX: error when clicking on the help button </span></h3>
<p>In a language other than English, French or Italian you get an error message when clicking on the help button. This will be fixed in Hugin-2009.4.0. In the meantime, the work around is to change language to one of the above three; or to ask for help on the mailing list.
</p>
<a name="Non-Unique_Filenames" id="Non-Unique_Filenames"></a><h3> <span class="mw-headline"> Non-Unique Filenames </span></h3>
<p>Some components of Hugin have been reported not to deal well with image files
that have the same name in different folders. The workaround is to rename
your images files so that all image files in a project are unique.
</p>
<a name="Temporary_Files" id="Temporary_Files"></a><h3> <span class="mw-headline"> Temporary Files </span></h3>
<p>Hugin has a preference setting for the temporary files folder. Currently it
is not implemented properly and files will be written in the same folder as
the project file.
</p><p>A partial workaround on Linux is to start Hugin from a terminal with
</p>
<pre>
TMPDIR=/media/disk-2/tmp hugin &amp;
</pre>
<p>These temporary files have to be deleted manually after the stitch.
</p>
<a name="Special_Characters_in_Paths" id="Special_Characters_in_Paths"></a><h3> <span class="mw-headline"> Special Characters in Paths </span></h3>
<table style="margin: 1em auto 1em 1em;background:#FFFF99;color:#FF0000;text-align:left;border: solid #FF3300;">
<tr valign="top">
<th> =
</th><th>&nbsp;;
</th><th>&nbsp;:
</th><th> $
</th><th> "
</th><th>&nbsp;%
</th><th> #
</th><th>
</th><th> '
</th><th> (
</th><th> )
</th><th> `
</th><th> &amp;
</th><th> *
</th><th> +
</th><th> ^
</th><th> ~
</th><th> &lt;
</th><th>&nbsp;?
</th><th> &gt;
</th><th> and the space character.
</th></tr></table>
<p>Hugin currently does not do plausibility checks on the paths and file names that are given to it. It relies on the operating system's conventions and limitations. However Hugin uses make to run the stitching process, and make has more restrictive limitation than the operating system.
</p><p>Please don't use the above characters in your files and folders when you want to make sure they work with Hugin. If you absolutely need files named this way, rename them after processing. Do not file bug reports based on filenames with the above characters. The <a href="https://sourceforge.net/tracker/?func=detail&amp;atid=550441&amp;aid=2883450&amp;group_id=77506" class="external text" title="https://sourceforge.net/tracker/?func=detail&amp;atid=550441&amp;aid=2883450&amp;group_id=77506" rel="nofollow">issue</a> is known, analyzed, and may be fixed in the future.
</p>
<a name="Hugin_fails_stitching_some_stereographics_and_other_polar_projections" id="Hugin_fails_stitching_some_stereographics_and_other_polar_projections"></a><h3> <span class="mw-headline"> Hugin fails stitching some stereographics and other polar projections </span></h3>
<p>This is a known limitation caused by photos being distorted into extreme 'C' and 'O' shapes. The workaround: stitch all of your pictures into a single equirectangular, and then load the equirectangular into Hugin to generate the stereographic or other projections you wanted to do in the first place.
</p><p><br />
</p>
<a name="OSX_.2F_iPhoto" id="OSX_.2F_iPhoto"></a><h3> <span class="mw-headline"> OSX / iPhoto </span></h3>
<p>Dragging the photos from iPhoto to Hugin works perfectly as long as there is no forward slash in the Name of the events in iPhoto (which translates to folders inside the iPhoto Database).
</p>
<a name="Fast_Preview" id="Fast_Preview"></a><h3> <span class="mw-headline"> Fast Preview </span></h3>
<p>Why are there two preview windows, and which one should I use? For most purposes, the newer Fast Preview window is faster. However it is still under development and sometimes shows artefacts. The old preview still does a logarithmic tone mapping of stacked
images and is the only way to preview hdr or fused output.
</p>
<a name="Control_Point_creation" id="Control_Point_creation"></a><h2> <span class="mw-headline"> Control Point creation </span></h2>
<a name="How_do_I_add_control_points" id="How_do_I_add_control_points"></a><h3> <span class="mw-headline"> How do I add control points </span></h3>
<p>The <a href="Control_points.html" title="Control points">control points</a> editor is quite powerful, but its usage is probably not obvious on the first try. Here are some ways the developers use the Control Point panel:
</p><p>1. Selecting control points in 100% zoom.
</p><p>This method needs some scrolling, if big images are used. You might want to try the fit to window zoom setting in that case. Switch to the Control Points tab, and use the following settings:
</p>
<pre>Zoom: 100%
[X] auto fine tune
[X] auto add
[X] auto estimate
</pre>
<p>Click on a prominent feature in the left image. If the image pair already contains control points, <a href="Hugin.html" title="Hugin">hugin</a> will try to select the point in the other image. If its the first point in this pair, click near the same feature on the right image. The second point will be placed and fine tuned automatically. If you are not happy with the placement, both points can be moved by dragging them to a better position. Press the "f" key to fine tune the point in a small area.
</p><p><br />
2. Selecting control points in fit to window mode.
</p><p>I uses this mode if I need to set points on big images. Switch to the Control Points tab, and use the following settings:
</p>
<pre>Zoom: fit to window
[X] auto fine tune
[ ] auto add
[X] auto estimate
</pre>
<p>Click on left image. The image will be shown in 100% view. Within the detailed view, click on a prominent feature. If the image pair already contains control points, hugin will try to select the point in the other image. If its the first point in this pair, click near the same feature on the right image. The point will be placed and fine tuned automatically. If you are not happy with the placement, both points can be moved by clicking at the desired position. Move the point close to the desired feature and press the "f" key to fine tune the point. When the points are on the same feature, press the right mouse button, or press the "a" key to add the control point pair. It will then be shown in the list below the image.
</p>
<a name="How_do_I_scroll_both_images_at_the_same_time.3F" id="How_do_I_scroll_both_images_at_the_same_time.3F"></a><h3> <span class="mw-headline"> How do I scroll both images at the same time? </span></h3>
<p>Try pressing the shift key while moving the mouse. The control key or the middle mouse button can be used to scroll only the image under the mouse cursor.
</p>
<a name="How_do_I_stop_Hugin_pausing_for_a_moment_after_every_click.3F" id="How_do_I_stop_Hugin_pausing_for_a_moment_after_every_click.3F"></a><h3> <span class="mw-headline"> How do I stop Hugin pausing for a moment after every click? </span></h3>
<p>The <i>preview window</i> updates continuously whenever anything changes, so disable the preview auto-update, close it or make it smaller if you don't need it.
</p><p>Otherwise, picking <a href="Control_points.html" title="Control points">control points</a> with <i>auto fine tune</i> selected can involve a lot
of processing. You can reduce this by <i>selecting File -&gt; Preferences -&gt; Finetune</i> and
lowering the values for <i>Patch width</i>, <i>Search area width</i> and <i>Local search area width</i>.
This means you can't be so sloppy when clicking to create control points, but the results will
be the same.
</p>
<a name="Windows:_when_user_is_not_admin.2C_not_all_cp-creators_are_available_to_choose_from" id="Windows:_when_user_is_not_admin.2C_not_all_cp-creators_are_available_to_choose_from"></a><h3> <span class="mw-headline"> Windows: when user is not admin, not all cp-creators are available to choose from </span></h3>
<p>Preferences are stored in the registry on Windows. Every users has their own. To have all the cp-creator pre-sets like the admin users, hit the "Load defaults" button on the Control Points tab in the Preferences dialog.
</p>
<a name="Common_problems_when_creating_a_panorama" id="Common_problems_when_creating_a_panorama"></a><h2> <span class="mw-headline"> Common problems when creating a panorama </span></h2>
<a name="The_Control_Points_tab_shows_my_photos_rotated" id="The_Control_Points_tab_shows_my_photos_rotated"></a><h3> <span class="mw-headline"> The Control Points tab shows my photos rotated </span></h3>
<p>The rotation of photos in the <a href="Hugin_Control_Points_tab.html" title="Hugin Control Points tab">Hugin Control Points tab</a> isn't necessarily
related to the orientation of the files themselves.
</p><p>Hugin shows photos at the angle they best fit into the panorama, so if the
panorama fit is bad, then you will see strange angles in the Control Points
tab. Probably the problem is caused by bad alignment, you can
identify 'bad' <a href="Control_points.html" title="Control points">Control points</a> in the <a href="Hugin_Control_Points_table.html" title="Hugin Control Points table">Hugin Control Points table</a>, delete them and re-optimise.
</p>
<a name="How_can_I_reuse_a_project_as_a_template.3F" id="How_can_I_reuse_a_project_as_a_template.3F"></a><h3> <span class="mw-headline"> How can I reuse a project as a template? </span></h3>
<p>If you copy a .pto project to a different folder and open it with hugin, you will be prompted for the 'missing' images. You should delete any control points from this template project since they won't be relevant to the new photos.
</p><p>Alternatively you can load your images as normal, then <i>Apply template</i>
from the <i>File</i> menu, this will import image settings and parameters
from a previous project.
</p>
<a name="How_do_I_straighten_a_curved_horizon.3F" id="How_do_I_straighten_a_curved_horizon.3F"></a><h3> <span class="mw-headline"> How do I straighten a curved horizon? </span></h3>
<p>If the panorama looks nice but the horizon is curved, there are two ways to improve the image and straighten the horizon. First, try optimizing the view by selecting "Positions and View" as the optimization mode and run the optimizer afterwards. By clicking "Calculate Field of View" in the "Stitcher" tab and displaying the preview window afterwards you can check if the image has been improved.
</p><p>If it is still curved, you have to add vertical guide control points in the "Control Points" tab. Usually two <a href="Vertical_control_points.html" title="Vertical control points">vertical control points</a> are enough to straighten the horizon nicely. Often edges of buildings, poles or other man made structures provide good vertical lines. To add a vertical control point, switch to the control point editor and select the same image on both sides. Place a control point on the left image on the upper area of the vertical feature. In the right image, select a control point on the lower area of the features, and press the Add button. Once the new point has been added, its type should automatically switch to "vertical line". You might want to switch off the auto-add and auto-estimate options while doing this to avoid naggy dialogs while adding these guide points.
</p><p>Two points that are roughly 90 degrees apart provide the best effect.
</p><p>See also the related perspective correction tutorials: hugin tutorial on perspective correction, <a href="Perspective_correction.html" title="Perspective correction">Perspective correction</a>, Leveling a Finished Panorama. While these are concerned with correction of the perspective in one image, the same technique can be used for
leveling a panorama.
</p>
<a name="Half_the_panorama_is_black.2C_my_pictures_fill_only_the_right_half_of_the_output" id="Half_the_panorama_is_black.2C_my_pictures_fill_only_the_right_half_of_the_output"></a><h3> <span class="mw-headline"> Half the panorama is black, my pictures fill only the right half of the output </span></h3>
<p>Hugin uses the first photo as the <i>anchor</i> image and puts it in the middle by default. This means that if you shot a sequence from left to right, the images will fill the right hand side of the panorama. There are three ways to fix this:
</p>
<ul><li> Open the <b>preview</b> window and click the <b>center</b> button.
</li><li> or select the middle photo, hit <b>anchor this image for position</b> and <b>reset</b> in the <b>images</b> tab, then reoptimise.
</li><li> In the 'Fast Panorama Preview' window select 'Drag'. Left mouse drags the image, right mouse rotates the image.
</li></ul>
<a name="I_get_visible_bands_in_the_sky_and_other_flat_areas.2C_what_can_I_do.3F" id="I_get_visible_bands_in_the_sky_and_other_flat_areas.2C_what_can_I_do.3F"></a><h3> <span class="mw-headline"> I get visible bands in the sky and other flat areas, what can I do? </span></h3>
<p>Make sure you are using <a href="Enblend.html" title="Enblend">enblend</a> to do the final image assembly, this will blend the overlap as much as is possible - Enable enblend by stitching the images <b>into a high quality TIFF file</b> in the <b>stitcher</b> tab.
</p><p>If you still have problems, then you probably have to correct <a href="Vignetting.html" title="Vignetting">vignetting</a> in your images. In the vignetting area of <b>camera and lens</b> tab, select <b>edit parameters...</b>. Then select <b>division</b>, <b>polynomial</b> and <b>estimate polynomial</b> to calculate a vignetting correction curve for your camera combination - This will be applied to every photo in your project when you click <b>OK</b>.
</p>
<a name="My_photos_never_quite_line_up.2C_what_can_I_do.3F" id="My_photos_never_quite_line_up.2C_what_can_I_do.3F"></a><h3> <span class="mw-headline"> My photos never quite line up, what can I do? </span></h3>
<p>It is normal to get little stitching <a href="Parallax.html" title="Parallax">parallax</a> errors if
the camera moves between photos. The solution is to rotate the camera around
the <a href="No-parallax_point.html" title="No-parallax point">no-parallax point</a> using a panoramic head or philopod.
</p><p>Otherwise you can sometimes improve things by optimising the <i>d &amp; e</i> parameters
separately - When you optimise <b>everything</b>, unselect <b>Inherit</b> in
the <b>camera and Lens</b> panel for 'd &amp; e'.
</p><p>If these parallax errors are still large, you need to decide which
parts of the scene that you want to line-up and which parts don't
matter. Select <a href="Control_points.html" title="Control points">control points</a> only on objects that you do want to
line-up and which are all about the same distance from the camera.
</p><p>The remaining broken lines can then be retouched in a photo editor like the gimp.
The <i>shear</i> tool is ideal for bending the lines and
getting them to line up.
</p>
<a name="I_have_extraded_and_edited_cubefaces_and_want_to_merge_them_together_again._How_do_I_do_that_.3F" id="I_have_extraded_and_edited_cubefaces_and_want_to_merge_them_together_again._How_do_I_do_that_.3F"></a><h3> <span class="mw-headline"> I have extraded and edited cubefaces and want to merge them together again. How do I do that&nbsp;? </span></h3>
<p>Set the <b>enblend options</b> to -l1 --fine-mask --no-optimize
</p>
<a name="Can_I_stitch_my_HDR_images_.3F" id="Can_I_stitch_my_HDR_images_.3F"></a><h3> <span class="mw-headline"> Can I stitch my HDR images&nbsp;? </span></h3>
<p>Yes. If you already have merged your HDR stacks, follow the <b>Normal</b> Output on the <b>Stitcher</b> tab (<b>HDR merging</b> is for stacks that will be merged by Hugin). In the <b>Processing</b> step the output will be an HDR in TIFF format.
</p>
<a name="Why_is_my_panorama_upside_down_.3F" id="Why_is_my_panorama_upside_down_.3F"></a><h3> <span class="mw-headline"> Why is my panorama upside down&nbsp;? </span></h3>
<p>Hugin stitches the panorama on a sphere and can't determine what is up or what is down. Even if vertical control points are assigned, there is still no notion of up and down, so the panorama can flip upside down. The solution for that is to open the Preview window, click on the Num. Trans. button in the toolbar, enter 180 in the roll field and apply. This will flip the panorama back to the right orientation.
</p>
<a name="Why_do_multi-lens_projects_end_up_distorted.2Fbroken.3F" id="Why_do_multi-lens_projects_end_up_distorted.2Fbroken.3F"></a><h3> <span class="mw-headline"> Why do multi-lens projects end up distorted/broken? </span></h3>
<p>You have probably optimized 'Everything'. This will cause the optimizer to try to optimize lens parameters for each of the different lenses, and there may not be a big enough spread of control points for the optimization to work well.
When stitching photos from different lenses, or when you don't have a good spread of control points, optimize 'Position, view &amp; Barrel (y,p,r,v,b).
</p>
<a name="GPU-stitching_.28nona.29" id="GPU-stitching_.28nona.29"></a><h2> <span class="mw-headline"> GPU-stitching (nona) </span></h2>
<p>Starting with Hugin-2009.2 nona has a new, experimental feature: it can use the video card (GPU) to accelerate the stitching. How much acceleration you will get, if any, depends on the combination of video card and driver.
</p>
<a name="I_get_a_nona:_GL_error._Does_this_mean_that_I_found_a_bug.3F" id="I_get_a_nona:_GL_error._Does_this_mean_that_I_found_a_bug.3F"></a><h3> <span class="mw-headline"> I get a nona: GL error. Does this mean that I found a bug? </span></h3>
<p>Not necessarily. This functionality is highly experimental. It may be that you have an outdated driver, or that the functionality is not supported on your video card. Note down the version of the driver you are using and the specs of your video card (GPU and RAM). Then update to the latest driver from nVidia or AMD (ATI has been bought by AMD). Currently only these two families of GPUs support the functionality.
</p>
<a name="How_can_I_know_if_nona-GPU_works_on_my_system.3F" id="How_can_I_know_if_nona-GPU_works_on_my_system.3F"></a><h3> <span class="mw-headline"> How can I know if nona-GPU works on my system? </span></h3>
<p>At the moment we have too little information to predict this. We know that only nVidia and AMD(ATI) powered video cards work, and not all of them. The more recent the video card, the higher the likelihood that it works. Improve your chances by updating to the latest driver for your GPU. Look at experience reports from other users and report your experience here.
</p>
<a name="What_speed_improvement_can_I_expect.3F" id="What_speed_improvement_can_I_expect.3F"></a><h3> <span class="mw-headline"> What speed improvement can I expect? </span></h3>
<p>It depends on the video card. Bandwidth is mostly the bottleneck, specifically getting the transformed data from the GPU back to the main system memory.
</p>
<a name="Bug_Reporting" id="Bug_Reporting"></a><h3> <span class="mw-headline"> Bug Reporting </span></h3>
<p>When reporting success or failure using the GPU for stitching, always report also the driver version, video card GPU and RAM. Tell us what you were doing, the size and number of input images (note that if you stitch from within Hugin or PTBatcher, it is only one input image at a time).
</p>
<a name="Postprocessing" id="Postprocessing"></a><h2> <span class="mw-headline"> Postprocessing </span></h2>
<a name="Why_is_the_ICC_profile_of_my_input_images_not_preserved.3F" id="Why_is_the_ICC_profile_of_my_input_images_not_preserved.3F"></a><h3> <span class="mw-headline"> Why is the ICC profile of my input images not preserved? </span></h3>
<p>Since hugin 0.5 and enblend 2.4 <a href="Colour_profile.html" title="Colour profile">ICC profiles</a> in the input files are transfered to the output panorama. Please update to a current version.
</p>
<a name="How_can_I_postprocess_the_image_using_multiple_layers_in_The_Gimp.3F" id="How_can_I_postprocess_the_image_using_multiple_layers_in_The_Gimp.3F"></a><h3> <span class="mw-headline"> How can I postprocess the image using multiple layers in The Gimp? </span></h3>
<ul><li> Use the <a href="Nona.html" title="Nona">nona</a> stitcher on the command-line, to output to a multilayer <a href="TIFF.html" title="TIFF">TIFF</a> format:
</li></ul>
<pre> nona -m TIFF_multilayer -o multi_layer.tif project.pto
</pre>
<p>This will will produce a multi_layer.tif file, that contains all remapped images, cropped to their bounding box.
</p>
<ul><li> Alternatively select the <b>Remapped Images</b> option in the <a href="Hugin_Stitcher_tab.html" title="Hugin Stitcher tab">Hugin Stitcher tab</a>, this will create each <i>layer</i> as a separate file. Then use the <b>tiffcp</b> command-line tool (part of libtiff) to join them together into a multi-page TIFF:
</li></ul>
<pre> tiffcp project0000.tif project0001.tif project0002.tif multi_layer.tif
</pre>
<ul><li> You can also use tif2xcf, to combine the <b>Remapped Images</b> TIFF output into a multilayer XCF.
</li></ul>
<p>Unfortunately this requires a lot of memory because it stores each remapped image in a layer with the size of the final panorama.
</p>
<a name="Installation" id="Installation"></a><h2> <span class="mw-headline"> Installation </span></h2>
<a name="Where_can_I_download_hugin_installers" id="Where_can_I_download_hugin_installers"></a><h3> <span class="mw-headline"> Where can I download hugin installers </span></h3>
<p>Official releases are available from hugin.sf.net.
</p>
<a name="How_can_I_compile_Hugin.app_on_my_OSX_machine.3F" id="How_can_I_compile_Hugin.app_on_my_OSX_machine.3F"></a><h3> <span class="mw-headline"> How can I compile Hugin.app on my OSX machine? </span></h3>
<p>See Hugin Compiling OSX, Autopano-sift-C Compiling OSX and Enblend Compiling OSX.
</p>
<a name="How_do_I_compile_hugin_on_my_linux_machine.3F" id="How_do_I_compile_hugin_on_my_linux_machine.3F"></a><h3> <span class="mw-headline"> How do I compile hugin on my linux machine? </span></h3>
<p>See Hugin Compiling Fedora, Hugin Compiling Gentoo, Hugin Compiling OpenSuse and Hugin Compiling Ubuntu
</p>
<a name="make.5B2.5D:_.2A.2A.2A_No_rule_to_make_target_.60.2Fusr.2Flib.2FlibGL.so.27.2C_needed_by_.60src.2Fhugin_base.2Flibhuginbase.so.0.0.27.__Stop." id="make.5B2.5D:_.2A.2A.2A_No_rule_to_make_target_.60.2Fusr.2Flib.2FlibGL.so.27.2C_needed_by_.60src.2Fhugin_base.2Flibhuginbase.so.0.0.27.__Stop."></a><h3> <span class="mw-headline"> make[2]: *** No rule to make target `/usr/lib/libGL.so', needed by `src/hugin_base/libhuginbase.so.0.0'. Stop. </span></h3>
<p>So you're trying to build from source. Most likely you have proprietary nVidia or ATI drivers. They are a moving target and so is X. On debian based systems including Ubuntu, diagnose with `dpkg -S /usr/lib/libGL.so` and check that the linked library exist (i.e. it is not listed in red when doing `ll /usr/lib/mesa/libGL.so`). If it is listed in red, check where the library is (`ll /usr/lib/libGL*` is a good start on Ubuntu) and link it properly.
</p>
<a name="How_do_I_compile_hugin_on_my_Windows_machine.3F" id="How_do_I_compile_hugin_on_my_Windows_machine.3F"></a><h3> <span class="mw-headline"> How do I compile hugin on my Windows machine? </span></h3>
<p>See Hugin Compiling Windows
</p>
<a name="Enblend-Enfuse_OpenMP_SSE_GPU:_which_one_is_the_right_one_for_me.3F" id="Enblend-Enfuse_OpenMP_SSE_GPU:_which_one_is_the_right_one_for_me.3F"></a><h3> <span class="mw-headline"> Enblend-Enfuse OpenMP SSE GPU: which one is the right one for me? </span></h3>
<p>Enblend and Enfuse can be optimized at build time for different hardware configurations. This yields four categories of Enblend-Enfuse builds, with a few variations. If you build Enblend-Enfuse from source, check the build options in the README file. If you download a binary, you can find out how it has been built with the following command:
</p>
<pre> enblend -v -V
</pre>
<p>look for the following in the output text:
</p>
<ol><li> <b>Extra feature: OpenMP: yes</b> this version has OpenMP.
</li><li> <b>Extra feature: image cache: yes</b> this version has image cache
</li><li> <b>Extra feature: GPU acceleration: yes</b> this version has GPU support
</li><li> SSE-support is not mentioned, you'll find out if you have an unsupported CPU and the binary will refuse to run.
</li></ol>
<p>These are approximate guidelines to help you choose what may work for you:
</p>
<ul><li> if you have a recent, multi-core / multi-thread CPU, you probably want the OpenMP-enabled version. Note however that speed improvement does not scale well, so don't expect a 6 cores CPU to be 3x faster than a 2 cores one.
</li><li> if you have a recent, fast video card, you probably want the GPU-enabled version. This is not mutually exclusive with OpenMP and a good builder will add both features to his binaries. If speed is important to you, you want to test which of the two is faster on your system. If system responsiveness is important to you, the GPU-enabled version frees CPU resources for your other tasks. Note that even if your binary is GPU-enabled, the GPU will not be used unless you specify the option `--gpu`.
</li><li> if you have an old CPU without SSE2 support, you want a NOSSE build. This is the least performing version.
</li><li> Last but not least, if blending fails because of large images, try the image cache variation. The image cache allows for processing of large project when memory is scarce but images are large (and disk is large enough too). Image cache is incompatible with OpenMP, but a good bilder will make this version GPU-enabled too, so test it with `--gpu` if speed is important.
</li></ul>
<a name="Selecting_right_version_of_enblend-enfuse_binary_for_Windows" id="Selecting_right_version_of_enblend-enfuse_binary_for_Windows"></a><h3> <span class="mw-headline"> Selecting right version of enblend-enfuse binary for Windows </span></h3>
<p>There are 3 variants of enblend-enfuse binaries officially released for Windows. Each one has a special feature set:
</p><p>1. enblend.exe/enfuse.exe
</p><p>These executables are the standard release. They are using one processor core and the image cache for processing very big images.
</p><p>2. enblend_openmp.exe/enfuse_openmp.exe
</p><p>These executables can utilize several cores of modern multi-core processors and are therefore significantly faster on modern processors. But they may fail on very big images because they are working without the image cache. In this case, please switch to the standard version.
For running the OpenMP variants you will need "Microsoft Visual C++ 2008 Redistributable Package (x86)".
</p><p><br />
3. enblend_nosse.exe/enfuse_nosse.exe
</p><p>If you have an old CPU without SSE2 support, you want a NOSSE build. This is the least performing version.
You will need to download a separate package to get this version from sourceforge.net
</p><p>All three variants can utilize a modern graphic card to accelerate the optimizing of the seam line between two images. To use this feature supply the parameter --gpu to enblend.
</p><p><br />
</p>
<a name="Selecting_right_version_of_enblend-enfuse_binary_for_Debian.2FUbuntu" id="Selecting_right_version_of_enblend-enfuse_binary_for_Debian.2FUbuntu"></a><h3> <span class="mw-headline"> Selecting right version of enblend-enfuse binary for Debian/Ubuntu </span></h3>
<p>At the time of writing the official Debian/Ubuntu package ships with one executable only, however in July 2010 a change has been committed to debian-unstable that delivers two binaries:
</p><p>1. enblend/enfuse
</p><p>These executables are the standard release. They are using one processor core and the image cache for processing very big images.
</p><p>2. enblend_mp/enfuse_mp
</p><p>These executables can utilize several cores of modern multi-core processors and are therefore significantly faster on modern processors. But they may fail on very big images because they are working without the image cache.
</p><p>Both variants can utilize a modern graphic card to accelerate the optimizing of the seam line between two images. To use this feature supply the parameter --gpu to enblend.
</p>
<div class="printfooter">
Retrieved from "<a href="Hugin_FAQ.html">http://wiki.panotools.org/Hugin_FAQ</a>"</div>
</div></div></div></div></body></html>