README
11. GOAL
2
3Toolchain to create panoramic images for every occasion,
4from quick holiday snaps to images with hundreds of megapixels.
5
6
72. CONTENT
8
9This package contains the following programs:
10
11 - hugin, the main program, a GUI for the panorama tools suite
12 and some programs included here.
13
14 - nona, a simple stitcher that does geometrical and photometric
15 distortions to photos and writes the output to image files.
16 It is a replacement for PTStitcher (doesn't support most
17 features of PTStitcher, but is faster, opensource and
18 will be extended in the future). The parameters, mostly
19 backward-compatible to PTStitcher, are specified in a .pto
20 project such as those generated by hugin, i.e. nona doesn't
21 decide what the distortions are going to be, it just does
22 what it is told to do.
23
24 - fulla correction of barrel distortion, chromatic aberration
25 and vignetting.
26
27 - autooptimiser, optimise a panorama pairwise, starting from an
28 anchor image. cmd line version of the pairwise mode in hugin
29
30 - align_image_stack a tool to automate the process to align
31 a stack of photos.
32
33 - tca_correct a tool to automatically generate chromatic
34 aberration correction parameters for use with fulla.
35
36 - hugin_executor for command-line stitching or running assistant.
37
38 - pto_gen command line tool to generate project file from images.
39
40 - cpfind command line tool to find control points.
41
42 - linefind command line tool to find vertical features for leveling.
43
44 - geocpset command line tool to connect featureless images by
45 "geometric" control points.
46
47 - icpfind command line tool for using heuristic control point
48 matching like inside Hugin GUI
49
50 - cpclean command line tool to remove control points with improbable
51 error distances
52
53 - checkpto command line tool to examine project file and reports back
54 the number of image chains present
55
56 - pto_var command line tool to manipulate image variables
57
58 - pto_lensstack command line tool to manipulate lens and stacks
59
60 - pto_mask command line tool to add mask to project file
61
62 - pto_template command line tool to apply template to project file
63
64 - calibrate_lens_gui automatic lens calibration using straight-line
65 detection
66
67 - vig_optimize command line tool to estimate photometric parameters.
68
69 - hugin_hdrmerge merges multiple exposures to HDR using Khan
70 anti-ghosting algorithm
71
72 - hugin_stitch_project a GUI tool to stitch a single Hugin .pto project.
73
74 - celeste_standalone removes cloud-like control points from project files.
75
76 - PTBatcherGUI a GUI queue manager for stitching multiple Hugin projects.
77
78 - deghosting_mask Creates mask for removing ghosting in bracketed images
79
80 - pano_modify Change output parameters of project file
81
82 - pano_trafo Transform image coordinates
83
84 - pto_merge Merges two or more Hugin project files
85
86 - pto_move Moves Hugin project files with associated images
87
88 - lensdb Maintenance tool for Hugins camera and lens database
89
90 - verdandi Merges images using watershed algorithm
91
92These programs are built on top of the pano13 library,
93http://panotools.sourceforge.net/
94
95
963. USE
97
98hugin can be used to stitch multiple images together. The resulting image can
99span 360 degrees. Another common use is the creation of very high resolution
100pictures by combining multiple images.
101
102See http://hugin.sourceforge.net/ for more information and tutorials.
103
104See http://wiki.panotools.org/Development_of_Open_Source_tools#Supported_Platforms
105for some information on releases for different platforms.
106
107
1084. TYPICAL WORKFLOW
109
110 1. load images
111 2. specify initial parameters (lens etc)
112 3. select control points points.
113 4. run optimizer to estimate image positions
114 5. set output parameters and stitch images together.
115
116
1175. KNOWN ISSUES / INCOMPATIBILITIES / LIMITATIONS
118
119Check the Hugin FAQ and bug tracker
120
121http://wiki.panotools.org/Hugin_FAQ#Known_Limitations
122
123An updated list of issues deemed to be critical,
124including discussions and workarounds, is in the issue tracker
125
126https://bugs.launchpad.net/hugin/+bugs?search=Search&field.importance=Critical
127
128
129Linux: Compiz interferes with the fast preview window.
130If you're affected, the workaround is to not use Compiz.
131
132Some components of Hugin have been reported not to deal well with image files
133that have the same name in different folders. The workaround is to rename
134your images files so that all image files in a project are unique.
135
136
1377. SUPPORT / COMMUNITY
138
139Please use the hugin-ptx mailing list if you have questions or suggestions:
140http://groups.google.com/group/hugin-ptx
141