use math::Point;

/// Traits of objects having a bounding volume.
pub trait HasBoundingVolume<M, BV> {
    /// The bounding volume of `self` transformed by `m`.
    fn bounding_volume(&self, m: &M) -> BV;
}

/// Trait of bounding volumes.
///
/// Bounding volumes are coarse approximations of shapes. It usually have constant time
/// intersection, inclusion test. Two bounding volume must also be mergeable into a bigger bounding
/// volume.
pub trait BoundingVolume<P: Point> {
    // FIXME: keep that ? What about non-spacial bounding volumes (e.g. bounding cones, curvature
    // bounds, etc.) ?
    /// Returns a point inside of this bounding volume. This is ideally its center.
    fn center(&self) -> P;

    /// Checks if this bounding volume intersect with another one.
    fn intersects(&self, &Self) -> bool;

    /// Checks if this bounding volume contains another one.
    fn contains(&self, &Self) -> bool;

    /// Merges this bounding volume with another one. The merge is done in-place.
    fn merge(&mut self, &Self);

    /// Merges this bounding volume with another one.
    fn merged(&self, &Self) -> Self;

    /// Enlarges this bounding volume.
    fn loosen(&mut self, P::Real);

    /// Creates a new, enlarged version, of this bounding volume.
    fn loosened(&self, P::Real) -> Self;

    /// Tighten this bounding volume.
    fn tighten(&mut self, P::Real);

    /// Creates a new, tightened version, of this bounding volume.
    fn tightened(&self, P::Real) -> Self;
}