Struct libreda_db::layout::prelude::Path

pub struct Path<T> where
    T: CoordinateType,  {
    pub points: PointString<T>,
    pub width: T,
    pub path_type: PathEndType<T>,
}

Path is essentially a chain of line segments but with a possibly a non-zero width. It can be thought of the shape resulting by a stroke of a thick pen along the line segments.

Fields

points: PointString<T>

The vertices of the path which define the sequence of line segments.

width: T

Width of the path.

path_type: PathEndType<T>

Type of the path endings.

Implementations

impl<T> Path<T> where
    T: CoordinateType, 

pub fn new<I>(i: I, width: T) -> Path<T> where
    I: Into<PointString<T>>, 

Create new path by taking vertices from a type that implements Into<PointString<T>>.

pub fn new_extended<I>(i: I, width: T, ext_begin: T, ext_end: T) -> Path<T> where
    I: Into<PointString<T>>, 

Create a path with extended beginning and end.

pub fn new_rounded<I>(i: I, width: T) -> Path<T> where
    I: Into<PointString<T>>, 

Create a path with rounded beginning and end.

pub fn translate(&self, v: Vector<T>) -> Path<T>

Translate the path by an offset vector.

pub fn len(&self) -> usize

Get number of vertices defining the path.

pub fn scale(&self, factor: T) -> Path<T>

Scale the path. Scaling center is the origin (0, 0).

pub fn rotate_ortho(&self, angle: Angle) -> Path<T>

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

pub fn transform(&self, tf: &SimpleTransform<T>) -> Path<T>

Get the transformed version of this path by applying tf.

impl<T> Path<T> where
    T: CoordinateType + NumCast, 

pub fn area_approx<F>(&self) -> F where
    F: Float, 

Compute approximate area occupied by the path. Simply computes length*width.

Examples

use iron_shapes::prelude::*;
let path = Path::new(&[(0, 0), (0, 2)], 1);
assert_eq!(path.area_approx::<f64>(), 2f64);

pub fn to_polygon_approx(&self) -> SimplePolygon<f64>

Convert the path into a polygon. The polygon can be self-intersecting.

Examples

use iron_shapes::prelude::*;
let path = Path::new(&[(0, 0), (10, 0), (10, 20)], 4);
let polygon = path.to_polygon_approx();
assert_eq!(polygon, SimplePolygon::from(&[(0., 2.), (0., -2.), (12., -2.), (12., 20.), (8., 20.), (8., 2.)]));

Trait Implementations

impl<T> Clone for Path<T> where
    T: CoordinateType + Clone, 

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for Path<T> where
    T: CoordinateType + Debug, 

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

Formats the value using the given formatter.

impl<T> Eq for Path<T> where
    T: CoordinateType + Eq, 

impl<T> From<Path<T>> for Geometry<T> where
    T: CoordinateType, 

pub fn from(x: Path<T>) -> Geometry<T>

Performs the conversion.

impl<T> Hash for Path<T> where
    T: CoordinateType + Hash, 

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

Feeds this value into the given Hasher.

pub 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<Path<T>> for Path<T> where
    T: CoordinateType + PartialEq<T>, 

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

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

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

This method tests for !=.

impl<T> StructuralEq for Path<T> where
    T: CoordinateType, 

impl<T> StructuralPartialEq for Path<T> where
    T: CoordinateType, 

impl<T> TryBoundingBox<T> for Path<T> where
    T: CoordinateType, 

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

Compute the bounding box of this path. The returned bounding box is not necessarily the smallest bounding box.

TODO: Find a better approximation.

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

type Output = Path<Dst>

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

pub fn try_cast(&self) -> Option<<Path<T> as TryCastCoord<T, Dst>>::Output>

Try to cast to target data type.

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

Cast to target data type.