ronin/README.md

Ronin

"All I wanted, was a quick way of resizing a few photos.."

Ronin is a LISP repl to create generative graphics currently under development. You can follow the daily progress on Mastodon.

Install & Run

You can download builds for OSX, Windows and Linux, or if you wish to build it yourself, follow these steps:

git clone https://github.com/hundredrabbits/Ronin.git
cd Ronin/desktop/
npm install
npm start

Library

• (import path rect) Imports a graphic file with format.
• (export path format quality) Exports a graphic file with format.
• (pos x y t) Returns a position shape.
• (size w h t) Returns a size shape.
• (rect x y w h t) Returns a rect shape.
• (circle x y r t) Returns a circle shape.
• (line a b t) Returns a line shape.
• (text x y g s f t) Returns a text shape.
• (svg d t) Returns a svg shape.
• (stroke shape) Strokes a shape.
• (fill rect) Fills a shape.
• (clear rect) Clears a rect.
• (add ...args) Adds values.
• (sub ...args) Subtracts values.
• (mul ...args) Multiplies values.
• (div ...args) Divides values.
• (mod a b) Returns the modulo of a and b.
• (clamp val min max) Clamps a value between min and max.
• (step val step)
• (min)
• (max)
• (ceil)
• (floor)
• (sin)
• (cos)
• (PI)
• (TWO_PI)
• (random ...args)
• (gt a b) Returns true if a is greater than b, else false.
• (lt a b) Returns true if a is less than b, else false.
• (eq a b) Returns true if a is equal to b, else false.
• (and a b ...rest) Returns true if all conditions are true.
• (or a b ...rest) Returns true if at least one condition is true.
• (map fn arr)
• (filter fn arr)
• (reduce fn arr acc)
• (len item) Returns the length of a list.
• (first arr) Returns the first item of a list.
• (last arr) Returns the last
• (rest [_ ...arr])
• (range start end step)
• (get item key) Gets an object's parameter with name.
• (set item key val) Sets an object's parameter with name as value.
• (frame) Returns a rect of the frame.
• (center) Returns a position of the center of the frame.
• (scale rect w h)
• (resize w h)
• (crop rect)
• (clone a b)
• (of h ...keys)
• (theme variable el)
• (gradient [x1 y1 x2 y2] colors 'black'])
• (pixels rect fn q)
• (saturation pixel q)
• (contrast pixel q)
• (echo ...args)
• (str ...args)
• (open path) Imports a graphic file and resizes the frame.
• (folder path) Returns the content of a folder path.
• (exit force) Exits Ronin.
• (ronin)
• (time) Returns timestamp in milliseconds.
• (animate play) Toggles animation.
• (js)
• (test name a b)

Extras

• This application supports the Ecosystem Theme.
• Support this project through Patreon.
• See the License file for license rights and limitations (MIT).
• Pull Requests are welcome!