Initial commit of PGOPOGL module to git

Getting started to split the XS file to reduce the
size of the compile processes so things can build
on systems with lower memory requirements.  This may
reduce the time to compile as well.  Need to check.

Author: Chris Marshall

CHANGES

@@ -0,0 +1,116 @@
+Changes for PDL::Graphics::OpenGL::Perl::OpenGL 0.01_03 - CHM
+____________________________________________________________
+
+This module is an interim solution to accelerate debuging and
+integration of the official POGL release 0.57 into PDL.
+
+
+
+Changes for 0.57_03 - CHM
+____________________________________________________________
+
+Updated CHANGES.
+
+Makefile.PL: set verbose on as the default build option for
+             bettern diagnostics.  Also added better diags
+	     for when glversion.txt is not generated correctly
+	     and a clean exit(0) without writing a Makefile
+	     which is the preferred style for CPAN Testers.
+
+OpenGL.pm: updated $VERSION to 0.57_03 for a developers release
+
+
+
+
+Change List for 0.57 - Bob "grafman" Free <[email protected]>
+____________________________________________________________
+
+Updated CHANGES
+
+Updated MANIFEST
+
+Updated INSTALL
+
+Updated gl_util.c
+
+Updated gl_util.h
+
+Updated Makefile.PL
+
+Added oga.pl - OGA sample/test app
+
+Updated OpenGL.pm
+
+Updated OpenGL.pod
+
+Updated OpenGL.xs
+
+Updated README, README.Win32, README.FreeBSD, RADME.cygwin
+
+Updated test.pl to fix fullscreen handling
+
+Added test.jpg - test image
+
+Replaced include/GL/glut.h
+Added include/GL/freeglut.h
+Added include/GL/freeglut_ext.h
+Added include/GL/freeglut_std.h
+
+Added FreeGLUT/freeglut.dll
+Added FreeGLUT/freeglut.lib
+Added FreeGLUT/README.txt
+
+Updated glut_const.h
+
+Upated utils/cleanup.pl
+
+Updated glext_procs.h
+
+Updated examples/texhack
+
+Updated vertex.glsl
+
+Added utils/mingw.bat
+
+Added README.macosx
+
+Updated README.Win32
+
+Updated TODO
+
+Added KNOWN_PROBLEMS
+
+
+
+Chris Marshall
+____________________________________________________________
+
+Added README.cygwin
+
+Updated Makefile.PL
+
+Added utils/makefile.cywin
+
+Updated utils/glversion.c
+
+Updated gl_util.h, gl_const.h, glut_util.h, glu_const.h, glext_procs.h
+
+
+
+Sisyphus
+____________________________________________________________
+
+Added utils/makefile.mingw
+
+Updated Makefile.PL
+
+
+
+Alex Dodge
+____________________________________________________________
+
+Updated OpenGL.pod
+
+Updated OpenGL.pm
+
+Update OpenGL.xs

COPYRIGHT

