"""
   Elements :: A python 2D physics API pymunk 0.6.1+ -- with an focus on pygame

            Home: http://wiki.laptop.org/go/Elements
   Documentation: http://wiki.laptop.org/go/Elements/Documentation
   
 Sources & Demos: http://www.linuxuser.at/Elements
           Forum: http://www.slembcke.net/forums/viewforum.php?f=6
           
             IRC: #elements on irc.freenode.net
   	
   
   > About <

	Elements was started by Chris Hager (chris@linuxuser.at) in March 2008.
	(Please send me feedback :) I just got started on this, more will come
	frequenty, so check back soon :)
	   
	License: GPL, 2008

	Elements 0.1 is bundled with:
	- compiled chipmunk libs for: windows, linux 32 & 64 bit. osx is coming soon...
	- examples and the documentation
	- pymunk ctypes bindings to make chipmunk accessible in python
	- chipmunk source code in C (for the curious :)


   > How-to get the Sources, Examples & Chipmunk Library <
   
   	http://....zip
      	

   > Version <
   
   	Elements 0.1 (11. March 2008)
   	   

   > Latest Changes <


   > How to use Elements <

	You'll simply need to include the directory 'elements' like any other python module:

		import elements

	Now you can start using the whole Elements class (see the doc :)


   > Typical example with pygame <

   	world = elements()
   	world.add_wall((100, 200), (300, 200))
   	
   	# Main Game Loop:
   	while running:
   		# Event Checking
   		# ...

		screen.fill((255,255,255))

		# Update & Draw World
		world.update()
		world.draw(screen)

		# Flip Display
		pygame.display.flip()
		
		# Try to stay at 50 FPS
		clock.tick(50)   		


   > Quick Info about the Physical Properties <

   	Inertia:    The moment of inertia is like the mass of an object, but applied to its rotation. 
		    An object with a higher moment of inertia is harder to spin.

   	Elasticity: A value of 0.0 gives no bounce, while a value of 1.0 will give a 'perfect' bounce. 
		    However due to inaccuracies in the simulation using 1.0 or greater is not recommended however.
	
	Friction:   (Friction coefficient): Chipmunk uses the Coulomb friction model, a value of 0.0 is frictionless.
	
	Velocity:   The surface velocity of the object. Useful for creating conveyor belts or players that move around. 
		    This value is only used when calculating friction, not the collision.
"""
