ronin/src/Library.js

727 lines
21 KiB
JavaScript

function Library (client) {
// IO
this.open = async (name, scale = 1) => { // Import a graphic and scale canvas to fit.
const img = await resolveImage(name)
const rect = this.rect(0, 0, img.width * scale, img.height * scale)
this.resize(rect.w, rect.h)
await this.import(name, rect)
return rect
}
this.import = async (name, shape, alpha = 1) => { // Imports a graphic file with format.
const img = await resolveImage(name)
client.surface.draw(img, shape, alpha)
return shape || this.rect(0, 0, img.width, img.height)
}
this.export = async (format = 'jpg', quality = 0.9, name = `ronin-${timestamp()}`) => { // Exports a graphic file with format.
const type = `image/${format === 'jpeg' || format === 'jpg' ? 'jpeg' : 'png'}`
console.log('Exporting!')
client.source.write(name, format, client.surface.toDataURL(type, quality), type)
}
function timestamp (d = new Date(), e = new Date(d)) {
return `${arvelie()}-${neralie()}`
}
function arvelie (date = new Date()) {
const start = new Date(date.getFullYear(), 0, 0)
const diff = (date - start) + ((start.getTimezoneOffset() - date.getTimezoneOffset()) * 60 * 1000)
const doty = Math.floor(diff / 86400000) - 1
const y = date.getFullYear().toString().substr(2, 2)
const m = doty === 364 || doty === 365 ? '+' : String.fromCharCode(97 + Math.floor(doty / 14)).toUpperCase()
const d = `${(doty === 365 ? 1 : doty === 366 ? 2 : (doty % 14)) + 1}`.padStart(2, '0')
return `${y}${m}${d}`
}
function neralie (d = new Date(), e = new Date(d)) {
const ms = e - d.setHours(0, 0, 0, 0)
return (ms / 8640 / 10000).toFixed(6).substr(2, 6)
}
this.files = () => {
return Object.keys(client.cache.data)
}
// Shapes
this.pos = (x = 0, y = 0) => { // Returns a position shape.
return { x, y }
}
this.line = (ax, ay, bx, by) => { // Returns a line shape.
return { a: this.pos(ax, ay), b: this.pos(bx, by) }
}
this.size = (w, h) => { // Returns a size shape.
return { w, h }
}
this.rect = (x, y, w, h) => { // Returns a rect shape.
return { x, y, w, h, pos: { x, y }, size: { w, h } }
}
this.circle = (cx, cy, r) => { // Returns a circle shape.
return { cx, cy, r }
}
this.ellipse = (cx, cy, rx, ry) => { // Returns a ellipse shape.
return { cx, cy, rx, ry }
}
this.arc = (cx, cy, r, sa, ea) => { // Returns an arc shape.
return { cx, cy, r, sa, ea }
}
this.poly = (...pos) => { // Returns a poly shape.
return pos
}
this.text = (x, y, p, t, a = 'left', f = 'Arial') => { // Returns a text shape.
return { x, y, p, t, a, f }
}
this.svg = (x, y, d) => { // Returns a svg shape.
return { x, y, d }
}
this.color = (r, g, b, a = 1) => { // Returns a color object.
const hex = '#' + ('0' + parseInt(r, 10).toString(16)).slice(-2) + ('0' + parseInt(g, 10).toString(16)).slice(-2) + ('0' + parseInt(b, 10).toString(16)).slice(-2)
const rgba = `rgba(${r},${g},${b},${a})`
return { r, g, b, a, hex, rgba, toString: () => { return rgba }, 0: r, 1: g, 2: b, 3: a, f: [r / 255, g / 255, b / 255, a] }
}
this.hsl = (h, s, l, a = 1) => { // returns a HSL color object
return { h, s, l, a, toString: () => { return `hsla(${h},${s}%,${l}%,${a})` }, 0: h, 1: s, 2: l, 3: a, f: [h / 360, s / 100, l / 100, a] }
}
// Frame
this.resize = (w = client.surface.bounds().w, h = client.surface.bounds().h, fit = true) => { // Resizes the canvas to target w and h, returns the rect.
if (w === this['get-frame']().w && h === this['get-frame']().h) { return }
const rect = { x: 0, y: 0, w, h }
const a = new Image()
const b = new Image()
a.src = client.surface.toDataURL()
client.surface.resizeImage(a, b)
client.surface.resize(rect, fit)
return client.surface.draw(b, rect)
}
this.rescale = (w = 1, h) => { // Rescales the canvas to target ratio of w and h, returns the rect.
const rect = { x: 0, y: 0, w: this['get-frame']().w * w, h: this['get-frame']().h * (h || w) }
const a = new Image()
const b = new Image()
a.src = client.surface.toDataURL()
client.surface.resizeImage(a, b)
client.surface.resize(rect, true)
return client.surface.draw(b, rect)
}
this.crop = (rect = this['get-frame']()) => { // Crop canvas to rect.
return client.surface.crop(rect)
}
this.copy = (rect = this['get-frame']()) => { // Copy a section of the canvas.
return client.surface.copy(rect)
}
this.paste = (copy, rect = this['get-frame']()) => { // Paste a section of the canvas.
return client.surface.paste(copy, rect)
}
this.drag = (rect = this['get-frame'](), line = this.line()) => { // Drag a part of the canvas.
const pos = { x: line.b.x - line.a.x, y: line.b.y - line.a.y }
const crop = client.surface.copy(rect)
client.surface.clear(rect)
this.guide({ a: { x: rect.x, y: rect.y }, b: { x: pos.x + rect.x, y: pos.y + rect.y } })
this.guide(rect)
this.guide(this.offset(rect, { x: pos.x, y: pos.y }))
client.surface.context.drawImage(crop, rect.x, rect.y)
}
this.view = (a, b) => { // View a part of the canvas.
if (!a || !b) { return }
this.guide({ a: { x: a.x, y: a.y }, b: { x: b.x, y: b.y } })
this.guide(a)
this.guide(b)
client.surface.context.drawImage(this.copy(a), b.x, b.y, b.w, b.h)
}
this.pick = (shape = this['get-frame']()) => { // Returns the color of a pixel at pos, or of the average of the pixels in rect.
const rect = shape.w && shape.h ? shape : this.rect(shape.x, shape.y, 1, 1)
const img = client.surface.context.getImageData(rect.x, rect.y, rect.w, rect.h)
const sum = [0, 0, 0]
const count = img.data.length / 4
for (let i = 0, loop = img.data.length; i < loop; i += 4) {
sum[0] += img.data[i]
sum[1] += img.data[i + 1]
sum[2] += img.data[i + 2]
}
return this.color(this.floor(sum[0] / count), this.floor(sum[1] / count), this.floor(sum[2] / count))
}
this.orient = (deg = 0) => { // Orient canvas with angle in degrees.
const copy = this.copy()
const frame = this['get-frame']()
const mode = Math.floor(deg / 90) % 4
const offset = { x: [0, 0, -frame.w, -frame.w], y: [0, -frame.h, -frame.h, 0] }
const rect = { x: 0, y: 0, w: (mode === 1 || mode === 3 ? frame.h : frame.w), h: (mode === 1 || mode === 3 ? frame.w : frame.h) }
client.surface.resize(rect, false)
client.surface.context.save()
client.surface.context.rotate(this.rad(mode * 90))
client.surface.context.translate(offset.x[mode], offset.y[mode])
client.surface.context.drawImage(copy, 0, 0)
client.surface.context.restore()
}
this.mirror = { // Mirror canvas, methods: `x`, `y`.
x: (j = 0) => {
const copy = this.copy()
const frame = this['get-frame']()
client.surface.context.save()
client.surface.context.translate(frame.w, 0)
client.surface.context.scale(-1, 1)
client.surface.context.drawImage(copy, 0, 0)
client.surface.context.restore()
},
y: (j = 0) => {
const copy = this.copy()
const frame = this['get-frame']()
client.surface.context.save()
client.surface.context.translate(0, frame.h)
client.surface.context.scale(1, -1)
client.surface.context.drawImage(copy, 0, 0)
client.surface.context.restore()
}
}
// Transforms
this.transform = { // The transform toolkit, methods `push`, `pop`, `reset`, `move`, `scale`, `rotate`.
push: () => {
client.surface.context.save()
},
pop: () => {
client.surface.context.restore()
},
reset: () => {
client.surface.context.resetTransform()
client.surface.guide.resetTransform()
},
move: (x, y) => {
client.surface.context.translate(x, y)
this.guide(this.line(0, 0, x, y))
client.surface.guide.translate(x, y)
},
scale: (w, h) => {
client.surface.context.scale(w, h === undefined ? w : h)
this.guide(this.rect(0, 0, 50 * w, 50 * h))
client.surface.guide.scale(w, h === undefined ? w : h)
},
rotate: (a) => {
client.surface.context.rotate(a)
this.guide(this.arc(0, 0, 50, 0, a))
client.surface.guide.rotate(a)
}
}
// Actions
this.stroke = (shape, color, thickness = 2) => { // Strokes a shape.
client.surface.stroke(shape, color, thickness)
return shape
}
this.fill = (rect = this['get-frame'](), color) => { // Fills a shape.
client.surface.fill(rect, color)
return rect
}
this.clear = (rect = this['get-frame']()) => { // Clears a rect.
client.surface.clearGuide(rect)
client.surface.clear(rect)
return rect
}
this.gradient = (line, colors = ['white', 'black']) => { // Defines a gradient color.
const gradient = client.surface.context.createLinearGradient(line.a.x, line.a.y, line.b.x, line.b.y)
colors.forEach((color, i) => {
gradient.addColorStop(i * (1 / (colors.length - 1)), color)
})
return gradient
}
this.guide = (shape, color) => { // Draws a shape on the guide layer.
client.surface.drawGuide(shape, color)
return shape
}
// Pixels
this.pixels = (fn, q = 1, rect = this['get-frame']()) => {
if (!fn) { console.warn('Unknown function'); return rect }
const img = client.surface.context.getImageData(rect.x, rect.y, rect.w, rect.h)
for (let i = 0, loop = img.data.length; i < loop; i += 4) {
const pixel = [img.data[i], img.data[i + 1], img.data[i + 2], img.data[i + 3]]
const processed = fn(pixel, q)
img.data[i] = this.clamp(parseInt(processed[0]), 0, 255)
img.data[i + 1] = this.clamp(parseInt(processed[1]), 0, 255)
img.data[i + 2] = this.clamp(parseInt(processed[2]), 0, 255)
img.data[i + 3] = this.clamp(parseInt(processed[3]), 0, 255)
}
client.surface.context.putImageData(img, rect.x, rect.y)
return rect
}
this.saturation = (pixel, q) => { // Change the saturation of pixels.
const color = this.lum(pixel)
return [(color * (1 - q)) + (pixel[0] * q), (color * (1 - q)) + (pixel[1] * q), (color * (1 - q)) + (pixel[2] * q), pixel[3]]
}
this.contrast = (pixel, q) => { // Change the contrast of pixels.
const intercept = 128 * (1 - q)
return [pixel[0] * q + intercept, pixel[1] * q + intercept, pixel[2] * q + intercept, pixel[3]]
}
this.brightness = (pixel, q) => { // Change the brightness of pixels.
const range = 255 - -q
return [((pixel[0] / 255) * range), ((pixel[1] / 255) * range), ((pixel[2] / 255) * range), pixel[3]]
}
this.additive = (pixel, q) => { // Condense the data of pixels.
return [pixel[0] + q, pixel[1] + q, pixel[2] + q, pixel[3]]
}
this.multiply = (pixel, q) => { // Change the color balance of pixels.
return [pixel[0] * q[0], pixel[1] * q[1], pixel[2] * q[2], pixel[3]]
}
this.normalize = (pixel, q) => { // Normalize the color of pixels with another color.
const averaged = [128 - q.r + pixel[0], 128 - q.g + pixel[1], 128 - q.b + pixel[2], pixel[3]]
const offset = this.lum(pixel) - this.lum(averaged)
return this.additive(averaged, offset)
}
// Color
this.lum = (color) => { // Return the luminance of a color.
return 0.2126 * color[0] + 0.7152 * color[1] + 0.0722 * color[2]
}
// Strings
this.concat = (...items) => { // Concat multiple strings.
return items.reduce((acc, item) => { return `${acc}${item}` }, '')
}
this.split = (string, char) => { // Split string at character.
return string.split(char)
}
// Math
this.add = this['+'] = (...args) => { // Adds values.
return args.reduce((sum, val) => sum + val)
}
this.sub = this['-'] = (...args) => { // Subtracts values.
return args.reduce((sum, val) => sum - val)
}
this.mul = this['*'] = (...args) => { // Multiplies values.
return args.reduce((sum, val) => sum * val)
}
this.div = this['/'] = (...args) => { // Divides values.
return args.reduce((sum, val) => sum / val)
}
this.mod = this['%'] = (a, b) => { // Returns the modulo of a and b.
return a % b
}
this.rad = (degrees) => { // Convert radians to degrees.
return degrees * (Math.PI / 180)
}
this.deg = (radians) => { // Convert degrees to radians.
return radians * (180 / Math.PI)
}
this.clamp = (val, min, max) => { // Clamps a value between min and max.
return this.min(max, this.max(min, val))
}
this.step = (val, step) => {
return this.round(val / step) * step
}
this.min = Math.min // Returns lowest value.
this.max = Math.max // Returns highest value.
this.ceil = Math.ceil // Rounds up to the nearest integer.
this.floor = Math.floor // Rounds down to the nearest integer.
this.round = Math.round // Rounds to the nearest integer
this.sin = Math.sin
this.cos = Math.cos
this.log = Math.log
this.pow = Math.pow
this.sqrt = Math.sqrt // Calculate the square root.
this.sq = (a) => { // Calculate the square.
return a * a
}
this.PI = Math.PI
this.TWO_PI = Math.PI * 2
this.random = (...args) => {
if (args.length >= 2) {
// (random start end)
return args[0] + Math.random() * (args[1] - args[0])
} else if (args.length === 1) {
// (random max)
return Math.random() * args[0]
}
return Math.random()
}
// Binary
this.logand = (a, b) => {
return a & b
}
this.logior = (a, b) => {
return a | b
}
this.logxor = (a, b) => {
return a ^ b
}
this.lognot = (a) => {
return ~ a
}
this.ash = (a, b) => {
return a << b
}
// Logic
this.gt = (a, b) => { // Returns true if a is greater than b, else false.
return a > b
}
this.lt = (a, b) => { // Returns true if a is less than b, else false.
return a < b
}
this.eq = (a, b) => { // Returns true if a is equal to b, else false.
return a === b
}
this.and = (...args) => { // Returns true if all conditions are true.
for (let i = 0; i < args.length; i++) {
if (!args[i]) {
return args[i]
}
}
return args[args.length - 1]
}
this.or = (a, b, ...rest) => { // Returns true if at least one condition is true.
const args = [a, b].concat(rest)
for (let i = 0; i < args.length; i++) {
if (args[i]) {
return args[i]
}
}
return args[args.length - 1]
}
this.not = (a) => { //Negation. Returns true if a is false. Returns false if a is true.
return !a
}
this.while = (fn, action) => { //While loop. Execute action for as long as fn is true.
while (fn()) {
action()
}
}
// Arrays
this.apply = (fn, argslist) => {
let result = fn(...argslist);
return result;
}
this.each = (arr, fn) => { // Run a function for each element in a list.
for (let i = 0; i < arr.length; i++) {
const arg = arr[i]
fn(arg, i)
}
}
this.eachof = (arr, fn) => {
for(let elem of arr){
fn(elem);
}
}
this.map = (arr, fn) => { // Returns a new list with fn applied to each value.
return arr.map(fn);
}
this.filter = (arr, fn) => { // Returns a new list, without values evaluated to false by fn.
return arr.filter(fn);
}
this.reduce = (arr, fn, acc) => {
const length = arr.length
let result = acc === undefined ? arr[0] : acc
for (let i = acc === undefined ? 1 : 0; i < length; i++) {
result = fn(result, arr[i], i, arr)
}
return result
}
this.len = (item) => { // Returns the length of a list.
return item.length
}
this.list = (...items) => { // Returns a new array with the items
return items
}
this.cons = (arr, ...items) => { // Returns a new array with the items appended to arr.
return arr.concat(items)
}
this.push = (arr, ...items) => { // Appends the items into the existing list.
for (let i = 0; i < items.length; i++) {
arr.push(items[i])
}
return arr
}
this.pop = (arr) => { // Pop the last item from the list and return the item.
return arr.pop();
}
this.first = (arr) => { // Returns the first item of a list.
return arr[0]
}
this.last = (arr) => { // Returns the last
return arr[arr.length - 1]
}
this.rest = ([_, ...arr]) => { // Returns all arguments except the first
return arr
}
this.range = (start, end, step = 1) => { //Returns a list of numbers counting from start to end. Step defaults to 1.
const arr = []
if (step > 0) {
for (let i = start; i <= end; i += step) {
arr.push(i)
}
} else {
for (let i = start; i >= end; i += step) {
arr.push(i)
}
}
return arr
}
// Objects
this.get = (item, key) => { // Gets an object's parameter with name.
return item && (key !== null && key !== undefined) ? item[key] : null
}
this.set = (item, ...args) => { // Sets an object's parameter with name as value.
for (let i = 0; i < args.length; i += 2) {
const key = args[i]
const val = args[i + 1]
item[key] = val
}
return item
}
this.of = (h, ...keys) => { // Gets object parameters with names.
return keys.reduce((acc, key) => {
return acc[key]
}, h)
}
this.object = (...entries) => { // Creates an object with provided entries.
const result = {}
for (let i = 0; i < entries.length; i += 2) {
result[entries[i]] = entries[i + 1]
}
return result
}
this.keys = (item) => { // Returns a list of the object's keys
return Object.keys(item)
}
this.values = (item) => { // Returns a list of the object's values
return Object.values(item)
}
this.entries = (item) => { // Returns a list of the object's properties, each in array of [key, value]
return Object.entries(item);
}
// Convolve
this.convolve = (kernel, rect = this['get-frame']()) => {
const sigma = kernel.flat().reduce((a, x) => (a + x))
const kw = kernel[0].length; const kh = kernel.length
const img = client.surface.context.getImageData(rect.x, rect.y, rect.w, rect.h)
const out = new Uint8ClampedArray(rect.w * 4 * rect.h)
for (let i = 0, outer = img.data.length; i < outer; i++) { // bytes
const ix = Math.floor(i / 4) % rect.w; const iy = Math.floor((i / 4) / rect.w)
let acc = 0.0
for (let k = 0, inner = kw * kh; k < inner; k++) { // kernel
const kx = (k % kw); const ky = (Math.floor(k / kw))
const x = Math.ceil(ix + kx - kw / 2); const y = Math.ceil(iy + ky - kh / 2)
if (x < 0 || x >= rect.w || y < 0 || y >= rect.h) continue // edge case
acc += img.data[x * 4 + y * rect.w * 4 + i % 4] * kernel[kx][ky] / sigma
}
out[i] = acc
if (i % 4 === 3) out[i] = 255
}
img.data.set(out, 0)
client.surface.context.putImageData(img, rect.x, rect.y)
return rect
}
this.blur = () => { // Returns the blur kernel.
return [[1, 2, 1],
[2, 4, 2],
[1, 2, 2]]
}
this.sharpen = () => { // Returns the sharpen kernel.
return [[0, -1, 0],
[-1, 5, -1],
[0, -1, 0]]
}
this.edge = () => { // Returns the edge kernel.
return [[-1, -1, -1],
[-1, 9, -1],
[-1, -1, -1]]
}
// Points
this.offset = (a, b) => { // Offsets pos a with pos b, returns a.
a.x += b.x
a.y += b.y
return a
}
this.distance = (a, b) => { // Get distance between positions.
return Math.sqrt(((a.x - b.x) * (a.x - b.x)) + ((a.y - b.y) * (a.y - b.y)))
}
// Utilities
this.print = (value) => {
client.source.write('ronin-print', 'txt', value, 'text/plain')
return value
}
this.echo = (...args) => { // Print arguments to interface.
client.log(args)
return args
}
this.debug = (...args) => { // Print arguments to console.
console.log(...args)
return args
}
this.time = (rate = 1) => { // Returns timestamp in milliseconds.
return (Date.now() * rate)
}
this.js = () => { // Javascript interop.
return window
}
// Returns a new function that
// Useful when executing JS functions that need a strict `this` context.
//
// An example:
// `(get (get (js) "navigator") "requestMIDIAccess")` in Ronin
// should be equivalent to `window.navigator.requestMIDIAccess` in JS.
// Executing such retrieved JS method will crash though - as the method
// needs an internal `this` context - in exemplary case, window.navigator.
//
this['js-bind'] = (fn, thisArg, ...args) => {
return fn.bind(thisArg, ...args)
}
this.on = (event, f) => { // Triggers on event.
client.bind(event, f)
}
this.test = (name, a, b) => { //nit test. Checks if a is equal to b, logs results to console.
if (`${a}` !== `${b}`) {
console.warn('failed ' + name, a, b)
} else {
console.log('passed ' + name, a)
}
return a === b
}
this.benchmark = (fn) => { // Logs time taken to execute a function.
const start = Date.now()
const result = fn()
console.log(`time taken: ${Date.now() - start}ms`)
return result
}
// Accessors
this['get-theme'] = () => { // Get theme values.
return client.theme.active
}
this['get-frame'] = () => { // Get frame shape.
return client.surface.getFrame()
}
// Extras
// https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/globalCompositeOperation
this['blend-mode'] = (operation = 'source-over') => {
client.surface.context.globalCompositeOperation = operation
}
async function resolveImage(name) {
const img = new Image()
img.src = await client.cache.resolve(name)
return img
}
}
global.Library = Library