Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

pdl::graphics::opengl::perl::opengl(3pm) [debian man page]

OpenGL(3pm)						User Contributed Perl Documentation					       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 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.

perl v5.14.2							    2012-01-02							       OpenGL(3pm)

Check Out this Related Man Page

glutInit(3GLUT) 						       GLUT							   glutInit(3GLUT)

NAME

       glutInit - initialize the GLUT library.

SYNTAX

       #include <GLUT/glut.h>

       void glutInit(int *argcp, char **argv);

ARGUMENTS

       argcp	 A  pointer  to  the  program's  unmodified  argc variable from main.  Upon return, the value pointed to by argcp will be updated,
		 because glutInit extracts any command line options intended for the GLUT library.

       argv	 The program's unmodified argv variable from main. Like argcp, the data for argv will be updated  because  glutInit  extracts  any
		 command line options understood by the GLUT library.

DESCRIPTION

       glutInit  will initialize the GLUT library and negotiate a session with the window system. During this process, glutInit may cause the ter-
       mination of the GLUT program with an error message to the user if GLUT cannot be properly initialized.  Examples of this situation  include
       the failure to connect to the window system, the lack of window system support for OpenGL, and invalid command line options.

       glutInit also processes command line options, but the specific options parse are window system dependent.

X IMPLEMENTATION NOTES

       The X Window System specific options parsed by glutInit are as follows:

       -display DISPLAY
	       Specify the X server to connect to. If not specified, the value of the DISPLAY environment variable is used.

       -geometry WxH+X+Y
	       Determines  where  window's  should be created on the screen. The parameter following -geometry should be formatted as a standard X
	       geometry specification.	The effect of using this option is to change the GLUT initial size and initial position  the  same  as	if
	       glutInitWindowSize or glutInitWindowPosition were called directly.

       -iconic Requests all top-level windows be created in an iconic state.

       -indirect
	       Force the use of indirect OpenGL rendering contexts.

       -direct Force the use of direct OpenGL rendering contexts (not all GLX implementations support direct rendering contexts). A fatal error is
	       generated if direct rendering is not supported by the OpenGL implementation.

	       If neither -indirect or -direct are used to force a particular behavior, GLUT will attempt to use direct rendering if possible  and
	       otherwise fallback to indirect rendering.

       -gldebug
	       After  processing  callbacks  and/or  events, check if there are any OpenGL errors by calling glGetError.  If an error is reported,
	       print out a warning by looking up the error code with gluErrorString.  Using this option is helpful in  detecting  OpenGL  run-time
	       errors.

       -sync   Enable synchronous X protocol transactions.  This option makes it easier to track down potential   X protocol errors.

SEE ALSO

       glutCreateWindow, glutInitWindowPosition, glutInitWindowSize, glutMainLoop

AUTHOR

       Mark J. Kilgard (mjk@nvidia.com)

GLUT
									3.7							   glutInit(3GLUT)
Man Page