elm-community/elm-linear-algebra/2.0.2

NOTE: this package moved to elm-community/linear-algebra

NOTE: this package is not compatible with Elm 0.19.1

Math.Matrix4

A high performance linear algebra library using native JS arrays. Geared towards 3D graphics and use with Graphics.WebGL. All matrices are immutable.

This library uses the convention that the prefix make is creating a new array,as without the prefix, you are applying some transform to an existing matrix.

Create

type Mat4
= Mat4

4x4 matrix type

identity : Mat4

A matrix with all 0s, except 1s on the diagonal.

Operations

inverseOrthonormal : Mat4 -> Mat4

Computes the inverse of the given matrix m, assuming that the matrix is orthonormal.

mul : Mat4 -> Mat4 -> Mat4

Matrix multiplcation: a * b

mulAffine : Mat4 -> Mat4 -> Mat4

Matrix multiplication, assuming a and b are affine: a * b

transpose : Mat4 -> Mat4

"Flip" the matrix across the diagonal by swapping row index and column index.

makeBasis : Vec3 -> Vec3 -> Vec3 -> Mat4

Creates a transform from a basis consisting of 3 linearly independent vectors.

transform : Mat4 -> Vec3 -> Vec3

Multiply a vector by a 4x4 matrix: m * v

Projections

makeFrustum : Float -> Float -> Float -> Float -> Float -> Float -> Mat4

Creates a matrix for a projection frustum with the given parameters.

Parameters:

* left - the left coordinate of the frustum * right- the right coordinate of the frustum * bottom - the bottom coordinate of the frustum * top - the top coordinate of the frustum * znear - the near z distance of the frustum * zfar - the far z distance of the frustum

makePerspective : Float -> Float -> Float -> Float -> Mat4

Creates a matrix for a perspective projection with the given parameters.

Parameters:

* fovy - field of view in the y axis, in degrees * aspect - aspect ratio * znear - the near z distance of the projection * zfar - the far z distance of the projection

makeOrtho : Float -> Float -> Float -> Float -> Float -> Float -> Mat4

Creates a matrix for an orthogonal frustum projection with the given parameters.

Parameters:

* left - the left coordinate of the frustum * right- the right coordinate of the frustum * bottom - the bottom coordinate of the frustum * top - the top coordinate of the frustum * znear - the near z distance of the frustum * zfar - the far z distance of the frustum

makeOrtho2D : Float -> Float -> Float -> Float -> Mat4

Creates a matrix for a 2D orthogonal frustum projection with the given parameters. znear and zfar are assumed to be -1 and 1, respectively.

Parameters:

* left - the left coordinate of the frustum * right- the right coordinate of the frustum * bottom - the bottom coordinate of the frustum * top - the top coordinate of the frustum

makeLookAt : Vec3 -> Vec3 -> Vec3 -> Mat4

Creates a transformation matrix for a camera.

Parameters:

* eye - The location of the camera * center - The location of the focused object * up - The "up" direction according to the camera

Apply Transformations

rotate : Float -> Vec3 -> Mat4 -> Mat4

Concatenates a rotation in radians about an axis to the given matrix.

scale : Vec3 -> Mat4 -> Mat4

Concatenates a scaling to the given matrix.

scale3 : Float -> Float -> Float -> Mat4 -> Mat4

Concatenates a scaling to the given matrix.

translate : Vec3 -> Mat4 -> Mat4

Concatenates a translation to the given matrix.

translate3 : Float -> Float -> Float -> Mat4 -> Mat4

Concatenates a translation to the given matrix.

Create Transformations

makeRotate : Float -> Vec3 -> Mat4

Creates a transformation matrix for rotation in radians about the 3-element vector axis.

makeScale : Vec3 -> Mat4

Creates a transformation matrix for scaling each of the x, y, and z axes by the amount given in the corresponding element of the 3-element vector.

makeScale3 : Float -> Float -> Float -> Mat4

Creates a transformation matrix for scaling by 3 scalar values, one for each of the x, y, and z directions.

makeTranslate : Vec3 -> Mat4

Creates a transformation matrix for translating each of the x, y, and z axes by the amount given in the corresponding element of the 3-element vector.

makeTranslate3 : Float -> Float -> Float -> Mat4

Creates a transformation matrix for translating by 3 scalar values, one for each of the x, y, and z directions.