#tree #collision #hit #detect

bin+lib collide_tree

A test for colliding many objects that runs at O(n*lg(n)) and can be used at any number of dimensions

2 releases

0.1.1 Dec 2, 2020
0.1.0 Dec 2, 2020

#10 in #hit

MIT license

13KB
278 lines

Collide Tree

A test for colliding many objects that runs at O(n*lg(n)) and can be used at any number of dimensions

This runs faster than the naive, "compare everything with everything else" system, with over 25 elements.

With 1000 Elements, it runs in a 5th of the time.

  • Naive : ~= 210.3ms
  • Collide Tree: ~= 38.ms

How to use it.

The CollideTree object is dependant on the following two traits

pub trait BoundBox: Sized + Clone {
    ///Split the box in half somehow, normally this should vary in direction
    fn split(&self) -> (Self, Self);
    ///Test if one box collides with another.
    fn hits(&self, b: &Self) -> bool;
}

pub trait Located {
    type Box: BoundBox;
    fn bounds(&self) -> Self::Box;
}

When you create the CollideTree, you must provide it with a <T:BoundBox>. This will represent the area the tree will put the items into. Items you add will all be of type <L:Located+Debug> and the bounds method must return a T.

to get a list of collisions from a list of 'L', simply add them to the tree, and use the closure to mark what you want to do with the collisions.


    let list = create_range_list(1000);
    let mut tree = CollideTree::new(Bounds::new(0., 0., 1000., 1000.));

    //the vec for building the result 
    let mut t_col = Vec::new();


    for a in &list {
        //in the closure add the collision ids to the result. or do something else with them
        tree.add_item(a.clone(), &mut |a, b| t_col.push((a.id, b.id)));
    }

Dependencies

~670KB
~12K SLoC