Crate aoer_plotty_rs

AOER-PLOTTY-RS : ArmyOfEvilRobots pen-plotter art related tools and libraries

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.

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::Hatching 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

Modules

context

A stateful drawing context which gives you canvas-ish drawing capabilities Provides the crate::context::Context struct which gives us a canvas-style drawing context which provides plotter-ready SVG files. See Context for more details, and examples.

elements

Elements : Reusable art components, usually designed for use with Context

errors

Errors

gcode

gcode module provides a simple post-processor for line-based art to be converted into GCode Module which provides Line->GCode post-processing

geo_types

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

l_system

L-system implementation, with expansion/recursion The l_system module provides a simple Lindenmeyer fractal generator for use with plotted line-art. Take a look at the crate::l_system::LSystem struct for more details, and examples.

optimizer

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

plotter

Plotter Module for talking to a serial plotter via gcode

prelude

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.

turtle

Turtle graphics implementation, including integration with L-systems