Hugin FAQ - Revision history

Thomas: /* Stitch fails when '&' is part of the Windows user-name */

2013-02-07T16:28:24Z

‎Stitch fails when '&' is part of the Windows user-name

Janmartin: /* Script Returned -11 */

2012-11-29T13:54:20Z

‎Script Returned -11

Harryvanderwolf: /* OS X 10.7 and Enblend / Enfuse */

2012-04-18T13:28:48Z

‎OS X 10.7 and Enblend / Enfuse

Harryvanderwolf: /* OSX: error when clicking on the help button */

2012-04-18T13:25:38Z

‎OSX: error when clicking on the help button

Zarl: /* OS X / iPhoto */ 10.7 Lion related bug added

2012-03-30T15:39:43Z

‎OS X / iPhoto: 10.7 Lion related bug added

Zarl: /* What is Python Scripting? */ typo

2012-03-30T15:22:40Z

‎What is Python Scripting?: typo

Zarl: /* OSX / iPhoto */ typo in headline

2012-03-30T15:22:18Z

‎OSX / iPhoto: typo in headline

Tracyb: Added example batch file to set temporary folder location on windows and, updated Stitch fails ... Windows username section

2012-02-25T09:17:40Z

Added example batch file to set temporary folder location on windows and, updated Stitch fails ... Windows username section

Zarl: /* Special Characters in Paths */ wikipedia link and a typo

2011-10-07T09:59:54Z

‎Special Characters in Paths: wikipedia link and a typo

Bruno: Patching nadir shots using XYZ mosaic mode

2011-10-06T22:43:20Z

Patching nadir shots using XYZ mosaic mode

@@ Line 200: / Line 200: @@
 Work-around: See the Temporary Folders section above, or Move your hugin data to a folder in the root directory such as C:\hugin.  Then go to the Windows Control Panel and change ''System, Advanced, Environment, user TMP'' to a folder in the root, such as 'C:\temp' (create it if necessary).
-Notes:  This work-around probably needs Win 7 ''Administrator'' privileges.
+Notes:  On Windows 7 go to Start>Control Panel>User Account>Change my environment variables and change the variables TEMP and TMP accordingly.
 A simpler solution should be to set hugin ''File, Preferences, Temporary dir'' to C:\hugin; but it doesn't fix

← Older revision		Revision as of 13:54, 29 November 2012
Line 271:		Line 271:

	The plugin failing with an exception. Ask the plugin maintainer to produce more specific error messages. It is good practice to catch such exceptions and let the user know what dependency is missing.		The plugin failing with an exception. Ask the plugin maintainer to produce more specific error messages. It is good practice to catch such exceptions and let the user know what dependency is missing.
		+
		+	On Ubuntu this most often is caused by 'tiffdump missing'.
		+	Fix:
		+	sudo apt-get install libtiff-tools
		+
		+	To find other errors start hugin from the Terminal, then repeat ysour steps and check the output in the Terminal.

	=== Why do I read of users having access to a certain action and I don't see it on my system? ===		=== Why do I read of users having access to a certain action and I don't see it on my system? ===

@@ Line 215: / Line 215: @@
 === OS X 10.7 and Enblend / Enfuse ===
