GIMP Plug-In set for 360° panoramas
===================================

Copyright (C) 2013 Michał Rudewicz <michal.rudewicz@gmail.com>

This plugin set contain 4 plugins helpful in 360° equirectangular panorama
creation:
  * fill_zenith_nadir - fills transparent areas on the top and the bottom of
    the generated panorama with a gradient that smoothly connects to the
    neighbour pixels
  * panorama_to_zenith_nadir - converts panorama to editable form of zenith
    and nadir areas. This allows for easy editing, eg. patching, filling,
    placing a logo
  * zenith_nadir_to_panorama - converts back the editable zenith and nadir to
    panorama projection
  * set_google_plus_metadata - attach metadata needed to publish panorama on
    Google+

The panorama_to_zenith_nadir and zenith_nadir_to_panorama plugins are inspired
and based on algorithms published by Seb Przd on
http://theseblog.free.fr/2007/08/edit-nadir-and-zenith-of.php. These plugins
were developed as native, to speed-up their execution.

The fill_zenith_nadir is my own idea, that appeared after unsuccessful hours
of unfair fight with high resolution panoramas with huge empty areas on zenith
and nadir.

The last plugin - set_google_plus_metadata was obvious complement that enables
easy publication of low-res panoramas.

Requirements
============

The plugins were developed and tested on Ubuntu 12.10 and Gimp 2.8. It is
possible that Gimp 2.8 is needed for the set_google_plus_metadata. Other
plugins should work with older releases.

set_google_plus_metadata plugin requires libexempi library.

Installation
============

In normal cases, when Gimp and libexempi development files are available, it
should be enough to issue following commands:

	./configure
	make
	make install

Acknowledgements
================

Seb Przd for his post with algorithms.
Michael Natterer, Sven Neumann, Dave Neary and other Gimp developers for
plugin template and tutorial.

Michał Rudewicz

