Tree [533271] master /
 History



File Date Author Commit
 cmake 2014-10-22 Behnam Tabatabai Behnam Tabatabai [1283d8] RPATH for MACOSX, module for compiler settings.
 help 2014-09-30 Behnam Tabatabai Behnam Tabatabai [917ebb] Adding cmake files.
 po 2014-09-30 Behnam Tabatabai Behnam Tabatabai [917ebb] Adding cmake files.
 src 2014-11-13 Behnam Tabatabai Behnam Tabatabai [533271] Intermediate status.
 .gitignore 2014-09-29 Behnam Tabatabai Behnam Tabatabai [87fa89] Cleanup for starting new version.
 AUTHORS.txt 2014-09-29 Behnam Tabatabai Behnam Tabatabai [87fa89] Cleanup for starting new version.
 CMakeLists.txt 2014-10-22 Behnam Tabatabai Behnam Tabatabai [1283d8] RPATH for MACOSX, module for compiler settings.
 COPYING.txt 2014-09-29 Behnam Tabatabai Behnam Tabatabai [87fa89] Cleanup for starting new version.
 INSTALL.txt 2014-09-29 Behnam Tabatabai Behnam Tabatabai [87fa89] Cleanup for starting new version.
 README.txt 2014-09-29 Behnam Tabatabai Behnam Tabatabai [87fa89] Cleanup for starting new version.

Read Me

Gimp Plug-in for "Image Registration"
http://gimp-image-reg.sourceforge.net/

Version 0.5.5
2011-02-20

This is an implementation of the inverse compositional image
registration algorithm for Gimp. Image registration, also known as
image alignment, is the process of transforming a given image to
achieve a best match with another image. The need for such a tool is
given in situations where you want to combine two or more images which
are similar, but geometrically do not have a perfect match.

A typical use is the combination of 2 or 3 photos in HDR methods.
Unless you use a stable tripod, the source images will always be
slightly out of alignment, so the very first step will be to re-align
the images. The alignment step is normally built into dedicated HDR
software, but for doing simple HDR (using for example Gimp's layer
masks), you'll need to align the source images yourself, and this is
where this plug-in can be helpful.

Using the plug-in
-----------------
After you have built and installed the plug-in (see below), it will
appear as "Image Registration..." in the "Tools" menu. For using the
tool, load your images into Gimp (preferably as layers, see "Open as
Layers..."), select the layer you would like to transform, and launch
the tool. Refer to "Help" in tool's dialog for more information about
the parameters.

Installation
------------
As of version 0.5.5, the "Image Registration" plug-in has been built
and tested for Linux (Ubuntu 10.04 and 10.10), Win32, and Mac OS X
10.5 (Leopard) and 10.6 (Snow Leopard). Thanks to auto-tools, the
chances are the software can be easily built also for other posix
systems like FreeBSD and other UNIXes, but I have not tried that yet.

Installation on Windows and Mac OS X
------------------------------------
For Win32 and Mac OS X 10.5 and 10.6 (Lisanet port of Gimp) there are
pre-built binary distributions of the plug-in which you simply install
by unpacking the corresponding zip archives into your *personal* Gimp
directory, which is named:

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

Mac OS X 10.5 and 10.6 (Lisanet port of Gimp):
~/Library/Application Support/Gimp

Installation on Linux
---------------------
Currently there is no binary distribution for Linux and therefore the
plug-in must be built from source.

For building the plug-in for Linux, you will need the 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 on Linux
---------------------------------
Unless many users on your system will use this plug-in, I recommend a
"single-user" installation, in which the plug-in goes into your
personal ~/.gimp-2.6 directory, and the gimp installation directories
remain untouched.

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

(0) [Download '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)

For uninstalling the plug-in, simply run 'make uninstall'.

System-Wide Installation on Linux
---------------------------------
A system-wide installation is much like the user installation, except:

(a) the configuration step, in which you explicitly provide a prefix,
    and omit the option --enable-user-install [default: no], and

(b) administrative rights (sudo) for installing the software.

Passing the right prefix to the configure script is for making sure
that Gimp will find the plug-in 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'.

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:





No, thanks