# Hugin FAQ

From PanoTools.org Wiki

## Common error messages

### enblend: excessive overlap detected

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:

- Follow the error message and remove the suggested image from the set, you probably don't need it to complete the panorama.
- Switch back to enblend-3.2.
- Hugin will merge stacked images before blending if you select 'Exposure fusion' in the Hugin Stitcher tab. This error will go away, but Hugin will take a very different approach to variable exposure between photos.
- Mask out major parts of one image.

### 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.

### 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 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.

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.

This error also occurs when one photo is completely covered by another, try removing redundant photos.

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° Equirectangular Projection panorama first, then load this as a single source image into a new project and render whatever views you need.

Note (Jan 2010): This should be fixed in the latest enblend 4.0 release.

### enblend: Error -1073741795

See #Enblend: The system cannot execute the specified command, in particular if you are a Windows user try switching to the 'nosse' enblend-enfuse.

### 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.

### Hugin Quits (Seg Faults) at Launch (Linux)

There may be many reasons why a program dies before it has even started.

One possibility is bad configuration or installation of the video drivers. See this ticket. To diagnose, try running glxgears. On Ubuntu (the package is probably available on most Linux distributions):

    sudo apt-get mesa-utils
    glxgears

If glxgears does not run on your system, Hugin will not run either. See your Linux distribution's instruction on how to fix the video drivers.

### Simple user interface can not selected

There are two possible causes for this.

- Cause 1: your computer (exactly the graphic system) does not support the necessary OpenGL sub system. This may be the cause for some simple graphic chips or the driver does not implement the features. In the latter try to update your graphic driver.
- Cause 2: you have disabled the fast preview window during the last run of Hugin.

To reactivate the fast preview window and therefore the simple user interface start Hugin with pressed control key and activate the fast preview window again. You may switch to simple user interface once.

## Known Limitations

### Linux: Compiz

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 some Windows systems with Polish, Japanese, Russian or 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 - _ . This includes the path for the temporary folder which is named after your username on Windows systems.

### Non-Unique Filenames

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.

### Temporary Files

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 &

A workaround on Windows is to create a batch file which sets the temp folder before running Hugin. eg using notepad, create a file called HuginWithNewTemp.cmd with the following in it:

    REM Create a folder on C Drive called Temp for this to work

    REM Set the temp file environment variables for hugin
    set temp=c:\temp
    set tmp=c:\temp

    REM run hugin
    "C:\Program Files\Hugin\bin\hugin.exe

These temporary files have to be deleted manually after the stitch.

### Hugin fails stitching some stereographics and other polar projections

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.

### OS X and iPhoto

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).

### OS X 10.7 and Enblend / Enfuse

When using Hugin on Mac OS X 10.7 Lion with the built-in versions of enblend and enfuse (i.e. those packaged inside the hugin bundle) the stitching process will stop abruptly with an error. See bug 814280. The workaround is to use the enblend and enfuse versions for Mac OS X 10.4 Tiger that are inside the dmg in the enblend-enfuse-4.0 folder.
Note: Development versions as of version hugin-mac-2011.5.0.5723 and newer can be run on Lion as they are. They contain openmp enabled enblend/enfuse binaries that run on Lion.

### Fast Preview

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.

### Patching nadir shots using XYZ mosaic mode cuts the photos in half

"If an image is mapped to the nadir of a panorama and all translation parameters (X,Y,Z) are set to zero, the image is properly mapped and covers the entire nadir of the shot. However, if any of the X,Y,Z parameters are non-zero, then the image is cut in half and only occupies half of the nadir."

Basically the XYZ mosaic mode as it is implemented currently in Hugin requires that the mosaic photos must be mapped to a plane perpendicular to the view direction - In practice this means that what you are trying to do only works if the panorama is rotated such that the nadir is in the middle of the canvas and not at the bottom.

This isn't so bad, the nadir-in-the-middle image looks a bit weird, you can just reload the stitched equirectangular Projection result into a new single-photo project and straighten it there.

## Python Scripting

### What is Python Scripting?

Python is a powerful scripting language. Starting with Hugin 2011.2, Hugin exposes the panorama object through hsi.py in Python. It must be explicitly activated at build time with the CMake boolean parameter -DBUILD_HSI:BOOL=ON. It is currently untested / unavailable on OS X.

### How do I start Scripting?

    $ python
    Python 2.7.1+ (r271:86832, Apr 11 2011, 18:13:53)
    [GCC 4.5.2] on linux2
    Type "help", "copyright", "credits" or "license" for more information.
    >>> import hsi
    >>> help (hsi)

