Gimp Plug-in for Image Registration Get Gimp Plug-in for Image Registration at SourceForge.net.                   Fast, secure and Free Open Source software downloads
Welcome! Installation Examples References

Installing the Plug-in

As of version 0.5.5, the Image Registration plug-in has been built and (roughly) tested for Linux (Ubuntu 10.04 and 10.10), Mac OS X 10.5 (Leopard) and 10.6 (Snow Leopard), and Windows (2000, XP, Vista, and Windows 7). Thanks to auto-tools, the chances are the software can be easily built also for BSD and other UNIXes, but I have not tried that yet.

Installing on Linux

There is no binary distribution for Linux. Therefore, for installing the plug-in on Linux you must first build it. The build procedure is quite easy as it strictly follows the known configure, make, make install pattern. The only thing you must take care of before you can compile the plug-in is the installation of development package libgimp2.0-dev, which you easily get and install by your package manager (apt, Synaptic Package Manager, etc.).

The plug-in can be built either for a single user, or for a system-wide installation

Single-User Installation

Unless many users on your system will use this plug-in, I strongly recommend a single-user installation, in which the plug-in goes into your personal ~/.gimp-2.6-directory, and the system-wide gimp installation directories remain untouched.

For a single-user installation of the plug-in, first download the newest sources (currently gimp-image-reg-0.5.5.tar.gz) into some directory, change to that directory, and issue the following commands:

(1) tar xvfz gimp-image-reg-0.5.5.tar.gz
(2) mkdir build
(3) cd build
(4) ../gimp-image-reg-0.5.5/configure --enable-user-install
(5) make
(6) make install
        

If everything goes right, the image registration plug-in and the accompanying files will be installed in your personal ~/.gimp-2.6 directory, namely:

