tool for assembling multiple photos and creating a 'seamless' panorama.

tool for assembling multiple photos and creating a 'seamless' panorama.

−

This process is completely automatic if you use the [[hugin Assistant tab]],

+

Hugin is a program that is 'tab' based. Below you see an partial example screen of Hugin showing the button bar and the tabs.

+

[[Image:Hugin_tabs.png]]

+

+

This process of assembling multiple photos and creating a 'seamless' panorama is completely automatic

+

if you use the [[hugin Assistant tab]], which is the default tab,

but '''hugin''' also allows full manual control of every stage.

but '''hugin''' also allows full manual control of every stage.

So '''hugin''' divides up the various stages and presents them as ''tabs''

So '''hugin''' divides up the various stages and presents them as ''tabs''

Line 26:

Line 30:

In the [[hugin Images tab]] you can add or remove photos to and from your project.

In the [[hugin Images tab]] you can add or remove photos to and from your project.

−

The table in the middle also shows the positions in the final scene for each the

+

The table in the middle also shows the positions in the final scene for each of the

−

images, these positions are actually angles for [[roll]], [[pitch]] and [[yaw]].

+

images. These positions are actually angles for [[roll]], [[pitch]] and [[yaw]].

−

Although you could enter these positions manually here, you are more likely to

+

Although you can enter these positions manually here, you are more likely to

−

create [[control points]] in the [[hugin Control Points tab]] and then use the

+

create [[control points]] automatically with the builtin ''feature matcher'' which

−

''optimiser'' in the [[hugin Optimizer tab]] to position your images for you.

+

will try to find equal points in overlapping images automatically for you, after which

+

the ''optimiser'' in the [[hugin Optimizer tab]] positions your images for you.

+

In some cases the ''feature matcher'' doesn't detect correct overlapping points in which

+

case you can add [[control points]] manually in the [[hugin Control Points tab]].

== Camera and Lens ==

== Camera and Lens ==

Line 55:

Line 62:

The [[hugin Crop tab]] allows you to apply simple masks to ignore these

The [[hugin Crop tab]] allows you to apply simple masks to ignore these

areas from your photos.

areas from your photos.

+

+

== Mask ==

+

+

Often photos contain parts which should not be used in the final panorama (e.g. moving objects),

+

alternatively you may need to specifically include a distinctive feature (e.g. persons) in the final panorama.

+

+

The [[Hugin Mask tab]] allows you to mask these areas for inclusion or exclusion from the stitched panorama.

== Control Points ==

== Control Points ==

Line 107:

Line 121:

* '''Save as''' a ''pto'' file with a different name.

* '''Save as''' a ''pto'' file with a different name.

* '''Write PTStitcher script''', saves a simplified project file suitable for batch stitching with [[PTStitcher]], [[nona]] or [[PTmender]]. Note that [[nona]] can stitch a [[hugin]] project file directly, so this step is unnecessary when using '''nona'''.

* '''Write PTStitcher script''', saves a simplified project file suitable for batch stitching with [[PTStitcher]], [[nona]] or [[PTmender]]. Note that [[nona]] can stitch a [[hugin]] project file directly, so this step is unnecessary when using '''nona'''.

* '''Merge project''', can be used to merge another project with the current project: new photos will be added to the list of images, for duplicate photos only the control points are merged.

* '''Apply Template''', assigns parameters from an existing ''pto'' project to the current set of photos. Only position and [[Lens correction model|lens parameters]] are transferred, [[control points]] are ignored.

* '''Apply Template''', assigns parameters from an existing ''pto'' project to the current set of photos. Only position and [[Lens correction model|lens parameters]] are transferred, [[control points]] are ignored.

−

* '''Preferences''' opens the [[hugin Preferences]] window.

* '''Preferences''' opens the [[hugin Preferences]] window.

−

* '''Quit''' hugin.

* '''Quit''' hugin.

Line 120:

Line 135:

* '''Fine-tune all Points''' does the same as '''Fine-tune''' in the [[hugin Control Points tab]] except that all [[control points]] in the project are adjusted. Fine tune settings are set in the [[hugin Preferences]].

* '''Fine-tune all Points''' does the same as '''Fine-tune''' in the [[hugin Control Points tab]] except that all [[control points]] in the project are adjusted. Fine tune settings are set in the [[hugin Preferences]].

+

* '''Remove control points in masks''' removes all control points in regions which are masked on the [[Hugin Mask tab]].

* '''Optimize''', re-optimises the current project. This has exactly the same effect as clicking '''Optimize Now!''' in the [[hugin Optimizer tab]].

* '''Optimize''', re-optimises the current project. This has exactly the same effect as clicking '''Optimize Now!''' in the [[hugin Optimizer tab]].

Line 126:

Line 142:

== View ==

== View ==

−

* '''Control point table''' shows the [[hugin Control Points table]].

+

