Struct geo::geometry::Triangle

pub struct Triangle<T = f64>(pub Coord<T>, pub Coord<T>, pub Coord<T>)
where
    T: CoordNum;

A bounded 2D area whose three vertices are defined by Coords. The semantics and validity are that of the equivalent Polygon; in addition, the three vertices must not be collinear and they must be distinct.

Tuple Fields

0: Coord<T>

1: Coord<T>

2: Coord<T>

Implementations

impl<T> Triangle<T>where
    T: CoordNum,

pub fn new(v1: Coord<T>, v2: Coord<T>, v3: Coord<T>) -> Triangle<T>

Instantiate Self from the raw content value

pub fn to_array(&self) -> [Coord<T>; 3]

pub fn to_lines(&self) -> [Line<T>; 3]

pub fn to_polygon(self) -> Polygon<T>

Create a Polygon from the Triangle.

Examples

use geo_types::{coord, Triangle, polygon};

let triangle = Triangle::new(
    coord! { x: 0., y: 0. },
    coord! { x: 10., y: 20. },
    coord! { x: 20., y: -10. },
);

assert_eq!(
    triangle.to_polygon(),
    polygon![
        (x: 0., y: 0.),
        (x: 10., y: 20.),
        (x: 20., y: -10.),
        (x: 0., y: 0.),
    ],
);

Trait Implementations

impl<T> AbsDiffEq<Triangle<T>> for Triangle<T>where
    T: AbsDiffEq<T, Epsilon = T> + CoordNum,
    <T as AbsDiffEq<T>>::Epsilon: Copy,

fn abs_diff_eq(
    &self,
    other: &Triangle<T>,
    epsilon: <Triangle<T> as AbsDiffEq<Triangle<T>>>::Epsilon
) -> bool

Equality assertion with an absolute limit.

Examples

use geo_types::{point, Triangle};

let a = Triangle::new((0.0, 0.0).into(), (10.0, 10.0).into(), (0.0, 5.0).into());
let b = Triangle::new((0.0, 0.0).into(), (10.01, 10.0).into(), (0.0, 5.0).into());

approx::abs_diff_eq!(a, b, epsilon=0.1);
approx::abs_diff_ne!(a, b, epsilon=0.001);

type Epsilon = T

Used for specifying relative comparisons.

fn default_epsilon() -> <Triangle<T> as AbsDiffEq<Triangle<T>>>::Epsilon

The default tolerance to use when testing values that are close together.

fn abs_diff_ne(&self, other: &Rhs, epsilon: Self::Epsilon) -> bool

The inverse of AbsDiffEq::abs_diff_eq.

impl<T> Area<T> for Triangle<T>where
    T: CoordFloat,

fn signed_area(&self) -> T

fn unsigned_area(&self) -> T

impl<T> BoundingRect<T> for Triangle<T>where
    T: CoordNum,

type Output = Rect<T>

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

Return the bounding rectangle of a geometry

impl<T> Centroid for Triangle<T>where
    T: GeoFloat,

type Output = Point<T>

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

See: https://en.wikipedia.org/wiki/Centroid

impl<T> ChamberlainDuquetteArea<T> for Triangle<T>where
    T: CoordFloat,

fn chamberlain_duquette_signed_area(&self) -> T

fn chamberlain_duquette_unsigned_area(&self) -> T

impl<T> Clone for Triangle<T>where
    T: Clone + CoordNum,

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<F: GeoFloat> ClosestPoint<F, Point<F>> for Triangle<F>

fn closest_point(&self, p: &Point<F>) -> Closest<F>

Find the closest point between self and p.

impl<T> Contains<Coord<T>> for Triangle<T>where
    T: GeoNum,

fn contains(&self, coord: &Coord<T>) -> bool

impl<T> Contains<Geometry<T>> for Triangle<T>where
    T: GeoFloat,

fn contains(&self, geometry: &Geometry<T>) -> bool

impl<T> Contains<GeometryCollection<T>> for Triangle<T>where
    T: GeoFloat,

fn contains(&self, target: &GeometryCollection<T>) -> bool

impl<T> Contains<Line<T>> for Triangle<T>where
    T: GeoFloat,

fn contains(&self, target: &Line<T>) -> bool

impl<T> Contains<LineString<T>> for Triangle<T>where
    T: GeoFloat,

fn contains(&self, target: &LineString<T>) -> bool

impl<T> Contains<MultiLineString<T>> for Triangle<T>where
    T: GeoFloat,

fn contains(&self, target: &MultiLineString<T>) -> bool

impl<T> Contains<MultiPoint<T>> for Triangle<T>where
    T: GeoFloat,

fn contains(&self, target: &MultiPoint<T>) -> bool

impl<T> Contains<MultiPolygon<T>> for Triangle<T>where
    T: GeoFloat,

