Gentoo Wiki


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.


Tools in Portage


Simply run:

emerge --ask 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).


and now you have to emerge enblend

emerge --ask 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 ...


Hugin exists in portage. To install this you need to do the following

emerge --ask 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.


Now also AutoPano-SIFT is in portage.

 emerge --ask autopano-sift

External tools

Panorama Tools

The Panorama Tools were created by Helmut Dersch. His new webpages ( dont have references to Panorama Tools.

But his old site is still online at and contains the whole Panorama Tools toolset.

The PanoTools downloads contain the following:

Simply download the tar.gz file from 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

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 --ask wxGTK libpano boost

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

cvs login
cvs -z3 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..

su -
make install


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 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

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 by typing

cvs -z3 co gimp-plugin-ng

Do the auto generation


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
warning: failed to load external entity ""
compilation error: file ../help/stylesheets/plainhtml.xsl line 7 element import
xsl:import : unable to load
make[2]: *** [html.stamp] Error 5

Now build it


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'

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.


How To Use these

Portage Links

Retrieved from ""

Last modified: Wed, 10 Sep 2008 06:17:00 +0000 Hits: 22,767