aoer-plotty-rs 0.4.1

A variety of utilities for creating pen-plotter based artwork.
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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137

//! # AOER-PLOTTY-RS : ArmyOfEvilRobots pen-plotter art related tools and libraries
//!
//! [![Package][package-img]][package-url] [![Documentation][documentation-img]][documentation-url]
//!
//! This library contains a variety of tools used to make pen-plotter based art.
//! While it focuses on a combination of nannou and geo/geo_types for now, it
//! will likely expand into other areas as I find the need for my own creations.
//! Based (extremely roughly) on [`shapely`] for Python for the geographic
//! functions, with a splash of [`VSK`].
//!
//! *CAUTION: This isn't even Alpha quality yet, and I am poking away at it on
//! my days off. May spontaneously explode, might take your plotter with it.*
//!
//! [`shapely`]: https://github.com/shapely/shapely
//! [`vsk`]: https://vsketch.readthedocs.io/en/latest/index.html
//!
//! # Changelog
//! * 0.2.2. Bugfixens! The regular_poly_native function was duplicating
//!          points, resulting in invalid geometries.
//! * 0.2.1. Optimizations and plotters:
//!   * Add optimization to toolpaths/line-ordering so that we don't waste
//!     valuable time traversing empty space when plotting.
//!   * Add simple serial-plotter support
//! * 0.2.0. We made it!!!!
//!   * Typography module. It's buggy and ugly, but we can now place simple
//!     text on the sketches.
//!   * Performance improvements; particularly on complex overlapping
//!     geometries
//!   * Truchet tiles (Carlson Smith)
//!   * Example of using a UI in Nannou to customize a sketch
//! * 0.1.11. Added the first "element" (reusable sketch component) in the form
//!          of the [`elements::CarlsonSmithTruchet`], which provides tileable
//!          and scalable truchets which make for some very interesting patterns.
//!          Think of them as the "goto 10" tiles on steroids.
//!          Also added a to_geos trait which makes it easy to convert
//!          back and forth from geo_types without fancy and unpredictable
//!          From/Into magic.
//!          Also added a [`geo_types::shapes`] module which provides some
//!          additional primitives (arc, polygons, circles).
//!          Added the [`geo_types::boolean::BooleanOp`] trait to allow for
//!          boolean operations directly against geo_types.
//! * 0.1.10. Getting close to having to do a 0.2 release. Added the 'flatten'
//!          method to [`context::Context`] so that you can merge all your
//!          pen strokes that live on the same layer. Good for merging
//!          overlapping polygons. Layer is defined as "exact same color, pen,
//!          and fill configuration"
//! * 0.1.9. Add masking to context: You can now mask the drawable area with
//!          any [`geo_types::Geometry`] variant and only areas under the mask
//!          will actually render. Also changed some performance and accuracy
//!          related optimizations so that clipped items look clean.
//!          Also added the final Generative Artistry examples. I'll miss
//!          implementing those :(
//! * 0.1.8. Add a bunch of new features to Context, including regular polygons
//!          and tesselated polys (stars of various point counts). Circles are
//!          now somewhat simpler as well.
//! * 0.1.7. Another big change. Added the Context drawing library, which is HUGE,
//!   and contains way too much functionality to discuss here.
//! * 0.1.6. Various changes:
//!   * Add [`geo_types::buffer::Buffer`] trait to offset polygons
//!   * Add [`geo_types::clip::LineClip`] trait to Clip geometry with
//!     OTHER geometry.
//!   * [`geo_types::svg::Arrangement`] trait has been extended to
//!     better support arbitrary transformations.
//!   * [`geo_types::svg::Arrangement`] trait has also added a margin
//!     option to fit geometry on a page with predefined margins.
//!   * [`geo_types::hatch::OutlineStroke`] is a utility Trait which
//!     takes a LineString/MultiLineString and applies a stroke, returning
//!     a MultiLineString containing lines which outline the stroked line
//!   * [`geo_types::hatch::OutlineFillStroke`] is the same as [`geo_types::hatch::OutlineStroke`]
//!     except it also fills the stroke with the given HatchPattern. Great for turning
//!     drawings made of thick lines into nicely filled polygons.
//!   * Tons more examples which are oxidized versions of the
//!     [`Generative Artistry tutorials`]
//! * 0.1.5. Add SVG generation features.
//! * 0.1.4. Add the [`geo_types::hatch::Hatch`]ing submodule.
//! * 0.1.3. Breaking change to GCode POST again; use an enum to define the
//!          the input geometry so that we can add new geometry source types,
//!          like svg2polyline polylines, or even multilayer geo with tool changes.
//! * 0.1.2. Mostly documentation improvements. Made MIT license explicit.
//! * 0.1.1. Breaking change to the GCode POST function to use geo_types in
//!          order to be consistent with everywhere else in the library.
//!          Also changed the Turtle/TurtleTrait to just be mutable.
//! * 0.1.0. Initial commit
//!
//! [documentation-img]: https://docs.rs/aoer-plotty-rs/badge.svg
//! [documentation-url]: https://docs.rs/aoer-plotty-rs
//! [package-img]: https://img.shields.io/crates/v/aoer-plotty-rs.svg
//! [package-url]: https://crates.io/crates/aoer-plotty-rs
//! [`Generative Artistry tutorials`]: https://generativeartistry.com/tutorials/

/// Extensions/Traits for geo_types geometry. Also includes some helper functions
/// for working with Nannou and geo_types.
pub mod geo_types;

/// Turtle graphics implementation, including integration with L-systems
pub mod turtle;

/// L-system implementation, with expansion/recursion
pub mod l_system;

/// gcode module provides a simple post-processor for line-based art to be converted
/// into GCode
pub mod gcode;

/// A stateful drawing context which gives you canvas-ish drawing capabilities
pub mod context;

/// Errors
pub mod errors;

/// Elements : Reusable art components, usually designed for use with Context
pub mod elements;

/// Workbench : Tooling to turn your 'sketches' into interactive UI based tools
/// that can be used to tweak a design and generate SVG output (and eventually
/// even to directly plot the result).
/// Note; this has been prototyped out, but I am not happy with how the process
/// works yet, so no library here (for now).

/// optimizer
/// Library that optimizes path to reduce travel time
pub mod optimizer;

/// Plotter
/// Module for talking to a serial plotter via gcode
pub mod plotter;

/// Make your life easy! Just import prelude::* and ignore all the warnings!
/// One stop shopping at the expense of a slightly more complex dependency graph.
pub mod prelude {
    pub use crate::geo_types::hatch::*;
    pub use crate::geo_types::nannou::NannouDrawer;
    pub use crate::geo_types::svg::*;
    pub use crate::geo_types::PointDistance;
    pub use crate::l_system::LSystem;
    pub use crate::turtle::{Turtle, TurtleTrait};
}