Hugin Main window

From PanoTools.org Wiki
(Difference between revisions)
Jump to: navigation, search
m (Images)
(Hugin Main window: first save of 2013 Simple user interface)
Line 1: Line 1:
 +
{| style="margin: 1em auto 1em 1em;background:#FFFF99;color:#FF0000;text-align:left;border: solid #FF3300;"
 +
|-valign="top"
 +
! '''2013-01-23:'''
 +
! Currently these pages are completely rewritten to reflect the state of the new designed GUI which will be released in 2013
 +
|}
 +
 
= Tabs =
 
= Tabs =
  
Line 4: Line 10:
 
tool for assembling multiple photos and creating a 'seamless' panorama.
 
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.
+
Hugin is a program that is 'tab' based. Below you see an partial example screen of Hugin showing the tabs.
[[Image:Hugin_tabs.png]]
+
[[Image:hugin2013_tabs.png]]
  
 
This process of assembling multiple photos and creating a 'seamless' panorama is completely automatic  
 
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,  
 
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. For this '''hugin''' provides three user interface options: Simple, Advanced and Expert.
So '''hugin''' divides up the various stages and presents them as ''tabs''
+
The '''hugin''' simple mode consists of the [[hugin Assistant tab]] and a few other tabs that give you simple control on what you are doing.
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,
+
This is a quick overview of this ''tab'' system for the ''Simple'' interface, it isn't a step by step tutorial,
 
