Tree [13794f] default /
 History

Read Only access


File Date Author Commit
 CMakeModules 2009-02-28 gkohlmeyer gkohlmeyer [d89630] Update of CMake files for boost 1.38.0
 admin 2003-11-16 dangelo dangelo [e81e87] small script to package the current cvs into a ...
 doc 2009-05-06 brunopostle brunopostle [13794f] man page updates
 mac 2009-05-02 harryvanderwolf harryvanderwolf [6ccf64] [OSX] some updates to XCode project to facilita...
 platforms 2009-02-26 erik_krause erik_krause [665ccb]
 src 2009-05-05 brunopostle brunopostle [f5829e] s/PTTiff2psd/PTtiff2psd/
 utils 2008-06-10 brunopostle brunopostle [fa9d67]
 whitepaper 2007-08-17 ippei ippei [689774] more documentation
 .cvsignore 2004-10-13 dwilkins42 dwilkins42 [8c3969] Remove last Makefiles and update .cvsignore files
 AUTHORS 2008-07-24 brunopostle brunopostle [4078c9] Update translation credits
 CMakeLists.txt 2009-04-26 tmodes tmodes [430892] Allow only one PTBatcherGUI instance, command l...
 COPYING 2004-10-12 dangelo dangelo [dc0140] switched to automake/autoconf.
 ChangeLog 2009-05-05 brunopostle brunopostle [3d60d6] Update ChangeLog for 0.8.0_rc1
 INSTALL_cmake 2008-01-15 dangelo dangelo [d5c5e9] Modified the CMake build system to build a bare...
 LICENCE 2003-04-06 dangelo dangelo [1b6fd0] Initial revision
 LICENCE_JHEAD 2005-07-18 dangelo dangelo [124339] Added licence files for JHEAD, move VIGRA_LICENCE
 LICENCE_VIGRA 2006-03-04 dangelo dangelo [8f0f49] merged vigra 1.4 version back into HEAD. Everyt...
 README 2009-02-10 brunopostle brunopostle [29a99e] Note that gnu make is required for stitching
 README_JP 2008-08-31 ippei ippei [f68055] Japanese documentation update
 README_WINDOWS 2008-03-31 brunopostle brunopostle [febe2b] Fix some dead links to the old mailing list
 TODO 2008-08-31 ippei ippei [abd15e] reset the old and obsolete TODO file

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 stich images together.


6. KNOWN ISSUES / INCOMPATIBILITIES

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 proprietry driver.

If you're affected, the workaround is to not use Compiz.


SUPPORT / COMMUNITY

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

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:





No, thanks