Installation¶
The most straightforward way to install glumpy is to use pip:
pip install glumpy
or upgrade any existing installation:
pip install --upgrade glumpy
Packages requirements¶
Mandatory requirements for glumpy are:
- numpy: http://numpy.org
- pyopengl: http://pyopengl.sourceforge.net
- cython: http://cython.org
- triangle: http://dzhelil.info/triangle/
The most easy way to install these dependencies is:
$ pip install numpy
$ pip install cython
$ pip install pyopengl
$ pip install triangle
If you have alread installed them, make sure to upgrade to the lastest version:
$ pip install --upgrade numpy
$ pip install --upgrade pyopengl
$ pip install --upgrade cython
$ pip install --upgrade triangle
Backends requirements¶
Glumpy requires at least one toolkit for opening a window and creates an OpenGL context. This can be done using one of the standard C/C++ toolkits (Qt, GLFW, glut, pygame, SDL2, Wx, GTK2 or GTK3) and requires the corresponding python bindings or a pure python toolkit such as pyglet.
Warning
You only need to have one of these packages, no need to install them all !
Modern Backends | Qt | GLFW | Pyglet | SDL2 | GTK3 | Wx3 |
Multiple windows | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Non-decorated windows | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Resize windows | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Move windows | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Set GL API | ✓ | ✓ | — | ✓ | ✓ | ✓ |
Set GL Profile | ✓ | ✓ | — | ✓ | ✓ | ✓ |
Share GL Context | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Fullscreen | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Unicode handling | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Old school backends | Wx2 | Glut | Freeglut | Pygame | GTK 2.x |
Multiple windows | ✓ | — | — | — | ✓ |
Non-decorated windows | ✓ | ✓ | ✓ | ✓ | ✓ |
Resize windows | ✓ | ✓ | ✓ | — | ✓ |
Move windows | ✓ | ✓ | ✓ | — | ✓ |
Set GL API | — | — | — | — | — |
Set GL Profile | — | — | — | — | — |
Share GL Context | — | — | — | — | ✓ |
Fullscreen | ✓ | ✓ | ✓ | ✓ | ✓ |
Unicode handling | ✓ | — | — | ✓ | ✓ |
Scroll event | ✓ | — | ✓ | — | ✓ |
Hardware requirements¶
Glumpy makes heavy use of the graphic cards installed on your system. More precisely, glumpy makes heavy use of the Graphical Processing Unit (GPU) through shaders. Glumpy thus requires a fairly recent video card (~ less than 12 years old) as well as an up-to-date video driver such that glumpy can access the programmable pipeline (as opposed to the fixed pipeline).
On Linux and OSX platform, you can type:
$ glxinfo
The results of the above command and is long list of information related to your video driver. The most important information for the time being is whether you have direct access to your video card and what is the GL version and the shading language version:
...
direct rendering: Yes
...
OpenGL vendor string: NVIDIA Corporation
OpenGL renderer string: NVIDIA GeForce GT 650M OpenGL Engine
OpenGL version string: 2.1 NVIDIA-8.24.9 310.40.25f01
OpenGL shading language version string: 1.20
...
The OpenGL version must be at least 2.1 and the shading language version must be at least 1.1. If this is not the case, you need to install more recent versions. Have a look a your system documentation or browse online for howtos.