Hugin Main window

From PanoTools.org Wiki
(Difference between revisions)
Jump to: navigation, search
(Exposure)
m (Numerous minor tweaks)
 
(37 intermediate revisions by 5 users not shown)
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 =
  
Although there are many other uses, [[hugin]] is primarily a
+
Although there are many other uses, [[Hugin]] is primarily a
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 a partial example screen of Hugin showing the tabs.
  
This process is completely automatic if you use the [[hugin Assistant tab]],
+
[[Image:hugin2013_tabs.png]]
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,
+
This process of assembling multiple photos and creating a "seamless" panorama is completely automatic
you can find these on the [http://hugin.sourceforge.net/tutorials/ hugin website].
+
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 (as displayed above) that give you simple but effective 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 tutorials on the [http://hugin.sourceforge.net/tutorials/ Hugin website].
 +
 
 +
For this same overview regarding the "old" user interface (but still the user interface of the current stable release), you can start with [[Hugin Main window old gui]].
  
 
== Assistant ==
 
== Assistant ==
  
The [[hugin Assistant tab]] is the fully automatic part of [[hugin]], here you can
+
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
 
load images, align them and ''stitch'' them into a panorama without having to use
 
any of the other tabs.
 
any of the other tabs.
 +
The [[Hugin Assistant tab]] also consists of a panoramic overview and a preview. This overview and preview are visible on the other tabs as well, be it with different functionality and sometimes slightly modified layout.
  
 
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 can involve the use of 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 options to check your images and positions, the white balance, control points (equal points in two overlapping images), ''etcetera''. Changes will immediately be displayed in this preview. This [[Hugin Preview tab]] is the same preview as displayed in the [[Hugin Assistant tab]] and all other tabs in the Simple User Interface.
The table in the middle also shows the positions in the final scene for each the
+
images, these positions are actually angles for [[roll]], [[pitch]] and [[yaw]].
+
  
Although you could enter these positions manually here, you are more likely to
 
create [[control points]] in the [[hugin Control Points tab]] and then use the
 
''optimiser'' in the [[hugin Optimizer tab]] to position your images for you.
 
  
== Camera and Lens ==
+
== Layout ==
  
Photos have properties that need to be known in order to assemble them
+
The Layout tab shows the entire project as a diagram with colour-coded lines connecting each of the photographs.
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
+
[[image:Hugin2013_layout_tab.png|thumb|300px|left|Screenshot of Layout tab; click for larger versions]]
[[hugin Camera and Lens tab]]; '''hugin''' can estimate the '''field of view'''
+
{{clr}}
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 ==
+
Green lines connecting images show the control points have a small error; red lines show a large error. Grey lines show no control points connecting the images.
  
Often photos contain parts that you don't want to be used.  Typically
+
You can see where the project is OK and where there are problems if it isn't quite right. Just click on any connection and Hugin jumps to the Control Points tab to edit that pair of photos.
[[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
+
Use the '''Scale''' slider to change the size of the photo thumbnails. This only affects the Layout display and won't change the final panorama.
areas from your photos.
+
  
== Control Points ==
+
== Projection ==
 +
The [[Hugin Projection tab]] is for adjusting the [[Projections|projection]] of the panorama; some projections have adjustable parameters that will appear when selected.
  
[[hugin]] stitches panoramas by matching identical features in different
+
== Move/Drag ==
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]]
+
The [[Hugin move drag tab|Hugin Move/Drag tab]] is used to recentre the panorama interactively (or place it for whatever reason off centre).
is used to manage pairs of '''control points'''.
+
  
'''control points''' can be created automatically in the '''Align''' section
+
== Crop ==
of the [[hugin Assistant tab]] or with the '''Feature Matching''' section
+
of the [[hugin Images tab]].
+
  
== Optimizer ==
+
The [[Hugin Crop tab]] displays a rectangle over your preview. By dragging the edges of this rectangle, you can adjust the output area of the panorama.
 
+
[[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 ==
+
 
+
TODO
+
  
 
= Menus =
 
= Menus =
Line 100: Line 68:
 
== File ==
 
== File ==
  
* '''New''', discard the current project and start a new empty project.
+
* '''New''': Discard the current project and start a new empty project.
* '''Open''' an existing [[hugin]], [[PTGUI]], [[PTAssembler]], [[autopano]] or [[autopano-sift]] project file.
+
* '''Open''' an existing [[Hugin]], [[PTGUI]], [[PTAssembler]], [[autopano]] or [[autopano-sift]] project file.
* '''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.
 
+
* '''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.
* '''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.
 
+
* '''Quit''' Hugin.
* '''Preferences''' opens the [[hugin Preferences]] window.
+
 
+
* '''Quit''' hugin.
+
  
 
== Edit ==
 
== Edit ==
  
* '''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]].
+
== View ==
  
* '''Optimize''', re-optimises the current project.  This has exactly the same effect as clicking '''Optimize Now!''' in the [[hugin Optimizer tab]].
+
* '''Panorama Editor''' opens the [[Hugin Panorama Editor window|Editor window]] where you have control over the various states a workflow is going through from a set of source images to the panorama.
* '''Add Image''' to the current project.
+
* '''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''' checkbox: Shows or hides the (docked) overview in the screen.
 +
* '''Grid''' checkbox: Shows or hides the grid in the overview and preview canvas (see [[ Hugin Assistant tab]]).
  
== View ==
+
== Interface ==
  
* '''Control point table''' opens the [[hugin Control Points table]].
+
* '''Simple''': This is the user interface this introduction is written for. It consists of all basic functionality to create a panorama and will suffice in 90% of all cases.
* '''Preview window''' opens the [[hugin Preview window]].
+
* '''Advanced''': This user interface starts Hugin in the Panorama Editor screen. The Simple interface is available in the background.
 +
* '''Expert''': This user interface also starts Hugin in the Panorama Editor screen and unleashes all the power and options of Hugin.
  
 
== 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]].
= Button bar =
+
* '''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.
 
+
TODO describe buttons
+
 
+
* '''New project'''
+
* '''Open project'''
+
* '''Save project'''
+
* '''Save project as'''
+
 
+
* '''Undo'''
+
* '''Redo'''
+
 
+
* '''Add image'''
+
* '''Re-optimize'''
+
 
+
* '''Preview panorama'''
+
* '''Show control points'''
+
  
* '''About Hugin'''
 
  
__NOTOC__
 
 
[[Category:Software:Hugin]]
 
[[Category:Software:Hugin]]

Latest revision as of 06:31, 28 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

[edit] 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 a 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 (as displayed above) that give you simple but effective 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 tutorials on the Hugin website.

For this same overview regarding the "old" user interface (but still the user interface of the current stable release), you can start with Hugin Main window old gui.

[edit] 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. The Hugin Assistant tab also consists of a panoramic overview and a preview. This overview and preview are visible on the other tabs as well, be it with different functionality and sometimes slightly modified layout.

Alternatively, you can use this Assistant as the first step in creating a project that can involve the use of 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.

[edit] Preview

In the Hugin Preview tab, you have options to check your images and positions, the white balance, control points (equal points in two overlapping images), etcetera. Changes will immediately be displayed in this preview. This Hugin Preview tab is the same preview as displayed in the Hugin Assistant tab and all other tabs in the Simple User Interface.


[edit] Layout

The Layout tab shows the entire project as a diagram with colour-coded lines connecting each of the photographs.

Screenshot of Layout tab; click for larger versions


Green lines connecting images show the control points have a small error; red lines show a large error. Grey lines show no control points connecting the images.

You can see where the project is OK and where there are problems if it isn't quite right. Just click on any connection and Hugin jumps to the Control Points tab to edit that pair of photos.

Use the Scale slider to change the size of the photo thumbnails. This only affects the Layout display and won't change the final panorama.

[edit] Projection

The Hugin Projection tab is for adjusting the projection of the panorama; some projections have adjustable parameters that will appear when selected.

[edit] Move/Drag

The Hugin Move/Drag tab is used to recentre the panorama interactively (or place it for whatever reason off centre).

[edit] Crop

The Hugin Crop tab displays a rectangle over your preview. By dragging the edges of this rectangle, you can adjust the output area of the panorama.

[edit] Menus

[edit] 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] Edit

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

[edit] 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 checkbox: Shows or hides the (docked) overview in the screen.
  • Grid checkbox: Shows or hides the grid in the overview and preview canvas (see Hugin Assistant tab).

[edit] Interface

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

[edit] 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