Struct visioncortex::Path

pub struct Path<T> {
    pub path: Vec<T>,
}

Path of generic points in 2D space

Fields

path: Vec<T>

T can be PointI32/PointF64, etc. (see src/point.rs).

Implementations

impl<T> Path<T>

pub fn new() -> Self

Creates a new 2D Path with no points

pub fn from_points(points: Vec<T>) -> Self

Creates a 2D Path with ‘points’ as its points

pub fn add(&mut self, point: T)

Adds a point to the end of the path

pub fn pop(&mut self) -> Option<T>

Removes the last point from the path and returns it, or None if it is empty.

pub fn iter(&self) -> Iter<'_, T>

Returns an iterator on the vector of points in the path

pub fn len(&self) -> usize

Returns the number of points in the path

pub fn is_empty(&self) -> bool

Returns true if the path is empty, false otherwise

impl<T> Path<T>

where T: Clone + PartialEq,

pub fn to_open(&self) -> Self

Convert a closed path to an open path. A clone of ‘self’ is returned untouched if ‘self’ is empty or open.

pub fn to_closed(&self) -> Self

Convert an unclosed path to a closed path. A clone of ‘self’ is returned untouched if ‘self’ is empty or closed.

impl<T> Path<T>

where T: AddAssign + Copy,

pub fn offset(&mut self, o: &T)

Applies an offset to all points in the path

impl<T> Path<T>

where T: ToSvgString + Copy + Add<Output = T>,

pub fn to_svg_string( &self, close: bool, offset: &T, precision: Option<u32> ) -> String

Generates a string representation of the path in SVG format.

Takes a bool to indicate whether the end should be wrapped back to start.

An offset is specified to apply an offset to the display points (useful when displaying on canvas elements).

If close is true, assume the last point of the path repeats the first point

impl<T> Path<Point2<T>>

where T: Add<Output = T> + Sub<Output = T> + Mul<Output = T> + PartialEq + PartialOrd + Copy + Into<f64>,

pub fn reduce(&self, tolerance: f64) -> Option<Self>

Path is a closed path (shape), but the reduce algorithm only reduces open paths. We divide the path into four sections, spliced at the extreme points (max-x max-y min-x min-y), and reduce each section individually. Thus the most simplified path consists of at least 4 points. This function assumes the last point of the path repeats the first point.

impl Path<Point2<i32>>

pub fn smooth( &self, corner_threshold: f64, outset_ratio: f64, segment_length: f64, max_iterations: usize ) -> PathF64

Returns a copy of self after Path Smoothing, preserving corners.

corner_threshold is specified in radians. outset_ratio is a real number >= 1.0. segment_length is specified in pixels (length unit in path coordinate system).

impl Path<Point2<f64>>

pub fn smooth( &self, corner_threshold: f64, outset_ratio: f64, segment_length: f64, max_iterations: usize ) -> PathF64

impl Path<Point2<i32>>

pub fn simplify(&self, clockwise: bool) -> Self

Returns a copy of self after Path Simplification:

First remove staircases then simplify by limiting penalties.

pub fn image_to_path( image: &BinaryImage, clockwise: bool, mode: PathSimplifyMode ) -> PathI32

Converts outline of pixel cluster to path with Path Walker. Takes a bool representing the clockwiseness of traversal (useful in svg representation to represent holes). Takes an enum PathSimplifyMode which indicates the required operation:

• Polygon - Walk path and simplify it
• Otherwise - Walk path only

pub fn to_path_f64(&self) -> PathF64

Returns a copy of self converted to PathF64

Trait Implementations

impl<T: Clone> Clone for Path<T>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Path<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for Path<T>

fn default() -> Path<T>

Returns the “default value” for a type.

impl<T> Index<Range<usize>> for Path<T>

type Output = [T]

The returned type after indexing.

fn index(&self, index: Range<usize>) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<T> Index<RangeFrom<usize>> for Path<T>

type Output = [T]

The returned type after indexing.

fn index(&self, index: RangeFrom<usize>) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<T> Index<RangeInclusive<usize>> for Path<T>

type Output = [T]

The returned type after indexing.

fn index(&self, index: RangeInclusive<usize>) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<T> Index<usize> for Path<T>

type Output = T

The returned type after indexing.

fn index(&self, index: usize) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<T> IndexMut<usize> for Path<T>

fn index_mut(&mut self, index: usize) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.