About this fork

The original developer of PyOpenGL is ignoring reported issues and pull requests with fixes, so here's a working fork that integrates some fixes from the community.

Put these lines in your requirements.txt to use this fork:

PyOpenGL @ git+https://github.com/gulagkulak/pyopengl.git@master#egg=PyOpenGL
PyOpenGL_accelerate @ git+https://github.com/gulagkulak/pyopengl.git@master#egg=PyOpenGL_accelerate&subdirectory=accelerate

Then install with:

$ pip install -r requirements.txt

PyOpenGL and PyOpenGL_Accelerate

PyOpenGL is normally distributed via PyPI using standard pip:

$ pip install PyOpenGL PyOpenGL_accelerate

You can install this repository by branching/cloning and running pip:

$ cd pyopengl
$ pip install -e .
$ cd accelerate
$ pip install -e .

Note that to compile PyOpenGL_accelerate you will need to have a functioning Python extension-compiling environment.

Learning PyOpenGL

If you are new to PyOpenGL, you likely want to start with the OpenGLContext tutorial page. Those tutorials require OpenGLContext, (which is a big wrapper including a whole scenegraph engine, VRML97 parser, lots of demos, etc) you can install that with:

$ pip2.7 install "OpenGLContext-full==3.1.1"

Or you can clone it (including the tutorial sources) with:

$ git clone https://github.com/mcfletch/openglcontext.git

or (for GitHub usage):

$ git clone https://github.com/mcfletch/pyopengl.git

The documentation pages are useful for looking up the parameters and semantics of PyOpenGL calls.

Running Tests

You can run the PyOpenGL test suite from a source-code checkout, you will need:

• git (for the checkout)
• GLUT (FreeGLUT)
• GLExtrusion library (libgle)
• GLU (normally available on any OpenGL-capable machine)
• tox (pip install tox)

Running the test suite from a top-level checkout looks like:

$ tox

The result being a lot of tests being run in a matrix of environments. All of the environment will pull in pygame, some will also pull in numpy. Some will have accelerate, and some will not.