fn contains(&self, target: &MultiPolygon<T>) -> bool

impl<T> Contains<Point<T>> for Triangle<T>where
    T: GeoNum,

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

impl<T> Contains<Polygon<T>> for Triangle<T>where
    T: GeoFloat,

fn contains(&self, target: &Polygon<T>) -> bool

impl<T> Contains<Rect<T>> for Triangle<T>where
    T: GeoFloat,

fn contains(&self, target: &Rect<T>) -> bool

impl<F> Contains<Triangle<F>> for MultiPolygon<F>where
    F: GeoFloat,

fn contains(&self, rhs: &Triangle<F>) -> bool

impl<T> Contains<Triangle<T>> for Geometry<T>where
    T: GeoFloat,

fn contains(&self, triangle: &Triangle<T>) -> bool

impl<T> Contains<Triangle<T>> for GeometryCollection<T>where
    T: GeoFloat,

fn contains(&self, target: &Triangle<T>) -> bool

impl<T> Contains<Triangle<T>> for Line<T>where
    T: GeoFloat,

fn contains(&self, target: &Triangle<T>) -> bool

impl<T> Contains<Triangle<T>> for LineString<T>where
    T: GeoFloat,

fn contains(&self, target: &Triangle<T>) -> bool

impl<T> Contains<Triangle<T>> for MultiLineString<T>where
    T: GeoFloat,

fn contains(&self, target: &Triangle<T>) -> bool

impl<T> Contains<Triangle<T>> for MultiPoint<T>where
    T: GeoFloat,

fn contains(&self, target: &Triangle<T>) -> bool

impl<T> Contains<Triangle<T>> for Point<T>where
    T: CoordNum,

fn contains(&self, triangle: &Triangle<T>) -> bool

impl<T> Contains<Triangle<T>> for Polygon<T>where
    T: GeoFloat,

fn contains(&self, target: &Triangle<T>) -> bool

impl<T> Contains<Triangle<T>> for Rect<T>where
    T: GeoFloat,

fn contains(&self, target: &Triangle<T>) -> bool

impl<T> Contains<Triangle<T>> for Triangle<T>where
    T: GeoFloat,

fn contains(&self, target: &Triangle<T>) -> bool

impl<T> CoordinatePosition for Triangle<T>where
    T: GeoNum,

type Scalar = T

fn calculate_coordinate_position(
    &self,
    coord: &Coord<T>,
    is_inside: &mut bool,
    boundary_count: &mut usize
)

fn coordinate_position(&self, coord: &Coord<Self::Scalar>) -> CoordPos

impl<'a, T: CoordNum + 'a> CoordsIter<'a> for Triangle<T>

