Tree [a7863c] default /

Read Only access

File Date Author Commit
 CMakeModules 2011-08-28 harryvanderwolf harryvanderwolf [359785] merge
 Debian 2010-11-06 James Legg James Legg [aacb50] Merge changes from default into overview branch.
 artwork-src 2011-07-25 Yuval Levy Yuval Levy [076c3e] added shadow to icon for website
 doc 2011-08-28 harryvanderwolf harryvanderwolf [359785] merge
 mac 2011-09-14 harryvanderwolf harryvanderwolf [fd95a4] [OSX} remove junk from XCode project
 platforms 2011-05-31 Matthew Petroff Matthew Petroff [edceb4] Merge
 src 2011-09-15 tmodes tmodes [a7863c] Different fixes for fast preview from changeset...
 utils 2011-01-09 Yuval Levy Yuval Levy [8c577b] merged gsoc2010_panorama_overview branch
 whitepaper 2007-08-17 ippei ippei [689774] more documentation
 .hgignore 2011-05-31 Matthew Petroff Matthew Petroff [edceb4] Merge
 .hgtags 2011-05-29 Yuval Levy Yuval Levy [696461] Added tag 2011.0.0 for changeset 67a96ebdac74
 AUTHORS 2009-11-06 yuv yuv [3a1fb7] removed reference to the web and fixed it to th...
 CMakeLists.txt 2011-07-19 Yuval Levy Yuval Levy [ba85cc] Detect platform-specific threads library with C...
 COPYING 2011-06-08 Bruno Postle Bruno Postle [895b85] Update to correct version of GPLv2 license (wit...
 ChangeLog 2011-06-19 Yuval Levy Yuval Levy [f3bfd6] Updated ChangeLog 2011-05-27 tmodes tmodes [2f6425] Merge
 INSTALL_cmake 2011-05-21 tmodes tmodes [c264b1] Updated README for python scripting
 LICENCE_VIGRA 2006-03-04 dangelo dangelo [8f0f49] merged vigra 1.4 version back into HEAD. Everyt...
 README 2011-07-08 Yuval Levy Yuval Levy [f114bb] libboost 1.40 is enough
 README_JP 2008-08-31 ippei ippei [f68055] Japanese documentation update
 TODO 2011-01-15 Pablo d'Angelo Pablo d'Angelo [f7b49d] merged default
 authors.txt 2011-08-09 harryvanderwolf harryvanderwolf [982f15] merge 2009-07-26 yuv yuv [009f99] added uninstall target to CMake build

Read Me


Toolchain to create panoramic images for every occasion,
from quick holiday snaps to images with hundreds of megapixels.


This package contains the following programs:

 - hugin, The main program, a GUI for the panorama tools suite
   and some programs included here.

 - nona, a simple stitcher that does geometrical and photometric
    distortions to photos and writes the output to image files.
    It is a replacement for PTStitcher (doesn't support most
   features of PTStitcher, but is faster, opensource and
   will be extended in the future).  The parameters, mostly
   backward-compatible to PTStitcher, are specified in a .pto 
   project such as those generated by hugin, i.e. nona doesn't
   decide what the distortions are going to be, it just does 
   what it is told to do.
 - nona_gui, nona with a graphical progress bar.

 - autooptimiser, optimise a panorama pairwise, starting from an
   anchor image. cmd line version of the pairwise mode in hugin

These programs are built on top of the pano13 library,


Hugin is work in progress and dependencies can be added any time.

Hugin depends on the following packages. The list may be
incomplete, and there may be some platform-specific dependencies.

For the latest updates, check

3.1. Build-Time Dependencies

Users compiling Hugin from source will need:

    The wxWidgets GUI toolkit version >=2.7.0. 2.9 support is experimental. 2.8.11 is recommended.
    boost >=1.40. The following boost libraries are used:
    libtiff the TIFF library with LZW support.
    libpano13 version >=2.9.18
    libjpg the JPEG library
    libpng the PNG library
    libopenexr the OpenEXR library
    Exiv2 Image metadata library
    GLEW the OpenGL Extension Wrangler Library
    freeglut or glut, the OpenGL utility toolkit
    optionally, lapack
    on Unix you need also
        libGLU the OpenGL utility library
    on Windows you need
        HTML Help Workshop for generating compiled HTML help file    
    for the optional Python Scripting Interface (currently functional and tested only on Linux and Windows)
        Python version >=2.6
        SWIG >=2.0 - If Python >=3.2, SWIG must be >=2.0.4
    Hugin can be compiled with gcc-4.4.4, gcc-4.5.1, and gcc-4.6, as well as with MSVC 2008 and MSVC 2010.
    The build process requires CMake version >=2.8

3.2. At runtime

    enblend >= 3.2 is required.
    Exiftool is recommended.
    Starting with Hugin 2010.3 and newer, Hugin ships with its own control points generator cpfind. Prior to 2010.3 another optional but recommended runtime dependency was a control points generator.
    Optionally Python argparse command-line parsing library for the Python scripts. 

4. USE
hugin can be used to stitch multiple images together. The resulting image can
span 360 degrees. Another common use is the creation of very high resolution
pictures by combining multiple images.

See for more information and tutorials.

for some information on releases for different platforms.


  1. load images
  2. specify initial parameters (lens etc)
  3. select control points points.
  4. run optimizer to estimate image positions
  5. set output parameters and stitch images together.


Check the Hugin FAQ and bug tracker

An updated list of issues deemed to be critical,
including discussions and workarounds, is in the issue tracker

Linux: Compiz interferes with the fast preview window.
If you're affected, the workaround is to not use Compiz.

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.


Please use the hugin-ptx mailing list if you have questions or suggestions: