Struct iron_shapes::redge::REdge

pub struct REdge<T> {
    pub start: T,
    pub end: T,
    pub offset: T,
    pub orientation: REdgeOrientation,
}

An rectilinear edge (horizontal or vertical line segment) is represented by its starting point and end point.

Fields

start: T

Start-coordinate of the edge.

end: T

End-coordinate of the edge.

offset: T

Distance to to the origin (0, 0).

orientation: REdgeOrientation

Orientation: Either horizontal or vertical.

Implementations

impl<T> REdge<T>

pub fn new_raw(start: T, end: T, offset: T, orientation: REdgeOrientation) -> Self

Create a new rectilinear edge.

Parameters

• start: Start-coordinate of the edge.
• end: End-coordinate of the edge.
• offset: Distance to to the origin (0, 0).
• orientation: Orientation: Either horizontal or vertical.

impl<T: Copy> REdge<T>

pub fn start(&self) -> Point<T>

Get the start point of the edge.

pub fn end(&self) -> Point<T>

Get the end point of the edge.

pub fn reversed(&self) -> Self

Return the same edge but with the two points swapped.

impl<T: PartialEq> REdge<T>

pub fn is_degenerate(&self) -> bool

Check if edge is degenerate. An edge is degenerate if start point and end point are equal.

pub fn is_ortho(&self) -> bool

Test if this edge is either horizontal or vertical.

pub fn is_horizontal(&self) -> bool

Test if this edge is horizontal.

pub fn is_vertical(&self) -> bool

Test if this edge is vertical.

impl<T: PartialOrd + Sub<Output = T> + Copy> REdge<T>

pub fn length(&self) -> T

Get the length of the edge.

impl<T: CoordinateType> REdge<T>

pub fn new<C>(start: C, end: C) -> Self where
    C: Into<Point<T>>, 

Create a new REdge from two arguments that implement Into<Point>. The two points must lie either on a vertical or horizontal line, otherwise None is returned.

Panics

Panics if the two points are not on the same horizontal or vertical line.

pub fn try_from_points<C>(start: C, end: C) -> Option<Self> where
    C: Into<Point<T>>, 

Create a new REdge from two arguments that implement Into<Point>. The two points must lie either on a vertical or horizontal line, otherwise None is returned.

pub fn vector(&self) -> Vector<T>

Returns the vector from self.start() to self.end().

pub fn direction(&self) -> Option<Vector<T>>

Get a vector of unit length pointing in the same direction as the edge. Returns None if the length of the edge is zero.

pub fn side_of(&self, point: Point<T>) -> Side

Tells on which side of the edge a point is.

Panics

Panics if the edge is degenerate.

Returns Side::Left if the point is on the left side, Side::Right if the point is on the right side or Side::Center if the point lies exactly on the line.

pub fn contains_point(&self, point: Point<T>) -> ContainsResult

Test if point lies on the edge. Includes start and end points of edge.

pub fn line_contains_point(&self, point: Point<T>) -> bool

Test if point lies on the line defined by the edge.

pub fn is_parallel(&self, other: &REdge<T>) -> bool

Test if two edges are parallel.

pub fn is_collinear(&self, other: &REdge<T>) -> bool where
    T: CoordinateType, 

Test if two edges are collinear, i.e. are on the same line.

pub fn is_coincident(&self, other: &REdge<T>) -> bool

Test edges for coincidence. Two edges are coincident if they are oriented the same way and share more than one point (implies that they must be parallel).

pub fn crossed_by_line(&self, line: &REdge<T>) -> ContainsResult

Test if this edge is crossed by the line defined by the other edge.

Returns WithinBounds if start and end point of this edge lie on different sides of the line defined by the other edge or OnBounds if at least one of the points lies on the line.

pub fn lines_intersect(&self, other: &REdge<T>) -> bool

Test if lines defined by the edges intersect. If the lines are collinear they are also considered intersecting.

pub fn edges_intersect(&self, other: &REdge<T>) -> ContainsResult

Test if two edges intersect. If the edges coincide, they also intersect.

pub fn oriented_distance_to_line(&self, point: Point<T>) -> T

