Trait oxygengine_physics_2d::prelude::ncollide2d::query::PointQueryWithLocation

source ·

pub trait PointQueryWithLocation<N>where
    N: RealField + Copy,{
    type Location;

    // Required method
    fn project_point_with_location(
        &self,
        m: &Isometry<N, Unit<Complex<N>>, 2>,
        pt: &OPoint<N, Const<2>>,
        solid: bool
    ) -> (PointProjection<N>, Self::Location);
}

Expand description

Returns shape-specific info in addition to generic projection information

One requirement for the PointQuery trait is to be usable as a trait object. Unfortunately this precludes us from adding an associated type to it that might allow us to return shape-specific information in addition to the general information provided in PointProjection. This is where PointQueryWithLocation comes in. It forgoes the ability to be used as a trait object in exchange for being able to provide shape-specific projection information.

Any shapes that implement PointQuery but are able to provide extra information, can implement PointQueryWithLocation in addition and have their PointQuery::project_point implementation just call out to PointQueryWithLocation::project_point_with_location.

Required Associated Types§

source

type Location

Additional shape-specific projection information

In addition to the generic projection information returned in PointProjection, implementations might provide shape-specific projection info. The type of this shape-specific information is defined by this associated type.