PyOpenGL 3.x The Python OpenGL Binding

About PyOpenGL

PyOpenGL is the most common cross platform Python binding to OpenGL and related APIs. The binding is created using the standard ctypes library, and is provided under a liberal BSD-style Open-Source license.

PyOpenGL Supports

• OpenGL v1.1 to 4.x
• GLES 1 to 3.1 (Experimental)
• GLU
• EGL, WGL, GLX
• GLUT, FreeGLUT
• GLE 3 (GL Extrusion Library)
• hundreds of extensions to GL, GLES, EGL, WGL and GLX

PyOpenGL is interoperable with a large number of external GUI libraries for Python including (but not limited to):

• wxPython
• PyGame
• PyQt and PySide
• PyGTK
• Raw XLib
• OSMesa
• Raspberry Pi BCM
• Tkinter (if you have installed the Togl widget for Tk)

PyOpenGL 3.x runs on:

• Python 3.6+ (3.x < 6 support is likely to work, but untested)
• Python 2.7 (PyOpenGL 3.x will be the last version to support Python 2.x)
• PyPy (experimental)

Sub-Packages

The PyOpenGL project includes a number of sub-projects:

• PyOpenGL, the "OpenGL" package when installed, provides GL, GLES1, GLES2, GLES3, GLUT, GLU, GLE, WGL, EGL and GLX subpackages
• OpenGL_accelerate, a cython coded accelerator module for PyOpenGL, optional, but recommended where available
  • The code for OpenGL_accelerate is in the core PyOpenGL repository, but is distributed as a separate Python package and installs as OpenGL_accelerate
• PyOpenGL-Demo, a collection of small stand-alone demos
  • You normally want to run these from the source distribution, as there's nothing installed by the package
• OpenGLContext, a teaching and testing library built on top of PyOpenGL (and a lot of other libraries)
• You do NOT need OpenGLContext to use PyOpenGL

Downloading and Installation

The easiest way to install PyOpenGL is using pip

$ pip3 install PyOpenGL PyOpenGL_accelerate

You can also manually download the packages:

• PyOpenGL
• PyOpenGL_accelerate
• PyOpenGL Demo
• OpenGLContext

unpack them into temporary directories, change to those directories and run:

python setup.py

Detailed installation instructions are available.

Documentation

The documentation collection provides reference documentation, support and feedback information and pointers to more in-depth documentation.

Source Code

You can work with latest version of PyOpenGL using the git distributed source code control tool on the GitHub code-hosting platform:

git clone https://github.com/mcfletch/pyopengl.git
git clone https://github.com/mcfletch/pyopengl-demo.git
git clone https://github.com/mcfletch/openglcontext.git

If you encounter a bug, feel free to file a GitHub ticket, but do note that the author of PyOpenGL only gets a few days a year to work on Open Source projects these days, so expect that responses are likely to be slow.

Support

Bugs and general questions are best reported and answered on the PyOpenGL mailing list.  The list is fairly low-traffic.