
			A Gtk FITS Image Reader Module
			   Author: Michael S. Noble
			     mnoble@space.mit.edu

		Last Updated: $Date: 2004/05/10 15:13:41 $


This directory contains a FITS image reader module for the gdk-pixbuf
library of the GIMP toolkit (Gtk).  Gtk version 2.2 or later is required.

This FITS image loader can be built and installed in one of two ways:

(1) Directly from within the SLgtk distribution.  This is now the preferred
    approach, since it is simpler and faster.  All that should be required
    is to type

   		% make pixbuf_loader
   		% make install_pixbuf_loader

    from top of the SLgtk distribution, or

   		% make 
   		% make install

    from within the current directory (the directory containing this README).
    Note that you may need root/sudo privileges to perform the 'install' step.

(2) By adding the loader sourcecode into an existing Gtk distribution.  Given
    (1) this approach has been deprecated, so the instructions below are no
    longer guaranteed to work, nor will questions on the approach be supported 
    by the author.

    That said, prior to the availability of (1) I was able to compile and
    install the loader from w/in a Gtk2 distribution, via the following:

	% cd <gtk2.2_or_later_distribution>/gdk-pixbuf
	% cp <slgtk_distribution>/contrib/gdk-pixbuf/io-fits.c .
	% cp <slgtk_distribution>/contrib/gdk-pixbuf/Makefile.am .
	% cd ../
	% automake
	% ./configure      [options for your environment may be needed here]
	% cd gdk-pixbuf
	% make install

    This assumes that 

	a) You've *already* built/installed Gtk2.2 *from* the given source tree
	b) You have automake 1.4 (though old, it seems to be the one that's
	   needed)

    Instructions on how to build Gtk 2.2 from source are available at

	http://developer.gnome.org/doc/API/2.2/gtk/gtk-building.html

    The Gtk 2.2 release notes are HTTP-accessible at

	mail.gnome.org/archives/gtk-devel-list/2002-December/msg00128.html

    If you don't have the necessary version of automake you can get it at

	ftp://ftp.gnu.org/gnu/automake