### What is the difference between a Plugin and a Script?

Strictly speaking, they are both Python scripts. A Plugin runs inside Hugin, while a Script runs in a shell or desktop.

### Where Are the Plugins in Hugin and how do I use them?

If Hugin was compiled with HSI, a menu Action will list categories of system-wide plugins. Just select one to run it. Moreover, you can write your own plugins and run them with the menu Edit -> Run User Python Plugin. The default location for user plugins is set in the preferences.

### Script Returned -10

This error message indicates that the plugin tried to import something and failed. hpi.py currently has no other way of telling hugin what's wrong than to 'return -10'. Try to start Hugin from the command line and see if there is more verbose output there. Copy the output and ask for help on hugin-ptx.

### Script Returned -11

The plugin failing with an exception. Ask the plugin maintainer to produce more specific error messages. It is good practice to catch such exceptions and let the user know what dependency is missing.

On Ubuntu this most often is caused by 'tiffdump missing'. Fix: sudo apt-get install libtiff-tools

To find other errors start hugin from the Terminal, then repeat ysour steps and check the output in the Terminal.

### Why do I read of users having access to a certain action and I don't see it on my system?

Some actions only work with specific versions of Hugin or operating systems. It is possible that they have a different system than yours and that the plugin in question does not support your system. Often times this is just a matter of lack of testing resources on a particular platform. Help test the plugin and it may become accessible on your system as well.

## 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.

### Windows: when user is not admin, not all cp-creators are available to choose from

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.

### cpfind: not enough control points generated

Cpfind is a recent addition to the Hugin suite and its parameters still require some fine tuning. Unlike older CP generators used with Hugin, it depends on information passed in the PTO file. Make sure that your input project file contains reasonable information about the used lens. If you are using a fisheye or wide angle lens, try increasing the parameters --sieve1width --sieve1height --sieve1size. A combinations that may work is "--sieve1width 50 --sieve1height 50 --sieve1size 300". Sometimes also the option "--fullscale" might help. Read the Cpfind documentation.

## Common problems when creating a panorama

### I get thin horizontal black or white lines in large panoramas

This is a known bug in the memory handling of enblend that manifests with large panoramas.

You can workaround it by reducing the size of the panorama, or by adjusting the cache size in Hugin_Stitcher_tab -> Blender options. e.g. the default is 1024MB (1 GB), so if you have 4GB RAM you can try raising the cache to use most of your free memory, such as 3000MB, i.e: -m 3000

### The Control Points tab shows my photos rotated

The rotation of photos in the Hugin Control Points tab isn't necessarily related to the orientation of the files themselves.

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' Control points in the Hugin Control Points table, delete them and re-optimise.

### 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 various ways to improve the image and straighten the horizon.

First, try clicking the Straighten button in the Hugin Fast Preview window.

If this doesn't work then you can use the Move/Drag tab of the Hugin Fast Preview window to visually straighten the panorama, drag the photos with the mouse, use the right mouse button to rotate. One useful tip is to drag the panorama so a vertical feature is in the middle, rotate it so the feature lines up with the 'cross hair', then drag the panorama up or down until all the vertical features in the scene are vertical on the screen (holding down the shift key while dragging limits the motion to just up/down or left/right).

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 three 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.
- In the 'Fast Panorama Preview' window select 'Drag'. Left mouse drags the image, right mouse rotates the image.

### I get visible bands in the sky and other flat areas, what can I do?

If the banding looks like posterization[*] then this is likely due to a error with estimation of the camera response curve. To get an accurate response curve, Hugin needs significant vignetting and/or bracketed exposures. The workaround is to Reset... the Camera Response in the Hugin Camera and Lens tab[*] and stitch again - Hugin usually produces acceptable results for a simple panorama when the camera response parameters are all zero.

If there is a wave of light and dark patches in the sky this could be due to vignetting in the source photos, you can deal with this by optimising Vignetting (Vb, Vc, Vd) in the Hugin Exposure tab. Another workaround is to increase the number of enblend blending levels, try setting '-l 29' as the enblend Command line options in the Hugin Stitcher tab.

### My photos never quite line up, what can I do?

It is normal to get little stitching parallax errors if the camera moves between photos. The solution is to rotate the camera around the no-parallax point using a panoramic head[*] or philopod[*].

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'. Also you can open the control point window sort it by distance and check the ones large distance.

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.

The remaining broken lines can then be retouched in a photo editor like the gimp[*]. The shear tool is ideal for bending the lines and getting them to line up[*].

