Revision: 3349
http://hugin.svn.sourceforge.net/hugin/?rev=3349&view=rev
Author: ippei
Date: 2008-08-22 06:20:49 +0000 (Fri, 22 Aug 2008)
Log Message:
-----------
Mac: documentation update
Modified Paths:
--------------
hugin/trunk/mac/Documents/HOWTO-autopanosift.txt
hugin/trunk/mac/Documents/ReadMe-Mac.txt
Modified: hugin/trunk/mac/Documents/HOWTO-autopanosift.txt
===================================================================
--- hugin/trunk/mac/Documents/HOWTO-autopanosift.txt 2008-08-22 06:20:35 UTC (rev 3348)
+++ hugin/trunk/mac/Documents/HOWTO-autopanosift.txt 2008-08-22 06:20:49 UTC (rev 3349)
@@ -1,29 +1,43 @@
-How to set up Autopano-SIFT on Mac for HuginOSX
+===========================================================================
+ How to set up Automatic Control-point Detection software for Hugin on Mac
+===========================================================================
+Hugin project
+http://hugin.sourceforge.net/
-Autopano-SIFT is a set of .Net programs that can automatically generate control points from a set of images. There are two ways of using Autopano-SIFT from HuginOSX. One is very easy, but does not always work, and hence not supported. The other should work as long as you set up autopano-sift correctly, but it involves editing shell script.
-Steps:
+Introduction
-1. You need to install .Net environment called Mono. You can get its Framework installer package from <http://www.mono-project.com/Downloads>. You need administrator password for your computer.
+There are multiple software available for Automatic Control-point Detection (aka Autopano) task. Hugin itself does not implement this useful feature yet, but it can use external programs for the task. This document explains how you can set them up on Mac.
-2. Download Autopano-SIFT compiled for Mono environment from the author's homepage <http://user.cs.tu-berlin.de/~nowozin/autopano-sift/>, and read its readme and license files.
+If you have set up autopano-complete.sh or other software for previous versions in a custom location, then you may continue using them with 0.7.
-3. Use PutAutopanoSiftToHuginOSX program comes with HuginOSX to put the relevant files into HuginOSX's application package. That's all. If that did not work, you could try the next method, or give up (sorry).
+There are two ways of setting up those AutoCP programs. One is to install the pre-configured plugins into a certain location on your hard drive, and the other is to specify which program should be used how in the Hugin preferences.
-If you tried step 3 and it did not work, you might want to proceed to the alternative installation. From this step, however, I assume you have some knowledge in unix.
-4. We have to set up autopano-complete.sh comes with Autopano-SIFT. First, set AUTOPANO_PATH variable so that the script can find the .Net executables where ever the current path is. If you place the script and the executables in the same directory, `dirname "$0"` may work. Next, you need to replace every occurrence of "generatekeys.exe" with "generatekeys-sd.exe". Now the script should be ready. Launch the Terminal and try out the script. Typical usage would be "./autopano-complete.sh -o project.pto image1 image2" (-h option gives you the arguments you can use, but please note the long format with -- is not available on Mac and other BSD systems).
+Patent
-5. If the script works fine with you from any current directory, then it should be ready for hugin as well. Please open hugin's Preferences and in the Autopano tab, specify the path to the script as the custom Autopano-SIFT program.
+One of the main reasons this feature is not fully integrated into Hugin.app yet is that the technologies used in the implementations available for us at this moment are all patented. Although implementations are freely provided, you are responsible for judging whether each technology can be legally used in your country. Please use them at your own risk.
-What exactly HuginOSX does:
-HuginOSX has a customised script file inside the application bundle. If the custom program is not specified, HuginOSX checks whether all three autopano-sift files (autopano, generatekeys-sd, libsift) are inside the bundle, and calls its own script if they are there. If you specify the custom program, HuginOSX simply uses that one assuming it works.
+Using AutoCP Plug-in
+AutoCP plugins are self-contained with necessary executables and configuration. A program called "Install AutoCP Plugin" can install those plugins for you, so just open this application and choose the plugin you want to install.
-This document was originally written by Ippei UKAI (Copyleft 2006)
+Make sure to untick the "Use alternative Autopano-SIFT program" option in Hugin preferences. Please note the "Arguments" option will be ignored when plugins are used.
+
+Technically speaking, plugins can be installed in two locations: "~/Library/Application Support/Hugin/Autopano" and "/Library/Application Support/Hugin/Autopano". "Install AutoCP Plugin.app" application will install plugins into "~/Library/Application Support/Hugin/Autopano". You can uninstall plugins by removing from those folders.
+
+
+
+Specifying external programs
+
+If you choose to set up control point detection programs manually, open Preferences in Hugin, tick the "Use alternative Autopano-SIFT program" option, and "Choose..." the command line program you want to use. The "Arguments" will be passed to that command line program with variable appropriately replaced.
+
+
+
+This document was originally written by Ippei UKAI (Copyleft 2008)
Last Modified: $Id: HOWTO-autopanosift.txt 1703 2006-08-13 10:41:25Z ippei $
\ No newline at end of file
Modified: hugin/trunk/mac/Documents/ReadMe-Mac.txt
===================================================================
--- hugin/trunk/mac/Documents/ReadMe-Mac.txt 2008-08-22 06:20:35 UTC (rev 3348)
+++ hugin/trunk/mac/Documents/ReadMe-Mac.txt 2008-08-22 06:20:49 UTC (rev 3349)
@@ -1,96 +1,68 @@
-========================
- Read Me - HuginOSX 0.6
-========================
+=============================
+ Read Me - Hugin 0.7 for Mac
+=============================
-HuginOSX (hugin on Mac OS X)
+Hugin project
http://hugin.sourceforge.net/
License Agreements
-The programs included in this package are mainly released under GPL 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. The license of HuginOSX follows that of hugin on the other platforms, which is found in the "readme and license" folder.
+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.
Requirements
-Mac OS X 10.3.9 or above, either on PPC or Intel machine
+Mac OS X 10.4 or above, either on PPC or Intel machine
-(Users with Intel CPU may still experiense minor problems. We appreciate your report. If there is a serious problem, you can try running HuginOSX with Rosetta to work around: http://docs.info.apple.com/article.html?artnum=303120 )
-
Typical Installation Procedure
1. Read through the read-me and license files.
+2. Copy Hugin.app to /Applications folder or other locations of your preference.
+3. (Optional) Install Autopano-sift softwares..
-2. Copy HuginOSX.app to /Applications folder or other locations of your preference.
-3. (Optional) Install Autopano-sift:
- - Download and install Mono Framework (http://mono-project.com/)
- - Download Autopano-sift for Mono environment (http://user.cs.tu-berlin.de/~nowozin/autopano-sift/)
- - Launch PutAutopanoSiftToHuginOSX
- - Select "bin" folder in the autopano-sift package, and then HuginOSX.app that you have just installed
-
-
Usage
Basic usage of HuginOSX is not different from that of other platforms. Some of helpful resources are found in the "Help" menu, and you can find more on the web. The basic steps are:
1 add images to the project,
2 set the field of view of your lens (in degrees) etc.,
3 add control points,
-4 set the anchor point, which becomes the centre point of the resulting photo
-5 execute optimiser that puts the images in the best place according to the control points, and
-6 stitch the images together.
+4 execute optimiser that puts the images in the best place according to the control points, and
+5 stitch the images together.
There are many tutorials on the web, which might assist you to get started with hugin and the panorama photography.
-External commnad-line tools that can be used from inside HuginOSX
-
-- enblend by Andrew Mihal, http://enblend.sourceforge.net/
-This command-line program blends your panorama nicely. The program is already integrated into HuginOSX and no custom installation is required. For a reference, you can read its readme file in the "readme and licence" folder, however using enblend from command line may require separate installation of enblend tool.
-
-- autopano-sift by Sebastian Nowozin, http://user.cs.tu-berlin.de/~nowozin/autopano-sift/
-This is a set of .Net programs that can automatically add control points. We are not including this software in this package. Please read the tutorial in tools/autopano-sift/ folder in order to set up this software for your Mac and hugin.
-
-PTStitcher from the original Panorama Tools by Helmut Dersch and autopano by Alexandre Jenny have no source available to the public, and there are no versions available for OSX.
-
-
-
-
Free tools for doing panorama on Mac
Command-line tools whose Mac binaries are available from hugin project
-- nona The stitching engine of hugin. For use with other tools like clens.
+- nona The stitching engine of hugin. For use with other tools.
- mergepto Merges two hugin project files.
-- clens from Panorama Tools project, http://panotools.sourceforge.net/
-- enblend by Andrew Mihal, http://enblend.sourceforge.net/
+- enblend, enfuse by Andrew Mihal, http://enblend.sourceforge.net/
+- align_image_stack Useful for enfuse.
+- fulla Correction of distortion etc.
Other recommended free tools
-- PanoGLViewerOSX from hugin Project, http://sourceforge.net/projects/hugin/download/
-- autopano-sift by Sebastian Nowozin, http://user.cs.tu-berlin.de/~nowozin/autopano-sift/
-- MakeCubic from Apple Computer, http://developer.apple.com/quicktime/quicktimeintro/tools/index.html#qtvr
+- PanoGLView from hugin Project, http://sourceforge.net/projects/hugin/download/
+- QTVR MakeCubic from Apple Computer, http://developer.apple.com/quicktime/quicktimeintro/tools/index.html
- XBlend from Kekus Digital, http://www.kekus.com/xblend/
- PangeaVR Plugin from Pangea Software, http://www.pangeasoft.net/pano/plugin/
- PanoView (Japanese Only) by Yoshiaki Katayanagi, http://www.jizoh.jp/pages/download.html
-Known Problems
-
-- autopano-sift sometimes does not work when nested inside the application package.
-
-
-
Contacts
- See the homepage (http://hugin.sourceforge.net/) first.
- Visit the project page on SourceForge (http://sourceforge.net/projects/hugin) if you are interested in the developement.
+- Panotools.org hosts a knowledge base in Wiki (http://wiki.panotools.org/).
- The mainling list for everyone who cares about hugin (http://groups.google.com/group/hugin-ptx) would welcome any questions and/or help from you.
-- Recent OSX porting is mainly proceeded by Ippei UKAI (ippei_ukai@...). He's on the above mailing list as well, so using the mailing list should work fine. Note he's a university student and probably busy during term times.
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|