Calculate the distance from the point to the line given by the edge.

Distance will be positive if the point lies on the right side of the edge and negative if the point is on the left side.

pub fn distance_to_line(&self, point: Point<T>) -> T

Calculate the distance from the point to the line given by the edge.

pub fn projection(&self, point: Point<T>) -> Point<T>

Find the perpendicular projection of a point onto the line of the edge.

pub fn line_intersection(&self, other: &REdge<T>) -> RLineIntersection<T>

Compute the intersection of the two lines defined by the edges.

pub fn edge_intersection(&self, other: &REdge<T>) -> REdgeIntersection<T>

Compute the intersection between two edges.

pub fn rotate_ortho(&self, a: Angle) -> Self

Rotate the edge by a multiple of 90 degrees around (0, 0).

Trait Implementations

impl<T: CoordinateType> BoundingBox<T> for REdge<T>

fn bounding_box(&self) -> Rect<T>

Return the bounding box of this geometry.

impl<T: Clone> Clone for REdge<T>

fn clone(&self) -> REdge<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for REdge<T>

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

Formats the value using the given formatter.

impl<T: Copy> EdgeEndpoints<T> for REdge<T>

fn start(&self) -> Point<T>

Get the start point of the edge.

fn end(&self) -> Point<T>

Get the end point of the edge.

impl<T: CoordinateType> EdgeIntersect for REdge<T>

type Coord = T

Numeric type used for expressing the end-point coordinates of the edge.

type IntersectionCoord = T

Numeric type used for expressing an intersection-point of two edges. Often this might be the same as Coord.

fn edge_intersection(
    &self,
    other: &Self
) -> EdgeIntersection<Self::Coord, Self::IntersectionCoord, REdge<T>>

Compute intersection of two edges.

impl<T: Hash> Hash for REdge<T>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl<T: CoordinateType> Into<(Point<T>, Point<T>)> for &REdge<T>

fn into(self) -> (Point<T>, Point<T>)

Converts this type into the (usually inferred) input type.

impl<T: CoordinateType> Into<(Point<T>, Point<T>)> for REdge<T>

fn into(self) -> (Point<T>, Point<T>)

Converts this type into the (usually inferred) input type.

impl<T: CoordinateType> Into<Edge<T>> for &REdge<T>

fn into(self) -> Edge<T>

Converts this type into the (usually inferred) input type.

impl<T: CoordinateType> Into<Edge<T>> for REdge<T>

fn into(self) -> Edge<T>

Converts this type into the (usually inferred) input type.

impl<T: PartialEq> PartialEq<REdge<T>> for REdge<T>

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl<C> Segment<C> for REdge<C::Coord> where
    C: CoordinateConcept, 

type Point = Point<<C as CoordinateBase>::Coord>

Type used to represent the end points of the segment.

fn get_point(&self, dir: Direction1D) -> Self::Point

Get the start (LOW) or end (HIGH) point of the segment.

fn start(&self) -> Self::Point

Shortcut to get the ‘low’ end of the segment.

fn end(&self) -> Self::Point

Shortcut to get the ‘high’ end of the segment.

impl<T: CoordinateType> TryBoundingBox<T> for REdge<T>

fn try_bounding_box(&self) -> Option<Rect<T>>

Return the bounding box of this geometry if a bounding box is defined.

impl<T: CoordinateType + NumCast, Dst: CoordinateType + NumCast> TryCastCoord<T, Dst> for REdge<T>

type Output = REdge<Dst>

Output type of the cast. This is likely the same geometrical type just with other coordinate types.

fn try_cast(&self) -> Option<Self::Output>

Try to cast to target data type.

fn cast(&self) -> Self::Output

Cast to target data type.

impl<T: CoordinateType> TryFrom<&Edge<T>> for REdge<T>

fn try_from(value: &Edge<T>) -> Result<Self, Self::Error>

Try to convert an edge into a rectilinear edge. Returns none if the edge is not rectilinear.

type Error = ()

The type returned in the event of a conversion error.

impl<T: Copy> Copy for REdge<T>

impl<T: PartialEq> Eq for REdge<T>