Struct Segment 

#[repr(C)]
pub struct Segment<N>
where
    N: RealField + Copy,
{
    pub a: OPoint<N, Const<2>>,
    pub b: OPoint<N, Const<2>>,
}

A segment shape.

Fields

a: OPoint<N, Const<2>>

The segment first point.

b: OPoint<N, Const<2>>

The segment second point.

Implementations

impl<N> Segment<N>

where N: RealField + Copy,

pub fn new(a: OPoint<N, Const<2>>, b: OPoint<N, Const<2>>) -> Segment<N>

Creates a new segment from two points.

pub fn from_array(arr: &[OPoint<N, Const<2>>; 2]) -> &Segment<N>

Creates the reference to a segment from the reference to an array of two points.

impl<N> Segment<N>

where N: RealField + Copy,

pub fn a(&self) -> &OPoint<N, Const<2>>

👎Deprecated:

use the self.a public field directly.

The first point of this segment.

pub fn b(&self) -> &OPoint<N, Const<2>>

👎Deprecated:

use the self.b public field directly.

The second point of this segment.

impl<N> Segment<N>

where N: RealField + Copy,

pub fn scaled_direction( &self, ) -> Matrix<N, Const<nalgebra::::base::dimension::U2::{constant#0}>, Const<1>, ArrayStorage<N, 2, 1>>

The direction of this segment scaled by its length.

Points from self.a toward self.b.

pub fn length(&self) -> N

The length of this segment.

pub fn swap(&mut self)

Swaps the two vertices of this segment.

pub fn direction( &self, ) -> Option<Unit<Matrix<N, Const<nalgebra::::base::dimension::U2::{constant#0}>, Const<1>, ArrayStorage<N, 2, 1>>>>

The unit direction of this segment.

Points from self.a() toward self.b(). Returns None is both points are equal.

pub fn scaled_normal( &self, ) -> Matrix<N, Const<nalgebra::::base::dimension::U2::{constant#0}>, Const<1>, ArrayStorage<N, 2, 1>>

In 2D, the not-normalized counterclockwise normal of this segment.

pub fn normal( &self, ) -> Option<Unit<Matrix<N, Const<nalgebra::::base::dimension::U2::{constant#0}>, Const<1>, ArrayStorage<N, 2, 1>>>>

In 2D, the normalized counterclockwise normal of this segment.

pub fn transformed(&self, m: &Isometry<N, Unit<Complex<N>>, 2>) -> Segment<N>

Applies the isometry m to the vertices of this segment and returns the resulting segment.

pub fn point_at( &self, location: &SegmentPointLocation<N>, ) -> OPoint<N, Const<2>>

Computes the point at the given location.

pub fn tangent_cone_contains_dir( &self, feature: FeatureId, m: &Isometry<N, Unit<Complex<N>>, 2>, dir: &Unit<Matrix<N, Const<nalgebra::::base::dimension::U2::{constant#0}>, Const<1>, ArrayStorage<N, 2, 1>>>, ) -> bool

Checks that the given direction in world-space is on the tangent cone of the given feature.

Trait Implementations

impl<N> Clone for Segment<N>

where N: Clone + RealField + Copy,

fn clone(&self) -> Segment<N>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<N> ConvexPolyhedron<N> for Segment<N>

where N: RealField + Copy,

fn vertex(&self, id: FeatureId) -> OPoint<N, Const<2>>

Gets the specified vertex in the shape local-space.

fn face(&self, id: FeatureId, face: &mut ConvexPolygonalFeature<N>)

Fill face with the geometric description of the specified face, in the shape’s local-space.

fn feature_normal( &self, feature: FeatureId, ) -> Unit<Matrix<N, Const<nalgebra::::base::dimension::U2::{constant#0}>, Const<1>, ArrayStorage<N, 2, 1>>>

Returns any normal from the normal cone of the given feature.

fn support_face_toward( &self, m: &Isometry<N, Unit<Complex<N>>, 2>, dir: &Unit<Matrix<N, Const<nalgebra::::base::dimension::U2::{constant#0}>, Const<1>, ArrayStorage<N, 2, 1>>>, face: &mut ConvexPolygonalFeature<N>, )

Retrieve the face (in world-space) with a normal that maximizes the scalar product with dir.

fn support_feature_toward( &self, transform: &Isometry<N, Unit<Complex<N>>, 2>, dir: &Unit<Matrix<N, Const<nalgebra::::base::dimension::U2::{constant#0}>, Const<1>, ArrayStorage<N, 2, 1>>>, eps: N, face: &mut ConvexPolygonalFeature<N>, )

Retrieve the feature (in world-space) which normal cone contains dir.

fn support_feature_id_toward( &self, local_dir: &Unit<Matrix<N, Const<nalgebra::::base::dimension::U2::{constant#0}>, Const<1>, ArrayStorage<N, 2, 1>>>, ) -> FeatureId

Retrieve the identifier of the feature which normal cone contains dir.

impl<N> Debug for Segment<N>

where N: Debug + RealField + Copy,

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de, N> Deserialize<'de> for Segment<N>

where N: RealField + Copy + Deserialize<'de>,

fn deserialize<__D>( __deserializer: __D, ) -> Result<Segment<N>, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<N> HasBoundingVolume<N, AABB<N>> for Segment<N>

where N: RealField + Copy,

fn bounding_volume(&self, m: &Isometry<N, Unit<Complex<N>>, 2>) -> AABB<N>

The bounding volume of self transformed by m.

fn local_bounding_volume(&self) -> AABB<N>

The bounding volume of self.

impl<N> HasBoundingVolume<N, BoundingSphere<N>> for Segment<N>

where N: RealField + Copy,

fn bounding_volume( &self, m: &Isometry<N, Unit<Complex<N>>, 2>, ) -> BoundingSphere<N>

The bounding volume of self transformed by m.

fn local_bounding_volume(&self) -> BoundingSphere<N>

The bounding volume of self.

impl<N> PartialEq for Segment<N>

where N: PartialEq + RealField + Copy,

fn eq(&self, other: &Segment<N>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<N> PointQuery<N> for Segment<N>

where N: RealField + Copy,

fn project_point( &self, m: &Isometry<N, Unit<Complex<N>>, 2>, pt: &OPoint<N, Const<2>>, solid: bool, ) -> PointProjection<N>

Projects a point on self transformed by m.

fn project_point_with_feature( &self, m: &Isometry<N, Unit<Complex<N>>, 2>, pt: &OPoint<N, Const<2>>, ) -> (PointProjection<N>, FeatureId)

Projects a point on the boundary of self transformed by m and retuns the id of the feature the point was projected on.

fn distance_to_point( &self, m: &Isometry<N, Unit<Complex<N>>, 2>, pt: &OPoint<N, Const<2>>, solid: bool, ) -> N

Computes the minimal distance between a point and self transformed by m.

fn contains_point( &self, m: &Isometry<N, Unit<Complex<N>>, 2>, pt: &OPoint<N, Const<2>>, ) -> bool

Tests if the given point is inside of self transformed by m.

impl<N> PointQueryWithLocation<N> for Segment<N>

where N: RealField + Copy,

type Location = SegmentPointLocation<N>

Additional shape-specific projection information

fn project_point_with_location( &self, m: &Isometry<N, Unit<Complex<N>>, 2>, pt: &OPoint<N, Const<2>>, _: bool, ) -> (PointProjection<N>, <Segment<N> as PointQueryWithLocation<N>>::Location)

Projects a point on self transformed by m.

impl<N> RayCast<N> for Segment<N>

where N: RealField + Copy,

fn toi_and_normal_with_ray( &self, m: &Isometry<N, Unit<Complex<N>>, 2>, ray: &Ray<N>, max_toi: N, solid: bool, ) -> Option<RayIntersection<N>>

Computes the time of impact, and normal between this transformed shape and a ray.

fn toi_with_ray( &self, m: &Isometry<N, Unit<Complex<N>>, 2>, ray: &Ray<N>, max_toi: N, solid: bool, ) -> Option<N>

Computes the time of impact between this transform shape and a ray.

fn intersects_ray( &self, m: &Isometry<N, Unit<Complex<N>>, 2>, ray: &Ray<N>, max_toi: N, ) -> bool

Tests whether a ray intersects this transformed shape.

impl<N> Serialize for Segment<N>

where N: RealField + Copy + Serialize,

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<N> Shape<N> for Segment<N>

where N: RealField + Copy,

fn aabb(&self, m: &Isometry<N, Unit<Complex<N>>, 2>) -> AABB<N>

The AABB of self transformed by m.

fn local_aabb(&self) -> AABB<N>

The AABB of self.

fn bounding_sphere( &self, m: &Isometry<N, Unit<Complex<N>>, 2>, ) -> BoundingSphere<N>

The bounding sphere of self transformed by m.

fn as_ray_cast(&self) -> Option<&dyn RayCast<N>>

The RayCast implementation of self.

fn as_point_query(&self) -> Option<&dyn PointQuery<N>>

The PointQuery implementation of self.

fn as_support_map(&self) -> Option<&dyn SupportMap<N>>

The support mapping of self if applicable.

fn is_support_map(&self) -> bool

Whether self uses a support-mapping based representation.

fn as_convex_polyhedron(&self) -> Option<&dyn ConvexPolyhedron<N>>

The convex polyhedron representation of self if applicable.

fn is_convex_polyhedron(&self) -> bool

Whether self uses a convex polyhedron representation.

fn tangent_cone_contains_dir( &self, feature: FeatureId, m: &Isometry<N, Unit<Complex<N>>, 2>, _: Option<&[N]>, dir: &Unit<Matrix<N, Const<nalgebra::::base::dimension::U2::{constant#0}>, Const<1>, ArrayStorage<N, 2, 1>>>, ) -> bool

Check if if the feature _feature of the i-th subshape of self transformed by m has a tangent cone that contains dir at the point pt.

fn local_bounding_sphere(&self) -> BoundingSphere<N>

The bounding sphere of self.

fn subshape_containing_feature(&self, _i: FeatureId) -> usize

Returns the id of the subshape containing the specified feature.

fn as_composite_shape(&self) -> Option<&dyn CompositeShape<N>>

The composite shape representation of self if applicable.

fn as_deformable_shape(&self) -> Option<&dyn DeformableShape<N>>

The deformable shape representation of self if applicable.

fn as_deformable_shape_mut(&mut self) -> Option<&mut dyn DeformableShape<N>>

The mutable deformable shape representation of self if applicable.

fn is_composite_shape(&self) -> bool

Whether self uses a composite shape-based representation.

fn is_deformable_shape(&self) -> bool

Whether self uses a composite shape-based representation.

impl<N> SupportMap<N> for Segment<N>

where N: RealField + Copy,

fn local_support_point( &self, dir: &Matrix<N, Const<nalgebra::::base::dimension::U2::{constant#0}>, Const<1>, ArrayStorage<N, 2, 1>>, ) -> OPoint<N, Const<2>>

fn local_support_point_toward( &self, dir: &Unit<Matrix<N, Const<nalgebra::::base::dimension::U2::{constant#0}>, Const<1>, ArrayStorage<N, 2, 1>>>, ) -> OPoint<N, Const<2>>

Same as self.local_support_point except that dir is normalized.

fn support_point( &self, transform: &Isometry<N, Unit<Complex<N>>, 2>, dir: &Matrix<N, Const<nalgebra::::base::dimension::U2::{constant#0}>, Const<1>, ArrayStorage<N, 2, 1>>, ) -> OPoint<N, Const<2>>

fn support_point_toward( &self, transform: &Isometry<N, Unit<Complex<N>>, 2>, dir: &Unit<Matrix<N, Const<nalgebra::::base::dimension::U2::{constant#0}>, Const<1>, ArrayStorage<N, 2, 1>>>, ) -> OPoint<N, Const<2>>

Same as self.support_point except that dir is normalized.

impl<N> ToPolyline<N> for Segment<N>

where N: RealField + Copy,

type DiscretizationParameter = ()

fn to_polyline(&self, _: ()) -> Polyline<N>

Builds a triangle mesh from this shape.

impl<N> Copy for Segment<N>

where N: Copy + RealField,

impl<N> StructuralPartialEq for Segment<N>

where N: RealField + Copy,