solandra
TypeScript icon, indicating that this package has built-in type declarations

0.19.0 • Public • Published

Solandra

Principles

Opinionated, agile (code is easy to change) framework for algorithmic art. See my essays for research/plans that went into this!

  • Sketches always have width 1, height depends on aspect ratio.
  • Angles in radians.
  • Points are [number, number].
  • Colours in hsl(a).
  • Leverage TypeScript: you shouldn't need to learn much, autocomplete and type checking should have your back.
  • Not for beginners.
  • Control flow at level of drawing (tiling, partitions etc).
  • Few dependencies/mostly from scratch.
  • Performance is not the goal.
  • Common algorithmic art things (e.g. randomness) should be easy.
  • Should feel fun/powerful.
  • Life is too short to compile things.
  • Rethink APIs e.g. standard bezier curve APIs make absolutely no sense
  • Declarative when possible (especially anything configuration-y), procedural when pragmatic; make it easy to explore/change your mind.

Examples

Get Started

  • On CodeSandbox, quickly get started: Simple editable sketch
  • Clone this project to try out as add React powered GUI around stuff but first see it live.
  • On NPM. Install with npm i solandra or yarn add solandra.

Or if you want to play locally clone this repo, install dependencies with npm and start by:

npm run dev

Then open http://localhost:3000 and in your editor sketches.ts and try things out. It does things like the below

A simple example drawn with tiles

p.forTiling({ n: 20, margin: 0.1, type: "square" }, ([x, y], [dX, dY]) => {
  p.lineStyle = { cap: "round" }
  p.proportionately([
    [
      1,
      () => {
        p.setStrokeColour(120 + x * 120, 90 - 20 * y, 40)
        p.drawLine([x, y], [x + dX, y + dY])
      },
    ],
    [
      2,
      () => {
        p.setStrokeColour(120 + x * 120, 90 - 20 * y, 40)
        p.drawLine([x + dX, y], [x, y + dY])
      },
    ],
  ])
})

An example

An example

An example

An example

Over 140 Examples

New in 0.18: Palettes

Readme

Keywords

none

Package Sidebar

Install

npm i solandra

Weekly Downloads

12

Version

0.19.0

License

MIT

Unpacked Size

212 kB

Total Files

134

Last publish

Collaborators

  • jamesporter