public
Description: A module for to render using the Processing renderer from Python
Homepage:
Clone URL: git://github.com/bmander/prender.git
name age message
file README Wed Apr 01 15:32:16 -0700 2009 context manager throws errors upwards after fin... [bmander]
file makefile Thu Feb 26 18:27:32 -0800 2009 better, cleaner installation [bmander]
directory prender/ Wed Apr 01 15:32:16 -0700 2009 context manager throws errors upwards after fin... [bmander]
directory renderer/ Thu Feb 26 18:02:34 -0800 2009 moved renderer.pde into its own directory [bmander]
file setup.py Thu Feb 26 18:27:32 -0800 2009 better, cleaner installation [bmander]
README
PRender is a way to use Processing from inside Python. Like this:

Draw an X and save it as a "x.png":

  from prender import processing
  pr = processing.BaseRenderer()
  pr.start(200,200)
  pr.line(0,0,100,100)
  pr.line(0,100,100,0)
  pr.saveLocal( "x.png" )
  pr.stop()
  
If python throws an unhandled exception while the renderer is running, it will stall forever. Some sugar to handle that:


  from prender import processing
  pr = processing.BaseRenderer()
  
  def draw(xx):
    xx.line(0,0,100,100)
    xx.line(0,100,100,0)
    xx.saveLocal( "x.png" )
    raise Exception( "random problem" )
  
  pr.execute( 200, 200, draw )
  
The execute() method runs the function draw() until it finishes or catches an exception, at which point it stops the 
renderer.

The class "MapRenderer" is helpful for rendering maps

  from prender import processing
  mr = processing.MapRenderer()
  mr.start(-500,-500,500,500,500) #left,bottom,right,top,width
  mr.background(255,255,255)
  mr.line(-500,-500,500,500) #from lower-lefthand to upper-righthand
  mr.saveLocal("map.png")
  mr.stop()

==== INSTALLATION INSTRUCTIONS ====

--== Compile rendering server ==--

1) Open renderer/renderer.pde in Processing
2) Run it. It should throw an error along the lines of.
  "java.lang.ClassCastException: renderer cannot be cast to processing.core.PApplet
    at processing.core.PApplet.main(PApplet.java:6486)"
3) Go to "File"->"Export Application" and export a linux application.

--== Install rendering server ==--

$ sudo make install

--== Install python client library ==--

$ sudo python setup install

--== Test ==--

$ cd prender
$ python processing.py

If everything is working properly, several images should show up in the local directory. You can delete them; they don't 
do anything.