src/gallium/state_trackers/python/README

   1 This directory contains Python bindings to Gallium3D. It looks like a state
   2 tracker from the pipe driver perspective, and it looks like a pipe driver from
   3 the python script perspective.
   4
   5
   6 To build you'll need:
   7 * Python (with development packages)
   8 * SCons
   9 * SWIG, http://www.swig.org/download.html
  10 * Python Imaging Library with TK support, http://www.pythonware.com/products/pil/,
  11   for the samples
  12
  13 On a debian-based distro you can simply do:
  14
  15   aptitude install python-dev scons swig python-imaging python-imaging-tk
  16
  17 On a Windows machine ensure the swig command is in your PATH.
  18
  19 Invoke scons on the top dir as
  20
  21   scons debug=yes statetrackers=python drivers=softpipe winsys=none
  22
  23 To use it set PYTHONPATH appropriately, e.g, in Linux do:
  24
  25   export PYTHONPATH=$PWD/build/linux-x86-debug/gallium/state_trackers/python
  26
  27 or (in Windows)
  28
  29   set PYTHONPATH=%CD%\build\windows-x86-debug\gallium\state_trackers\python
  30
  31 and then try running
  32
  33   python progs/gallium/python/samples/tri.py
  34
  35 which should show a triangle.
  36
  37
  38 This is still work in progress:
  39 - errors are not handled properly and almost always result in crash
  40 - state atoms with array members are awkward to set
  41
  42 --
  43 Jose Fonseca <jfonseca@vmware.com>