Tiny 2D vector math library for JavaScript.
tinyvec2.js is a couple-of-lines long vector library designed with readability in mind. I found myself writing something similar many times, either when explaining vector math to my peers, or as part of quick experiments where I did not want to deal with managing dependencies.
While I enjoyed writing vector math functions every single time, sometimes the development momentum of what I really needed to build got lost. I wrote this piece of code so it is less likely happen again.
- Couple of common vector functions.
- No heavy abstractions. Vector is an array with 2 elements
[x, y]. - Purity. Meaning no mutation. This is why you maybe do not want to use this library in your game. Some operations create new arrays.
- Contemporary JavaScript. Use a transpiler of your choice if you need to support older browsers.
- ES6 module.
- No validation.
- No dependencies.
- You study or teach vector math.
- You need a quick reminder on how to perform common operations on 2D vectors.
- You need a 2D vector math library that you can just import as ES6 module.
- You are building a 2D vector math library and want to start somewhere.
import { add, mul, norm } from './tinyvec2.js'
const position = [0, 0]
const direction = [1, 1]
const speed = 20
const velocity = mul(norm(direction), speed)
const updatedPosition = add(position, velocity)