Difference between revisions of "Hugin Preferences"

From PanoTools.org Wiki
Jump to navigation Jump to search
(Chages in Hugin Assistant Setting)
(Changes in hugin 2009.2 and hugin 2009.4)
Line 101: Line 101:
  
 
{{clr}}
 
{{clr}}
 
+
= Control Points Detectors =
= Autopano =
 
 
 
 
[[hugin]] uses an external tool for automatically creating [[control points]] for a set of images either when:
 
[[hugin]] uses an external tool for automatically creating [[control points]] for a set of images either when:
  
Line 109: Line 107:
 
* or clicking '''Create control points''' in the [[hugin Images tab]].
 
* or clicking '''Create control points''' in the [[hugin Images tab]].
  
Set the pull down menu to use the default configuration for one of these external tools:
+
In list-box you can choose default Control point detector programs  such as :
  
 
* [[Autopano]] (by A. Jenny), closed source, available for Linux i386 and Windows 32bit.
 
* [[Autopano]] (by A. Jenny), closed source, available for Linux i386 and Windows 32bit.
 
* [[autopano-sift|Autopano-SIFT]] (by S. Nowozin), open source, available for Linux, Windows and OS X.
 
* [[autopano-sift|Autopano-SIFT]] (by S. Nowozin), open source, available for Linux, Windows and OS X.
 +
* [[autopano-sift-C]]  - part of hugin suite
 +
* [[Align image stack]]  - part of hugin suite
 +
* [[Match-n-shift]]
 +
* [[MatchPoint]]
 +
* [[Panomatic]] (by Anael Orlinski)
 +
 +
Actually some of them are predefined as a default value and you can add another similar tool .
  
Parameters for these tools can be customised or even switched to another similar tool (such as [[autopano-sift-C]]) in the remaining section. Typical tweaks might be to:
+
Parameters for these tools can be customized  in the '''Parameters for Control Point Detectors''' window, which you can open using ''Edit...'' or ''New...'' buttons. Typical tweaks might be to:
  
 
* Set ''--noransac'' for [[autopano-sift]] when using non-[[rectilinear Projection]] input images.
 
* Set ''--noransac'' for [[autopano-sift]] when using non-[[rectilinear Projection]] input images.
 
* Set ''--size'' for [[autopano-sift]] which by default downsizes images to 700 pixels before matching.
 
* Set ''--size'' for [[autopano-sift]] which by default downsizes images to 700 pixels before matching.
  
= Enblend =
+
= Stitching =
  
 
In the final stitching process [[nona]] reprojects and distorts images to fit, [[enblend]] takes these
 
In the final stitching process [[nona]] reprojects and distorts images to fit, [[enblend]] takes these
 
images as individual [[TIFF]] files and merges them using sophisticated seam positioning and blending into
 
images as individual [[TIFF]] files and merges them using sophisticated seam positioning and blending into
 
a single finished TIFF file.
 
a single finished TIFF file.
 +
 +
== Nona ==
 +
 +
