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.
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.