cozyvec

cozyvec is a terminal program for creating plotter art (specifically via SVG files) in javascript with minimal setup.

The library has been designed for brevity, so the code for a specific plot can be tweeted under the hashtag #cozyvec (much like PICO-8's #tweetcart and processing's #つぶやきProcessing) by providing shortcut versions of most tokens that are 1-4 characters.

Browser Version

Browser version available at: https://brubsby.github.io/cozyvec

However, the standalone builds are a better user experience (menu items)

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/brubsby/cozyvec.git
cd cozyvec/desktop/
npm install
npm start

Library

l2|lineTo(x,y) draw line from last point
m2|moveTo(x,y) move to point
clsp|closePath() draw line to last move to point
ppr|paper(name[,orientation]) change paper to size in library
ppr|paper(w,h[,name[,orientation]]) custom paper in mm
pen(w) pen width in mm, also starts new SVG group (to help with pen swapping)
mbox|marginBox([a[,b[,c[,d]]]]) create bounding box with margins [x1,y1,x2,y2] default 40 mm, partial arguments follow css margin conventions
log(s) log message s, gets overwritten by errors and other logs
err|error(s) error message s and quit
W|WIDTH canvas width
H|HEIGHT canvas height
PI π
TAU|TWO_PI 2*π
HPI|HALF_PI π/2
QPI|QUARTER_PI π/4
pow(a,b) exponentiation
sqrt(a) square root
sqr|square(a) square number
cub|cube(a) cube number
abs(a) absolute value
ceil(a) round up to nearest integer
flr|floor(a) round down to nearest integer
sgn|sign(a) return the sign of a number
sin(a) sine
cos(a) cosine
tan(a) tangent
asin(a) arcsine
acos(a) arccosine
atan(a) arctangent
at2|atan2(y,x) arctangent2
min(...a) minimum
max(...a) maximum
mid(a,b,c) clamp b to [a,c]
smid|smoothMid(a,b,c) clamp b to [a,c] with smoothing
dst|distance(x1,y1,x2,y2) distance between points
rnd|random() random [0-1)
rnd|random(a) random [0-a)
rnd|random(a,b) random [a-b)
srnd|seedRandom() seed rng with 0
srnd|seedRandom(s) seed rng with s
nse|noise(pos) simplex noise (pos can be a number or 1-4 numbers in a list)
nse|noise(pos,freq,amp) simplex noise
nse|noise(pos,freq,amp,octaves,lacunarity,gain) fractal simplex noise

Shortcuts

CmdOrCtrl+G documentation
CmdOrCtrl+R run code
CmdOrCtrl+E export SVG
CmdOrCtrl+I export PNG
CmdOrCtrl+P flip paper orientation
CmdOrCtrl+N new file
CmdOrCtrl+O open .js file
CmdOrCtrl+S save .js file
CmdOrCtrl+Tab dev console

Paper Sizes

Paper sizes are defined here, create an issue or PR if you'd like me to add another standardized paper size to select from.

You can also call paper|ppr(width_mm, height_mm[, name[, is_portrait]]) at the beginning of your script to define a custom size for your plot.

Community

Contributing

Please create an issue if you have questions about behavior, find a bug, or want to make a feature/paper size request! I will also accept PR's, but might edit them first!

brubsby / cozyvec