/genartlib

Utilities for creating generative artwork with Clojure

Primary LanguageClojureMIT LicenseMIT

genartlib

Clojars Project cljdoc badge

Ectogenesis

A Clojure library with simple utilities for creating generative artwork.

This library is built around Quil, a Clojure wrapper around the Processing framework. However, most of the functions are just mathematical utilies that could be used idependently.

To see and read about my artwork, visit tylerxhobbs.com or follow me on Instagram or Twitter.

Usage

To install, add this to your dependencies in project.clj:

[genartlib "0.1.22"]

Contents

View the API Docs.

The genartlib library has the following tools:

Project Template

Under project-template/, you'll find the basic setup that I use for every new generative art project. This is geared towards creating static images.

I also wrote a bit about my development setup and how I use it.

Algebra

The following algebra-ish functions are defined:

  • avg - average
  • interpolate / interpolate-multi - linear interpolation
  • rescale - map from one range to another
  • line-intersection - find the intersection of two lines
  • lines-intersection-point - another way to find line intersections
  • slope / point-slope - get the slope of a line
  • y-intercept - get the y intercept point of a line
  • angle / point-angle - get the angle between two points in radians
  • angular-coords - calculate the offset location from a base point with angle and magnitude
  • point-dist - distance between two points

Geometry

  • polygon-contains-point? - a fast test for checking if a point falls inside a polygon
  • rotate-polygon - rotates around the average center of the poly
  • shrink-polygon - shrink by a ratio

Curves

  • chaikin-curve - a curve-smoothing algorithm
  • chaikin-curve-retain-ends - a variation that preserves the original end points
  • split-curve-by-step - break up a curve into chunks with the given length
  • split-curve-into-parts - break up a curve into chunks with equal length, given a number of parts to have
  • interpolate-curve - find a point that is a given percentage along the length of a curve
  • line-simplification - an implementation of the Ramer-Douglas-Peucker line simplification algorithm

Random

  • gauss - sample a gaussian probability distribution
  • abs-gauss - basically gauss + abs
  • triangular - sample a triangular probability distribution
  • pareto-sampler / pareto-sample - sample a pareto probability distribution
  • random-point-in-circle - uniform sampling of points within a circle
  • odds - returns true or false with the given probability
  • choice - pick from a list of items with uniform probability
  • weighted-choice - pick from a list of items, each with an assigned probability
  • repeatable-shuffle - a version of shuffle that uses Processing's Random, in order to ensure repeatability with the same seed

Plotter

  • sort-curves-for-plotting - sorts a seq of curves in order to minimize plotter travel distance

Utils

  • w and h - shorthand for expressing a length or position in terms of percentage of the image width or height - good for using a pseudo-vector approach to creating images
  • set-color-mode - set the color mode to HSV with ranges H [0, 360], S [0.0, 100.0], V [0.0, 100.0], alpha [0.0, 1.0]
  • in? / not-in? - test if a seq contains an item
  • between? - is a value inside an inclusive range?
  • enumerate - turns a seq of items into a seq like ([0 item-0] [1 item-1] [2 item-2] ...)
  • zip - combine two or more seqs into tuples
  • snap-to - snap a value to a given window size, kind of like configurable rounding
  • vec-remove - remove an item from a vector

License

Copyright © Tyler Hobbs

Distributed under the MIT License.