Hugin Preferences - Revision history

Thomas at 17:58, 6 February 2013

2013-02-06T17:58:35Z

Harryvanderwolf: /* Control Point Detectors */

2013-01-27T14:07:47Z

‎Control Point Detectors

Thomas at 09:46, 27 January 2013

2013-01-27T09:46:02Z

Bruno: /* Control Point Detectors */

2011-03-13T23:55:47Z

‎Control Point Detectors

Zarl: /* Troubleshooting */ Link to Hugin FAQ

2011-01-15T12:49:55Z

‎Troubleshooting: Link to Hugin FAQ

Zarl: /* Troubleshooting */ list sorting

2011-01-15T12:45:22Z

‎Troubleshooting: list sorting

Zarl: /* Celeste */ new paragraph "Troubleshooting" about resetting to defaults

2011-01-15T12:40:50Z

‎Celeste: new paragraph "Troubleshooting" about resetting to defaults

Zarl: /* User interface */ Mac OS X specific options

2010-09-21T14:32:28Z

‎User interface: Mac OS X specific options

James Legg: /* Nona */ grammar corrections

2010-07-23T03:09:03Z

‎Nona: grammar corrections

Thomas: /* Nona */ Added note about unsupported features from nona-gpu

2010-07-22T16:25:17Z

‎Nona: Added note about unsupported features from nona-gpu

@@ Line 5: / Line 5: @@
 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 256MB should be ok for a system with 512MB of RAM, however this is very conservative, for large projects you will want to set this to a high proportion of your available system memory.
