Struct LinearRing 

pub struct LinearRing {
    pub abstract_ring: AbstractRing,
    /* private fields */
}

An implicitly closed ring of at least 3 distinct, non-adjacent positions.

Corresponds to gml:LinearRing in OGC 07-036 §10.5.8. The ring is implicitly closed: the last position is not repeated.

Invariants

• At least 3 positions.
• No two adjacent positions are equal.
• First and last positions are not equal.

Fields

abstract_ring: AbstractRing

Implementations

impl LinearRing

pub fn new( points: impl IntoIterator<Item = DirectPosition>, ) -> Result<LinearRing, Error>

Creates a new LinearRing from an ordered list of positions.

Errors

Returns Error::TooFewElements if points has fewer than 3 entries. Returns Error::AdjacentDuplicatePositions if adjacent positions are equal. Returns Error::RepeatedClosingVertex if the first and last positions are equal.

pub fn from_abstract_ring( abstract_ring: AbstractRing, points: impl IntoIterator<Item = DirectPosition>, ) -> Result<LinearRing, Error>

pub fn points(&self) -> &[DirectPosition]

Returns the positions of this ring.

pub fn set_points(&mut self, val: Vec<DirectPosition>) -> Result<(), Error>

Replaces the positions of this ring.

Errors

Returns the same errors as new.

impl LinearRing

pub fn length_3d(&self) -> f64

pub fn area_3d(&self) -> f64

Returns the 3D area_3d of this ring using the cross-product summation formula.

Computes |Σ (vᵢ × vᵢ₊₁)| / 2 over all consecutive vertex pairs (with wrap-around), which gives the correct planar area_3d regardless of orientation in 3D space.

Trait Implementations

impl ApplyTransform for LinearRing

fn apply_transform(&mut self, transform: Transform<f64, TGeneral, 3>)

fn apply_isometry(&mut self, isometry: Isometry<f64, Unit<Quaternion<f64>>, 3>)

fn apply_translation( &mut self, vector: Matrix<f64, Const<3>, Const<1>, ArrayStorage<f64, 3, 1>>, )

fn apply_rotation(&mut self, rotation: Rotation<f64, 3>)

fn apply_scale(&mut self, scale: Scale<f64, 3>)

impl AsAbstractCurve for LinearRing

fn abstract_curve(&self) -> &AbstractCurve

Returns a reference to the embedded AbstractCurve base data.

impl AsAbstractCurveMut for LinearRing

fn abstract_curve_mut(&mut self) -> &mut AbstractCurve

Returns a mutable reference to the embedded AbstractCurve base data.

impl AsAbstractGeometricPrimitive for LinearRing

fn abstract_geometric_primitive(&self) -> &AbstractGeometricPrimitive

Returns a reference to the embedded AbstractGeometricPrimitive base data.

impl AsAbstractGeometricPrimitiveMut for LinearRing

fn abstract_geometric_primitive_mut( &mut self, ) -> &mut AbstractGeometricPrimitive

Returns a mutable reference to the embedded AbstractGeometricPrimitive base data.

impl AsAbstractGeometry for LinearRing

fn abstract_geometry(&self) -> &AbstractGeometry

Returns a reference to the embedded AbstractGeometry base data.

fn srs_name(&self) -> Option<&String>

fn srs_dimension(&self) -> Option<u32>

impl AsAbstractGeometryMut for LinearRing

fn abstract_geometry_mut(&mut self) -> &mut AbstractGeometry

Returns a mutable reference to the embedded AbstractGeometry base data.

fn set_srs_name(&mut self, srs_name: impl Into<String>)

fn set_srs_name_opt(&mut self, srs_name: Option<String>)

fn clear_srs_name(&mut self)

fn set_srs_dimension(&mut self, srs_dimension: u32)

fn set_srs_dimension_opt(&mut self, srs_dimension: Option<u32>)

fn clear_srs_dimension(&mut self)

impl AsAbstractGml for LinearRing

fn abstract_gml(&self) -> &AbstractGml

Returns a reference to the embedded AbstractGml base data.

fn id(&self) -> Option<&Id>

Returns the optional identifier of this GML object.

fn names(&self) -> &[Code]

Returns the names of this GML object.

impl AsAbstractGmlMut for LinearRing

fn abstract_gml_mut(&mut self) -> &mut AbstractGml

Returns a mutable reference to the embedded AbstractGml base data.

fn set_id(&mut self, id: Id)

Sets the identifier of this GML object.

fn set_id_opt(&mut self, id: Option<Id>)

Sets or clears the identifier of this GML object.

fn clear_id(&mut self)

Clears the identifier of this GML object.

fn set_names(&mut self, names: Vec<Code>)

fn push_name(&mut self, name: Code)

fn extend_names(&mut self, names: impl IntoIterator<Item = Code>)

impl AsAbstractObject for LinearRing

fn abstract_object(&self) -> &AbstractObject

impl AsAbstractObjectMut for LinearRing

fn abstract_object_mut(&mut self) -> &mut AbstractObject

impl AsAbstractRing for LinearRing

fn abstract_ring(&self) -> &AbstractRing

Returns a reference to the embedded AbstractRing base data.

impl AsAbstractRingMut for LinearRing

fn abstract_ring_mut(&mut self) -> &mut AbstractRing