@@ -0,0 +1,82 @@
+
+ Copyright (c) 1998,1999 Kenneth Albanowski. All rights reserved.
+ Copyright (c) 2007 Bob Free. All rights reserved.
+ This program is free software; you can redistribute it and/or
+ modify it under the same terms as Perl itself.
+
+Some portions of this module, including some code sections in OpenGL.pm and
+OpenGL.xs (marked by "Melax" comments) are Copyright Stan Melax, as are the
+files in the example/ directory. This is Stan's original COPYRIGHT message
+for those works:
+
+(c) Copyright 1995, Stan Melax, ALL RIGHTS RESERVED
+Stan Melax
+Alberta Research Council
+[email protected]
+http://www.arc.ab.ca/~stan
+
+Please feel free to give 
+me acknowledgement/credit/money/honorable-mention/job-offers/research-funding
+wherever or whenever appropriate :-)
+Permission to copy, modify is granted provided that you
+include the above copyright notice with it.
+This software is provided as is, and comes with no promises
+or guarantees.  You may only use it if you promise not to
+sue me or my employer for anything relating to the use of
+this software :-) 
+
+OpenGL is a trademark of Silicon Graphics Inc.
+
+Special thanks to:
+	Tim Bunce
+	Brian Paul
+	Karl Glazebrook   http://www.ast.cam.ac.uk/~kgb
+	The Alberta Research Council
+	
+Feel free to email me your name so I can add it to the above list.
+Acknowledgement and credit for those where acknowledgement
+and credit is warrented ... yadda , yadda .... bla ... bla ...
+
+Some of these examples in the "examples" subdirectory
+are adapted from the OpenGL Programming Guide.
+
+Here's the copyright that was attached to the examples
+from "OpenGL Programming Guide" by Neider, Davis, and Woo,
+and published by Addison Wesley:
+
+/*
+ * (c) Copyright 1993, Silicon Graphics, Inc.
+ * ALL RIGHTS RESERVED 
+ * Permission to use, copy, modify, and distribute this software for 
+ * any purpose and without fee is hereby granted, provided that the above
+ * copyright notice appear in all copies and that both the copyright notice
+ * and this permission notice appear in supporting documentation, and that 
+ * the name of Silicon Graphics, Inc. not be used in advertising
+ * or publicity pertaining to distribution of the software without specific,
+ * written prior permission. 
+ *
+ * THE MATERIAL EMBODIED ON THIS SOFTWARE IS PROVIDED TO YOU "AS-IS"
+ * AND WITHOUT WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR OTHERWISE,
+ * INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR
+ * FITNESS FOR A PARTICULAR PURPOSE.  IN NO EVENT SHALL SILICON
+ * GRAPHICS, INC.  BE LIABLE TO YOU OR ANYONE ELSE FOR ANY DIRECT,
+ * SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY
+ * KIND, OR ANY DAMAGES WHATSOEVER, INCLUDING WITHOUT LIMITATION,
+ * LOSS OF PROFIT, LOSS OF USE, SAVINGS OR REVENUE, OR THE CLAIMS OF
+ * THIRD PARTIES, WHETHER OR NOT SILICON GRAPHICS, INC.  HAS BEEN
+ * ADVISED OF THE POSSIBILITY OF SUCH LOSS, HOWEVER CAUSED AND ON
+ * ANY THEORY OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE
+ * POSSESSION, USE OR PERFORMANCE OF THIS SOFTWARE.
+ * 
+ * US Government Users Restricted Rights 
+ * Use, duplication, or disclosure by the Government is subject to
+ * restrictions set forth in FAR 52.227.19(c)(2) or subparagraph
+ * (c)(1)(ii) of the Rights in Technical Data and Computer Software
+ * clause at DFARS 252.227-7013 and/or in similar or successor
+ * clauses in the FAR or the DOD or NASA FAR Supplement.
+ * Unpublished-- rights reserved under the copyright laws of the
+ * United States.  Contractor/manufacturer is Silicon Graphics,
+ * Inc., 2011 N.  Shoreline Blvd., Mountain View, CA 94039-7311.
+ *
+ * OpenGL(TM) is a trademark of Silicon Graphics, Inc.
+ */

FreeGLUT/README.txt

@@ -0,0 +1,2 @@
+Since FreeGLUT has been stable/frozen since 2005, and since shared libs are usable across all
+Win32 OSs, I've included binary builds of FreeGLUT for Win32.

FreeGLUT/freeglut.dll

