1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
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
setup.py::
$ cd pyopengl
$ python setup.py develop
$ cd accelerate
$ python setup.py develop
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.
.. _`tutorial page`: http://pyopengl.sourceforge.net/context/tutorials/index.html
.. _`documentation pages`: http://pyopengl.sourceforge.net/documentation/
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.
.. 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/MikeCFletcher/pyopengl/branch/master
: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
|