-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.
+The [[Hugin Preview window|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 ==
@@ Line 15: / Line 15: @@
 The "language" option in the Hugin Preferences doesn't work for the Mac version. On Mac OS X the system's country settings will be used instead: change the language setting there (i.e. drag the preferred language to the top of the list), and Hugin will reflect that when you restart the program. An alternative but more time consuming way to set another language than the current system language is to quit Hugin, reveal it's icon in the Finder, click on it and open the Information window (Cmd.-I). After deselecting all unwanted language options you can start Hugin in your preferred language.
 == File options ==
@@ Line 21: / Line 25: @@
 Note that intermediate stitching files are created in the output folder and not in this '''Temporary dir'''.
 = Assistant =
-The [[Hugin Assistant tab]] automates the entire panorama creation process, these
+The [[Hugin Assistant tab|Assistant tab]] automates the entire panorama creation process, these
 settings allow you to customise the assistant.
@@ Line 40: / Line 49: @@
 == Auto align ==
-Auto align uses [[autopano-sift]] or [[autopano]] to generate [[control points]]
+Auto align uses the [[Hugin_Preferences#Control_Point_Detectors|default control point detector]] 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
+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'''
+[[Hugin Stitcher tab|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.
@@ Line 79: / Line 90: @@
 [[Hugin]] helps position [[control points]] to within a fraction of a pixel distance automatically:
-* When '''auto fine-tune''' is selected in the [[Hugin Control Points tab]] while picking control points.
+* When '''auto fine-tune''' is selected in the [[Hugin Control Points tab|Control Points tab]] while picking control points.
-* When clicking '''Fine-tune''' in the [[Hugin Control Points tab]]
+* When clicking '''Fine-tune''' in the [[Hugin Control Points tab|Control Points tab]]
-* When picking '''Fine-tune all Points''' in the [[Hugin Main window]] '''Edit''' menu.
+* When picking '''Fine-tune all Points''' in the [[Panorama_Editor_window|Panorama editor window]] '''Edit''' menu.
 * '''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.
+* '''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 [[Panorama_Editor_window|Panorama editor 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.
@@ Line 100: / Line 111: @@
 [[Hugin]] uses an internal or external tool for automatically creating [[control points]] for a set of images either when
 * clicking the '''2. Align...''' button in the [[Hugin Assistant tab]] or
-* clicking the '''Create control points''' button in the [[Hugin Images tab]].
+* clicking the '''Create control points''' button in the [[Hugin Photos tab|Photos tab]].
 ''Note: If you have upgraded from an older release of Hugin, you will need to '''Load Defaults''' to update these preferences.''
@@ Line 116: / Line 127: @@
 Parameters for these tools can be customized in the [[Hugin Parameters for Control Point Detectors dialog]] which you can access by clicking one of the buttons '''Edit...''' or '''New...'''.
-These [[Hugin Parameters for Control Point Detectors dialog|parameters]] are also helpful if you want to use a similar command line tool that isn't already listed. Click the '''New...''' button to configure a new preset to use in the [[Hugin Assistant tab|Assistant]] or the [[Hugin Photos tab|Photos]] tabs.
+These [[Hugin Parameters for Control Point Detectors dialog|parameters]] are also helpful if you want to use a similar command line tool that isn't already listed. Click the '''New...''' button to configure a new preset to use in the [[Hugin Assistant tab|Assistant]] or the [[Hugin Photos tab|Photos tabs]].
-The '''Set default''' button will mark the preset selected in this list box to be used automatically in the [[Hugin Assistant tab]] when clicking the '''2. Align...''' button.
+The '''Set default''' button will mark the preset selected in this list box to be used automatically in the [[Hugin Assistant tab|Assistant tab]] when clicking the '''2. Align...''' button.
 = Stitching =
@@ Line 124: / Line 135: @@
 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 and/or [[Exposure fusion]] into
-a single finished image file.
+a single finished image file. These processes can be hold together by [[PTBatcherGUI]] or [[hugin_stitch_project]]. Select here processor should be used:
 '''Important note:''' The settings here are the defaults for ''new projects'', change settings for the ''current project'' in the [[Hugin Stitcher tab]].
 == Nona ==
@@ Line 156: / Line 173: @@
 == Enfuse ==
-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.
+If one of '''Exposure fusion''' output options is selected in the [[Hugin Stitcher tab|Stitcher tab]] then [[enfuse]] will be used to merge bracketed exposures during stitching.
-= Celeste =
+= Misc =
 Often a project has many control points attached to clouds in the sky, this is usually unwanted as clouds move between photos. [[Using Celeste with hugin|celeste]] will attempt to identify 'sky' control points and delete them.
 = Troubleshooting =

@@ Line 105: / Line 105: @@
 In the '''Control Point Detector Programs''' list box you can choose between several presets such as:
-* '''[[cpfind|Hugin's CPFind]]''' - This is the new general purpose control point generator introduced with Hugin 2010.4.0.
+* '''[[cpfind|Hugin's CPFind]]''' - This is the internal general purpose control point generator of hugin.
-* '''Hugin's CPFind + Celeste''' - This is the same as the [[cpfind|CPFind]] setting plus points in areas of sky are removed using the [[celeste]] tool. See [[Using Celeste with hugin]] for more details.
+* '''Hugin's CPFind + Celeste''' - This is the same as the [[cpfind|CPFind]] setting but it will also remove points in areas of sky using the [[celeste]] tool. See [[Using Celeste with hugin]] for more details.
 * '''Cpfind (multirow/stacked)''' - This is the same as the [[cpfind|CPFind]] setting, except that [[Align image stack]] is used to match photos in [[bracketing|bracketed]] stacks.
-* '''[[autopano-sift-C]]''' - a C version of [[autopano-sift]], installed separately.
+* '''[[autopano-sift-C]]''' - a C version of [[autopano-sift]], wwhich needs to be installed separately.
-* '''[[Panomatic]] (by Anael Orlinski)''', installed separately.
+* '''[[Panomatic]] (by Anael Orlinski)''', which needs to be installed separately.
 * '''autopano-sift-c (multirow/stacked)''' - This is the same as the [[autopano-sift-C]] setting, except that [[Align image stack]] is used to match photos in [[bracketing|bracketed]] stacks.
-* '''[[Align image stack]]''' - part of Hugin suite. Note that align_image_stack is not a general purpose control point detector, but is very effective for aligning images within stacks.
+* '''[[Align image stack]]''' - part of Hugin suite. Note that align_image_stack is not a general purpose control point detector, but it is very effective for aligning images within stacks.
-* '''Align image stack FullFrameFisheye''' - This the same as the [[Align image stack]] setting above except with an addition setting suitable for fisheye images.
+* '''Align image stack FullFrameFisheye''' - This the same as the [[Align image stack]] setting above except with an additional setting suitable for fisheye images.
 Parameters for these tools can be customized in the [[Hugin Parameters for Control Point Detectors dialog]] which you can access by clicking one of the buttons '''Edit...''' or '''New...'''.

@@ Line 52: / Line 52: @@
 Generally setting a percentage of 70% leads to no great loss of quality due to
 the way a camera [[CCD]] samples data.
@@ Line 119: / Line 116: @@
 Parameters for these tools can be customized in the [[Hugin Parameters for Control Point Detectors dialog]] which you can access by clicking one of the buttons '''Edit...''' or '''New...'''.
-These [[Hugin Parameters for Control Point Detectors dialog|parameters]] are also helpful if you want to use a similar command line tool that isn't already listed. Click the '''New...''' button to configure a new preset to use in the [[Hugin Assistant tab|Assistant]] or the [[Hugin Images tab|Images]] tabs.
+These [[Hugin Parameters for Control Point Detectors dialog|parameters]] are also helpful if you want to use a similar command line tool that isn't already listed. Click the '''New...''' button to configure a new preset to use in the [[Hugin Assistant tab|Assistant]] or the [[Hugin Photos tab|Photos]] tabs.
 The '''Set default''' button will mark the preset selected in this list box to be used automatically in the [[Hugin Assistant tab]] when clicking the '''2. Align...''' button.

@@ Line 101: / Line 101: @@
 {{clr}}
 = Control Point Detectors =
-[[Hugin]] uses an external tool for automatically creating [[control points]] for a set of images either when
+[[Hugin]] uses an internal or external tool for automatically creating [[control points]] for a set of images either when
 * clicking the '''2. Align...''' button in the [[Hugin Assistant tab]] or
 * clicking the '''Create control points''' button in the [[Hugin Images tab]].
-In the '''Control Point Detector Programs''' list box you can choose between several presets such as
+''Note: If you have upgraded from an older release of Hugin, you will need to '''Load Defaults''' to update these preferences.''
-* [[autopano-sift-C]] - part of Hugin suite
-* [[Panomatic]] (by Anael Orlinski)
+In the '''Control Point Detector Programs''' list box you can choose between several presets such as:
-* [[Align image stack]]  - part of Hugin suite. Note that align_image_stack is not a general purpose control point detector, but is very effective for aligning images within stacks.
+* '''[[cpfind|Hugin's CPFind]]''' - This is the new general purpose control point generator introduced with Hugin 2010.4.0.
-* [[Match-n-shift]]
+* '''Hugin's CPFind + Celeste''' - This is the same as the [[cpfind|CPFind]] setting plus points in areas of sky are removed using the [[celeste]] tool. See [[Using Celeste with hugin]] for more details.
-* [[Autopano]] (by A. Jenny), closed source, available for Linux i386 and Windows 32bit.
+* '''Cpfind (multirow/stacked)''' - This is the same as the [[cpfind|CPFind]] setting, except that [[Align image stack]] is used to match photos in [[bracketing|bracketed]] stacks.
-* [[autopano-sift|Autopano-SIFT]] (by S. Nowozin), open source, available for Linux, Windows and OS X
+* '''[[autopano-sift-C]]''' - a C version of [[autopano-sift]], installed separately.
 Parameters for these tools can be customized in the [[Hugin Parameters for Control Point Detectors dialog]] which you can access by clicking one of the buttons '''Edit...''' or '''New...'''.

@@ Line 168: / Line 168: @@
 *Windows: '''(FIXME)'''
 Quit hugin, rename the preferences file (e.g. add the previous version number) and on the next start of hugin a new preferences file will be generated.
 {{clr}}
 [[Category:Software:Hugin]]

@@ Line 164: / Line 164: @@
 Sometimes when updating a hugin installation new features such as the settings for a new control point editor won't appear where expected. The cause might be a conflict with the preferences file of a previous version of hugin. A good idea before pressing the "Reset do defaults" button might be to back up the old preferences file since it is a plain text file that contains your specific settings in a readable format. Saving this file gives you the chance to recreate these individual settings later on. The name and location of the preferences file is this for the following platforms:
-*Mac OS X: "hugin Preferences" is in Macintosh HD/Users/<YourUserAccount>/Library/Preferences/
+*Linux: ".hugin" can be found in your home directory '''(FIXME)'''
-*Linux: .hugin in your home directory '''(FIXME)'''
+*Mac OS X: "hugin Preferences" can be found in ''Macintosh HD/Users/<YourUserAccount>/Library/Preferences/''
 *Windows: '''(FIXME)'''
 Quit hugin, rename the preferences file (e.g. add the previous version number) and on the next start of hugin a new preferences file will be generated.

@@ Line 8: / Line 8: @@
 == 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
+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.
 such as Windows95 that doesn't support localised software.  Hugin won't change language
-immediately, you will need to stop and restart it.
+The "language" option in the Hugin Preferences doesn't work for the Mac version. On Mac OS X the system's country settings will be used instead: change the language setting there (i.e. drag the preferred language to the top of the list), and Hugin will reflect that when you restart the program. An alternative but more time consuming way to set another language than the current system language is to quit Hugin, reveal it's icon in the Finder, click on it and open the Information window (Cmd.-I). After deselecting all unwanted language options you can start Hugin in your preferred language.
 == File options ==

@@ Line 131: / Line 131: @@
 You can '''Create cropped images by default''', these [[Cropped TIFF]] images will speed up stitching, but some image editors do not process the offsets correctly.
-'''Use GPU for remapping''' will activate experimental [[nona]] code to remap images using the shading language of the ''Graphics Processing Unit'' in modern video hardware. However not all projections and the translation parameters are not yet supported by this experimental code. In this case nona will automatic switch back to CPU calculation.
+'''Use GPU for remapping''' will activate experimental [[nona]] code to remap images using the shading language of the ''Graphics Processing Unit'' in modern video hardware. However some projections and the translation parameters are not yet supported by this experimental code. In this case Nona will automatically switch back to CPU calculation.
 == Enblend ==