Struct linestring::cgmath_3d::LineString3

pub struct LineString3<T> where
    T: BaseFloat + Sync,  {
    pub connected: bool,
    // some fields omitted
}

A 3d line string, aka polyline. If the ‘connected’ field is set the ‘as_lines()’ method will connect start point with the end-point. Todo: The builder structure of this struct needs to be revisited

Fields

connected: bool

if connected is set the as_lines() method will add an extra line connecting the first and last point

Implementations

impl<T> LineString3<T> where
    T: BaseFloat + Sync, 

pub fn default() -> Self

pub fn with_capacity(capacity: usize) -> Self

pub fn with_points(self, points: Vec<Point3<T>>) -> Self

pub fn with_connected(self, connected: bool) -> Self

pub fn with_iter<'a, I>(iter: I) -> Self where
    T: 'a,
    I: Iterator<Item = &'a Point3<T>>, 

Copies the points of the iterator into the LineString2 from_iter is already claimed for into() objects.

pub fn copy_to_2d(&self, plane: Plane) -> LineString2<T>

Copy this linestring3 into a linestring2, keeping the axes defined by ‘plane’ An axis will always try to keep it’s position (e.g. y goes to y if possible). That way the operation is reversible (with regards to axis positions).

pub fn points(&self) -> &Vec<Point3<T>>

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn as_lines(&self) -> Vec<Line3<T>>

Returns the line string as a Vec of lines Will be deprecated at some time, use self.as_lines_iter().collect() instead

pub fn as_lines_iter(&self) -> Box<dyn Iterator<Item = Line3<T>>>

Returns the line string as a iterator of lines

pub fn as_lines_iter_len(&self) -> usize

The iterator of as_lines_iter() does not implement ExactSizeIterator. This can be used as a work around for that problem

pub fn push(&mut self, point: Point3<T>)

pub fn transform(&self, matrix4x4: &Matrix4<T>) -> Self

Return a new LineString3 containing the matrix transformed points

pub fn append(&mut self, other: Self)

Moves all the elements of other into Self, leaving other empty. TODO: currently ignores if other is connected or not.

Panics

Panics if the number of elements in the points vector overflows a usize.

pub fn simplify(&self, distance_predicate: T) -> Self

Simplify using Ramer–Douglas–Peucker algorithm adapted for 3d

pub fn simplify_vw(&self, points_to_delete: usize) -> Self

Simplify using Visvalingam–Whyatt algorithm adapted for 3d. This algorithm will delete ‘points_to_delete’ of points from the polyline with the smallest area defined by one point and it’s neighbours. Simplify using Visvalingam–Whyatt algorithm. This algorithm will delete ‘points_to_delete’ of points from the polyline with the smallest area defined by one point and it’s neighbours.

Trait Implementations

impl<T: Clone> Clone for LineString3<T> where
    T: BaseFloat + Sync, 

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for LineString3<T> where
    T: BaseFloat + Sync, 

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

Formats the value using the given formatter.

impl<T, IC: Into<Point3<T>>> FromIterator<IC> for LineString3<T> where
    T: BaseFloat + Sync, 

fn from_iter<I: IntoIterator<Item = IC>>(iter: I) -> Self

Creates a value from an iterator.

impl<T: Hash> Hash for LineString3<T> where
    T: BaseFloat + Sync, 

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: PartialEq> PartialEq<LineString3<T>> for LineString3<T> where
    T: BaseFloat + Sync, 

fn eq(&self, other: &LineString3<T>) -> bool

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

fn ne(&self, other: &LineString3<T>) -> bool

This method tests for !=.

impl<T: Eq> Eq for LineString3<T> where
    T: BaseFloat + Sync, 

impl<T> StructuralEq for LineString3<T> where
    T: BaseFloat + Sync, 

impl<T> StructuralPartialEq for LineString3<T> where
    T: BaseFloat + Sync,