HOWTO Panorama photography tools

From Gentoo Linux Wiki

Jump to: navigation, search
This article is part of the HOWTO series.
Installation • Kernel & Hardware • Networks • Portage • Software • System • X Server • Gaming • Non-x86 • Emulators • Misc

Note: this page needs a better name. (Nick : I suggest : Panorama Photos with hugin, PTStitcher, PTmender, Autopano-sift and Enblend)

The following are not instructions, but notes on how to install the various packages, where to find further information, and links to the bugs where the ebuilds can be found. They will be turned into instructions later, once the packages are more stable.

Contents

[edit] Tools in Portage

libpano12 and enblend are now part of portage. You just need to emerge them.

[edit] libpano12

You can simply 

emerge libpano12

This package contains libpano library and PTOptimizer but not the PTStitcher and other tools which are included in the original Panorama Tools However PTStitcher is a binary that does not work for AMD64. The alternative stitcher Nona works fine, but is not able to correct colors and brightness. A work around is to use the successor in development for PTStitcher : PTmender. PTmender is included in the recent version of libpano12 of the unstable branch. So you will have to add it in your package.keywords before emerging libpano12 : 

# echo "=media-libs/libpano12-2.8.4 ~*" >> /etc/portage/package.keywords  # ONLY FOR 64 BIT !

PTmender in hugin works fine with some restrictions because it is still in development. One of the restrictions is the Output File to be specified in hugin as "multiple tiff". So when hugin has finished you get a number of photos that you have to put together with enblend in terminal (see further under enblend).

[edit] Enblend

and now you have to emerge enblend 

emerge enblend

If you use MTmender on a AMD64 platform you have to combine the output files of hugin in terminal, simply using 

# enblend -o stitchedphoto.tiff huginoutputphoto00000.tiff huginoutputphoto00001.tiff ...

[edit] Hugin

Hugin exists in portage. Hugin-0.5 is stable. Hugin-0.7 in in testing. To install this you need to do the following 

emerge hugin

If the above does not work you can install hugin alternatively as follows :

If you work on a x86 system using PTStitcher you need to give the path to the PTStitcher executable in the preferences dialog of hugin. If you work on an AMD64 system type PTmender in the dialog box of hugin preferences.

[edit] AutoPano-SIFT

Now also AutoPano-SIFT is in portage. 

 emerge autopano-sift

[edit] ebuilds in bugs.gentoo.org

hugin-0.6.1.ebuild

[edit] External tools

The following tools do not exist in portage at all and dont have any ebuilds in http://bugs.gentoo.org

[edit] Panorama Tools

The Panorama Tools were created by Helmut Dersch. His new webpages (http://webuser.fh-furtwangen.de/~dersch/) dont have references to Panorama Tools.

But his old site is still online at http://www.all-in-one.ee/~dersch/ and contains the whole Panorama Tools toolset.

The PanoTools downloads contain the following:

  • PTStitcher
  • PTPicker
  • PTStereo
  • PTInterpolate
  • PTMorpher
  • PTAverage
  • PTStripe
  • PTEditor

Simply download the tar.gz file from http://www.all-in-one.ee/~dersch/PanoTools.tar.gz. As this is just a bog standard download I always put them in /opt. To do this, execute the following as root 

tar -xvzf PanoTools.tar.gz -C /opt

It is useful to check the permissions of PTStitcher and PTOptimizer in order to avoid the error "PTStitcher exited with nonzero error code". 

chmod u+x /opt/PTLinux/Helpers/PTStitcher

chmod u+x /opt/PTLinux/Helpers/PTOptimizer

[edit] Hugin from CVS

Hugin from cvs can be very unstable but have the newest features first. To build it yourself from CVS you require the following 

emerge wxGTK 
emerge libpano 
emerge boost

Get Hugin from the sources by doing the following, obviously you must have cvs already, if not do an emerge cvs. 

cvs -d:pserver:anonymous@hugin.cvs.sourceforge.net:/cvsroot/hugin login
cvs -z3 -d:pserver:anonymous@hugin.cvs.sourceforge.net:/cvsroot/hugin co hugin

All you need to do now is build hugin. You can do that by doing the following. In the bootstrap section I simply ignored all the messages telling me I needed to do x, y or z.. 

./bootstrap
./configure
make
su -
make install

[edit] AutoPano

AutoPano v1.03 provides a way to automatically generate the control points for a set of images. AutoPano can create files for Hugin, PTGui and PTAssembler. The resuling output file can be loaded in and tweeked.

AutoPano is not in portage either. Simply download from http://autopano.kolor.com/autopano_1_02b_linux_binary.tar.gz and install by running the following as root 

tar -xvzf autopano_1_02b_linux_binary.tar.gz -C /opt

To run autopano you must add the /opt/autopano_v103_linux to the path 

export PATH=$PATH:/opt/autopano_v103_linux

[edit] Gimp Panorama Plugin NG

Warning: the process of installing the Gimp Plugin from CVS is flaky

Gimp Panorama Plugin is not part of portage, this needs to be downloaded and build from CVS.

The Next Generation gimp plugins source code can be downloaded from sf.net by typing 

cvs -z3 -d:pserver:anonymous@panotools.cvs.sourceforge.net:/cvsroot/panotools co gimp-plugin-ng

Do the auto generation 

./autogen.sh

This is a hack to stop the help being reparsed as its currently failing in all my test cases 

./configure --disable-help

Warning without the above line you may see errors like 

-- Building HTML for en
I/O error : Attempt to load network entity http://docbook.sourceforge.net/release/xsl/current/xhtml/ofile-chunk.xsl
warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/xhtml/prile-chunk.xsl"
compilation error: file ../help/stylesheets/plainhtml.xsl line 7 element import
xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/xhtml/profile-chunk.xsl
make[2]: *** [html.stamp] Error 5

Now build it 

make

And as root 

make install

Warning : as the help pages are not built and currently dont, you get the following error when install the help pages, but the plugin has been installed and appears to work in my basic tests. 

mkdir -p -- /usr/local/share/PanoPlugin/help
-- Installing HTML for en
mkdir -p -- /usr/local/share/PanoPlugin/help/en
cp: cannot stat `./html/en/*.html': No such file or directory
cp: cannot stat `./html/en/gimp-help.xml': No such file or directory
make[2]: *** [install-data-local] Error 1
make[2]: Leaving directory `/home/xxxx/pano/gimp-plugin-ng/help'

[edit] Additional Information

You may also want to look at the HOWTO read raw camera images if your camera supports RAW images instead of lossy jpegs.

[edit] Links

[edit] How To Use these

[edit] Ebuild Information

[edit] Portage Links

Retrieved from "http://www.gentoo-wiki.com/HOWTO_Panorama_photography_tools"
Personal tools