ball.inbox

Syntax

l = ball.inbox(vl,vu<,b>)

Get the list of balls with extents intersecting a box. The extent is the axis-aligned bounding box of the ball. Specifying b = false indicates that only balls with positions falling in the box are returned.

Note

• This function uses cell-space-based algorithms for efficient spatial searching, and therefore assumes that the balls are properly mapped into the cell space. Directly after the model has been restored, or after balls have been created, one must execute a model clean command prior to using this function.

Returns:

l - a pointer to the list of balls

Arguments:

vl - lower corner of the box

vu - upper corner of the box

b - optional intersection specifier