X-Git-Url: https://git.yukkurigames.com/?p=python-bulletml.git;a=blobdiff_plain;f=bulletml%2F__init__.py;h=62a1d0419c696097fb723e58084287194d2056e6;hp=addc0fee1bce133a4c49fdd890b9bb9a6ecfbb63;hb=9da06c24edb2148cf6b773b58d280a1db407c5ce;hpb=70d25195d561d8b5d3126c6bbac0ecad2a502f06

diff --git a/bulletml/__init__.py b/bulletml/__init__.py
index addc0fe..62a1d04 100644
--- a/bulletml/__init__.py
+++ b/bulletml/__init__.py
@@ -9,6 +9,11 @@ renderer-agnostic.
 In addition to the standard BulletML XML format, this module supports
 an equivalent YAML format. See bulletml.bulletyaml for more details.
 
+Finally, three simple collision routines are provided:
+bulletml.overlaps for stationary circles, bulletml.collides for moving
+circles, and bulletml.collides_all for one moving circle against many
+moving circles.
+
 More information is available at the BulletML homepage,
 http://www.asahi-net.or.jp/~cs8k-cyu/bulletml/index_e.html, or the
 python-bullet homepage, http://code.google.com/p/python-bulletml/.
@@ -17,15 +22,13 @@ Basic Usage:
 
     from bulletml import Bullet, BulletML
     doc = Bulletml.BulletML.FromDocument(open("test.xml", "rU"))
+    player = ...  # On your own here, but it needs x and y fields.
     rank = 0.5    # Player difficulty, 0 to 1
-    params = []   # Initial variable settings, usually empty
-    actions = [a(params, rank) for a in doc.top]
-    bullet = Bullet(x, y, target=player, actions=actions, rank=rank)
+    bullet = Bullet.FromDocument(doc, x, y, target=player, rank=rank)
     bullets = [bullet]
     ...
     for bullet in bullets:
         bullets.extend(bullet.step())
-
     ...
 
 For drawing, you're on your own, but Bullet instances have a number of
@@ -35,9 +38,11 @@ attributes that can be used to influence it.
 
 from bulletml.parser import BulletML
 from bulletml.impl import Bullet
+from bulletml.collision import overlaps, collides, collides_all
 
-VERSION = (0, 1)
+VERSION = (2,)
 VERSION_STRING = ".".join(map(str, VERSION))
 
-__all__ = ["VERSION", "VERSION_STRING", "Bullet", "BulletML"]
+__all__ = ["VERSION", "VERSION_STRING", "Bullet", "BulletML",
+           "overlaps", "collides", "collides_all"]