OpenGL(3pm)

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 GitHub project page at <https://github.com/PDLPorters/pdl/issues> .

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://pdl.perl.org/?page=mailing-lists>

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.