lot

File*

animate

Docs

Download

What do I make?

Machine control

@title: GeometricColoringSheet

@author: CaitPrough

@snapshot: 12x12noGaps.png

// these are the size of the grid

const sqNumWidth = 12; // Number of squares wide

const sqNumHeight = 12; // Number of squares tall

// if width and height = 10 there will be no gap between shapes, larger will

// have the gaps as the remainder after 10, less will cause overlap

const squareWidth = 10; // Width of each 'square'

const squareHeight = 10; // Height of each 'square'

const canvasWidth = squareWidth * sqNumWidth - (squareWidth - 10);

const canvasHeight = squareHeight * sqNumHeight - (squareHeight - 10);

setDocDimensions(canvasWidth, canvasHeight);

const finalLines = [];

const finalLinesBounds = bt.bounds(finalLines);

// rotate the shape (not really useful for circles lmao)

function rotateShape(shape) {

const degrees = bt.randIntInRange(0, 3) * 90;

bt.rotate(shape, degrees);

}

// create full circle

function polylineCircle(center, radius, segments) {

const circle = [];

for (let i = 0; i <= segments; i++) {

const angle = (i / segments) * Math.PI * 2;

const x = center[0] + radius * Math.cos(angle);

const y = center[1] + radius * Math.sin(angle);

circle.push([x, y]);

}

return [circle];

}

// create quarter circle

function quarterCircle(center, radius, segments) {

const qCircle = [];

const startAngle = -Math.PI / 2; // angle

const endAngle = 0;

const angleIncrement = (endAngle - startAngle) / segments;

qCircle.push([5, 5], [-5, 5]);

qCircle.push([-5, 5], [-5, -5]);

for (let i = 0; i <= segments; i++) {

const angle = startAngle + i * angleIncrement;

const x = center[0] + radius * Math.cos(angle);

const y = center[1] + radius * Math.sin(angle);

qCircle.push([x, y]);

}

return [qCircle];

}

// create arc

function arc(center, radius, segments) {

const qCircle = [];

const startAngle = -Math.PI / 2; // angle

const endAngle = 0;

const angleIncrement = (endAngle - startAngle) / segments;

for (let i = 0; i <= segments; i++) {

const angle = startAngle + i * angleIncrement;

const x = center[0] + radius * Math.cos(angle);

Toolkit Close Help

The Toolkit

This is a quick reference sheet. For full documentation refer to this.

For an introduction to Blot check out this guide.

Check out our 38 second trailer for a brief overview of the whole Blot project.

There are three names that provide functionality available in the Blot editor: setDocDimensions, drawLines, and blotToolkit (which can also be referenced as bt).

The first two affect the drawing environment itself, and the blotToolkit is used for creating line drawings.

Environment Affecting

setDocDimensions(width: number, height: number)
drawLines(polylines: [number, number][][])

Modify Polylines

Take and modify polylines in place returns first passed polylines.

These functions are available in the blotToolkit or bt object.

bt.iteratePoints(polylines, (pt, t) => { ... }) // return pt to modify, "BREAK" to split, "REMOVE" to filter out point
bt.scale(polylines, scale : scaleXY | [scaleX, scaleY], ?origin: [ x, y ]) 
bt.rotate(polylines, degrees, ?origin: [ x, y ]) 
bt.translate(polylines, [dx, dy], ?origin: [ x, y ]) 
bt.originate(polylines) // moves center to [0, 0] 
bt.resample(polylines, sampleRate) 
bt.simplify(polylines, tolerance) 
bt.trim(polylines, tStart, tEnd)
bt.merge(polylines)  
bt.join(polylines0, ...morePolylines) 
bt.copy(polylines)
bt.cut(polylines0, polylines1) 
bt.cover(polylines0, polylines1) 
bt.union(polylines0, polylines1)
bt.difference(polylines0, polylines1)
bt.intersection(polylines0, polylines1)
bt.xor(polylines0, polylines1)
bt.offset(polylines, delta, ?ops = { endType, joinType, miterLimit, arcTolerance })

Get Data From Polylines

These functions are available in the blotToolkit or bt object.

// take polylines return other
bt.getAngle(polylines, t: [0 to 1]) // returns angle in degrees
bt.getPoint(polylines, t: [0 to 1]) // returns point as [x, y]
bt.getNormal(polylines, t: [0 to 1]) // returns normal vector as [x, y]

bt.pointInside(polylines, pt)

bt.bounds(polylines) 
/*
returns { 
  xMin, xMax, 
  yMin, yMax, 
  lt, ct, rt, 
  lc, cc, rc,
  lb, cb, rb,
  width, height
}

l is left
c is center
r is right
t is top
b is bottom

they are arranged in this configuration around the bounding box of the polylines

lt--ct--rt
 |   |   |
lc--cc--rc
 |   |   | 
lb--cb--rb
*/

Generate Polylines

These functions are available in the blotToolkit or bt object.

const myTurtle = new bt.Turtle()
  .forward(distance: number)
  .arc(angle: number, radius: number)
  .goTo( [ x: number, y: number ] ) // move with up/down state
  .jump( [ x: number, y: number ] ) // move but don't draw
  .step( [ dx: number, dy: number ] ) // add delta to turtles current position
  .right(angle: number)
  .left(angle: number)
  .setAngle(angle: number)
  .up() // sets drawing to false
  .down() // sets drawing to true
  .copy()
  .applyToPath(fn) // takes (turtlePath) => { }
  .lines() // get copy of the Turtle's path

// data
const position = myTurtle.pos // [x: number, y: number]
const angle = myTurtle.angle // number
const path = myTurtle.path // is array of polylines [number, number][][]
const drawing = myTurtle.drawing // boolean

bt.catmullRom(points, ?steps = 1000) // returns polyline [number, number][]
bt.nurbs(points, ?ops = { steps: 100, degree: 2}) // returns polyline [number, number][]

Randomness

These functions are available in the blotToolkit or bt object.

bt.rand();

bt.randInRange(min: number, max: number);

bt.randIntInRange(min: number, max: number); 

bt.setRandSeed(seed: number);

bt.noise(
  number | [ x:number , ?y: number , ?z: number ], 
  { 
    octaves: number [0 to 8], 
    falloff: number [0 to 100] 
  }
);

Idioms

These are small useful code snippets.

function centerPolylines(polylines, documentWidth, documentHeight) {
  const cc = bt.bounds(polylines).cc;
  bt.translate(polylines, [documentWidth / 2, documentHeight / 2], cc);
}