Gtk2::ImageView
===============

Perl bindings to the GtkImageView image viewer widget
Find out more about GtkImageView at http://trac.bjourne.webfactional.com/.

The Perl bindings follow the C API very closely, and the C reference
should be considered the canonical documentation.

Be sure to check out the example programs in the "examples" directory.

To discuss Gtk2::ImageView or gtk2-perl, ask questions and flame/praise the
authors, join gtk-perl-list@gnome.org at lists.gnome.org.


INSTALLATION
------------

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install


To avoid installing to a system directory, since this is a beta release,
you can change the installation prefix at Makefile.PL time with

   perl Makefile.PL PREFIX=/some/other/place

This will install the module to the subdirectory lib/perl5 under the given
prefix.  If this is not already in perl's include path, you'll need to tell
perl how to get to this library directory so you can use it; there are three
ways:

  in your environment (the easiest):
    # assuming a bourne-style shell
    PERL5LIB=/some/other/place/lib/perl5/site_perl
    export PERL5LIB

  on the perl command line:
    perl -I /some/other/place/lib/perl5/site_perl yourscript

  in the code of your perl script:
    use lib '/some/other/place/lib/perl5/site_perl';

To build the documentation as html, run:

  make html

Note that the bindings must first have been built and that the
mpod2html script must be installed.
  

DEPENDENCIES
------------

This module requires these other modules and libraries:

  perl >= 5.8.0
  Glib >= 1.163 (Perl module)
  GTK+ > 2.x (C library)
  GtkImageView >= 1.6.0

If GTK+ is as new or newer as 2.8, the Cairo module is also required:

  Cairo >= 1.00 (Perl module)

In order to build it from source, you'll also need

  ExtUtils::Depends >= 0.2
  ExtUtils::PkgConfig >= 1.03


BUG REPORTS
-----------

Please submit bug reports top
http://trac.bjourne.webfactional.com/newticket/.


COPYRIGHT AND LICENSE
---------------------

Copyright (c) 2007 -- 2008 by Jeffrey Ratcliffe <Jeffrey.Ratcliffe@gmail.com>
see AUTHORS for complete list of contributors

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 3 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Library General Public License for more details.

You should have received a copy of the GNU Lesser General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

