Difference between revisions of "Hugin"

Revision as of 09:24, 19 January 2013

Hugin is an Open Source panorama stitcher and graphical user interface (GUI) for Panorama tools. It also provides a number of additional components and command line tools.

About Hugin

Although Hugin is essentially a panorama stitcher, like other GUI front-ends it has a range of advanced features:

Among the Hugin workflow options, it is possible to correct exposure, Vignetting and White balance between photos; generate HDR, exposure fused or focus stacked output from bracketed photos; or use 16bit and HDR input data natively.

Photos can be digital or scanned, and taken with any kind of camera. A full range of lenses are supported, from simple cameraphones to obscure fisheye lenses. Hugin supports various output projections including a range of spherical, cartographic, and camera projections.

Hugin supports panoramas taken with multiple rows of photos, with or without bracketing. Bracketed photos can be handheld, taken using a DSLR bracketing function, or as consecutive panoramas shot at different EV exposure levels. Hugin can produce successful panoramas shot with cameras that always shoot using auto-exposure and auto-whitebalance.

hugin also supports the use of masks which means that you can exclude parts of images you don't want to appear in your panoramas, or include parts of image you specifically want to appear in your panoramas.

Hugin also uses a separate (background) panorama stitcher. This means that you can render a panorama in the PTBatcherGUI stich window, while working on the next panorama in hugin.

Starting with version 2011.2.0, Hugin is scriptable in Python. The scripting functionality is still in its infancy and requires more development and testing. For now it is available only in Linux and Windows, and currently there is no feedback from the plugin apart from it's success or failure, which is communicated in a dialog. If you're on Linux, you can start hugin from the command line and switch to the window you started it from while the plugin is running - then you'll see any console output it may produce.

Hugin homepage on SourceForge. Screenshots, Tutorials, Documentation and Links.
Hugin project summary page on SourceForge. Downloads.
Hugin on Launchpad. Bug database and Feature requests.
Hugin FAQ Frequently asked questions about Hugin.

User interface

Hugin components

The following tools are part of the Hugin suite:

hugin the gui front end.
nona a command-line replacement for PTStitcher.
fulla correction of barrel distortion, chromatic aberration and vignetting.
nona_gui a version of nona with simple GUI progress dialogs, similar to the windows version of PTStitcher.
autooptimiser a tool with the same interface as PTOptimizer except using pairwise optimization which doesn't require any manual pre-placement.
align_image_stack a tool to automate the process to align a stack of photos.
tca_correct a tool to automatically generate chromatic aberration correction parameters for use with fulla.
matchpoint feature identification.
pto2mk generation of Makefiles for command-line stitching.
pto_gen command line tool to generate project file from images
cpfind command line tool to find control points
linefind command line tool to find vertical features for leveling
icpfind command line tool for using heuristic control point matching like inside [[hugin]Hugin GUI]
cpclean command line tool to remove control points with improbable error distances
checkpto command line tool to examine project file and reports back the number of image chains present
pto_var command line tool to manipulate image variables
pto_lensstack command line tool to manipulate lens and stacks
calibrate_lens_gui automatic lens calibration using straight-line detection
vig_optimize command line tool to estimate photometric parameters.
hugin_hdrmerge merges multiple exposures to HDR using Khan anti-ghosting algorithm
hugin_stitch_project a GUI tool to stitch a single Hugin .pto project.
celeste_standalone removes cloud-like control points from project files.
PTBatcherGUI a GUI queue manager for stitching multiple Hugin projects.
PTBatcher command-line access to the Hugin Batch Processor stitching queue.
deghosting_mask Creates mask for removing ghosting in bracketed images
pano_modify Change output parameters of project file
pano_trafo Transform image coordinates
pto_merge Merges two or more Hugin project files
panoglview OpenGL panorama viewer stored in sourceforge SVN alongside hugin which must be built separately.
autopano-sift-C version of autopano-sift written in C, also needs to be built separately.

More information, documentation and tutorials are available on the project website.

Like other GUI front-ends, Hugin provides an easy-to-use unified point-and-click interface to a whole range of other command-line tools including:

autopano-sift, autopano-sift-C, panomatic or autopano for automatic creation of control points (note that an external control-point generator is no longer required by Hugin).
enblend and enfuse for seamless blending of output images.

The Hugin project also provides open source replacements for the small number of closed source components of Panorama tools, especially PTStitcher. A PTStitcher replacement called nona and a PTOptimizer replacement called autooptimiser have been developed, supporting their most important features.

Development

Hugin is Open Source, and like every community-developed software very much dependent on voluntary contributions of resources. If you have coding skills, you are welcome to look at the source code and contribute to it. Even if you don't have coding skills, you most likely have some skills that the project could use and you are more than welcome to contribute your time. The tasks requiring attention change frequently and so do the required skillset and resources. Find more about the development process.

External links

Hugin homepage for Screenshots, Tutorials, Documentation and Links.
Hugin Sourceforge project for Downloads.
Hugin's bug tracker for bug reports and feature requests.
Sourceforge HG to browse the Hugin source-code in Mercurial.
hugin-ptx GoogleGroup to contribute to development and peer support.

Supported operating systems

@@ Line 2: / Line 2: @@
 == About Hugin ==
