Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jamesporter/solandra
A framework for algorithmic art. TypeScript first. Make drawing concepts part of framework. Make APIs for humans.
https://github.com/jamesporter/solandra
Last synced: 4 months ago
JSON representation
A framework for algorithmic art. TypeScript first. Make drawing concepts part of framework. Make APIs for humans.
- Host: GitHub
- URL: https://github.com/jamesporter/solandra
- Owner: jamesporter
- License: mit
- Created: 2019-07-29T19:23:51.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-07-10T17:00:29.000Z (7 months ago)
- Last Synced: 2024-08-02T06:25:59.060Z (7 months ago)
- Language: TypeScript
- Size: 24.3 MB
- Stars: 182
- Watchers: 5
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Solandra
## Principles
Opinionated, agile (code is easy to change) framework for algorithmic art. See my [essays](https://www.amimetic.co.uk/art/) 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.
## Get Started
- On CodeSandbox, quickly get started: [Simple editable sketch](https://codesandbox.io/s/simple-solandra-example-2-wy7nx?fontsize=14)
- Clone [this project](https://github.com/jamesporter/solandra) to try out as add React powered GUI around stuff but first see it [live](https://solandra.amimetic.co.uk/).
- On [NPM](https://www.npmjs.com/package/solandra). 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](http://localhost:3000) and in your editor `sketches.ts` and try things out. It does things like the below
```typescript
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])
},
],
])
})
```
[Over 140 Examples](./samples/samples.md)
