Hugin installation memo log

=============================
Read Me - Hugin 2010.x for Mac
=============================
Hugin project
http://hugin.sourceforge.net/



License Agreements
The programs included in this package are mainly released under the GNU General Public License version 2 although some of them may contain different licenses. Please refer to the License and Readme files attached to each program. If you do not agree with any of those license agreements, please delete the relevant program immediately. Please read the Autopano-sift-C and SURF license in particular.

Requirements
Mac OS X 10.4 or above, either on PPC or Intel.


Typical Installation Procedure for Hugin
1. Read through the read-me and license files.
2. Copy Hugin.app to /Applications folder or another location of your preference.
3. (Optionally but strongly advised) Install Autopano-sift and/or Panomatic Control Point generators.

About the Control Point Generators
To be able to align and stitch seamless panoramas, hugin needs to know the corresponding locations (control points) between each overlapping pair of images. Hugin will calculate the best way to align those images using the Control Point generators. These Control Point generators are separate packages as it is not allowed to include the generators inside the bundle due to patent restriction.
Due to the same patent restriction it is not allowed to use Autopano-sift-C on commercial basis in the USA. All users who do use it on private, educational or any other non-commercial basis are free to use it.


Installation Procedure for Control Point Generators.
Due to the license restrictions we do not deliver them with this bundle. Please download them by double-clicking the “Download_AutoCPgenerators.webloc” in the “Control Point Generators” folder.
The Control Point generators come as separate .dmg files.
    1.    Open the relevant .dmg from your Desktop (inside you will find a folder with the generator and an installer).
    2.    Simply double-click the installer and the CP generator binary will be installed in your user directory inside “Library/Application Support/Hugin/Autopano”.
    3.    Close and delete the relevant installer dmg from your Desktop (optional).



How to configure the ControlPoint generators inside Hugin
When you start Hugin, go to preferences and to the “Control Point Detectors” pane.



Here you can add CP generators (currently panomatic and/or Autopano-sift-C). It is now possible to create different configurations based on the same generator.
panomatic default parameters: -o %o %i
autopano-sift-c default parameters: —maxmatches %p %o %i
autopano-sift-c 120+ images: —maxmatches %p %o %s
For autopano-sift-c you might want to experiment with ransac. Don’t use it for fisheye lenses. For normal lenses you might add “—ransac 1” to the parameters.

Note: After you have installed one or more CP generators, you need to set one generator as “default” generator. If you forget to do this the Assistant panel does not function.
For an explanation of Autopano-sift-c see: http://wiki.panotools.org/Autopano-sift-C.
For an explanation of Panomatic see: http://wiki.panotools.org/Panomatic
For an explanation of Ransac see: http://en.wikipedia.org/wiki/RANSAC

Note: Updated and extra builds for Hugin and CP generators can be found at: http://panorama.dyndns.org/index.php?lang=EN&subject=Hugin&texttag=Hugin


Usage of Hugin

Basic usage of Hugin on MacOSX is not different from that of other platforms. Some helpful resources can be found in the “Help” menu, and you can find more on the web and the Hugin website, specifically at: http://hugin.sourceforge.net/tutorials/.

You can use the “Assistant” which is the first pane and will almost automatically lead you through all necessary steps.
Or you can use the standard “step-by-step” approach.
The basic steps are:
1 add images to the project via the “Images” tab,
2 add control points, either by hand or via one of the control point generators,
3 execute the optimiser that puts the images in the best place according to the control points, and
4 stitch the images together.
There are many tutorials on the web, which might assist you to get started with hugin and the panorama photography.





Those who are interested in the development.
- Panotools.org hosts a Wiki knowledge base about all kind of panaorama related topics. (http://wiki.panotools.org/).
- The mailing list for everyone who cares about hugin (http://groups.google.com/group/hugin-ptx) would welcome any questions and/or help from you.
- On the panorama.dyndns website at http://panorama.dyndns.org/index.php?lang=EN&subject=Hugin&texttag=Hugin you will find new development MacOsx builds at regular basis.

---