This wiki has been moved to into the mediawiki branch.

Collision detection

From SuperTux
Jump to: navigation, search

This article describes Collision Detection (CD) schemes that were, are or should be implemented in SuperTux

There's a very good introduction into collision detection techniques at Make sure you've read that if you want to work on collision detection.

New Collision Detection

We're currently (July 2006) in the process of rewriting some parts of the collision detecion. Here are some random notes on how it works:

Simple BoundingBox / Triangle tests

We don't do any complicated sweep tests anymore, but simply test the destination positions of objects. When pushing objects out of collisions we also mostly ignore object movement now and simply push the object out of the collision in the shortest way possible. We don't sort collisions by time anymore, but try to resolve all collisions at once. The staged approach of the old system remains though.

Several Collision Detection Phases

We do collision detection in several phases with different groups of objects with slightly different characteristics each time. Currently defined collision groups:

enum CollisionGroup {
 /** Objects in DISABLED group are not tested for collisions */
  * "default" is moving object. MovingObjects get tested against all other
  * objects and against other movingobjects
  * a Moving object, that is not tested against other MovingObjects (or other
  * MovingOnlyStatic objects), but is tested against all other objects.
  * Doesn't move and isn't explicitly checked for collisions with other
  * objects (but other objects might check with this)
  * The difference to COLGROUP_TOUCHABLE is that we can do multiple
  * collision response tests in a row which is needed for static object
  * that tux walks on. The results for collisions with STATIC objects
  * are also sorted by time (so that the first hit gets handled first).
  * Use this for static obstacles
  * Isn't explicitly checked for collisions with other objects. But other
  * objects might check with this object.
  * Difference to COLGROUP_STATIC is that collisions with this object are
  * only tested once and collision response is typically not handled
  * Use this for touchable things like spikes/areas or collectibles like
  * coins
  * Should be used for tilemaps

Current collision detection Phases:

  1. COLGROUP_MOVING vs. COLGROUP_STATIC, this handles all collisions against solid objects (see below for details)
  2. COLGROUP_MOVING vs tile attributes, handles collisions against tilemap and reports touched tiles with special attributes (like spike). This is a separate phase to avoid collisions with spikes and similar stuff that are avoided by resolving the solid collisions.
  3. COLGROUP_MOVING vs COLGROUP_TOUCHABLE handles collisions of objects vs. touchable objects like coins/firefly.
  4. COLGROUP_MOVING vs COLGROUP_MOVING we finally handle inter-object collisions

Collisions with solid objects

Collisions with solid objects are handled separately before all other collisions. We use several tricks there:

  • Constraints: We calculate constraints into the left, right, top, bottom position, so that we can detect cases where tux gets crushed between 2 objects
  • Do collision detection into Y direction before doing it into X direction. That's the only way to avoid a collision on the right side in cases like picture 1.
  • We adjust tuxs position slightly when he only touches objects lightly. This helps when trying to jump through small holes and when running over 1 tile wide holes. (See picture 2,3)

Sketch of the algorithm

  1. Calculate desired destination position of all objects
  2. For each object in MOVING_OBJECT group do: (solid phase)
    1. Calculate top/bottom constraints you handle y-movement only. Adjust destination position to the constraints. (but don't report crushes yet)
    2. Calculate left/right constraints with full object movement. Adjust desination position to the constraints. Report a crush if not enough horizontal space is left.
    3. Calculate top/bottom constraints and report a crush if not enough vertical space is left
  3. For each object in MOVING_OBJECT group do: (tile attribute phase)
    1. if the destination position touches any tiles with special attributes: report a collision (call object->collision_tile)
  4. For each object in MOVING_OBJECT group do: (touchable phase)
    1. For each object in TOUCHABLE group do:
      1. If the 2 objects intersect report a collision (object1->collision and object2->collision is called)
  5. For each object in MOVING_OBJECT group do: (inter-object phase)
    1. For each object in MOVING_OBJECT group do:
      1. if the objects intersect report a collision (call object->collision and object2->collision) and push objects out of the collision depending on the rerturned policy from the collision calls.
  6. Move all objects to their destination positions

TODO: Sketch the algorithm for calculating solid constraints


The following 2 cases always results in tux ending in a crushed situation. No nice solution for these cases has been proposed yet (except avoiding these situations in levels, which should be easy).

The first problem is currently worked around by relaxing the crushed condition a bit.