Standard OpenGL bindings for Python
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.
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.
.. _tutorial page
: http://pyopengl.sourceforge.net/context/tutorials/index.html
.. _documentation pages
: https://mcfletch.github.io/pyopengl/documentation/index.html
You can run the PyOpenGL test suite from a source-code checkout, you will need:
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.
.. image:: https://travis-ci.org/mcfletch/pyopengl.svg?branch=master :target: https://travis-ci.org/mcfletch/pyopengl :alt: Travis Tests
.. image:: https://ci.appveyor.com/api/projects/status/github/mcfletch/pyopengl :target: https://ci.appveyor.com/project/MikeCFletcher/pyopengl :alt: Appveyor Build
.. image:: https://img.shields.io/pypi/v/pyopengl.svg :target: https://pypi.python.org/pypi/pyopengl :alt: Latest PyPI Version
.. image:: https://img.shields.io/pypi/dm/pyopengl.svg :target: https://pypi.python.org/pypi/pyopengl :alt: Monthly download counter