string_art 0.1.0-alpha.1

Convert images into thread patterns for creating string art. It generates detailed instructions in text format and provides graphical previews of the resulting patterns.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

pub mod circular;

use crate::Float;
pub use circular::Circular;
use svg::Node;

use crate::geometry::{Point, Segment};

pub trait Builder {
    type Scalar: Float;
    type Nail: Copy;
    type Handle: Handle<Scalar = Self::Scalar, Nail = Self::Nail>;

    fn build_nail(&self, position: Point<Self::Scalar>, rotation: Self::Scalar) -> Self::Nail;

    fn build_handle(self) -> Self::Handle;
}

pub unsafe trait Links: IntoIterator<Item = Self::Link> {
    type Link: Copy + Into<usize> + Send + Sync;

    const LEN: usize;
    const SQ_LEN: usize = Self::LEN * Self::LEN;
}

pub trait Handle: Copy + Send + Sync {
    type Scalar: Float;
    type Nail: Copy + Send + Sync;
    type Links: Links<Link = Self::Link>;
    type Link: Copy + Into<usize> + Send + Sync;
    type Error: std::error::Error;

    const LINKS: Self::Links;

    fn get_segment(
        self,
        start: (&Self::Nail, <Self::Links as IntoIterator>::Item),
        end: (&Self::Nail, <Self::Links as IntoIterator>::Item),
    ) -> Result<Segment<Self::Scalar>, Self::Error>;

    fn get_next_link(
        self,
        prev_link: <Self::Links as IntoIterator>::Item,
    ) -> <Self::Links as IntoIterator>::Item;

    fn draw_svg(self, nail: Self::Nail) -> impl Into<Box<dyn Node>>;
}