Tree [ab98c3] cpfind_flann /
History



File Date Author Commit
CMakeModules 2010-12-16 tmodes tmodes [70a446] Merged
Debian 2010-10-08 Kornel Benko Kornel Benko [3fade0] Use postinst to call ldconfig after the install...
admin 2010-09-19 tmodes tmodes [419cd4] Merged gsoc2010-makefilelib-branch
artwork-src 2010-11-26 Matthew Petroff Matthew Petroff [95be15] Updated Windows icons and icon generation for W...
doc 2011-01-03 Kornel.Benko@berlin.de Kornel.Benko@berlin.de [35d17b] Don't care about outdated manuals
mac 2011-01-07 tmodes tmodes [a75c9f] Merged
platforms 2010-12-26 Yuval Levy Yuval Levy [b8615c] removed obsolete cruft
src 2011-01-14 Pablo d'Angelo Pablo d'Angelo [7cb44d] CircularKeyPointDescriptor: Fixed rotation of g...
utils 2010-12-26 Yuval Levy Yuval Levy [b8615c] removed obsolete cruft
whitepaper 2007-08-17 ippei ippei [689774] more documentation
.hgignore 2011-01-08 Pablo d'Angelo Pablo d'Angelo [0e4c4f] merged in flann branch
.hgtags 2010-11-27 Matthew Petroff Matthew Petroff [55b2db] Removed tag 2009.4beta1
AUTHORS 2009-11-06 yuv yuv [3a1fb7] removed reference to the web and fixed it to th...
CMakeLists.txt 2011-01-06 tmodes tmodes [8b3ff3] Updated required libpano13 version to 2.9.18
COPYING 2004-10-12 dangelo dangelo [dc0140] switched to automake/autoconf.
ChangeLog 2010-12-28 Matthew Petroff Matthew Petroff [db5e0c] Merge
INSTALL_cmake 2009-09-24 eduperez eduperez [4ded8c] Small typo corrected
LICENCE_VIGRA 2006-03-04 dangelo dangelo [8f0f49] merged vigra 1.4 version back into HEAD. Everyt...
README 2009-08-03 yuv yuv [e500f0] spelling fixes (clemty)
README_JP 2008-08-31 ippei ippei [f68055] Japanese documentation update
README_WINDOWS 2009-08-03 yuv yuv [e500f0] spelling fixes (clemty)
TODO 2008-08-31 ippei ippei [abd15e] reset the old and obsolete TODO file
authors.txt 2011-01-01 Yuval Levy Yuval Levy [280785] pano_trafo doesn't flush output (Bug/Patch #695...
cmake_uninstall.cmake.in 2009-07-26 yuv yuv [009f99] added uninstall target to CMake build

Read Me

1. GOAL

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


2. CONTENT

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,
http://panotools.sourceforge.net/


3. DEPENDENCIES

The following external programs are REQUIRED:

1. enblend 3.2 or later, this includes the enfuse tool
2. exiftool from the Image::ExifTool perl module
3. gnu make is required for stitching

The following external programs are highly recommended:

1. autopano-sift-C, panomatic, autopano or autopano-sift


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 http://hugin.sourceforge.net/ for more information and tutorials.

See http://wiki.panotools.org/Development_of_Open_Source_tools#Supported_Platforms
for some information on releases for different platforms.


5. TYPICAL WORKFLOW

  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.


6. KNOWN ISSUES / INCOMPATIBILITIES / LIMITATIONS

Linux: Compiz interferes with the 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
...until xorg has "Redirected direct rendering", which might take a long time.

It's not an issue with NVidia's proprietary driver.

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.


SUPPORT / COMMUNITY

Please use the hugin-ptx mailing list if you have questions or suggestions:
http://groups.google.com/group/hugin-ptx