Gtk2::GLExt version 0.90
========================

The Gtk2::GLExt module allows a Perl developer to use GtkGLExt, an OpenGL
extension to GTK+ by Naofumi Yasufuku (��ʡ ��ʸ), with Gtk2-Perl.

Like the Gtk2 module on which it depends, Gtk2::GLExt follows the C API
of gtkglext as closely as possible while still being perlish.
Thus, the C API reference remains the canonical documentation.

You can find out everything you need to know about GtkGLExt at its homepage,
http://gtkglext.sourceforge.net

This module does not include actual OpenGL bindings; you need to get those
separately.  Search CPAN for OpenGL, SDL::OpenGL, and PDL::Graphics::OpenGL;
your mileage may vary.

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

Also have a look at the gtk2-perl website and sourceforge project page,
http://gtk2-perl.sourceforge.net


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';
  

DEPENDENCIES

This module requires these other modules and libraries:

  perl >= 5.8.0
  Glib >= 1.060 (perl module and requisite C libraries)
  Gtk2 >= 1.060 (perl module and requisite C libraries)
  gtkglext > 1.0 (C library)

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

  ExtUtils::Depends >= 0.2
  ExtUtils::PkgConfig >= 1.00


COPYRIGHT AND LICENSE

Copyright (C) 2003 by the gtk2-perl team (see the file AUTHORS for a
complete list)

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 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 Library General Public
License along with this library; if not, write to the 
Free Software Foundation, Inc., 59 Temple Place - Suite 330, 
Boston, MA  02111-1307  USA.