//! Build different kinds of 2D shapes. pub mod arc; mod builder; #[doc(no_inline)] pub use arc::Arc; pub use builder::Builder; use iced_native::{Point, Size}; /// An immutable set of points that may or may not be connected. /// /// A single [`Path`] can represent different kinds of 2D shapes! /// /// [`Path`]: struct.Path.html #[derive(Debug, Clone)] pub struct Path { raw: lyon::path::Path, } impl Path { /// Creates a new [`Path`] with the provided closure. /// /// Use the [`Builder`] to configure your [`Path`]. /// /// [`Path`]: struct.Path.html /// [`Builder`]: struct.Builder.html pub fn new(f: impl FnOnce(&mut Builder)) -> Self { let mut builder = Builder::new(); // TODO: Make it pure instead of side-effect-based (?) f(&mut builder); builder.build() } /// Creates a new [`Path`] representing a line segment given its starting /// and end points. /// /// [`Path`]: struct.Path.html pub fn line(from: Point, to: Point) -> Self { Self::new(|p| { p.move_to(from); p.line_to(to); }) } /// Creates a new [`Path`] representing a rectangle given its top-left /// corner coordinate and its `Size`. /// /// [`Path`]: struct.Path.html pub fn rectangle(top_left: Point, size: Size) -> Self { Self::new(|p| p.rectangle(top_left, size)) } /// Creates a new [`Path`] representing a circle given its center /// coordinate and its radius. /// /// [`Path`]: struct.Path.html pub fn circle(center: Point, radius: f32) -> Self { Self::new(|p| p.circle(center, radius)) } #[inline] pub(crate) fn raw(&self) -> &lyon::path::Path { &self.raw } #[inline] pub(crate) fn transformed( &self, transform: &lyon::math::Transform, ) -> Path { Path { raw: self.raw.transformed(transform), } } }