Returns a mutable reference to the embedded AbstractRing base data.

impl Clone for LinearRing

fn clone(&self) -> LinearRing

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ComputeEnvelope for LinearRing

fn compute_envelope(&self) -> Option<Envelope>

Returns the axis-aligned bounding box of all positions in this ring.

impl Debug for LinearRing

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

Formats the value using the given formatter.

impl Default for LinearRing

fn default() -> LinearRing

Returns the “default value” for a type.

impl<'a> From<&'a LinearRing> for AbstractRingKindRef<'a>

fn from(x: &'a LinearRing) -> AbstractRingKindRef<'a>

Converts to this type from the input type.

impl<'a> From<&'a LinearRing> for AbstractCurveKindRef<'a>

fn from(x: &'a LinearRing) -> AbstractCurveKindRef<'a>

Converts to this type from the input type.

impl<'a> From<&'a LinearRing> for AbstractGeometricPrimitiveKindRef<'a>

fn from(x: &'a LinearRing) -> AbstractGeometricPrimitiveKindRef<'a>

Converts to this type from the input type.

impl<'a> From<&'a LinearRing> for AbstractGeometryKindRef<'a>

fn from(x: &'a LinearRing) -> AbstractGeometryKindRef<'a>

Converts to this type from the input type.

impl From<LinearRing> for AbstractRingKind

fn from(x: LinearRing) -> AbstractRingKind

Converts to this type from the input type.

impl From<LinearRing> for AbstractCurveKind

fn from(x: LinearRing) -> AbstractCurveKind

Converts to this type from the input type.

impl From<LinearRing> for AbstractGeometricPrimitiveKind

fn from(x: LinearRing) -> AbstractGeometricPrimitiveKind

Converts to this type from the input type.

impl From<LinearRing> for AbstractGeometryKind

fn from(x: LinearRing) -> AbstractGeometryKind

Converts to this type from the input type.

impl From<LinearRing> for AbstractGmlKind

fn from(x: LinearRing) -> AbstractGmlKind

Converts to this type from the input type.

impl From<LinearRing> for AbstractObjectKind

fn from(x: LinearRing) -> AbstractObjectKind

Converts to this type from the input type.

impl HasGeometryType for LinearRing

fn geometry_type(&self) -> GeometryType

impl IterGeometries for LinearRing

fn iter_geometries( &self, ) -> Box<dyn Iterator<Item = AbstractGeometryKindRef<'_>> + '_>

impl PartialEq for LinearRing

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for LinearRing

impl TryFrom<AbstractCurveKind> for LinearRing

type Error = ()

The type returned in the event of a conversion error.

fn try_from(x: AbstractCurveKind) -> Result<LinearRing, ()>

Performs the conversion.

impl<'a> TryFrom<AbstractCurveKindRef<'a>> for &'a LinearRing

type Error = ()

The type returned in the event of a conversion error.

fn try_from(x: AbstractCurveKindRef<'a>) -> Result<&'a LinearRing, ()>

Performs the conversion.

impl TryFrom<AbstractGeometricPrimitiveKind> for LinearRing

type Error = ()

The type returned in the event of a conversion error.

fn try_from(x: AbstractGeometricPrimitiveKind) -> Result<LinearRing, ()>

Performs the conversion.

impl<'a> TryFrom<AbstractGeometricPrimitiveKindRef<'a>> for &'a LinearRing

type Error = ()

The type returned in the event of a conversion error.

fn try_from( x: AbstractGeometricPrimitiveKindRef<'a>, ) -> Result<&'a LinearRing, ()>

Performs the conversion.

impl TryFrom<AbstractGeometryKind> for LinearRing

type Error = ()

The type returned in the event of a conversion error.

fn try_from(x: AbstractGeometryKind) -> Result<LinearRing, ()>

Performs the conversion.

impl<'a> TryFrom<AbstractGeometryKindRef<'a>> for &'a LinearRing

type Error = ()

The type returned in the event of a conversion error.

fn try_from(x: AbstractGeometryKindRef<'a>) -> Result<&'a LinearRing, ()>

Performs the conversion.

impl TryFrom<AbstractGmlKind> for LinearRing

type Error = ()

The type returned in the event of a conversion error.

fn try_from(x: AbstractGmlKind) -> Result<LinearRing, ()>

Performs the conversion.

impl TryFrom<AbstractObjectKind> for LinearRing

type Error = ()

The type returned in the event of a conversion error.

fn try_from(x: AbstractObjectKind) -> Result<LinearRing, ()>

Performs the conversion.

impl TryFrom<AbstractRingKind> for LinearRing

type Error = ()

The type returned in the event of a conversion error.

fn try_from(x: AbstractRingKind) -> Result<LinearRing, ()>

Performs the conversion.

impl<'a> TryFrom<AbstractRingKindRef<'a>> for &'a LinearRing

type Error = ()

The type returned in the event of a conversion error.

fn try_from(x: AbstractRingKindRef<'a>) -> Result<&'a LinearRing, ()>

Performs the conversion.

impl TryFrom<GmlLinearRing> for LinearRing

type Error = Error

The type returned in the event of a conversion error.

fn try_from( value: GmlLinearRing, ) -> Result<LinearRing, <LinearRing as TryFrom<GmlLinearRing>>::Error>

Performs the conversion.