Elements: Difference between revisions

From OLPC
Jump to navigation Jump to search
mNo edit summary
(Undo revision 235268 by 123.53.123.179 (Talk))
 
(35 intermediate revisions by 9 users not shown)
Line 1: Line 1:
<div style="float:right">__TOC__</div>
<div style="float:right">__TOC__</div>
[[Image:Elements_banner1.jpg]]
[[Image:Elements_logo1.png]]



== About ==
== About ==
The ''Elements'' project is all about '''free and easy 2D physics for python''' -- with main attention on:
The ''Elements'' project is all about '''free and easy 2D physics for python''' and the XO laptop. It is used as the backend for the XO physics playground activity [[Physics]].
# An '''easy-to-use''', fast 2D physics API for the [http://wiki.slembcke.net/main/published/Chipmunk Chipmunk] 2d physics engine (with [http://code.google.com/p/pymunk/ pymunk] ctypes bindings)
# Examples and documentation on how to use the API
# Providing the examples as bundles, as they are already interesting and fun
# Speed optimization (also with an eye on the XO laptop :)
# Development of ideas for education and playful-learning




: '''Watch [http://www.youtube.com/watch?v=NZNTgglPbUA this] and [http://www.youtube.com/watch?v=QsTqspnvAaI that] video to see where we are heading
:[http://www.linuxuser.at/elements/elements.zip Elements.zip] (338 kb) | [http://www.linuxuser.at/elements/elements.xo Elements.xo] (195 kb) | [[Elements/Documentation|Documentation]] | [http://www.linuxuser.at/Elements Browse Source]


: IRC: '''#elements''' on irc.freenode.net


== More Informations ==
* IRC: #elements on irc.freenode.net
* Project started by [[User:Crazy-chris|Chris Hager]], March 2008. Source-Code is GPL licensed - so do with it what you want! Even eat it :)
* The ''Elements'' project derived from [[pymunx]], which started as examples for pymunk and is growing up to a real physics api for python
* The 2D physics is handled by the chipmunk physics engine (written in C by ...)
* Communication to the chipmunk library is done via the pymunk ctypes bindings (by Victor Blomqvist.)
* A lively and open development and support team is having fun improving and helping out :)
* Features: ''fast, easy to use, segments, polygons, circles, colissions, variable gravity, density, mass, friction, elasticity, inertia, impulses, screenshots, screencasts, cross-platform, entertaining, fascinating, ...''
* Limitations which will be implemented soon: Joints, Grouped Elements and Non-convex Polygons. Screencast encoding currently works only in linux with mencoder installed.


: <big>Homepage: http://elements.linuxuser.at</big>


== Screenshots ==
== Screenshots ==
Line 32: Line 19:


[[Image:Screenshot3.png|400px]] [[Image:Screenshot4.png|400px]]
[[Image:Screenshot3.png|400px]] [[Image:Screenshot4.png|400px]]


== Videos ==


== Downloads ==
* [[Image:Elements.zip]] (338 kb): Elements API, demos, pymunk, compiled chipmunk libs (and, for the curious, the Chipmunk sources)
* [[Image:Elements.xo]] ... ''Demo selection bundles for the XO laptop''
* ''<tt>svn checkout http://pymunk.googlecode.com/svn/trunk/ pymunk-read-only</tt>'' ... ''Pymunk with demos and docs''
* [http://files.slembcke.net/chipmunk/release/ChipmunkLatest.tgz ChipmunkLatest.tgz] ... ''The source of the Chipmunk physics engine (written in C)''


== Documentations ==
* [[Elements/Documentation|Elements API Documentation]]
* [http://www.linuxuser.at/pymunx/pymunk_api Pymunk API]
* [http://files.slembcke.net/chipmunk/chipmunk-docs.html Chipmunk Docs]


== Examples ==
http://www.linuxuser.at/Elements/demos
''Examples''
* [http://www.linuxuser.at/Elements/demos/demo1_ballsnsquares.py demo1_ballsnsquares.py] ''(most simple :)''
* [http://www.linuxuser.at/Elements/demos/demo2_drawwalls.py demo2_drawwalls.py] ''(create new walls)''
* [http://www.linuxuser.at/Elements/demos/demo3_addmany.py demo3_addmany.py] ''(add more objects at once)''
* [http://www.linuxuser.at/Elements/demos/demo4_drawpoly.py demo4_drawpoly.py] ''(draw a polygon)''
* [http://www.linuxuser.at/Elements/demos/demo5_draw.py demo5_draw.py] ''(tryout for segments (buggy))''
* [http://www.linuxuser.at/Elements/demos/demo6_throw_and_settings.py demo6_throw_and_settings.py] ''(++) (adjust elasticity, density, size and throw in objects)''
* [http://www.linuxuser.at/Elements/demos/demo7_elasticbox.py demo7_elasticbox.py] ''(++) (elastic walls all around. very funny :)''
* [http://www.linuxuser.at/Elements/demos/demo8_gravityfun.py demo8_gravityfun.py] ''(+++) (change the gravity vector (or set to (0,0) by right mouse click)''




Line 96: Line 54:
# Try to stay at 50 FPS
# Try to stay at 50 FPS
clock.tick(50)
clock.tick(50)

[[category:software ideas]]
[[category:physics]]
[[category:science]]

Latest revision as of 23:57, 18 May 2010

Elements logo1.png

About

The Elements project is all about free and easy 2D physics for python and the XO laptop. It is used as the backend for the XO physics playground activity Physics.


Watch this and that video to see where we are heading
IRC: #elements on irc.freenode.net


Homepage: http://elements.linuxuser.at

Screenshots

(from Elements/Screenshots)

Screenshot1.png Screenshot2.png

Screenshot3.png Screenshot4.png


Pygame Example

The typical usage in pygame can look like this:

      import pygame
      from pygame.locals import *
      from pygame.color import *   

      from elements import *
       
      pygame.init()
      screen = pygame.display.set_mode((800, 800))
      clock = pygame.time.Clock()

      world = elements()
      world.add_wall((100, 200), (300, 200))
         
      # Main Game Loop:
      while running:
         # Event Handling
         # Maybe calling world.add_ball(event.pos) or world.add_square(event.pos)
         # ...

         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)