Here you can set '''Default interpolator'' used during stitching.
 +
You can set '''Create cropped images by default'''  which will speed up stitching.
 +
'''Use GPU for remapping''' will activate currently experimental nona code to remap images using ''Graphical processor unit''.
 +
 +
== Enblend ==
  
 
The '''Use alternative Enblend program''' option allows you to use other tools with a similar interface
 
The '''Use alternative Enblend program''' option allows you to use other tools with a similar interface
Line 132: Line 145:
 
* '''-a'''                Pre-assemble non-overlapping images to speed up blending.  This is generally useful, but will slow blending in rare cases.
 
* '''-a'''                Pre-assemble non-overlapping images to speed up blending.  This is generally useful, but will slow blending in rare cases.
 
* '''-l number'''        Number of levels to use (1 to 29), larger numbers result in wider seams. E.g. setting 1 will result in a 2 pixel wide blend, 8 will result in a 256 pixel wide blend and you are extremely unlikely to want a blend level as high as 16.
 
* '''-l number'''        Number of levels to use (1 to 29), larger numbers result in wider seams. E.g. setting 1 will result in a 2 pixel wide blend, 8 will result in a 256 pixel wide blend and you are extremely unlikely to want a blend level as high as 16.
* '''-z'''                Use LZW compression.  The [[TIFF]] file format has a 2GiB limit (or 4GiB or 8GiB, depending on who you ask) so you will find this useful for large panoramas.
+
<!--* '''-z'''                Use LZW compression.  The [[TIFF]] file format has a 2GiB limit (or 4GiB or 8GiB, depending on who you ask) so you will find this useful for large panoramas.-->
 
* '''-b kilobytes'''      Image cache block size (default=2MiB)
 
* '''-b kilobytes'''      Image cache block size (default=2MiB)
 
* '''-c'''                Use CIECAM02 to blend colors.  Your input images need to have embedded [[Colour profile|colour profiles]] for this to work.
 
* '''-c'''                Use CIECAM02 to blend colors.  Your input images need to have embedded [[Colour profile|colour profiles]] for this to work.
Line 141: Line 154:
 
Note that setting '''Additional arguments''' here will only effect new projects, to change [[enblend]] and [[enfuse]] settings for the current project use the [[hugin Stitcher tab]].
 
Note that setting '''Additional arguments''' here will only effect new projects, to change [[enblend]] and [[enfuse]] settings for the current project use the [[hugin Stitcher tab]].
  
= Enfuse =
+
== Enfuse ==
  
If '''Exposure Blending''' is selected in the [[hugin Stitcher tab]] then [[enfuse]] will be used to merge bracketed exposures during stitching.
+
If one of '''Exposure fusion'''output options is selected in the [[hugin Stitcher tab]] then [[enfuse]] will be used to merge bracketed exposures during stitching.
  
 
= Celeste =
 
= Celeste =

Revision as of 02:15, 14 October 2009

General

Resource usage

To speed things up hugin keeps a copy in memory of as many input photos as possible. With very large projects, this would use all your system memory, so set Image cache memory to a value below your available free RAM. The default of 200MB should be ok for a system with 512MB of RAM.

The hugin Preview window is multi-threaded so can use more than one CPU/core if required. Set Number of CPUs to how many CPUs you wish to use.

User interface

Usually, hugin will use the current locale to determine the language of buttons, menus etc... Set the Language if you need to switch languages temporarily or if you are using a platform such as Windows95 that doesn't support localised software. hugin won't change language immediately, you will need to stop and restart it.

File options

Some hugin actions generate large temporary files, change the Tempdir to specify an alternative location for writing these files. One reason for setting this independently from the operating system would be to use a RAM disk to speed up stitching.


Assistant

The Hugin Assistant tab automates the entire panorama creation process, these settings allow you to customise the assistant.

Image loading

Select Automatically align images after loading to run the second Align... step immediately after loading the images.

Automatic control point checking after detecting control points

Select Remove cloud-like control points (Celeste) to run celeste after detecting control points. It will try to detect and remove control points in sky parts of the image, because in current control point detectors they are often mismatched.

Select Remove outlying control points by statistical method to run automatic statistical analyzer, which will try to remove control points, whose positions greatly disturbs pairwise matching of images.

Auto align

Auto align uses autopano-sift or autopano to generate control points between pairs of images, set Number of Ctrl Points per overlap to control the number of control points. Note that although most pictures can be stitched with just three or four control points, automatically generated points tend not to be very evenly distributed, so this number should be set to ten or more

The size of the output Panorama Image Size is usually set in the Hugin Stitcher tab where it is also possible to Calculate Optimal Size based on the sizes of the input images. The Auto align process does something similar, though here you can set a smaller output as a percentage. Generally setting a percentage of 70% leads to no great loss of quality due to the way a camera CCD samples data.

Show preview

You can choose Nothing for no preview at all, Fast Preview Window or Preview Window to show after previous steps.



Control Points Editor

HDR and 16bit display mode

hugin supports both HDR and 16bit imaging. These image formats contain a lot more brightness and colour information than can be displayed on a standard computer monitor, so hugin only shows a rough representation of these pictures.

16bit data can have linear or corrected gamma. Linear images appear very dark on many monitors, so set the Curve to gamma 2.2.

For HDR data, try setting the Curve to logarithmic.

Changes to the HDR and 16bit display mode require restarting hugin to take effect.

Finetune

hugin helps position control points to within a fraction of a pixel distance automatically:

  • Patch width, the size of the square of pixels taken from the left photo to match with the right photo when picking control points, reduce if this is taking a long time on your system.
  • Search area width, the percentage area of the right photo that is searched when picking control points, reduce if this is taking a long time on your system.
  • Local search area width, the region of the right photo searched when you click Fine-tune in the hugin Control Points tab or Fine-tune all Points in the hugin Main window Edit menu.
  • Correlation Threshold. For each Fine-tune, hugin calculates the quality of the control points match, raise this threshold to reject dubious matches.
  • Peak Curvature Threshold, Currently unused.

Rotation search

Enable this if your photos:


Control Points Detectors

hugin uses an external tool for automatically creating control points for a set of images either when:

In list-box you can choose default Control point detector programs such as :

Actually some of them are predefined as a default value and you can add another similar tool .

Parameters for these tools can be customized in the Parameters for Control Point Detectors window, which you can open using Edit... or New... buttons. Typical tweaks might be to:

Stitching

In the final stitching process nona reprojects and distorts images to fit, enblend takes these images as individual TIFF files and merges them using sophisticated seam positioning and blending into a single finished TIFF file.

Nona

Here you can set 'Default interpolator used during stitching. You can set Create cropped images by default which will speed up stitching. Use GPU for remapping will activate currently experimental nona code to remap images using Graphical processor unit.

Enblend

The Use alternative Enblend program option allows you to use other tools with a similar interface such as smartblend or enblend-mask.

enblend supports a range of Additional arguments, for example you may want to set:

  • -a Pre-assemble non-overlapping images to speed up blending. This is generally useful, but will slow blending in rare cases.
  • -l number Number of levels to use (1 to 29), larger numbers result in wider seams. E.g. setting 1 will result in a 2 pixel wide blend, 8 will result in a 256 pixel wide blend and you are extremely unlikely to want a blend level as high as 16.
  • -b kilobytes Image cache block size (default=2MiB)
  • -c Use CIECAM02 to blend colors. Your input images need to have embedded colour profiles for this to work.
  • -m megabytes Use this much memory before going to disk (default=1GiB). Increase if you have a lot of memory on your system.
  • --fine-mask Enables detailed mask generation.
  • --no-optimize Turn off mask optimization.

Note that setting Additional arguments here will only effect new projects, to change enblend and enfuse settings for the current project use the hugin Stitcher tab.

Enfuse

If one of Exposure fusionoutput options is selected in the hugin Stitcher tab then enfuse will be used to merge bracketed exposures during stitching.

Celeste

Often a project has many control points attached to clouds in the sky, this is usually unwanted as clouds move between photos. celeste will attempt to identify 'sky' control points and delete them.