The application interprets a dialect of LISP to automate simple graphical tasks, like resizing, cropping, coloring, and generating procedural imagery. You can look at these example files to better understand how this all works.

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.
(of h ...keys)
(frame) Returns a rect of the frame.
(center) Returns a position of the center of the frame.
(scale rect w h)
(resize w h) Resizes the canvas to target w and h, returns the rect.
(rescale w h) Rescales the canvas to target ratio of w and h, returns the rect.
(crop rect)
(clone a b)
(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.
(time) Returns timestamp in milliseconds.
(animate ~play) Toggles animation.
(js) Javascript interop.
(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!