• svn URL

Use this URL in your Subversion client. Need more instructions?
 

A API for 2D rigid body physics with python / pygame and both the Chipmunk and Box2D physics engine.

root

User picture

Author: asaf

Revision: 230 («Previous)


(August 23, 2009 22:49 UTC) Almost 3 years ago

Added jointDef.collideConnected property to be loaded by json_load

 
Name Date Rev. Commit message
buildscripts Fri, Apr 18 2008 161 [kne] Really easy Makefile for Win32/MinGW to build Box2D2. Wil...
contrib Tue, Mar 10 2009 222 [kne] Removed my old junk (first Python projects sure were ugly...
demos Tue, Mar 10 2009 224 [kne]
documentation Sun, Apr 27 2008 187 [crazy-chris] put box2d api reference in a zip file (60 files or so)
elements Mon, Aug 24 2009 230 [asaf] Added jointDef.collideConnected property to be loaded by ...
images Fri, Apr 04 2008 107 [crazy-chris] - NEW MANUAL PYGAME STYLE (DUPE :) - UPDATED API - defin...
misc Mon, Mar 31 2008 77 [crazy-chris] amost done
BUILDING Tue, Mar 10 2009 224 [kne]
CREDITS Thu, Jun 12 2008 209 [kne] Documentation modification / BUILDING simplified
ez_setup.py Tue, Mar 10 2009 220 [kne] Basic setuptools support added. Instead of just supportin...
LICENSE Fri, Mar 28 2008 39 [crazy-chris] full gplv3 license text
README Fri, Jul 10 2009 225 [bcjordan] Added another joint method and motor
setup.py Mon, Aug 10 2009 229 [bcjordan] Update version to 0.13 with JSON

README

This file is part of the 'Elements' Project
Elements is a 2D Physics API for Python (supporting Box2D2 (r148))

Copyright (C) 2008, The Elements Team, <elements@linuxuser.at>
 
Home:  http://elements.linuxuser.at
 IRC:  #elements on irc.freenode.net

Code:  svn co http://svn2.assembla.com/svn/elements          
       http://www.assembla.com/wiki/show/elements                  

License: Elements API: GPLv3
         Examples: Public Domain -- No legal restrictions
         
         
=================
Table of Contents
=================
    1. About the 'Elements' Project
    2. Requirements to use and build
    3. References 
    

1. About the 'Elements' Project
===============================
Elements is:
* An easy to use API for integrating 2D physics (with pybox2d) into own python ideas
* User interfaces & simulations, as well as teaching & learning tools
* Fast code

The Elements Project previously supported the Chipmunk 2D physics engine,
but due to the performance we decided to stick with Box2D exclusively. See:
http://wiki.laptop.org/go/Physic_Engines/Speed_Tests


Internal Coordinate Systems
---------------------------

     Elements          Box2D             Pyglet          Pygame
      +y                +y                +y              +-----> +x
      ^                 ^                 ^               |
      |                 |                 |               |
      |                 |                 |               V
      +-----> +x        +-----> +x        +-----> +x      +y

    It is possible to change the input coordinate system to any you wish, by default
    it is set to pygames. This means, adding a circle at (0,0) will add it at the top left corner.
    
    To change that to any other orientations, you can use inputAxisOrigin(left, top)
    > For pygame (default): inputAxisOrigin(left=True, top=True)


Unit Systems
------------

    Elements can take either pixels or meters as input for lengths/positions/...
    
    By default it is set to pixels, for convenient use with pygame. Change to meters with:
    > set_inputUnit(INPUT_METERS) and back with set_inputUnit(INPUT_PIXELS) 
    
    The output to the drawing methods is always done in pixels.
    
    
2. Requirements
===============
2.1 Usage Requirements
-----------------------
- Python  http://www.python.org
- pybox2d http://pybox2d.googlecode.com

pybox2d will be automatically installed by setuptools when you run the installation.

For the demos, these are required:
- pygame  http://www.pygame.org


3. References
=============
- http://wiki.laptop.org/go/Elements
- Elements home  http://www.assembla.com/wiki/show/elements
- Box2D forum    http://www.box2d.org/forum
- Box2D wiki     http://www.box2d.org/wiki
- pybox2d epydoc http://pybox2d.googlecode.com/svn/epydoc/html/index.html