Trait ncollide2d::query::PointQueryWithLocation

pub trait PointQueryWithLocation<N: Real> {
    type Location;

    fn project_point_with_location(
        &self,
        m: &Isometry<N>,
        pt: &Point<N>,
        solid: bool
    ) -> (PointProjection<N>, Self::Location);
}

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

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.

Required Methods

fn project_point_with_location(
    &self,
    m: &Isometry<N>,
    pt: &Point<N>,
    solid: bool
) -> (PointProjection<N>, Self::Location)

Projects a point on self transformed by m.

Implementors

impl<N: Real> PointQueryWithLocation<N> for Polyline<N>

type Location = (usize, SegmentPointLocation<N>)

impl<N: Real> PointQueryWithLocation<N> for Segment<N>

type Location = SegmentPointLocation<N>

impl<N: Real> PointQueryWithLocation<N> for Triangle<N>

type Location = TrianglePointLocation<N>