~/.gimp-2.6/plug-ins/gimp-image-reg     (executable)
~/.gimp-2.6/share/gimp-image-reg/*      (help files)
~/.gimp-2.6/share/locale/*              (localization files)
        

After installation, just re-start Gimp, and the plug-in will appear as a new entry Image Registration... in the bottom of the Tools menu.

Uninstalling

For uninstalling the plug-in, simply run make uninstall in the directory where you built and installed the plug-in. If you have no more access to that directory, simply get the sources again and build the plug-in without installing that (steps 1 through 5). This will give you again the environment in which you can issue the uninstall command.

System-Wide Installation

A system-wide installation is much like the single-user installation, except:

  1. In the configuration step you explicitly provide a prefix and omit the option --enable-user-install [default: no], and
  2. You will need administrative rights (sudo) for installing the software.

Passing the right prefix to the configure script is for making sure that the plug-in is installed in the right place so that Gimp can find it after installation. This prefix can be obtained from gimptool-2.0 (part of libgimp2.0-dev) by the following command:

$ gimptool-2.0 --prefix

The steps for a system-wide installation of the plug-in are the following:

(1) tar xvfz gimp-image-reg-0.5.5.tar.gz
(2) mkdir build
(3) cd build
(4) ../gimp-image-reg-0.5.5/configure --prefix=`gimptool-2.0 --prefix`
(5) make
(6) sudo make install
        

Upon successful completion, the plug-in and the accompanying files will go into:

${prefix}/lib/gimp/2.0/plug-ins/gimp-image-reg (executable)
${prefix}/share/gimp-image-reg/*               (help files)
${prefix}/share/locale/*                       (localization files)
        

For uninstalling the plug-in, simply run sudo make uninstall in the directory where you installed the plug-in.

Installing on Windows

Binary Distribution for Windows

The easiest way of installing the plug-in on Windows platforms is to use the binary distribution gimp-image-reg-0.5.5-win32.zip. It is a pre-built version of the plug-in which you simply unpack into your personal gimp directory, which is presumably named:

c:\Documents and Settings\{user}\.gimp-2.6 (Windows 2000/XP) 
c:\Users\{user}\.gimp-2.6                  (Windows 7, Windows Vista)
        

This will install following files and directories into your personal gimp directory:

...\.gimp-2.6\plug-ins\gimp-image-reg.exe (executable)
...\.gimp-2.6\share\gimp-image-reg\*      (help files)
...\.gimp-2.6\share\locale\*              (localization files)
        

After unpacking the files, just re-start Gimp, and the plug-in will appear as a new entry Image Registration... in the bottom of the Tools menu.

Uninstalling

Currently there is no Windows installer (and more specifically, no uninstaller) for the plug-in. Therefore, for uninstalling the plug-in you'll need to manually delete the files listed above.

Building from source for Win32

Currently the binaries for Win32 are built by cross-compiling under Linux (using the same scripts as for building the Linux binaries).

For cross-compiling the sources, will need to get and install

  1. Minimalist GNU win32 cross-compiler (look for mingw32 in your package manager), and
  2. the Win32 development packages for Gimp and Gtk+.

The latter packages can be downloaded from:

http://sourceforge.net/projects/gimp-win/files/ (look for gimp-dev-2.6.4.zip or newer)
ftp://ftp.gnome.org/pub/gnome/binaries/win32/ (look for gtk+-bundle_2.18.7-20100213_win32.zip or newer)

After unpacking the zip packages into some directory (e.g., /opt/mingw32) you will need to patch the prefix statements in pkgconfig files to reflect the actual location of the libraries. A script like the following might be helpful for doing that:

#!/bin/sh
TARGET=/opt/mingw32
for f in $TARGET/lib/pkgconfig/*.pc ; do
  echo "Patching $f ..."
  if [ ! -e $f.orig ]; then
    cp -p $f $f.orig
  fi
  sed -i s+^prefix=.*+prefix=$TARGET+ $f
done
        

After adjusting the pkgconfig prefixes, and assuming that you have installed the development libraries in say /opt/mingw32, the build steps are much like the normal installation for Linux, namely:

(1) tar xvfz gimp-image-reg-0.5.5.tar.gz
(2) mkdir build
(3) cd build
(4) ../gimp-image-reg-0.5.5/configure          \
           --with-user-install-dir=`pwd`/win32 \
           --enable-user-install=yes           \
           --with-prefix=/opt/mingw32          \
           --host=i586-mingw32msvc             \
           --target=i586-mingw32msvc           \
           --build=i386-linux
(5) make
(6) make install
        

This will create a directory win32 in your current directory and install the package there. For the actual installation of the plug-in, copy the contents of win32/... into your personal gimp-2.6 directory under Windows.

Installing on Mac OS X

Binary Distribution for Mac OS X

If you are using the Lisa-port Gimp distribution for Mac OS X (see GIMP on OS X), then the easiest way of installing the plug-in is to use the binary distributions

These are pre-built versions of the plug-in, which you simply unpack into your personal gimp directory named:

~/Library/Application Support/Gimp

This will install following files and directories into your personal application support gimp directory:

~/Library/Application Support/Gimp/plug-ins/gimp-image-reg (executable)
~/Library/Application Support/Gimp/share/gimp-image-reg/*  (help files)
~/Library/Application Support/Gimp/share/locale/*          (localization files)
        

After unpacking the ZIP archive, just re-start Gimp, and the plug-in will appear as a new entry Image Registration... in the bottom of the Tools menu.

Uninstalling

Currently there is no Mac OS X installer (and more specifically, no uninstaller) for the plug-in. Therefore, for uninstalling the plug-in you'll need to manually delete the files listed above.

Building from source for Mac OS X (Lisa-port)

For compiling the plug-in for the Lisa-port of Gimp under Mac OS X, carefully perform the following steps:

  1. Setting up the Lisa-port environment.

    1. Download the sources for Gimp on OS X from sourceforge.net into a directory named gimponosx:

      svn co https://gimponosx.svn.sourceforge.net/svnroot/gimponosx gimponosx
                      

      The Lisa-port scripts (contained in the source distribution, see below) expect the sources to live in ~/src/macports. Therefore, create a directory ~/src, and move the just downloaded gimponsx directory there:

      mkdir ~/src
      mv gimponosx ~/src/macports
                      

      This is a modified version of Macports, nicely tuned for building Gimp, and without the annoyances of the original Macports, which obstinately insists on bringing its own perl, python, etc.

    2. Next, deactivate your standard Macports, if you have one. For doing so it is not necessary to completely uninstall Macports. Just rename the Macports root directory so that the system cannot find it:

      sudo mv /opt/local /opt/local.disabled
                      
    3. Now step into macports

      cd ~/src/macports
                    

      and issue the following commands for preparing and making MacPorts:

      ./scripts/gp-prep
      ./scripts/gp-makeports
                    

      The last command will prompt you for your password to complete.

    4. Now extend your PATH, and build and install Gimp:

      export PATH=/tmp/skl/Gimp.app/Contents/Resources/bin:$PATH
      sudo port install gimp2
                    

      This will take a while (approximately 2 hours on my Macbook) to fetch and compile the packages needed for building Gimp.

    Having built the Gimp, the directory ~/src/macports/Gimp-app/Contents/Resources will contain among others the development environment (header files and libraries) we need for compiling and building the plug-in. Keep the stuff in ~/src/macports/... safe, as it will be needed every time you compile the plug-in.

  2. Build the plug-in.

    1. Delete the directory /tmp/skl/ if there is one (this directory is created every time you start the Lisa-port Gimp), create a directory with the same name, and inside that directory create a symbolic link Gimp.app to point to ~/src/macports/Gimp-app (beware of dot and dash in Gimp.app and Gimp-app):
      rm -rf /tmp/skl
      mkdir -p /tmp/skl
      cd /tmp/skl
      ln -s ~/src/macports/Gimp-app Gimp.app
      cd - 
                    
    2. Extend your PATH:
      export PATH=$PATH:/tmp/skl/Gimp.app/Contents/Resources/bin
                    
    3. Build and install the plug-in:

      tar xvfz gimp-image-reg-0.5.5.tar.gz
      cd gimp-image-reg-0.5.5
      mkdir build
      cd build
      ../configure --enable-user-install \
                   --with-user-install-dir=`pwd`/macos \
                   --with-prefix=/tmp/skl/Gimp.app/Contents/Resources
      make
      make install
                      

      Upon successful completion, this will install the plug-in into the subdirectory macos in your current directory. For the actual installation of the plug-in, simply copy the contents of this subdirectory into your personal Gimp directory located at ~/Library/Application Support/Gimp:

      cd macos
      cp -r -p . ~/Library/Application\ Support/Gimp
                      

Building from source for Mac OS X (MacPorts)

For building the plug-in under MacPorts, first install gimp2 and intltool. Having done that, the rest is the same as building under Linux. I highly recommend the single-user installation variant to keep the system-wide Gimp installation directories unaffected by this plug-in:

(1) tar xvfz gimp-image-reg-0.5.5.tar.gz
(2) mkdir build
(3) cd build
(4) ../gimp-image-reg-0.5.5/configure --enable-user-install
(5) make
(6) make install
        

If everything goes right, the image registration plug-in and the accompanying files will be installed in your personal ~/.gimp-2.6 directory, namely:

~/.gimp-2.6/plug-ins/gimp-image-reg     (executable)
~/.gimp-2.6/share/gimp-image-reg/*      (help files)
~/.gimp-2.6/share/locale/*              (localization files)