### I have extracted and edited cubefaces and want to merge them together again. How do I do that ?

Manually enter the values for yaw and pitch for each of the photos. When you stitch set the enblend options in the Hugin Stitcher tab 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.

### Why is my panorama upside down ?

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.

### Why do multi-lens projects end up distorted/broken?

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 & Barrel (y,p,r,v,b).

### Why does my output covers only 180°?

Did you observe that the output is cropped at the +-90° borders? (e.g. saw teeth like borders in the fast preview window)

Then you have probably used the translation parameters X/Y/Z. This behaviour is a fundamental limitation of the used approach of the translation parameters. It is (internal) working in the rectilinear space, which is limited to maximal FOV of 180°, and therefore also the output is limited to FOV<180° (for more information see Stitching a photo-mosaic).

The solution/workaround is to set all X/Y/Z values to zero or to limit the horizontal field of view (HFOV) to a value smaller than 180°.

### After adding an image the focal length is another value than the EXIF value

When you stitch a panorama the used lens settings are stored in Hugins camera and lens database. This covers the lens projection, the crop, the field of view (FOV), the distortions parameters and also the photometric parameters.

When you load a new image Hugin looks up these information in the database and applies them automatically.

So when you used wrong parameters in one stitch it can also effect adding images to new project. A wrong information here can also confuse the assistant (especially cpfind).

To fix the issue there are several ways: In an existing project you can select reset from the context menu on the Photos tab. For a permanent fix you can manually save a correct lens information in the database (Photos tab, context menu Lens>Save lens to database). These manually save information will get a higher weight than the automatically saved information. If this does not help delete the database file, when Hugin is closed. You will find the filename in the Help>About screen, on the tab system. But keep in mind that these changes does not affect existing project files. You have to add the image (again) to a (new) project file (because the information is only read from the database when you add an images).

## GPU-stitching (nona)

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.

### Bug Reporting

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).

## Batch processing

### Why do I need to give 2 file names

The batch processor needs a project file with the settings how it should be stitch a panorama.

- So you will be first asked for a project file name (extension pto).
- Afterwards you can specify the file name for the final panorama image file.

### Why does PTBatcherGUI disappear after 10 s

PTBatcherGUI does not disappear. Only the icon in the tray bar is automatically hidden by Windows. Click on the chevron beside the tray bar and configure it display PTBatcherGUI always (the exact settings depends on the Windows version.)

### PTBatcherGUI does not stitch

In this case you need to check the batch processor settings:

- First check the preferences: on the tab stitching the processor PTBatcherGUI should be selected and the option immediately start shout

be checked. (or press "Load defaults").

