summaryrefslogtreecommitdiff
path: root/src/gallium/state_trackers/python/README
blob: e03d546830411dccb37c788f410731a8f57633fd (plain)
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
This directory contains Python bindings to Gallium3D. It looks like a state
tracker from the pipe driver perspective, and it looks like a pipe driver from
the python script perspective.


To build you'll need:
* Python (with development packages)
* SCons
* SWIG, http://www.swig.org/download.html
* Python Imaging Library with TK support, http://www.pythonware.com/products/pil/, 
  for the samples

On a debian-based distro you can simply do:

  aptitude install python-dev scons swig python-imaging python-imaging-tk

On a Windows machine ensure the swig command is in your PATH.

Invoke scons on the top dir as
 
  scons debug=yes statetrackers=python drivers=softpipe,trace winsys=none

To use it set PYTHONPATH appropriately, e.g, in Linux do:

  export PYTHONPATH=$PWD/build/linux-x86-debug/gallium/state_trackers/python

or (in Windows)

  set PYTHONPATH=%CD%\build\windows-x86-debug\gallium\state_trackers\python

and then try running

  python src/gallium/state_trackers/python/samples/tri.py

which should show a triangle.


This is still work in progress:
- errors are not handled properly and almost always result in crash
- state atoms with array members are awkward to set

--
Jose Fonseca <jfonseca@vmware.com>