Getting started with DartBox2d part 2

This is an update to this post as dartbox2d has undergone some drastic changes since that was written over a year ago.

Getting the code

The first of the main differences is that dartbox2d is now a package hosted on pub. Getting the code is a matter of having a pubspec.yaml file in the root of your project that looks something like:

name: dartbox2d-tutorial
version: 0.0.1
author: Dominic Hamon <>
    box2d: ">=0.1.1"
    browser: any"

The dependencies section is the important bit. This lets pub know that this application depends on any version of box2d with a version number greater than 0.1.1. That version uses the vector_math package instead of a hand-rolled math library and runs against the latest (as of this writing) dart sdk r19447. It also depends on browser which we’ll need to pull in the script to allow the code to run both as dart and javascript.

Then, just call $DART_SDK/bin/pub install and the box2d package will be installed. If any errors about conflicting dependencies are printed, please let me know.

The HTML page

    <script type="application/dart" src="tutorial.dart"></script>
    <script src="packages/browser/dart.js"></script>

The Dart code

At the top of the dart file, you would now import the libraries you need:

library dartbox2d_tutorial;
import 'dart:html';
import 'package:box2d/box2d.dart';

Note that the box2d package actually contains two libraries; box2d.dart for use with the VM and box2d_browser.dart for use in the browser. The only difference is that the latter enables debug drawing functions using dart:html. If you’re planning on running through DartEditor, you probably want box2d_browser.

The rest of the tutorial works almost as is, though the new math library means that initializeWorld should look like:

void initializeWorld() {
    // Create a world with gravity and allow it to sleep.
    world = new World(new vec2(0, -10), true, new DefaultWorldPool());

    // Create the ground.
    PolygonShape sd = new PolygonShape();
    sd.setAsBox(50.0, 0.4);

    BodyDef bd = new BodyDef();
    bd.position.setCoords(0.0, 0.0);
    Body ground = world.createBody(bd);

    // Create a bouncing ball.
    final bouncingBall = new CircleShape();
    bouncingBall.radius = BALL_RADIUS;

    final ballFixtureDef = new FixtureDef();
    ballFixtureDef.restitution = 0.7;
    ballFixtureDef.density = 0.05;
    ballFixtureDef.shape = bouncingBall;

    final ballBodyDef = new BodyDef();
    ballBodyDef.linearVelocity = new vec2(-2, -20);
    ballBodyDef.position = new vec2(15, 15);
    ballBodyDef.type = BodyType.DYNAMIC;
    ballBodyDef.bullet = true;

    final ballBody = world.createBody(ballBodyDef);

And the switch to dart:html leaves initializeCanvas looking like:

CanvasElement canvas;
CanvasRenderingContext2D ctx;
ViewportTransform viewport;
DebugDraw debugDraw

void initializeCanvas() {
    // Create a canvas and get the 2d context.
    canvas = new CanvasElement(width:CANVAS_WIDTH, height:CANVAS_HEIGHT);
    ctx = canvas.getContext("2d");

    // Create the viewport transform with the center at extents.
    final extents = new Vector(CANVAS_WIDTH / 2, CANVAS_HEIGHT / 2);
    viewport = new CanvasViewportTransform(extents, extents);
    viewport.scale = VIEWPORT_SCALE;

    // Create our canvas drawing tool to give to the world.
    debugDraw = new CanvasDraw(viewport, ctx);

    // Have the world draw itself for debugging purposes.
    world.debugDraw = debugDraw;

and run as:

void run() {
    window.animationFrame.then((time) => step());

void step() {
    world.step(1/60, 10, 10);
    ctx.clearRect(0, 0, CANVAS_WIDTH, CANVAS_HEIGHT);

Also, though the frog and dartc compilers have been replaced by dart2js so this is compiled to javascript using:

$ $DART_SDK/bin/dart2js tutorial.dart -otutorial.dart.js

There are a host of examples in the demos folder of the DartBox2d source here.

4 thoughts on “Getting started with DartBox2d part 2

  1. Hi Dominic,

    I can’t seem to get the ‘pub install’ to work. I tried both using the interface in the editor and typing it in manually in the file. Here’s the error that I get:

    — Mar 21, 2013 8:38:22 PM Running pub install … —
    Pub install failed, [1] Resolving dependencies…
    Incompatible version constraints on ‘args’:
    – ‘bot’ depends on version >=0.4.2
    – ‘box2d’ depends on version >=0.4.1 <0.4.2

    I'm not very experienced with the Dart Editor, so there's probably a way around this, but I can't figure it out. Just though I'd give you a heads up.

    • Hi Robbie

      Don’t worry, it’s quite a common situation. It seems that one of the dependencies in box2d (probably unittest) has updated its dependency to bot 0.4.2 and I forgot to pin it so that wouldn’t happen.

      I’ll open a bug for myself so I don’t forget. In the mean time, you should be able to either change the ‘pubspec.yaml’ in packages/box2d so it refers to args ">=0.4.2 <0.4.3" or you can change the dependency line for box2d to be:


      That should work.

  2. It seems the dependencies have incremented again, to “=0.4.2 =0.4.2 =0.9.5 <0.9.6"

    Using the "git" option for Source did not work, I think because I could not access the pubspec.yaml until I had a local copy.

    The line bd.position.setCoords(0.0, 0.0); is giving a method doesn't exist error, so I changed it to bd.position.setComponents(0.0, 0.0);

    CanvasViewportTransform seems to be defined only in box2d_browser.dart, so for running in the Dart Editor I changed the import line to:

    import 'package:box2d/box2d_browser.dart';

    The last thing I needed to do to get this to run was remember the constructor! If anyone gets an error calling step() on the world object, this seems to be the reason. Seems like the error message could be more informative… although I guess this is a pretty big mistake!

    Final suggestion: I think it would be quite helpful to link to a file with the complete code, to avoid some confusion about what goes where.

    Thank you for the tutorial!

Leave a Reply

Your email address will not be published. Required fields are marked *