* '''Full Screen''' shows this '''Hugin Main window''' using as much screen space as possible without any window decorations. Note that the [[Hugin Fast Preview window]] can also be set as full screen.

−

* '''Preview window''' shows the [[hugin Preview window]].

+

* '''Control point table''' shows the [[Hugin Control Points table]].

+

* '''Preview window''' shows the [[Hugin Preview window]].

+

* '''Fast Preview window''' shows the [[Hugin Fast Preview window]].

+

* '''Assistant''' shows the [[Hugin Assistant tab]].

+

* '''Images''' shows the [[Hugin Images tab]].

+

* '''Camera and Lens''' shows the [[Hugin Camera and Lens tab]].

+

* '''Crop''' shows the [[Hugin Crop tab]].

+

* '''Mask''' shows the [[Hugin Mask tab]].

+

* '''Control Points''' shows the [[Hugin Control Points tab]].

+

* '''Optimizer''' shows the [[Hugin Optimizer tab]].

+

* '''Exposure''' shows the [[Hugin Exposure tab]].

+

* '''Stitcher''' shows the [[Hugin Stitcher tab]].

== Help ==

== Help ==

−

* '''About'''

* '''Help''' opens the [[hugin]] manual.

* '''Help''' opens the [[hugin]] manual.

* '''Tip of the day'''

* '''Tip of the day'''

* '''Keyboard Shortcuts'''

* '''Keyboard Shortcuts'''

* '''FAQ''', hugin [[hugin FAQ|Frequently asked questions]].

* '''FAQ''', hugin [[hugin FAQ|Frequently asked questions]].

+

* '''About''' shows the [[Hugin About window]].

+

* '''Donate''' opens the Hugin donation page, there is no obligation to donate. Any donations are used for travel and promotion costs related to Hugin development.

Tabs

Although there are many other uses, hugin is primarily a
tool for assembling multiple photos and creating a 'seamless' panorama.

Hugin is a program that is 'tab' based. Below you see an partial example screen of Hugin showing the button bar and the tabs.

This process of assembling multiple photos and creating a 'seamless' panorama is completely automatic
if you use the hugin Assistant tab, which is the default tab,
but hugin also allows full manual control of every stage.
So hugin divides up the various stages and presents them as tabs
in the main window. These tabs are roughly in the order of panorama
creation from left to right, though in practice fine-tuning a project can
involve some jumping around between tabs.

This is a quick overview of this tab system, it isn't a step by step tutorial,
you can find these on the hugin website.

Assistant

The hugin Assistant tab is the fully automatic part of hugin, here you can
load images, align them and stitch them into a panorama without having to use
any of the other tabs.

Alternatively, you can use this Assistant as the first step in creating a
project that will involve the use some or all of the other tabs:

Images

In the hugin Images tab you can add or remove photos to and from your project.
The table in the middle also shows the positions in the final scene for each of the
images. These positions are actually angles for roll, pitch and yaw.

Although you can enter these positions manually here, you are more likely to
create control points automatically with the builtin feature matcher which
will try to find equal points in overlapping images automatically for you, after which
the optimiser in the hugin Optimizer tab positions your images for you.
In some cases the feature matcher doesn't detect correct overlapping points in which
case you can add control points manually in the hugin Control Points tab.

Camera and Lens

Photos have properties that need to be known in order to assemble them
seamlessly, notably geometric properties such as field of view or
barrel distortion, plus photometric properties such as vignetting
or exposure.

Again, although you could enter parameters for these properties here in the
hugin Camera and Lens tab; hugin can estimate the field of view
from data stored in the photo by the camera, it can also use the optimisers
in the hugin Optimizer tab to calculate the geometric distortion, and in the
hugin Exposure tab to calculate photometric corrections.

Crop

Often photos contain parts that you don't want to be used. Typically
fisheye Projection images have a circular area in the middle with
a useless black area outside. Scanned images have edges that need to
be cropped away.

The hugin Crop tab allows you to apply simple masks to ignore these
areas from your photos.

Mask

Often photos contain parts which should not be used in the final panorama (e.g. moving objects),
alternatively you may need to specifically include a distinctive feature (e.g. persons) in the final panorama.

The Hugin Mask tab allows you to mask these areas for inclusion or exclusion from the stitched panorama.

Control Points

hugin stitches panoramas by matching identical features in different
photos, these features are defined by pairs of control points.
The hugin Control Points tab shows two photos at a time and allows
you to manually create and edit any pair of control points.

So for this to work, the photos in the project have to be already aligned. Align
photos by managing control points in the hugin Control Points tab and optimising
geometric image parameters in the hugin Optimizer tab.

Stitcher

The end result of a hugin project is an image file containing a panorama. The
final hugin Stitcher tab is where size and quality are set and where this output
file is created.

Write PTStitcher script, saves a simplified project file suitable for batch stitching with PTStitcher, nona or PTmender. Note that nona can stitch a hugin project file directly, so this step is unnecessary when using nona.