- Then start PTBatcherGUI (File->Run batch processor"). If you don't see a window, check the tray area (beside the clock) and open PTBatcherGUI from the context menu on the icon. Probably the batch queue is mixed up. Delete the queue (File->Clear batch).
- Now go back to Hugin and press stitch. After specify the output prefix, the project should appear in PTBatcherGUI and the stitching starting.

### How do I clean up the batch queue

- If PTBatcherGUI is running, select File->Clear batch.
- If PTBatcherGUI is not running, start PTBatcherGUI from the "File->Run batch processor" or from the start menu. During the starting hold down the control key. You there will be ask to skip the loading of the batch queue. Confirm yes to clean up the batch queue.

## Postprocessing

### How can I postprocess the image using multiple layers in The Gimp?

- Use the nona stitcher on the command-line, to output to a multilayer TIFF format:

     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.

### Why doesn't the remapped images align when loading in an image processing software?

By default nona creates cropped TIFF files for the remapped files. Here only the rectangle which contains image information is saved and the offset is saved in the metadata. Some image processing software (e.g. The Gimp) does not read the offset when loading these images and so the images do not align perfectly here.

If you want to process the remapped images in another program switch off the cropped output. For existing projects go to the stitcher tab, select blender, options and deselect cropped output. In the Hugin Preferences on program tab you can change the default for all new projects.

## Installation

### Where can I download hugin installers?

Official releases are available from hugin.sf.net.

### Why do you provide only a msi installer for Windows?

The official binaries are compiled with MS Visual C++. They need the so called Visual C++ Redistributable for Visual Studio to run. These are helper libraries (DLL) provided by Microsoft. Maybe you have they already installed, because other programs may also depend on them. But often they are missing on your computer. The installer takes care of them and install the Visual C++ Redistributable for you when you install Hugin with the msi installer. (There are different Redistributable versions available for different versions of the compiler. The installer does contain the currently needed version.)

For experts: You can extract the files from the installer without installing with `msiexec`:

     msiexec /a Hugin-2018.0-win64.msi /qb TARGETDIR=c:\path\to\directory

This will extract all files into `c:\path\to\directory`. You will get 2 subfolders: `Hugin` and `System64`. Keep the sub-structure of the `Hugin` folder intact. You can copy this folder to any place on your hard disc. The `System64` folders contains the files from the Visual C++ Redistributable for Visual Studio. Either install the correct Visual C++ Redistributable for Visual Studio (preferred way, for Hugin 2017.0 and 2018.0 the correct version is "Visual C++ Redistributable für Visual Studio 2015") or copy the dll from `System64` to `Hugin\bin`.

### How can I compile Hugin.app on my OSX machine?

See Hugin Compiling OSX[*], Autopano-sift-C Compiling OSX[*] and Enblend Compiling OSX[*].

### How do I compile hugin on my linux machine?

See Hugin Compiling Fedora[*], Hugin Compiling Gentoo[*], Hugin Compiling OpenSuse[*] and Hugin Compiling Ubuntu[*]

### make[2]: *** No rule to make target `/usr/lib/libGL.so', needed by `src/hugin_base/libhuginbase.so.0.0'. Stop.

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.

### How do I compile hugin on my Windows machine?

See Hugin Compiling Windows[*]

### Enblend-Enfuse OpenMP SSE GPU: which one is the right one for me?

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:

     enblend -v -V

look for the following in the output text:

1. Extra feature: OpenMP: yes this version has OpenMP.
2. Extra feature: image cache: yes this version has image cache
3. Extra feature: GPU acceleration: yes this version has GPU support
4. SSE-support is not mentioned, you'll find out if you have an unsupported CPU and the binary will refuse to run.

These are approximate guidelines to help you choose what may work for you:

- 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.
- 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`.
- if you have an old CPU without SSE2 support, you want a NOSSE build. This is the least performing version.
- 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.

### Selecting right version of enblend-enfuse binary for Debian/Ubuntu

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:

1. enblend/enfuse

These executables are the standard release. They are using one processor core and the image cache for processing very big images.

2. enblend_mp/enfuse_mp

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.

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.

## Support

### Reporting Bugs

If you think you have found a bug in Hugin, please report it on Launchpad to help us make Hugin better. Before reporting a bug, try a few things to make sure it is really a bug. Then collect the following information and transmit it to the developers via the bug tracker.

1. What version of Hugin are you using? Consider upgrading and try to reproduce the bug. Maybe it was fixed in a more recent version.
2. read the output log. Are there any suggested actions or messages in there? If so, follow the advice and try again. Save the output log to a text file and attach it to the report if you file a bug report.
3. Attach the .pto file to the bug report.
4. Use a meaningful title for the bug report. The line reporting the error in the output log is a good place to start. Before filing a new bug report, check for duplicates. Launchpad does already a little bit so. If the bug is already known, add yourself and you files with a comment to the bug. This will give your report and your log more visibility than if somebody looking at your bug has to mark it as duplicate.

### Why is my Bug Report marked Invalid?

We trust you that you are experiencing the issue on your end and that it bugs you, but most likely the solution lies not in the Hugin codebase. If you feel that your report has been marked Invalid by mistake, feel free to reply and to set the status back to New for a re-evaluation. Somebody may explain to you why the report was marked as Invalid and what you can do.

### Why is my Bug Report marked Incomplete?

Every system is different and those trying to help fixing the bugs do not see and experience what you do. In order to help you, they are likely to need more information. Without that information the bug report is of little use. We mark as Incomplete reports that require additional information. Once you provide it, please mark the report status as New again

### How do I Change the Status of my Report?

- If you reply via the web interface: hit the yellow round button next to the current status to get a selection of stati. Unless you know what you are doing, set it to New to attract developer's attention.
- If you reply by email: at the bottom of your email enter a line starting with one single space and the following words: `status new`. Read more about the email interface.

### User Support: Mailing List

Hugin has a lively and friendly user groups. Connect with expert users and ask questions on the Hugin-PTX mailing list. To subscribe send an empty email to hugin-ptx+subscribe@googlegroups.com and follow the instructions in the email you receive back. To ask questions, send an email to hugin-ptx@googlegroups.com Your first emails will be moderated, so be patient if you don't see your message right away.

Retrieved from "https://wiki.panotools.org/index.php?title=Hugin_FAQ&oldid=16018"