-Like other [[GUI front-ends]], '''Hugin''' provides an easy-to-use unified point-and-click interface to a whole range of other command-line tools including:
-* [[autopano-sift]], [[autopano-sift-C]], [[panomatic]] or [[autopano]] for automatic creation of [[control points]].
+Although Hugin is essentially a panorama stitcher, like other [[GUI front-ends]] it has a range of advanced features:
-* [[nona]] for remapping input images and rendering output images.
-* [[enblend]] and [[enfuse]] for seamless blending of output images.
+Among the Hugin workflow options, it is possible to correct [[Exposure correction|exposure]], [[Vignetting]] and [[White balance]] between photos; generate [[HDR]],  [[w:Exposure Fusion|exposure fused]] or [[w:Focus stacking|focus stacked]] output from [[bracketing|bracketed]] photos; or use [[16bit]] and [[HDR]] input data natively.
+Photos can be digital or scanned, and taken with any kind of camera. A full range of lenses are supported, from simple cameraphones to obscure [[fisheye]] lenses.  Hugin supports various output [[projections]] including a range of spherical, cartographic, and camera projections.
+Hugin supports panoramas taken with multiple rows of photos, with or without bracketing.  Bracketed photos can be handheld, taken using a DSLR bracketing function, or as consecutive panoramas shot at different EV exposure levels.  Hugin can produce successful panoramas shot with cameras that always shoot using auto-exposure and auto-whitebalance.
+hugin also supports the use of masks which means that you can exclude parts of images you don't want to appear in your panoramas, or include parts of image you specifically want to appear in your panoramas.
-The Hugin project also provides open source replacements for the small number of closed source components of [[Panorama tools]], especially [[PTStitcher]].
+Hugin also uses a separate (background) panorama stitcher. This means that you can render a panorama in the PTBatcherGUI stich window, while working on the next panorama in hugin.
-A PTStitcher replacement called [[nona]] has been developed, supporting its most important features.
-Among the Hugin workflow options, it is possible to correct [[Exposure correction|exposure]], [[Vignetting]] and [[White balance]] between photos; generate [[HDR]],  [[w:Exposure fusion|exposure fused]] or [[w:Focus stacking|focus stacked]] output from [[bracketing|bracketed]] photos; or use [[16bit]] and [[HDR]] input data natively.
+Starting with version 2011.2.0, Hugin is scriptable in Python.  The scripting functionality is still in its infancy and requires more development and testing.  For now it is available only in Linux and Windows, and currently there is no feedback from the plugin apart from it's success or failure, which is communicated in a dialog. If you're on Linux, you can start hugin from the command line and switch to the window you started it from while the plugin is running - then you'll see any console output it may produce.
 * [http://hugin.sourceforge.net Hugin homepage] on SourceForge. Screenshots, Tutorials, Documentation and Links.
 * [http://sourceforge.net/projects/hugin Hugin project summary page] on SourceForge. Downloads.
 * [https://launchpad.net/hugin Hugin on Launchpad]. Bug database and Feature requests.
-* [[Hugin FAQ]] Frequently asked questions about Hugin
+* [[Hugin FAQ]] Frequently asked questions about Hugin.
 == User interface ==
@@ Line 37: / Line 41: @@
 * [[Hugin Reset Values window]]
 * [[Hugin Keyboard shortcuts]]
+* [[Hugin Scripting Interface]]
 == Hugin components ==
@@ Line 51: / Line 56: @@
 * [[MatchPoint|matchpoint]] feature identification.
 * [[pto2mk]] generation of Makefiles for command-line stitching.
-* [[cpclean]] command line tool to remove control points with improbable error distances
+* [[pto_gen]] command line tool to generate project file from images
 * [[cpfind]] command line tool to find control points
+* [[linefind]] command line tool to find vertical features for leveling
 * [[icpfind]] command line tool for using heuristic control point matching like inside [[hugin]Hugin GUI]
-* [[calibrate_lens]] automatic lens calibration using straight-line detection
+* [[cpclean]] command line tool to remove control points with improbable error distances
+* [[checkpto]] command line tool to examine project file and reports back the number of image chains present
+* [[pto_var]] command line tool to manipulate image variables
+* [[pto_lensstack]] command line tool to manipulate lens and stacks
+* [[calibrate_lens_gui]] automatic lens calibration using straight-line detection
 * [[vig_optimize]] command line tool to estimate photometric parameters.
 * [[hugin_hdrmerge]] merges multiple exposures to [[HDR]] using Khan anti-ghosting algorithm
@@ Line 60: / Line 70: @@
 * [[celeste_standalone]] removes cloud-like control points from project files.
 * [[Hugin Batch Processor|PTBatcherGUI]] a GUI queue manager for stitching multiple Hugin projects.
-* [[PTBatcher]] command-line access to the [[hugin Batch Processor]] stitching queue.
+* [[Hugin Batch Processor|PTBatcher]] command-line access to the [[Hugin Batch Processor]] stitching queue.
 * [[deghosting_mask]] Creates mask for removing ghosting in bracketed images
 * [[pano_modify]] Change output parameters of project file
@@ Line 68: / Line 78: @@
 * [[autopano-sift-C]] version of [[autopano-sift]] written in C, also needs to be built separately.
-More information, documentation and tutorials are available on the project website.
+More information, documentation and tutorials are available on the [http://hugin.sourceforge.net/ project website].
+Like other [[GUI front-ends]], '''Hugin''' provides an easy-to-use unified point-and-click interface to a whole range of other command-line tools including:
+* [[autopano-sift]], [[autopano-sift-C]], [[panomatic]] or [[autopano]] for automatic creation of [[control points]] (note that an external control-point generator is no longer required by Hugin).
+* [[enblend]] and [[enfuse]] for seamless blending of output images.
+The Hugin project also provides open source replacements for the small number of closed source components of [[Panorama tools]], especially [[PTStitcher]].
+A PTStitcher replacement called [[nona]] and a PTOptimizer replacement called [[autooptimiser]] have been developed, supporting their most important features.
 == Development ==