fn coords_count(&'a self) -> usize

Return the number of coordinates in the Triangle.

type Iter = Chain<Chain<Once<Coord<T>>, Once<Coord<T>>>, Once<Coord<T>>>

type ExteriorIter = <Triangle<T> as CoordsIter<'a>>::Iter

type Scalar = T

fn coords_iter(&'a self) -> Self::Iter

Iterate over all exterior and (if any) interior coordinates of a geometry.

fn exterior_coords_iter(&'a self) -> Self::ExteriorIter

Iterate over all exterior coordinates of a geometry.

impl<T> Debug for Triangle<T>where
    T: Debug + CoordNum,

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

Formats the value using the given formatter.

impl<T> Densify<T> for Triangle<T>where
    T: CoordFloat,
    Line<T>: EuclideanLength<T>,
    LineString<T>: EuclideanLength<T>,

type Output = Polygon<T>

fn densify(&self, max_distance: T) -> Self::Output

impl<'de, T> Deserialize<'de> for Triangle<T>where
    T: CoordNum + Deserialize<'de>,

fn deserialize<__D>(
    __deserializer: __D
) -> Result<Triangle<T>, <__D as Deserializer<'de>>::Error>where
    __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> EuclideanDistance<T, Point<T>> for Triangle<T>where
    T: GeoFloat,

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

Returns the distance between two geometries

impl<IC, T> From<[IC; 3]> for Triangle<T>where
    IC: Into<Coord<T>> + Copy,
    T: CoordNum,

fn from(array: [IC; 3]) -> Triangle<T>

Converts to this type from the input type.

impl<T> From<Triangle<T>> for Geometry<T>where
    T: CoordNum,

fn from(x: Triangle<T>) -> Geometry<T>

Converts to this type from the input type.

impl<T> From<Triangle<T>> for Polygon<T>where
    T: CoordNum,

fn from(t: Triangle<T>) -> Polygon<T>

Converts to this type from the input type.

impl<C: GeoNum> HasDimensions for Triangle<C>

fn is_empty(&self) -> bool

Some geometries, like a MultiPoint, can have zero coordinates - we call these empty.

fn dimensions(&self) -> Dimensions

The dimensions of some geometries are fixed, e.g. a Point always has 0 dimensions. However for others, the dimensionality depends on the specific geometry instance - for example typical Rects are 2-dimensional, but it’s possible to create degenerate Rects which have either 1 or 0 dimensions.

fn boundary_dimensions(&self) -> Dimensions

The dimensions of the Geometry’s boundary, as used by OGC-SFA.

impl<T> Hash for Triangle<T>where
    T: Hash + CoordNum,

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl<T> InteriorPoint for Triangle<T>where
    T: GeoFloat,

type Output = Point<T>

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

Calculates a representative point inside the Geometry

impl<T, G> Intersects<G> for Triangle<T>where
    T: CoordNum,
    Polygon<T>: Intersects<G>,

fn intersects(&self, rhs: &G) -> bool

impl<T> Intersects<Triangle<T>> for Coord<T>where
    Triangle<T>: Intersects<Coord<T>>,
    T: CoordNum,

fn intersects(&self, rhs: &Triangle<T>) -> bool

impl<T> Intersects<Triangle<T>> for Line<T>where
    Triangle<T>: Intersects<Line<T>>,
    T: CoordNum,

fn intersects(&self, rhs: &Triangle<T>) -> bool

impl<T> Intersects<Triangle<T>> for Polygon<T>where
    Triangle<T>: Intersects<Polygon<T>>,
    T: CoordNum,

fn intersects(&self, rhs: &Triangle<T>) -> bool

impl<T> Intersects<Triangle<T>> for Rect<T>where
    Triangle<T>: Intersects<Rect<T>>,
    T: CoordNum,

fn intersects(&self, rhs: &Triangle<T>) -> bool

impl<'a, T: CoordNum + 'a> LinesIter<'a> for Triangle<T>

type Scalar = T

type Iter = <[Line<<Triangle<T> as LinesIter<'a>>::Scalar>; 3] as IntoIterator>::IntoIter

fn lines_iter(&'a self) -> Self::Iter

Iterate over all exterior and (if any) interior lines of a geometry.

impl<T: CoordNum, NT: CoordNum> MapCoords<T, NT> for Triangle<T>

type Output = Triangle<NT>

fn map_coords(&self, func: impl Fn(Coord<T>) -> Coord<NT> + Copy) -> Self::Output

Apply a function to all the coordinates in a geometric object, returning a new object.

fn try_map_coords<E>(
    &self,
    func: impl Fn(Coord<T>) -> Result<Coord<NT>, E>
) -> Result<Self::Output, E>

Map a fallible function over all the coordinates in a geometry, returning a Result

impl<T: CoordNum> MapCoordsInPlace<T> for Triangle<T>

fn map_coords_in_place(&mut self, func: impl Fn(Coord<T>) -> Coord<T>)

Apply a function to all the coordinates in a geometric object, in place

fn try_map_coords_in_place<E>(
    &mut self,
    func: impl Fn(Coord<T>) -> Result<Coord<T>, E>
) -> Result<(), E>

Map a fallible function over all the coordinates in a geometry, in place, returning a Result.

impl<T: CoordNum> MapCoordsInplace<T> for Triangle<T>

fn map_coords_inplace(&mut self, func: impl Fn((T, T)) -> (T, T) + Copy)where
    T: CoordNum,

👎Deprecated since 0.21.0: use MapCoordsInPlace::map_coords_in_place instead which takes a Coord instead of an (x,y) tuple

Apply a function to all the coordinates in a geometric object, in place

Examples

#[allow(deprecated)]
use geo::MapCoordsInplace;
use geo::Point;
use approx::assert_relative_eq;

let mut p = Point::new(10., 20.);
#[allow(deprecated)]
p.map_coords_inplace(|(x, y)| (x + 1000., y * 2.));

assert_relative_eq!(p, Point::new(1010., 40.), epsilon = 1e-6);

impl<T> PartialEq<Triangle<T>> for Triangle<T>where
    T: PartialEq<T> + CoordNum,

fn eq(&self, other: &Triangle<T>) -> 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 !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<F: GeoFloat> Relate<F, GeometryCollection<F>> for Triangle<F>

fn relate(&self, other: &GeometryCollection<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, Line<F>> for Triangle<F>

fn relate(&self, other: &Line<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, LineString<F>> for Triangle<F>

fn relate(&self, other: &LineString<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, MultiLineString<F>> for Triangle<F>

fn relate(&self, other: &MultiLineString<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, MultiPoint<F>> for Triangle<F>

fn relate(&self, other: &MultiPoint<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, MultiPolygon<F>> for Triangle<F>

fn relate(&self, other: &MultiPolygon<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, Point<F>> for Triangle<F>

fn relate(&self, other: &Point<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, Polygon<F>> for Triangle<F>

fn relate(&self, other: &Polygon<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, Rect<F>> for Triangle<F>

fn relate(&self, other: &Rect<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, Triangle<F>> for GeometryCollection<F>

fn relate(&self, other: &Triangle<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, Triangle<F>> for Line<F>

fn relate(&self, other: &Triangle<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, Triangle<F>> for LineString<F>

fn relate(&self, other: &Triangle<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, Triangle<F>> for MultiLineString<F>

fn relate(&self, other: &Triangle<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, Triangle<F>> for MultiPoint<F>

fn relate(&self, other: &Triangle<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, Triangle<F>> for MultiPolygon<F>

fn relate(&self, other: &Triangle<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, Triangle<F>> for Point<F>

fn relate(&self, other: &Triangle<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, Triangle<F>> for Polygon<F>

fn relate(&self, other: &Triangle<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, Triangle<F>> for Rect<F>

fn relate(&self, other: &Triangle<F>) -> IntersectionMatrix

impl<F: GeoFloat> Relate<F, Triangle<F>> for Triangle<F>

fn relate(&self, other: &Triangle<F>) -> IntersectionMatrix

impl<T> RelativeEq<Triangle<T>> for Triangle<T>where
    T: AbsDiffEq<T, Epsilon = T> + CoordNum + RelativeEq<T>,

fn relative_eq(
    &self,
    other: &Triangle<T>,
    epsilon: <Triangle<T> as AbsDiffEq<Triangle<T>>>::Epsilon,
    max_relative: <Triangle<T> as AbsDiffEq<Triangle<T>>>::Epsilon
) -> bool

Equality assertion within a relative limit.

Examples

use geo_types::{point, Triangle};

let a = Triangle::new((0.0, 0.0).into(), (10.0, 10.0).into(), (0.0, 5.0).into());
let b = Triangle::new((0.0, 0.0).into(), (10.01, 10.0).into(), (0.0, 5.0).into());

approx::assert_relative_eq!(a, b, max_relative=0.1);
approx::assert_relative_ne!(a, b, max_relative=0.0001);

fn default_max_relative() -> <Triangle<T> as AbsDiffEq<Triangle<T>>>::Epsilon

The default relative tolerance for testing values that are far-apart.

fn relative_ne(
    &self,
    other: &Rhs,
    epsilon: Self::Epsilon,
    max_relative: Self::Epsilon
) -> bool

The inverse of RelativeEq::relative_eq.

impl<T> RemoveRepeatedPoints<T> for Triangle<T>where
    T: CoordNum + FromPrimitive,

fn remove_repeated_points(&self) -> Self

Create a new geometry with (consecutive) repeated points removed.

fn remove_repeated_points_mut(&mut self)

Remove (consecutive) repeated points inplace.

impl<T> Serialize for Triangle<T>where
    T: CoordNum + 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<T> TryFrom<Geometry<T>> for Triangle<T>where
    T: CoordNum,

Convert a Geometry enum into its inner type.

Fails if the enum case does not match the type you are trying to convert it to.

type Error = Error

The type returned in the event of a conversion error.

fn try_from(
    geom: Geometry<T>
) -> Result<Triangle<T>, <Triangle<T> as TryFrom<Geometry<T>>>::Error>

Performs the conversion.

impl<T: CoordNum, NT: CoordNum, E> TryMapCoords<T, NT, E> for Triangle<T>

type Output = Triangle<NT>

👎Deprecated since 0.21.0: use MapCoords::try_map_coords which takes a Coord instead of an (x,y) tuple

fn try_map_coords(
    &self,
    func: impl Fn((T, T)) -> Result<(NT, NT), E> + Copy
) -> Result<Self::Output, E>

👎Deprecated since 0.21.0: use MapCoords::try_map_coords which takes a Coord instead of an (x,y) tuple

Map a fallible function over all the coordinates in a geometry, returning a Result

impl<T: CoordNum, E> TryMapCoordsInplace<T, E> for Triangle<T>

fn try_map_coords_inplace(
    &mut self,
    func: impl Fn((T, T)) -> Result<(T, T), E>
) -> Result<(), E>

👎Deprecated since 0.21.0: use MapCoordsInPlace::try_map_coords_in_place which takes a Coord instead of an (x,y) tuple

Map a fallible function over all the coordinates in a geometry, in place, returning a Result.

impl<T> Copy for Triangle<T>where
    T: Copy + CoordNum,

impl<T> Eq for Triangle<T>where
    T: Eq + CoordNum,

impl<T> StructuralEq for Triangle<T>where
    T: CoordNum,

impl<T> StructuralPartialEq for Triangle<T>where
    T: CoordNum,