- 1 Common error messages
- 1.1 enblend: no input files specified
- 1.2 enblend: error writing to image swap file
- 1.3 false --compression NONE
- 1.4 Enblend error: Mask is entirely black, but white image was not identified as redundant
- 1.5 enblend: illegal option -- compression
- 1.6 Makefile: target pattern contains no %
- 1.7 nona: GL error: Framebuffer incomplete, incomplete attachment in:
- 1.8 make: enfuse: command not found
- 2 Known Limitations
- 3 Control Point creation
- 4 Common problems when creating a panorama
- 4.1 How can I reuse a project as a template?
- 4.2 How do I straighten a curved horizon?
- 4.3 Half the panorama is black, my pictures fill only the right half of the output
- 4.4 I get visible bands in the sky and other flat areas, what can I do?
- 4.5 My photos never quite line up, what can I do?
- 4.6 I have extraded and edited cubefaces and want to merge them together again. How do I do that ?
- 4.7 Can I stitch my HDR images ?
- 5 GPU-stitching (nona)
- 6 Postprocessing
- 7 Installation
Common error messages
enblend: no input files specified
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'. Open the Hugin Preview window or Hugin Fast Preview window to adjust the view and/or crop.
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.
enblend: error writing to image swap file
enblend 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.
false --compression NONE
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 -> Preferences -> Enblend and click Load Defaults -> Yes -> Ok
Enblend error: Mask is entirely black, but white image was not identified as redundant
This is a well known "error" for enblend. Try to use the additional enblend parameter "--fine-mask" to ged 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.
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.
enblend: illegal option -- compression
hugin 0.7.0 and later versions require at least enblend version 3.2. This error indicates that you need to upgrade enblend.
Makefile: target pattern contains no %
This is a message generated by w:Make_(software) (which Hugin uses to manage the stitching sequence). The error is caused by a : or # character in one of the file paths. The workaround is to rename to remove any 'special' shell characters and try again.
nona: GL error: Framebuffer incomplete, incomplete attachment in:
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 GPU-stitching.
make: enfuse: command not found
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 higher.
Linux: Compiz interferes with the hugin Fast Preview window. This is not a hugin specific issue. Research shows all direct rendered stuff will have various problems under Compiz: https://bugs.launchpad.net/ubuntu/+source/xorg-server/+bug/96991
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.
It's not an issue with NVidia's proprietry driver.
If you're affected, the workaround is to not use Compiz.
Windows: International Characters in Path
Hugin is fully internationalised and can cope with special characters in file paths. However, hugin apparently fails on Windows systems with Russian and Czech codepages, the workaround is to use shell-safe ascii characters in file and folder names: 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 - _ .
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.
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.
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.
A partial workaround on Linux is to start Hugin from a terminal with
TMPDIR=/media/disk-2/tmp hugin &
These temporary files have to be deleted manually after the stitch.
Control Point creation
How do I add control points
The control points 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:
1. Selecting control points in 100% zoom.
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:
Zoom: 100% [X] auto fine tune [X] auto add [X] auto estimate
Click on a prominent feature in the left image. 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 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.
2. Selecting control points in fit to window mode.
I uses this mode if I need to set points on big images. Switch to the Control Points tab, and use the following settings:
Zoom: fit to window [X] auto fine tune [ ] auto add [X] auto estimate
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.
How do I scroll both images at the same time?
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.
How do I stop Hugin pausing for a moment after every click?
The preview window updates continuously whenever anything changes, so disable the preview auto-update, close it or make it smaller if you don't need it.
Otherwise, picking control points with auto fine tune selected can involve a lot of processing. You can reduce this by selecting File -> Preferences -> Finetune and lowering the values for Patch width, Search area width and Local search area width. This means you can't be so sloppy when clicking to create control points, but the results will be the same.
Common problems when creating a panorama
How can I reuse a project as a template?
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.
Alternatively you can load your images as normal, then Apply template from the File menu, this will import image settings and parameters from a previous project.
How do I straighten a curved horizon?
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.
If it is still curved, you have to add vertical guide control points in the "Control Points" tab. Usually two vertical control points 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.
Two points that are roughly 90 degrees apart provide the best effect.
See also the related perspective correction tutorials: hugin tutorial on perspective correction, Perspective correction, 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.
Half the panorama is black, my pictures fill only the right half of the output
Hugin uses the first photo as the anchor 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 two ways to fix this:
- Open the preview window and click the center button.
- or select the middle photo, hit anchor this image for position and reset in the images tab, then reoptimise.
I get visible bands in the sky and other flat areas, what can I do?
Make sure you are using enblend to do the final image assembly, this will blend the overlap as much as is possible - Enable enblend by stitching the images into a high quality TIFF file in the stitcher tab.
If you still have problems, then you probably have to correct vignetting in your images. In the vignetting area of camera and lens tab, select edit parameters.... Then select division, polynomial and estimate polynomial to calculate a vignetting correction curve for your camera combination - This will be applied to every photo in your project when you click OK.
My photos never quite line up, what can I do?
Otherwise you can sometimes improve things by optimising the d & e parameters separately - When you optimise everything, unselect Inherit in the camera and Lens panel for 'd & e'.
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 control points only on objects that you do want to line-up and which are all about the same distance from the camera.
I have extraded and edited cubefaces and want to merge them together again. How do I do that ?
Set the enblend options to -l1 --fine-mask --no-optimize
Can I stitch my HDR images ?
Yes. If you already have merged your HDR stacks, follow the Normal Output on the Stitcher tab (HDR merging is for stacks that will be merged by Hugin). In the Processing step the output will be an HDR in TIFF format.
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.
I get a nona: GL error. Does this mean that I found a bug?
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.
How can I know if nona-GPU works on my system?
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.
What speed improvement can I expect?
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.
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).
Why is the ICC profile of my input images not preserved?
Since hugin 0.5 and enblend 2.4 ICC profiles in the input files are transfered to the output panorama. Please update to a current version.
How can I postprocess the image using multiple layers in The Gimp?
nona -m TIFF_multilayer -o multi_layer.tif project.pto
This will will produce a multi_layer.tif file, that contains all remapped images, cropped to their bounding box.
- Alternatively select the Remapped Images option in the Hugin Stitcher tab, this will create each layer as a separate file. Then use the tiffcp command-line tool (part of libtiff) to join them together into a multi-page TIFF:
tiffcp project0000.tif project0001.tif project0002.tif multi_layer.tif
- You can also use tif2xcf, to combine the Remapped Images TIFF output into a multilayer XCF.
Unfortunately this requires a lot of memory because it stores each remapped image in a layer with the size of the final panorama.
Where can I download hugin installers
Information on installers for both stable and testing builds of hugin can be found on the panospace download page.