mach2 v0.1.0

mach2

A speedy, lightweight, and typesafe canvas rendering and lifecycle management library.

Graphs of $f(x) = \sin(x) + \cos\Bigl(\frac{x}{2}\Bigr) + \cos\Bigl(\frac{x}{3}\Bigr) + \cos(2x)$. x-y rendering of a Lorentz attractor, and a rendering of the Mandelbrot set.

Features

• Mathematical Rendering: Provides a multitude of mathematical functions for rendering, and allows you to graph them with ease.
• Lifecycle Management: Manages your canvas' rendering lifecycle for you, so you can focus on what you want to draw.
• Lightweight: Weighing in at just ~20KB, mach2 is a lightweight library that won't slow down your websites or visualisations.
• Typesafe: Written in TypeScript, mach2 provides type safety for your canvas rendering.
• Easy Animation: Provides simple primitives for animations, so you can animate your renderings.

Installation

pnpm add mach2
npm i mach2
bun i mach2

Optionally, you can add KaTeX to render LaTeX expressions.

pnpm add katex
npm i katex
bun i katex

Usage

import mach2 from 'mach2';

const canvas = document.getElementById('canvas') as HTMLCanvasElement;

// create a scene
const scene = mach2.scene(canvas);

scene.add([
	// add a new static object
	new (class extends mach2.Static {
		mount() {
			// render cartesian axis
			mach2.graph.axis(this.ctx);

			// graph a parabola
			mach2.graph.fn(this.ctx, (x) => x ** 2, 'red', 2);
		}
	})()
]);