Skip to content

A collection of utility functions that relates to linear algebra and graphics programming.

License

Notifications You must be signed in to change notification settings

baku89/linearly

Repository files navigation

A collection of utility functions that relates to linear algebra and graphics programming.

🍡 I'd appreciate receiving PRs from anyone willing to help with tedious tasks like writing JSDoc, adding necessary functions, or writing tests.

This library is based on glMatrix, but adopts an immutable data structure. So you don't need to specify a receiver matrix as the first argument.

glMatrix

// In glMatrix, you have to manually pass an output vector by reference to reuse allocated memory space efficiently.
const dir = vec3.fromValues(2, 1, 3)
vec3.normalize(dir, dir)

const out = vec3.create()
vec3.cross(out, dir, [0, 1, 0])
vec2.scale(out, out, 3)

Linearly

// In linearly, you can simply write like this:
import {mat2d, vec3} from 'linearly'

const dir = vec3.normalize([2, 1, 3])
let out = vec3.cross(dir, [0, 1, 0])
out = vec3.scale(out, 3)

// As the values of Linearly are plain 1D arrays, you can initialize a vector by either way.
const a: vec2 = [1, 2]
const b = vec2.of(1, 2)

// But since vector and matrix are immutable and annotated with read-only flags, a mutation such as below is handled as an error in TypeScript.
a[0] = 3
// ^
// Cannot assign to '0' because it is a read-only property.

// Some constants such as mat2.identity are also read-only and defined as frozen array (applied Object.freeze). You can use `clone` to mutate them.
const m = mat2d.clone(mat2d.ident)
m[4] *= 2.0
m[5] = -4.5

In addition to functions that can be found on glMatrix docs, the library also provides some useful functions. For example:

Development

git clone https://github.com/baku89/lnearly
cd linearly
yarn install
yarn test --watch

License

This repository is published under an MIT License. See the included LICENSE file.

About

A collection of utility functions that relates to linear algebra and graphics programming.

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published