matrix

An array of arrays of floats that represent a matrix. Can be any size but transformation matrices are 4x4.

ident

ident(
size: int,
) 

Create a (square) identity matrix with dimensions

size:

int

Size of the matrix

diag

diag(
..diag: float,
) 

Create a square matrix with the diagonal set to the given values

..diag:

float

Diagonal values

dim

dim(
m: matrix,
) 

Returns the dimension of the given matrix as (m, n)

m:

matrix

The matrix

column

column(
mat: matrix,n: int,
) 

Returns the n-th column of a matrix as a vector

mat:

matrix

Input matrix

n:

int

The column’s index

round

round(
mat: matrix,precision: int,
) 

Rounds each value in the matrix to a precision.

mat:

matrix

Input matrix

precision:

int

Default: 8

Rounding precision (digits)

transform-translate

transform-translate(
x: float,y: float,z: float,
) 

Returns a

translation matrix

x:

float

The translation in the

direction.

y:

float

The translation in the

direction.

z:

float

The translation in the

direction.

transform-shear-x

transform-shear-x(
factor: float,
) 

Returns a

x-shear matrix

factor:

float

The shear in the

direction.

transform-shear-z

transform-shear-z(
factor: float,
) 

Returns a

z-shear matrix

factor:

float

The shear in the

direction.

transform-scale

transform-scale(
f: floatarraydictionary,
) 

Returns a

scale matrix

f:

float or array or dictionary

The scale factor(s) of the matrix. An array of at least 3 floats sets the x, y and z scale factors. A dictionary sets the scale in the direction of the corresponding x, y and z keys. A single float sets the scale for all directions.

transform-rotate-dir

transform-rotate-dir(
dir: vector,up: vector,
) 

Returns a

rotation xyz matrix for a direction and up vector

dir:

vector

idk

up:

vector

idk

transform-rotate-x

transform-rotate-x(
angle: angle,
) 

Returns a

rotation matrix

angle:

angle

The angle to rotate around the

axis

transform-rotate-y

transform-rotate-y(
angle: angle,
) 

Returns a

rotation matrix

angle:

angle

The angle to rotate around the

axis

transform-rotate-z

transform-rotate-z(
angle: angle,
) 

Returns a

rotation matrix

angle:

angle

The angle to rotate around the

axis

transform-rotate-aer

transform-rotate-aer(
azimuth: angle,elevation: angle,roll: angle,
) 

Returns a

rotation matrix from azimuth/elevation/roll. Assumes the viewing convention where

points up and

points toward the viewer.

azimuth:

angle

Rotation around z.

elevation:

angle

Tilt above the xy plane.

roll:

angle

Rotation around the current viewing axis.

transform-rotate-xz

transform-rotate-xz(
x: angle,z: angle,
) 

Returns a

rotation matrix

x:

angle

The angle to rotate around the

axis

z:

angle

The angle to rotate around the

axis

transform-rotate-ypr

transform-rotate-ypr(
a: angle,b: angle,c: angle,
) 

Returns a

rotation matrix - yaw-pitch-roll

a:

angle

Yaw

b:

angle

Pitch

c:

angle

Roll

transform-rotate-xyz

transform-rotate-xyz(
x: angle,y: angle,z: angle,
) 

Returns a

rotation matrix - euler angles

Calculates the product of the three rotation matrices

x:

angle

Rotation about x

y:

angle

Rotation about y

z:

angle

Rotation about z

mul-mat

mul-mat(
..matrices: matrix,
) 

Multiplies matrices on top of each other.

..matrices:

matrix

The matrices to multiply from left to right.

mul4x4-vec3

mul4x4-vec3(
mat: matrix,vec: vector,w: float,
) 

Multiplies a

matrix with a vector of size 3 or 4. The resulting is three dimensional

mat:

matrix

The matrix to multiply

vec:

vector

The vector to multiply

w:

float

The default value for the fourth element of the vector if it is three dimensional.

mul-vec

mul-vec(
mat: matrix,vec: vector,
) 

Multiplies an

matrix with an

th dimensional vector where

. Prefer the use of mul4x4-vec3 when possible as it does not use loops.

mat:

matrix

The matrix to multiply

vec:

vector

The vector to multiply

inverse

inverse(
matrix: matrix,
) 

Calculates the inverse matrix of any size.

matrix:

matrix

The matrix to inverse.