@@ -0,0 +1,122 @@
+ This module is a testing and integration version of POGL only.
+ See POGL for the official release.  This interface will likely
+ change radically before the full POGL functionality is
+ integrated with PDL.  Thanks!
+
+ Visit the Perl OpenGL (POGL) Developer's Site for more information:
+ http://graphcomp.com/opengl
+
+ To install the OpenGL module, please follow these instructions:
+
+ 1. Update your development environment with the latest OpenGL header
+    and lib files.  If you are using a GPU, get the latest drivers
+    from your vendor.
+
+    Install FreeGLUT (or compatible) - you can find this at
+    http://freeglut.sourceforge.net/.
+
+    On Windows, FreeGLUT is installed automatically by this module if
+    needed.  On Mac OS X (Leopard and newer), GLUT is built in.  On
+    Linux distributions FreeGLUT is available via their package
+    installers.
+
+    The 'include' subfolder provided with this module contains headers
+    that this module has been tested with.
+
+    This module looks for libGL.so, libGLU.so and libglut.so
+    (opengl32.dll, glu32.dll and freeglut.dll on Windows) in the normal
+    places for your OS installation; you may need to symlink libraries
+    from various vendors to the proper place/names.
+
+    Note: it is strongly recommended, but not required, that you
+    install PerlMagick (6.3.5 or newer) first, as this will
+    dramatically simplify and enhance your ability/performance in
+    loading/saving images/textures via OpenGL::Image - see INSTALL
+    note in the OpenGL::Image module.
+
+ 
+ 2. Run 'perl Makefile.PL'
+
+    Makefile.PL attempts to detemine your OS and available libs.
+    You can override these defaults by specifying:
+
+        perl Makefile.PL interface=XFACE [verbose]
+
+    where XFACE is one of the following constants:
+
+        FREEGLUT		Default window interface
+        GLUT			Fallback if FreeGLUT is not available
+        GLX			Unix X11
+        W32API			Windows via CYGWIN
+        AGL			Mac OS X
+        
+    Makefile.PL will attempt to build and run a glversion utility to
+    determine what version and extensions your OpenGL installation
+    supports, and will create an gl_exclude.h header file to exclude
+    APIs your libraries do not support.  You can manually edit this
+    file to override excluded extensions.
+
+    The "verbose" option provides additional info for troubleshooting.
+
+    Note: glversion assumes libGL.so and libglut.so
+    (opengl32.dll and freeglut.dll on Windows) - and that it will
+    be run via a GUI window (eg. X11 on Unix).  This will impact
+    automated build systems.
+
+
+    For building POGL without extension exclusions, use:
+
+        perl Makefile.PL dist=NO_EXCLUSIONS
+
+    Note: NO_EXCLUSIONS is the default for Windows; this can be
+    overridden by using the EXCLUSIONS option.
+
+
+    To install in non-standard locations, use the PREFIX and LIB options
+    when generating the Makefiles:
+
+        perl Makefile.PL prefix=/PREFIXPATH [LIB=/PREFIXPATH/perl/lib]
+
+    where PREFIXPATH is the path of the directory where you wish
+    the module to be installed (e.g. binary executables in /PREFIXPATH/bin,
+    manual pages in /PREFIXPATH/man, library files in /PREFIXPATH/lib...).
+    The LIB option allows you to control where the perl module stuff goes
+    rather than the default /PREFIXPATH/lib/perl5).
+
+    Then either set the PERL5LIB environment variable before you run
+    scripts that use the modules/libraries (see perlrun) or in your
+    programs say:
+ 
+      use lib '/PREFIXPATH/perl/lib';
+
+
+ 3. Run 'make' ('nmake' on Windows) to build OpenGL.pm.
+
+ 
+ 4. Run 'make test' ('nmake test' on Windows) to test your
+    installation.  You must have GLUT installed in order to run
+    this test.  You should see a spinning cube with textured surfaces.
+    Press 'q' to quit/complete the test (the test window must have focus).
+
+    Note: Automated builds will normally fail this test, as it requires
+    the ability to open a GL context (window) and provide user input.
+
+ 
+ 5. If all is well, run 'sudo make install' ('nmake install on Windows')
+    to intall the OpenGL module onto your system.
+
+
+ 6. It is recommended (not required) that you also install the OpenGL::Image
+    and OpenGL::Shader modules to enhance POGL's features.
+
+
+Read the included README files for additional notes on your particular
+platform.
+
+
+If you get an error about __eprintf missing, add
+
+   -L/opt/gnu/lib/gcc-lib/sparc-sun-solaris2.7/2.96/ -lgcc
+
+to the @LIBS initializer in Makefile.PL (change the directory for the
+appropriate one for your system).