-When using Hugin on Mac OS X 10.7 ''Lion'' with the built-in versions of enblend and enfuse (i.e. those packaged inside the hugin bundle) the stitching process will stop abruptly with an error. See [https://bugs.launchpad.net/hugin/+bug/814280 bug 814280]. The workaround is to use the enblend and enfuse versions for Mac OS X 10.4 ''Tiger'' that are inside the dmg in the ''enblend-enfuse-4.0'' folder.
+When using Hugin on Mac OS X 10.7 ''Lion'' with the built-in versions of enblend and enfuse (i.e. those packaged inside the hugin bundle) the stitching process will stop abruptly with an error. See [https://bugs.launchpad.net/hugin/+bug/814280 bug 814280]. The workaround is to use the enblend and enfuse versions for Mac OS X 10.4 ''Tiger'' that are inside the dmg in the ''enblend-enfuse-4.0'' folder.<br>
 === Fast Preview ===

← Older revision		Revision as of 13:25, 18 April 2012
Line 128:		Line 128:
	Hugin is fully internationalised and can cope with special characters in file paths. However, hugin apparently fails on some Windows systems with Polish, Japanese, Russian or Czech codepages, the workaround is to use shell-safe ascii characters in file and folder names: '''A B C D E F G H I J K L M N O P Q R S T U V W X Y Z a b c d e f g h i j k l m n o p q r s t u v w x y z 0 1 2 3 4 5 6 7 8 9 - _ .''' This includes the path for the temporary folder which is named after your username on Windows systems.		Hugin is fully internationalised and can cope with special characters in file paths. However, hugin apparently fails on some Windows systems with Polish, Japanese, Russian or Czech codepages, the workaround is to use shell-safe ascii characters in file and folder names: '''A B C D E F G H I J K L M N O P Q R S T U V W X Y Z a b c d e f g h i j k l m n o p q r s t u v w x y z 0 1 2 3 4 5 6 7 8 9 - _ .''' This includes the path for the temporary folder which is named after your username on Windows systems.

−	~~=== OSX: error when clicking on the help button ===~~

−	In a language other than English, French or Italian you get an error message when clicking on the help button. This will be fixed in Hugin-2009.4.0. In the meantime, the work around is to change language to one of the above three; or to ask for help on the mailing list.

	=== Non-Unique Filenames ===		=== Non-Unique Filenames ===

@@ Line 211: / Line 211: @@
 This is a known limitation caused by photos being distorted into extreme 'C' and 'O' shapes. The workaround: stitch all of your pictures into a single equirectangular, and then load the equirectangular into Hugin to generate the stereographic or other projections you wanted to do in the first place.
-=== OS X / iPhoto ===
+=== OS X and iPhoto ===
 Dragging the photos from iPhoto to Hugin works perfectly as long as there is no forward slash in the Name of the events in iPhoto (which translates to folders inside the iPhoto Database).
 === Fast Preview ===

@@ Line 240: / Line 240: @@
 === What is Python Scripting? ===
-Python is a powerful scripting language.  Starting with Hugin 2011.2, Hugin exposes the panorama object through hsi.py in Python.  It must be explicitly activated at build time with the CMake boolean parameter -DBUILD_HSI:BOOL=ON.  It is currently untested / unavailable on OSX.
+Python is a powerful scripting language.  Starting with Hugin 2011.2, Hugin exposes the panorama object through hsi.py in Python.  It must be explicitly activated at build time with the CMake boolean parameter -DBUILD_HSI:BOOL=ON.  It is currently untested / unavailable on OS X.
 === How do I start Scripting? ===

@@ Line 148: / Line 148: @@
 TMPDIR=/media/disk-2/tmp hugin &
 </pre>
 These temporary files have to be deleted manually after the stitch.
@@ Line 182: / Line 196: @@
 Please don't use the above characters in your files and folders when you want to make sure they work with Hugin. If you absolutely need files named this way, rename them after processing. Do not file bug reports based on filenames with the above characters. The [https://sourceforge.net/tracker/?func=detail&atid=550441&aid=2883450&group_id=77506 issue] is known, analyzed, and may be fixed in the future.
-=== Stitch fails when '&' is part of the Windows 7 ''user-name'' ===
+=== Stitch fails when '&' is part of the Windows ''user-name'' ===
 This is a variant of the above, but more difficult to work around.  The ''user-name'' is part of all paths in the user's data area, including the temporary file locations defined by TMP and TEMP.  Stitch fails almost immediately with a make path error.
-Work-around: Move your hugin data to a folder in the root directory such as C:\hugin.  Then go to the Windows Control Panel and change ''System, Advanced, Environment, user TMP'' to a folder in the root, such as 'C:\temp' (create it if necessary).
+Work-around: See the Temporary Folders section above, or Move your hugin data to a folder in the root directory such as C:\hugin.  Then go to the Windows Control Panel and change ''System, Advanced, Environment, user TMP'' to a folder in the root, such as 'C:\temp' (create it if necessary).
 Notes:  This work-around probably needs Win 7 ''Administrator'' privileges.
@@ Line 196: / Line 210: @@
 This is a known limitation caused by photos being distorted into extreme 'C' and 'O' shapes. The workaround: stitch all of your pictures into a single equirectangular, and then load the equirectangular into Hugin to generate the stereographic or other projections you wanted to do in the first place.
 === OSX / iPhoto ===

@@ Line 178: / Line 178: @@
 |}
-Hugin currently does not do plausibility checks on the paths and file names that are given to it. It relies on the operating system's conventions and limitations. However Hugin uses make to run the stitching process, and make has more restrictive limitation than the operating system.
+Hugin currently does not do plausibility checks on the paths and file names that are given to it. It relies on the operating system's conventions and limitations. However Hugin uses [http://en.wikipedia.org/wiki/Make_%28software%29 make] to run the stitching process, and make has more restrictive limitations than the operating system.
 Please don't use the above characters in your files and folders when you want to make sure they work with Hugin. If you absolutely need files named this way, rename them after processing. Do not file bug reports based on filenames with the above characters. The [https://sourceforge.net/tracker/?func=detail&atid=550441&aid=2883450&group_id=77506 issue] is known, analyzed, and may be fixed in the future.

← Older revision		Revision as of 22:43, 6 October 2011
Line 214:		Line 214:

	Unfortunately the Hugin Makefile system only supports restarting if you stitch on the command-line. The GUI tools always create new temporary .pto project and Makefile files every time they stitch, so this forces make to recreate everything for every stitch.		Unfortunately the Hugin Makefile system only supports restarting if you stitch on the command-line. The GUI tools always create new temporary .pto project and Makefile files every time they stitch, so this forces make to recreate everything for every stitch.
		+
		+	=== Patching nadir shots using XYZ mosaic mode cuts the photos in half ===
		+
		+	"If an image is mapped to the [[nadir]] of a panorama and all translation parameters (X,Y,Z) are set to zero, the image is properly mapped and covers the entire nadir of the shot. However, if any of the X,Y,Z parameters are non-zero, then the image is cut in half and only occupies half of the nadir."
		+
		+	Basically the XYZ mosaic mode as it is implemented currently in [[Hugin]] requires that the mosaic photos must be mapped to a plane perpendicular to the view direction - In practice this means that what you are trying to do only works if the panorama is rotated such that the nadir is in the middle of the canvas and not at the bottom.
		+
		+	This isn't so bad, the nadir-in-the-middle image looks a bit weird, you can just reload the stitched [[equirectangular Projection]] result into a new single-photo project and straighten it there.

	== Python Scripting ==		== Python Scripting ==