you can find these on the [http://hugin.sourceforge.net/tutorials/ hugin website].
 
you can find these on the [http://hugin.sourceforge.net/tutorials/ hugin website].
 +
 +
For this same overview regarding the old gui you can start with [[Hugin Main window old gui]]
  
 
== Assistant ==
 
== Assistant ==
Line 25: Line 30:
  
 
Alternatively, you can use this '''Assistant''' as the first step in creating a
 
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:
+
project that will involve the use some or all of the other tabs. You can also switch to one of the other
 +
user interface modes Advanced and Expert if you want or need to.
  
== Images ==
+
== Preview ==
  
In the [[hugin Images tab]] you can add or remove photos to and from your project.
+
In the [[hugin Preview tab]] you have some options to modify the preview as displayed in the [[Hugin Assistant tab]]  
The table in the middle also shows the positions in the final scene for each of the
+
like selectivelydisplaying/hiding images and modify some view options.
images. These positions are actually angles for [[roll]], [[pitch]] and [[yaw]].
+
  
Although you can enter these positions manually here, you are more likely to
+
== Layout ==
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 ==
+
== Projection ==
  
Photos have properties that need to be known in order to assemble them
+
== Move/Drag ==
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 ==
 
== Crop ==
Line 63: Line 54:
 
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 ==
 
 
[[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'''.
 
 
In addition to the '''Control Points tab''' the [[hugin Control Points table]]
 
is used to manage pairs of '''control points'''.
 
 
'''control points''' can be created automatically in the '''Align''' section
 
of the [[hugin Assistant tab]] or with the '''Feature Matching''' section
 
of the [[hugin Images tab]].
 
 
== Optimizer ==
 
 
[[hugin]] uses a photo alignment scheme where it adjusts image orientation
 
and lens settings of source photos until the [[control points]] line-up,
 
this process is called ''optimisation'' and the '''hugin Optimizer tab'''
 
is where it is controlled.  You actually ''create'' individual
 
'''control points''' in the [[hugin Control Points tab]], and ''manage''
 
them in the [[hugin Images tab]] and [[hugin Control Points table]].
 
 
== Exposure ==
 
 
Photos in a project can have differences in exposure or white balance, either because of
 
natural changes in lighting or from settings in the camera itself.
 
 
The [[hugin Exposure tab]] corrects these ''photometric'' variations by looking
 
at pairs of overlapping photos and modelling a system of [[camera response curve]],
 
'''exposure''', '''white balance''' and [[vignetting]] that fits the photos.
 
 
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.
 
  
 
= Menus =
 
= Menus =
Line 120: Line 63:
 
* '''Save''' the current project as a hugin ''pto'' file.
 
* '''Save''' the current project as a hugin ''pto'' file.
 
* '''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'''.
 
 
* '''Most recently used projects''', shows a list of recent Hugin projects.
 
* '''Most recently used projects''', shows a list of recent Hugin projects.
* '''Send to batch''', adds the current project to the [[Hugin Batch Processor]] stitching queue.
 
 
* '''Run Batch Processor''', launches the [[Hugin Batch Processor]] GUI queue manager, note that the queue won't be processed unless this queue manager is running.
 
* '''Run Batch Processor''', launches the [[Hugin Batch Processor]] GUI queue manager, note that the queue won't be processed unless this queue manager is running.
* '''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.
 
 
* '''Preferences''' opens the [[hugin Preferences]] window.
 
* '''Preferences''' opens the [[hugin Preferences]] window.
 
* '''Quit''' hugin.
 
* '''Quit''' hugin.
Line 133: Line 72:
 
* '''Undo''', undoes the most recent change to the current project.
 
* '''Undo''', undoes the most recent change to the current project.
 
* '''Redo''', redoes an undo.
 
* '''Redo''', redoes an undo.
 
* '''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]].
 
* '''Add Image''' to the current project.
 
  
 
== View ==
 
== View ==
  
 +
* '''Panorama Editor''' opens the Editor window where you have control over the various states a workflow is going through from a set of source images to the panorama.
 
* '''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.
 
* '''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.
* '''Control point table''' shows the [[Hugin Control Points table]].
+
* '''Overview''' shows the [[Hugin Control Points table]].
* '''Preview window''' shows the [[Hugin Preview window]].
+
* '''Grid''' 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]].
+
== Interface ==
* '''Camera and Lens''' shows the [[Hugin Camera and Lens tab]].
+
 
* '''Crop''' shows the [[Hugin Crop tab]].
+
* '''Simple''', This is the user interface this introduction is written for. It consists of all basic functionality to create a program and will suffice in 90% of all cases.
* '''Mask''' shows the [[Hugin Mask tab]].
+
* '''Advanced''', this user interface that starts hugin in the Panorama Editor screen. The simple interface is available in the background.
* '''Control Points''' shows the [[Hugin Control Points tab]].
+
* '''Expert''', this user interface also start hugin in the Panorama Editor screen and unleashes all the power and options of hugin.
* '''Optimizer''' shows the [[Hugin Optimizer tab]].
+
 
* '''Exposure''' shows the [[Hugin Exposure tab]].
+
* '''Stitcher''' shows the [[Hugin Stitcher tab]].
+
  
 
== Help ==
 
== Help ==
Line 164: Line 96:
 
* '''About''' shows the [[Hugin About window]].
 
* '''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.
 
* '''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.
 
= Buttons =
 
 
Above the row of tabs are a series of buttons for common commands:
 
 
== [[Image:Hugin_filenew.png]] New project ==
 
 
Discards the current project and starts a new empty project.
 
 
== [[Image:Hugin_fileopen.png]] Open project ==
 
 
Opens an existing [[hugin]], [[PTGUI]], [[PTAssembler]], [[autopano]] or [[autopano-sift]] project file.
 
 
== [[Image:Hugin_filesave.png]] Save project ==
 
 
Saves the current project as a hugin .pto file.
 
 
== [[Image:Hugin_filesaveas.png]] Save project as ==
 
 
Saves as a .pto file with a different name.
 
 
== [[Image:Hugin_undo.png]] Undo ==
 
 
Undoes the most recent change to the current project.
 
 
== [[Image:Hugin_redo.png]] Redo ==
 
 
Redoes an undo.
 
 
== [[Image:Hugin_edit_add.png]] Add image ==
 
 
Adds an image or photo to the current project.
 
 
== [[Image:Hugin_optimize.png]] Re-optimize ==
 
 
Re-optimises the current project.  This has exactly the same effect as clicking '''Optimize Now!''' in the [[hugin Optimizer tab]].
 
 
== [[Image:Gl_preview.png]] Fast Preview panorama ==
 
 
Shows the [[hugin Fast Preview window]].
 
 
== [[Image:Hugin_preview.png]] Preview panorama ==
 
 
Shows the [[hugin Preview window]].
 
 
== [[Image:Hugin_list.png]] Show control points ==
 
 
Shows the [[hugin Control Points table]].
 
 
== [[Image:Hugin_info.png]] About Hugin ==
 
 
Shows the hugin '''About''' pop-up window, this displays the current version and a list of contributors.
 
  
  
 
[[Category:Software:Hugin]]
 
[[Category:Software:Hugin]]

Revision as of 21:53, 23 January 2013

2013-01-23: Currently these pages are completely rewritten to reflect the state of the new designed GUI which will be released in 2013

Contents

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 tabs. Hugin2013 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. For this hugin provides three user interface options: Simple, Advanced and Expert. The hugin simple mode consists of the hugin Assistant tab and a few other tabs that give you simple control on what you are doing.

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

For this same overview regarding the old gui you can start with Hugin Main window old gui

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. You can also switch to one of the other user interface modes Advanced and Expert if you want or need to.

Preview

In the hugin Preview tab you have some options to modify the preview as displayed in the Hugin Assistant tab like selectivelydisplaying/hiding images and modify some view options.

Layout

Projection

Move/Drag

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.


Menus

File

  • New, discard the current project and start a new empty project.
  • Open an existing hugin, PTGUI, PTAssembler, autopano or autopano-sift project file.
  • Save the current project as a hugin pto file.
  • Save as a pto file with a different name.
  • Most recently used projects, shows a list of recent Hugin projects.
  • Run Batch Processor, launches the Hugin Batch Processor GUI queue manager, note that the queue won't be processed unless this queue manager is running.
  • Preferences opens the hugin Preferences window.
  • Quit hugin.

Edit

  • Undo, undoes the most recent change to the current project.
  • Redo, redoes an undo.

View

  • Panorama Editor opens the Editor window where you have control over the various states a workflow is going through from a set of source images to the panorama.
  • 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.
  • Overview shows the Hugin Control Points table.
  • Grid shows the Hugin Preview window.


Interface

  • Simple, This is the user interface this introduction is written for. It consists of all basic functionality to create a program and will suffice in 90% of all cases.
  • Advanced, this user interface that starts hugin in the Panorama Editor screen. The simple interface is available in the background.
  • Expert, this user interface also start hugin in the Panorama Editor screen and unleashes all the power and options of hugin.


Help

  • Help opens the hugin manual.
  • Tip of the day
  • Keyboard Shortcuts
  • FAQ, hugin 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.
Personal tools
Namespaces

Variants
Actions
Navigation
tools
Tools