NAME

       PDL::Graphics::OpenGL::Perl::OpenGL - PDL TriD OpenGL interface using POGL

VERSION

       Version 0.01_10

SYNOPSIS

       This module provides the glue between the Perl OpenGL functions and the API defined by the internal
       PDL::Graphics::OpenGL one. It also supports any miscellaneous OpenGL or GUI related functionality to
       support PDL::Graphics::TriD refactoring.

       You should eventually be able to replace:

           use PDL::Graphics::OpenGL
       by
           use PDL::Graphics::OpenGL::Perl::OpenGL;

       This module also includes support for FreeGLUT and GLUT instead of X11+GLX as mechanism for creating
       windows and graphics contexts.

EXPORT

       See the documentation for the OpenGL module.  More details to follow as the refactored TriD module
       interface and build environment matures

FUNCTIONS

   TBD
   TBD
   new($class,$options,[$window_type])
       Returns a new OpenGL object with attributes specified in the options field, and of the 3d window type, if
       specified.  These attributes are:

         x,y - the position of the upper left corner of the window (0,0)
         width,height - the width and height of the window in pixels (500,500)
         parent - the parent under which the new window should be opened (root)
         mask - the user interface mask (StructureNotifyMask)
         attributes - attributes to pass to glXChooseVisual

       Allowed 3d window types, case insensitive, are:

         glut - use Perl OpenGL bindings and GLUT windows (no Tk)
         x11  - use Perl OpenGL (POGL) bindings with X11 (disabled)

   default GLUT callbacks
       These routines are set as the default GLUT callbacks for when GLUT windows are used for PDL/POGL.  Their
       only function at the moment is to drive an fake XEvent queue to feed the existing TriD GUI controls.  At
       some point, the X11 stuff will the deprecated and we can rewrite this more cleanly.

   default_options
       default options for object oriented methods

   XPending()
       OO interface to XPending

   XResizeWindow(x,y)
       OO interface to XResizeWindow

   glpXNextEvent()
       OO interface to glpXNextEvent

   glpRasterFont()
       OO interface to the glpRasterFont function

   AUTOLOAD
       If the function is not prototyped in OO we assume there is no explicit mention of the three identifying
       parameters (Display, Window, Context) and try to load the OpenGL function.

   glXSwapBuffers
       OO interface to the glXSwapBuffers function

AUTHOR

       Chris Marshall, "<devel dot chm dot 01 at gmail.com>"

BUGS

       Bugs and feature requests may be submitted through the PDL sourceforge project page at
       <http://sourceforge.net/tracker/?group_id=612> .

SUPPORT

       PDL uses a mailing list support model.  The Perldl mailing list is the best for questions, problems, and
       feature discussions with other PDL users and PDL developers.

       To subscribe see the page at <http://mailman.jach.hawaii.edu/mailman/listinfo/perldl>

ACKNOWLEDGEMENTS

       TBD including PDL TriD developers and POGL developers...thanks to all.

COPYRIGHT & LICENSE

       Copyright 2009 Chris Marshall.

       This program is free software; you can redistribute it and/or modify it under the terms of either: the
       GNU General Public License as published by the Free Software Foundation; or the Artistic License.

       See http://dev.perl.org/licenses/ for more information.