Package org.joml

Interface Matrix4fc

• All Known Implementing Classes:
`Matrix4f`, `Matrix4fStack`

`public interface Matrix4fc`
Interface to a read-only view of a 4x4 matrix of single-precision floats.
Author:
Kai Burjack
• Method Summary

All Methods
Modifier and Type Method Description
`Matrix4f` ```add​(Matrix4fc other, Matrix4f dest)```
Component-wise add `this` and `other` and store the result in `dest`.
`Matrix4f` ```add4x3​(Matrix4fc other, Matrix4f dest)```
Component-wise add the upper 4x3 submatrices of `this` and `other` and store the result in `dest`.
`Matrix4f` ```arcball​(float radius, float centerX, float centerY, float centerZ, float angleX, float angleY, Matrix4f dest)```
Apply an arcball view transformation to this matrix with the given `radius` and center `(centerX, centerY, centerZ)` position of the arcball and the specified X and Y rotation angles, and store the result in `dest`.
`Matrix4f` ```arcball​(float radius, Vector3fc center, float angleX, float angleY, Matrix4f dest)```
Apply an arcball view transformation to this matrix with the given `radius` and `center` position of the arcball and the specified X and Y rotation angles, and store the result in `dest`.
`float` `determinant()`
Return the determinant of this matrix.
`float` `determinant3x3()`
Return the determinant of the upper left 3x3 submatrix of this matrix.
`float` `determinantAffine()`
Return the determinant of this matrix by assuming that it represents an `affine` transformation and thus its last row is equal to `(0, 0, 0, 1)`.
`boolean` ```equals​(Matrix4fc m, float delta)```
Compare the matrix elements of `this` matrix with the given matrix using the given `delta` and return whether all of them are equal within a maximum difference of `delta`.
`Matrix4f` ```fma4x3​(Matrix4fc other, float otherFactor, Matrix4f dest)```
Component-wise add the upper 4x3 submatrices of `this` and `other` by first multiplying each component of `other`'s 4x3 submatrix by `otherFactor`, adding that to `this` and storing the final result in `dest`.
`Matrix4f` ```frustum​(float left, float right, float bottom, float top, float zNear, float zFar, boolean zZeroToOne, Matrix4f dest)```
Apply an arbitrary perspective projection frustum transformation for a right-handed coordinate system using the given NDC z range to this matrix and store the result in `dest`.
`Matrix4f` ```frustum​(float left, float right, float bottom, float top, float zNear, float zFar, Matrix4f dest)```
Apply an arbitrary perspective projection frustum transformation for a right-handed coordinate system using OpenGL's NDC z range of `[-1..+1]` to this matrix and store the result in `dest`.
`Matrix4f` ```frustumAabb​(Vector3f min, Vector3f max)```
Compute the axis-aligned bounding box of the frustum described by `this` matrix and store the minimum corner coordinates in the given `min` and the maximum corner coordinates in the given `max` vector.
`Vector3f` ```frustumCorner​(int corner, Vector3f point)```
Compute the corner coordinates of the frustum defined by `this` matrix, which can be a projection matrix or a combined modelview-projection matrix, and store the result in the given `point`.
`Matrix4f` ```frustumLH​(float left, float right, float bottom, float top, float zNear, float zFar, boolean zZeroToOne, Matrix4f dest)```
Apply an arbitrary perspective projection frustum transformation for a left-handed coordinate system using the given NDC z range to this matrix and store the result in `dest`.
`Matrix4f` ```frustumLH​(float left, float right, float bottom, float top, float zNear, float zFar, Matrix4f dest)```
Apply an arbitrary perspective projection frustum transformation for a left-handed coordinate system using OpenGL's NDC z range of `[-1..+1]` to this matrix and store the result in `dest`.
`Planef` ```frustumPlane​(int which, Planef plane)```
Calculate a frustum plane of `this` matrix, which can be a projection matrix or a combined modelview-projection matrix, and store the result in the given `plane`.
`Vector4f` ```frustumPlane​(int plane, Vector4f planeEquation)```
Calculate a frustum plane of `this` matrix, which can be a projection matrix or a combined modelview-projection matrix, and store the result in the given `planeEquation`.
`Vector3f` ```frustumRayDir​(float x, float y, Vector3f dir)```
Obtain the direction of a ray starting at the center of the coordinate system and going through the near frustum plane.
`float[]` `get​(float[] arr)`
Store this matrix into the supplied float array in column-major order.
`float[]` ```get​(float[] arr, int offset)```
Store this matrix into the supplied float array in column-major order at the given offset.
`java.nio.ByteBuffer` ```get​(int index, java.nio.ByteBuffer buffer)```
Store this matrix in column-major order into the supplied `ByteBuffer` starting at the specified absolute buffer position/index.
`java.nio.FloatBuffer` ```get​(int index, java.nio.FloatBuffer buffer)```
Store this matrix in column-major order into the supplied `FloatBuffer` starting at the specified absolute buffer position/index.
`java.nio.ByteBuffer` `get​(java.nio.ByteBuffer buffer)`
Store this matrix in column-major order into the supplied `ByteBuffer` at the current buffer `position`.
`java.nio.FloatBuffer` `get​(java.nio.FloatBuffer buffer)`
Store this matrix in column-major order into the supplied `FloatBuffer` at the current buffer `position`.
`Matrix4d` `get​(Matrix4d dest)`
Get the current values of `this` matrix and store them into `dest`.
`Matrix4f` `get​(Matrix4f dest)`
Get the current values of `this` matrix and store them into `dest`.
`Matrix3d` `get3x3​(Matrix3d dest)`
Get the current values of the upper left 3x3 submatrix of `this` matrix and store them into `dest`.
`Matrix3f` `get3x3​(Matrix3f dest)`
Get the current values of the upper left 3x3 submatrix of `this` matrix and store them into `dest`.
`java.nio.ByteBuffer` ```get4x3​(int index, java.nio.ByteBuffer buffer)```
Store the upper 4x3 submatrix in column-major order into the supplied `ByteBuffer` starting at the specified absolute buffer position/index.
`java.nio.FloatBuffer` ```get4x3​(int index, java.nio.FloatBuffer buffer)```
Store the upper 4x3 submatrix in column-major order into the supplied `FloatBuffer` starting at the specified absolute buffer position/index.
`java.nio.ByteBuffer` `get4x3​(java.nio.ByteBuffer buffer)`
Store the upper 4x3 submatrix in column-major order into the supplied `ByteBuffer` at the current buffer `position`.
`java.nio.FloatBuffer` `get4x3​(java.nio.FloatBuffer buffer)`
Store the upper 4x3 submatrix in column-major order into the supplied `FloatBuffer` at the current buffer `position`.
`Matrix4x3f` `get4x3​(Matrix4x3f dest)`
Get the current values of the upper 4x3 submatrix of `this` matrix and store them into `dest`.
`java.nio.ByteBuffer` ```get4x3Transposed​(int index, java.nio.ByteBuffer buffer)```
Store the upper 4x3 submatrix of `this` matrix in row-major order into the supplied `ByteBuffer` starting at the specified absolute buffer position/index.
`java.nio.FloatBuffer` ```get4x3Transposed​(int index, java.nio.FloatBuffer buffer)```
Store the upper 4x3 submatrix of `this` matrix in row-major order into the supplied `FloatBuffer` starting at the specified absolute buffer position/index.
`java.nio.ByteBuffer` `get4x3Transposed​(java.nio.ByteBuffer buffer)`
Store the upper 4x3 submatrix of `this` matrix in row-major order into the supplied `ByteBuffer` at the current buffer `position`.
`java.nio.FloatBuffer` `get4x3Transposed​(java.nio.FloatBuffer buffer)`
Store the upper 4x3 submatrix of `this` matrix in row-major order into the supplied `FloatBuffer` at the current buffer `position`.
`Vector3f` ```getColumn​(int column, Vector3f dest)```
Get the first three components of the column at the given `column` index, starting with `0`.
`Vector4f` ```getColumn​(int column, Vector4f dest)```
Get the column at the given `column` index, starting with `0`.
`Vector3f` `getEulerAnglesZYX​(Vector3f dest)`
Extract the Euler angles from the rotation represented by the upper left 3x3 submatrix of `this` and store the extracted Euler angles in `dest`.
`Quaterniond` `getNormalizedRotation​(Quaterniond dest)`
Get the current values of `this` matrix and store the represented rotation into the given `Quaterniond`.
`Quaternionf` `getNormalizedRotation​(Quaternionf dest)`
Get the current values of `this` matrix and store the represented rotation into the given `Quaternionf`.
`AxisAngle4d` `getRotation​(AxisAngle4d dest)`
Get the rotational component of `this` matrix and store the represented rotation into the given `AxisAngle4d`.
`AxisAngle4f` `getRotation​(AxisAngle4f dest)`
Get the rotational component of `this` matrix and store the represented rotation into the given `AxisAngle4f`.
`Vector3f` ```getRow​(int row, Vector3f dest)```
Get the first three components of the row at the given `row` index, starting with `0`.
`Vector4f` ```getRow​(int row, Vector4f dest)```
Get the row at the given `row` index, starting with `0`.
`Vector3f` `getScale​(Vector3f dest)`
Get the scaling factors of `this` matrix for the three base axes.
`Matrix4fc` `getToAddress​(long address)`
Store this matrix in column-major order at the given off-heap address.
`Vector3f` `getTranslation​(Vector3f dest)`
Get only the translation components `(m30, m31, m32)` of this matrix and store them in the given vector `xyz`.
`java.nio.ByteBuffer` ```getTransposed​(int index, java.nio.ByteBuffer buffer)```
Store the transpose of this matrix in column-major order into the supplied `ByteBuffer` starting at the specified absolute buffer position/index.
`java.nio.FloatBuffer` ```getTransposed​(int index, java.nio.FloatBuffer buffer)```
Store the transpose of this matrix in column-major order into the supplied `FloatBuffer` starting at the specified absolute buffer position/index.
`java.nio.ByteBuffer` `getTransposed​(java.nio.ByteBuffer buffer)`
Store the transpose of this matrix in column-major order into the supplied `ByteBuffer` at the current buffer `position`.
`java.nio.FloatBuffer` `getTransposed​(java.nio.FloatBuffer buffer)`
Store the transpose of this matrix in column-major order into the supplied `FloatBuffer` at the current buffer `position`.
`Quaterniond` `getUnnormalizedRotation​(Quaterniond dest)`
Get the current values of `this` matrix and store the represented rotation into the given `Quaterniond`.
`Quaternionf` `getUnnormalizedRotation​(Quaternionf dest)`
Get the current values of `this` matrix and store the represented rotation into the given `Quaternionf`.
`Matrix4f` `invert​(Matrix4f dest)`
Invert this matrix and write the result into `dest`.
`Matrix4f` `invertAffine​(Matrix4f dest)`
Invert this matrix by assuming that it is an `affine` transformation (i.e. its last row is equal to `(0, 0, 0, 1)`) and write the result into `dest`.
`Matrix4f` `invertFrustum​(Matrix4f dest)`
If `this` is an arbitrary perspective projection matrix obtained via one of the `frustum()` methods, then this method builds the inverse of `this` and stores it into the given `dest`.
`Matrix4f` `invertOrtho​(Matrix4f dest)`
Invert `this` orthographic projection matrix and store the result into the given `dest`.
`Matrix4f` `invertPerspective​(Matrix4f dest)`
If `this` is a perspective projection matrix obtained via one of the `perspective()` methods, that is, if `this` is a symmetrical perspective frustum transformation, then this method builds the inverse of `this` and stores it into the given `dest`.
`Matrix4f` ```invertPerspectiveView​(Matrix4fc view, Matrix4f dest)```
If `this` is a perspective projection matrix obtained via one of the `perspective()` methods, that is, if `this` is a symmetrical perspective frustum transformation and the given `view` matrix is `affine` and has unit scaling (for example by being obtained via `lookAt()`), then this method builds the inverse of `this * view` and stores it into the given `dest`.
`Matrix4f` ```invertPerspectiveView​(Matrix4x3fc view, Matrix4f dest)```
If `this` is a perspective projection matrix obtained via one of the `perspective()` methods, that is, if `this` is a symmetrical perspective frustum transformation and the given `view` matrix has unit scaling, then this method builds the inverse of `this * view` and stores it into the given `dest`.
`boolean` `isAffine()`
Determine whether this matrix describes an affine transformation.
`Matrix4f` ```lerp​(Matrix4fc other, float t, Matrix4f dest)```
Linearly interpolate `this` and `other` using the given interpolation factor `t` and store the result in `dest`.
`Matrix4f` ```lookAlong​(float dirX, float dirY, float dirZ, float upX, float upY, float upZ, Matrix4f dest)```
Apply a rotation transformation to this matrix to make `-z` point along `dir` and store the result in `dest`.
`Matrix4f` ```lookAlong​(Vector3fc dir, Vector3fc up, Matrix4f dest)```
Apply a rotation transformation to this matrix to make `-z` point along `dir` and store the result in `dest`.
`Matrix4f` ```lookAt​(float eyeX, float eyeY, float eyeZ, float centerX, float centerY, float centerZ, float upX, float upY, float upZ, Matrix4f dest)```
Apply a "lookat" transformation to this matrix for a right-handed coordinate system, that aligns `-z` with `center - eye` and store the result in `dest`.
`Matrix4f` ```lookAt​(Vector3fc eye, Vector3fc center, Vector3fc up, Matrix4f dest)```
Apply a "lookat" transformation to this matrix for a right-handed coordinate system, that aligns `-z` with `center - eye` and store the result in `dest`.
`Matrix4f` ```lookAtLH​(float eyeX, float eyeY, float eyeZ, float centerX, float centerY, float centerZ, float upX, float upY, float upZ, Matrix4f dest)```
Apply a "lookat" transformation to this matrix for a left-handed coordinate system, that aligns `+z` with `center - eye` and store the result in `dest`.
`Matrix4f` ```lookAtLH​(Vector3fc eye, Vector3fc center, Vector3fc up, Matrix4f dest)```
Apply a "lookat" transformation to this matrix for a left-handed coordinate system, that aligns `+z` with `center - eye` and store the result in `dest`.
`Matrix4f` ```lookAtPerspective​(float eyeX, float eyeY, float eyeZ, float centerX, float centerY, float centerZ, float upX, float upY, float upZ, Matrix4f dest)```
Apply a "lookat" transformation to this matrix for a right-handed coordinate system, that aligns `-z` with `center - eye` and store the result in `dest`.
`Matrix4f` ```lookAtPerspectiveLH​(float eyeX, float eyeY, float eyeZ, float centerX, float centerY, float centerZ, float upX, float upY, float upZ, Matrix4f dest)```
Apply a "lookat" transformation to this matrix for a left-handed coordinate system, that aligns `+z` with `center - eye` and store the result in `dest`.
`float` `m00()`
Return the value of the matrix element at column 0 and row 0.
`float` `m01()`
Return the value of the matrix element at column 0 and row 1.
`float` `m02()`
Return the value of the matrix element at column 0 and row 2.
`float` `m03()`
Return the value of the matrix element at column 0 and row 3.
`float` `m10()`
Return the value of the matrix element at column 1 and row 0.
`float` `m11()`
Return the value of the matrix element at column 1 and row 1.
`float` `m12()`
Return the value of the matrix element at column 1 and row 2.
`float` `m13()`
Return the value of the matrix element at column 1 and row 3.
`float` `m20()`
Return the value of the matrix element at column 2 and row 0.
`float` `m21()`
Return the value of the matrix element at column 2 and row 1.
`float` `m22()`
Return the value of the matrix element at column 2 and row 2.
`float` `m23()`
Return the value of the matrix element at column 2 and row 3.
`float` `m30()`
Return the value of the matrix element at column 3 and row 0.
`float` `m31()`
Return the value of the matrix element at column 3 and row 1.
`float` `m32()`
Return the value of the matrix element at column 3 and row 2.
`float` `m33()`
Return the value of the matrix element at column 3 and row 3.
`Matrix4f` ```mul​(Matrix3x2fc right, Matrix4f dest)```
Multiply this matrix by the supplied `right` matrix and store the result in `dest`.
`Matrix4f` ```mul​(Matrix4fc right, Matrix4f dest)```
Multiply this matrix by the supplied `right` matrix and store the result in `dest`.
`Matrix4f` ```mul​(Matrix4x3fc right, Matrix4f dest)```
Multiply this matrix by the supplied `right` matrix and store the result in `dest`.
`Matrix4f` ```mul4x3ComponentWise​(Matrix4fc other, Matrix4f dest)```
Component-wise multiply the upper 4x3 submatrices of `this` by `other` and store the result in `dest`.
`Matrix4f` ```mulAffine​(Matrix4fc right, Matrix4f dest)```
Multiply this matrix by the supplied `right` matrix, both of which are assumed to be `affine`, and store the result in `dest`.
`Matrix4f` ```mulAffineR​(Matrix4fc right, Matrix4f dest)```
Multiply this matrix by the supplied `right` matrix, which is assumed to be `affine`, and store the result in `dest`.
`Matrix4f` ```mulComponentWise​(Matrix4fc other, Matrix4f dest)```
Component-wise multiply `this` by `other` and store the result in `dest`.
`Matrix4f` ```mulLocal​(Matrix4fc left, Matrix4f dest)```
Pre-multiply this matrix by the supplied `left` matrix and store the result in `dest`.
`Matrix4f` ```mulLocalAffine​(Matrix4fc left, Matrix4f dest)```
Pre-multiply this matrix by the supplied `left` matrix, both of which are assumed to be `affine`, and store the result in `dest`.
`Matrix4f` ```mulOrthoAffine​(Matrix4fc view, Matrix4f dest)```
Multiply `this` orthographic projection matrix by the supplied `affine` `view` matrix and store the result in `dest`.
`Matrix4f` ```mulPerspectiveAffine​(Matrix4fc view, Matrix4f dest)```
Multiply `this` symmetric perspective projection matrix by the supplied `affine` `view` matrix and store the result in `dest`.
`Matrix4f` ```mulPerspectiveAffine​(Matrix4x3fc view, Matrix4f dest)```
Multiply `this` symmetric perspective projection matrix by the supplied `view` matrix and store the result in `dest`.
`Matrix4f` ```mulTranslationAffine​(Matrix4fc right, Matrix4f dest)```
Multiply this matrix, which is assumed to only contain a translation, by the supplied `right` matrix, which is assumed to be `affine`, and store the result in `dest`.
`Matrix3f` `normal​(Matrix3f dest)`
Compute a normal matrix from the upper left 3x3 submatrix of `this` and store it into `dest`.
`Matrix4f` `normal​(Matrix4f dest)`
Compute a normal matrix from the upper left 3x3 submatrix of `this` and store it into the upper left 3x3 submatrix of `dest`.
`Matrix3f` `normalize3x3​(Matrix3f dest)`
Normalize the upper left 3x3 submatrix of this matrix and store the result in `dest`.
`Matrix4f` `normalize3x3​(Matrix4f dest)`
Normalize the upper left 3x3 submatrix of this matrix and store the result in `dest`.
`Vector3f` `normalizedPositiveX​(Vector3f dir)`
Obtain the direction of `+X` before the transformation represented by `this` orthogonal matrix is applied.
`Vector3f` `normalizedPositiveY​(Vector3f dir)`
Obtain the direction of `+Y` before the transformation represented by `this` orthogonal matrix is applied.
`Vector3f` `normalizedPositiveZ​(Vector3f dir)`
Obtain the direction of `+Z` before the transformation represented by `this` orthogonal matrix is applied.
`Matrix4f` ```obliqueZ​(float a, float b, Matrix4f dest)```
Apply an oblique projection transformation to this matrix with the given values for `a` and `b` and store the result in `dest`.
`Vector3f` `origin​(Vector3f origin)`
Obtain the position that gets transformed to the origin by `this` matrix.
`Vector3f` `originAffine​(Vector3f origin)`
Obtain the position that gets transformed to the origin by `this` `affine` matrix.
`Matrix4f` ```ortho​(float left, float right, float bottom, float top, float zNear, float zFar, boolean zZeroToOne, Matrix4f dest)```
Apply an orthographic projection transformation for a right-handed coordinate system using the given NDC z range to this matrix and store the result in `dest`.
`Matrix4f` ```ortho​(float left, float right, float bottom, float top, float zNear, float zFar, Matrix4f dest)```
Apply an orthographic projection transformation for a right-handed coordinate system using OpenGL's NDC z range of `[-1..+1]` to this matrix and store the result in `dest`.
`Matrix4f` ```ortho2D​(float left, float right, float bottom, float top, Matrix4f dest)```
Apply an orthographic projection transformation for a right-handed coordinate system to this matrix and store the result in `dest`.
`Matrix4f` ```ortho2DLH​(float left, float right, float bottom, float top, Matrix4f dest)```
Apply an orthographic projection transformation for a left-handed coordinate system to this matrix and store the result in `dest`.
`Matrix4f` ```orthoCrop​(Matrix4fc view, Matrix4f dest)```
Build an ortographic projection transformation that fits the view-projection transformation represented by `this` into the given affine `view` transformation.
`Matrix4f` ```orthoLH​(float left, float right, float bottom, float top, float zNear, float zFar, boolean zZeroToOne, Matrix4f dest)```
Apply an orthographic projection transformation for a left-handed coordiante system using the given NDC z range to this matrix and store the result in `dest`.
`Matrix4f` ```orthoLH​(float left, float right, float bottom, float top, float zNear, float zFar, Matrix4f dest)```
Apply an orthographic projection transformation for a left-handed coordiante system using OpenGL's NDC z range of `[-1..+1]` to this matrix and store the result in `dest`.
`Matrix4f` ```orthoSymmetric​(float width, float height, float zNear, float zFar, boolean zZeroToOne, Matrix4f dest)```
Apply a symmetric orthographic projection transformation for a right-handed coordinate system using the given NDC z range to this matrix and store the result in `dest`.
`Matrix4f` ```orthoSymmetric​(float width, float height, float zNear, float zFar, Matrix4f dest)```
Apply a symmetric orthographic projection transformation for a right-handed coordinate system using OpenGL's NDC z range of `[-1..+1]` to this matrix and store the result in `dest`.
`Matrix4f` ```orthoSymmetricLH​(float width, float height, float zNear, float zFar, boolean zZeroToOne, Matrix4f dest)```
Apply a symmetric orthographic projection transformation for a left-handed coordinate system using the given NDC z range to this matrix and store the result in `dest`.
`Matrix4f` ```orthoSymmetricLH​(float width, float height, float zNear, float zFar, Matrix4f dest)```
Apply a symmetric orthographic projection transformation for a left-handed coordinate system using OpenGL's NDC z range of `[-1..+1]` to this matrix and store the result in `dest`.
`Matrix4f` ```perspective​(float fovy, float aspect, float zNear, float zFar, boolean zZeroToOne, Matrix4f dest)```
Apply a symmetric perspective projection frustum transformation for a right-handed coordinate system using the given NDC z range to this matrix and store the result in `dest`.
`Matrix4f` ```perspective​(float fovy, float aspect, float zNear, float zFar, Matrix4f dest)```
Apply a symmetric perspective projection frustum transformation for a right-handed coordinate system using OpenGL's NDC z range of `[-1..+1]` to this matrix and store the result in `dest`.
`float` `perspectiveFar()`
Extract the far clip plane distance from `this` perspective projection matrix.
`float` `perspectiveFov()`
Return the vertical field-of-view angle in radians of this perspective transformation matrix.
`Matrix4f` ```perspectiveFrustumSlice​(float near, float far, Matrix4f dest)```
Change the near and far clip plane distances of `this` perspective frustum transformation matrix and store the result in `dest`.
`Matrix4f` ```perspectiveLH​(float fovy, float aspect, float zNear, float zFar, boolean zZeroToOne, Matrix4f dest)```
Apply a symmetric perspective projection frustum transformation for a left-handed coordinate system using the given NDC z range to this matrix and store the result in `dest`.
`Matrix4f` ```perspectiveLH​(float fovy, float aspect, float zNear, float zFar, Matrix4f dest)```
Apply a symmetric perspective projection frustum transformation for a left-handed coordinate system using OpenGL's NDC z range of `[-1..+1]` to this matrix and store the result in `dest`.
`float` `perspectiveNear()`
Extract the near clip plane distance from `this` perspective projection matrix.
`Vector3f` `perspectiveOrigin​(Vector3f origin)`
Compute the eye/origin of the perspective frustum transformation defined by `this` matrix, which can be a projection matrix or a combined modelview-projection matrix, and store the result in the given `origin`.
`Matrix4f` ```pick​(float x, float y, float width, float height, int[] viewport, Matrix4f dest)```
Apply a picking transformation to this matrix using the given window coordinates `(x, y)` as the pick center and the given `(width, height)` as the size of the picking region in window coordinates, and store the result in `dest`.
`Vector3f` `positiveX​(Vector3f dir)`
Obtain the direction of `+X` before the transformation represented by `this` matrix is applied.
`Vector3f` `positiveY​(Vector3f dir)`
Obtain the direction of `+Y` before the transformation represented by `this` matrix is applied.
`Vector3f` `positiveZ​(Vector3f dir)`
Obtain the direction of `+Z` before the transformation represented by `this` matrix is applied.
`Vector3f` ```project​(float x, float y, float z, int[] viewport, Vector3f winCoordsDest)```
Project the given `(x, y, z)` position via `this` matrix using the specified viewport and store the resulting window coordinates in `winCoordsDest`.
`Vector4f` ```project​(float x, float y, float z, int[] viewport, Vector4f winCoordsDest)```
Project the given `(x, y, z)` position via `this` matrix using the specified viewport and store the resulting window coordinates in `winCoordsDest`.
`Vector3f` ```project​(Vector3fc position, int[] viewport, Vector3f winCoordsDest)```
Project the given `position` via `this` matrix using the specified viewport and store the resulting window coordinates in `winCoordsDest`.
`Vector4f` ```project​(Vector3fc position, int[] viewport, Vector4f winCoordsDest)```
Project the given `position` via `this` matrix using the specified viewport and store the resulting window coordinates in `winCoordsDest`.
`Matrix4f` ```projectedGridRange​(Matrix4fc projector, float sLower, float sUpper, Matrix4f dest)```
Compute the range matrix for the Projected Grid transformation as described in chapter "2.4.2 Creating the range conversion matrix" of the paper Real-time water rendering - Introducing the projected grid concept based on the inverse of the view-projection matrix which is assumed to be `this`, and store that range matrix into `dest`.
`int` `properties()`
Return the assumed properties of this matrix.
`Matrix4f` ```reflect​(float nx, float ny, float nz, float px, float py, float pz, Matrix4f dest)```
Apply a mirror/reflection transformation to this matrix that reflects about the given plane specified via the plane normal and a point on the plane, and store the result in `dest`.
`Matrix4f` ```reflect​(float a, float b, float c, float d, Matrix4f dest)```
Apply a mirror/reflection transformation to this matrix that reflects about the given plane specified via the equation `x*a + y*b + z*c + d = 0` and store the result in `dest`.
`Matrix4f` ```reflect​(Quaternionfc orientation, Vector3fc point, Matrix4f dest)```
Apply a mirror/reflection transformation to this matrix that reflects about a plane specified via the plane orientation and a point on the plane, and store the result in `dest`.
`Matrix4f` ```reflect​(Vector3fc normal, Vector3fc point, Matrix4f dest)```
Apply a mirror/reflection transformation to this matrix that reflects about the given plane specified via the plane normal and a point on the plane, and store the result in `dest`.
`Matrix4f` ```rotate​(float ang, float x, float y, float z, Matrix4f dest)```
Apply rotation to this matrix by rotating the given amount of radians about the specified `(x, y, z)` axis and store the result in `dest`.
`Matrix4f` ```rotate​(float angle, Vector3fc axis, Matrix4f dest)```
Apply a rotation transformation, rotating the given radians about the specified axis and store the result in `dest`.
`Matrix4f` ```rotate​(AxisAngle4f axisAngle, Matrix4f dest)```
Apply a rotation transformation, rotating about the given `AxisAngle4f` and store the result in `dest`.
`Matrix4f` ```rotate​(Quaternionfc quat, Matrix4f dest)```
Apply the rotation - and possibly scaling - transformation of the given `Quaternionfc` to this matrix and store the result in `dest`.
`Matrix4f` ```rotateAffine​(float ang, float x, float y, float z, Matrix4f dest)```
Apply rotation to this `affine` matrix by rotating the given amount of radians about the specified `(x, y, z)` axis and store the result in `dest`.
`Matrix4f` ```rotateAffine​(Quaternionfc quat, Matrix4f dest)```
Apply the rotation - and possibly scaling - transformation of the given `Quaternionfc` to this `affine` matrix and store the result in `dest`.
`Matrix4f` ```rotateAffineXYZ​(float angleX, float angleY, float angleZ, Matrix4f dest)```
Apply rotation of `angleX` radians about the X axis, followed by a rotation of `angleY` radians about the Y axis and followed by a rotation of `angleZ` radians about the Z axis and store the result in `dest`.
`Matrix4f` ```rotateAffineYXZ​(float angleY, float angleX, float angleZ, Matrix4f dest)```
Apply rotation of `angleY` radians about the Y axis, followed by a rotation of `angleX` radians about the X axis and followed by a rotation of `angleZ` radians about the Z axis and store the result in `dest`.
`Matrix4f` ```rotateAffineZYX​(float angleZ, float angleY, float angleX, Matrix4f dest)```
Apply rotation of `angleZ` radians about the Z axis, followed by a rotation of `angleY` radians about the Y axis and followed by a rotation of `angleX` radians about the X axis and store the result in `dest`.
`Matrix4f` ```rotateAround​(Quaternionfc quat, float ox, float oy, float oz, Matrix4f dest)```
Apply the rotation - and possibly scaling - transformation of the given `Quaternionfc` to this matrix while using `(ox, oy, oz)` as the rotation origin, and store the result in `dest`.
`Matrix4f` ```rotateAroundAffine​(Quaternionfc quat, float ox, float oy, float oz, Matrix4f dest)```
Apply the rotation - and possibly scaling - transformation of the given `Quaternionfc` to this `affine` matrix while using `(ox, oy, oz)` as the rotation origin, and store the result in `dest`.
`Matrix4f` ```rotateAroundLocal​(Quaternionfc quat, float ox, float oy, float oz, Matrix4f dest)```
Pre-multiply the rotation - and possibly scaling - transformation of the given `Quaternionfc` to this matrix while using `(ox, oy, oz)` as the rotation origin, and store the result in `dest`.
`Matrix4f` ```rotateLocal​(float ang, float x, float y, float z, Matrix4f dest)```
Pre-multiply a rotation to this matrix by rotating the given amount of radians about the specified `(x, y, z)` axis and store the result in `dest`.
`Matrix4f` ```rotateLocal​(Quaternionfc quat, Matrix4f dest)```
Pre-multiply the rotation - and possibly scaling - transformation of the given `Quaternionfc` to this matrix and store the result in `dest`.
`Matrix4f` ```rotateLocalX​(float ang, Matrix4f dest)```
Pre-multiply a rotation around the X axis to this matrix by rotating the given amount of radians about the X axis and store the result in `dest`.
`Matrix4f` ```rotateLocalY​(float ang, Matrix4f dest)```
Pre-multiply a rotation around the Y axis to this matrix by rotating the given amount of radians about the Y axis and store the result in `dest`.
`Matrix4f` ```rotateLocalZ​(float ang, Matrix4f dest)```
Pre-multiply a rotation around the Z axis to this matrix by rotating the given amount of radians about the Z axis and store the result in `dest`.
`Matrix4f` ```rotateTowards​(float dirX, float dirY, float dirZ, float upX, float upY, float upZ, Matrix4f dest)```
Apply a model transformation to this matrix for a right-handed coordinate system, that aligns the local `+Z` axis with `(dirX, dirY, dirZ)` and store the result in `dest`.
`Matrix4f` ```rotateTowards​(Vector3fc dir, Vector3fc up, Matrix4f dest)```
Apply a model transformation to this matrix for a right-handed coordinate system, that aligns the local `+Z` axis with `dir` and store the result in `dest`.
`Matrix4f` ```rotateTowardsXY​(float dirX, float dirY, Matrix4f dest)```
Apply rotation about the Z axis to align the local `+X` towards `(dirX, dirY)` and store the result in `dest`.
`Matrix4f` ```rotateTranslation​(float ang, float x, float y, float z, Matrix4f dest)```
Apply rotation to this matrix, which is assumed to only contain a translation, by rotating the given amount of radians about the specified `(x, y, z)` axis and store the result in `dest`.
`Matrix4f` ```rotateTranslation​(Quaternionfc quat, Matrix4f dest)```
Apply the rotation - and possibly scaling - ransformation of the given `Quaternionfc` to this matrix, which is assumed to only contain a translation, and store the result in `dest`.
`Matrix4f` ```rotateX​(float ang, Matrix4f dest)```
Apply rotation about the X axis to this matrix by rotating the given amount of radians and store the result in `dest`.
`Matrix4f` ```rotateXYZ​(float angleX, float angleY, float angleZ, Matrix4f dest)```
Apply rotation of `angleX` radians about the X axis, followed by a rotation of `angleY` radians about the Y axis and followed by a rotation of `angleZ` radians about the Z axis and store the result in `dest`.
`Matrix4f` ```rotateY​(float ang, Matrix4f dest)```
Apply rotation about the Y axis to this matrix by rotating the given amount of radians and store the result in `dest`.
`Matrix4f` ```rotateYXZ​(float angleY, float angleX, float angleZ, Matrix4f dest)```
Apply rotation of `angleY` radians about the Y axis, followed by a rotation of `angleX` radians about the X axis and followed by a rotation of `angleZ` radians about the Z axis and store the result in `dest`.
`Matrix4f` ```rotateZ​(float ang, Matrix4f dest)```
Apply rotation about the Z axis to this matrix by rotating the given amount of radians and store the result in `dest`.
`Matrix4f` ```rotateZYX​(float angleZ, float angleY, float angleX, Matrix4f dest)```
Apply rotation of `angleZ` radians about the Z axis, followed by a rotation of `angleY` radians about the Y axis and followed by a rotation of `angleX` radians about the X axis and store the result in `dest`.
`Matrix4f` ```scale​(float x, float y, float z, Matrix4f dest)```
Apply scaling to `this` matrix by scaling the base axes by the given x, y and z factors and store the result in `dest`.
`Matrix4f` ```scale​(float xyz, Matrix4f dest)```
Apply scaling to this matrix by uniformly scaling all base axes by the given `xyz` factor and store the result in `dest`.
`Matrix4f` ```scale​(Vector3fc xyz, Matrix4f dest)```
Apply scaling to `this` matrix by scaling the base axes by the given `xyz.x`, `xyz.y` and `xyz.z` factors, respectively and store the result in `dest`.
`Matrix4f` ```scaleAround​(float sx, float sy, float sz, float ox, float oy, float oz, Matrix4f dest)```
Apply scaling to `this` matrix by scaling the base axes by the given sx, sy and sz factors while using `(ox, oy, oz)` as the scaling origin, and store the result in `dest`.
`Matrix4f` ```scaleAround​(float factor, float ox, float oy, float oz, Matrix4f dest)```
Apply scaling to this matrix by scaling all three base axes by the given `factor` while using `(ox, oy, oz)` as the scaling origin, and store the result in `dest`.
`Matrix4f` ```scaleAroundLocal​(float sx, float sy, float sz, float ox, float oy, float oz, Matrix4f dest)```
Pre-multiply scaling to `this` matrix by scaling the base axes by the given sx, sy and sz factors while using the given `(ox, oy, oz)` as the scaling origin, and store the result in `dest`.
`Matrix4f` ```scaleAroundLocal​(float factor, float ox, float oy, float oz, Matrix4f dest)```
Pre-multiply scaling to this matrix by scaling all three base axes by the given `factor` while using `(ox, oy, oz)` as the scaling origin, and store the result in `dest`.
`Matrix4f` ```scaleLocal​(float x, float y, float z, Matrix4f dest)```
Pre-multiply scaling to `this` matrix by scaling the base axes by the given x, y and z factors and store the result in `dest`.
`Matrix4f` ```scaleLocal​(float xyz, Matrix4f dest)```
Pre-multiply scaling to `this` matrix by scaling all base axes by the given `xyz` factor, and store the result in `dest`.
`Matrix4f` ```shadow​(float lightX, float lightY, float lightZ, float lightW, float a, float b, float c, float d, Matrix4f dest)```
Apply a projection transformation to this matrix that projects onto the plane specified via the general plane equation `x*a + y*b + z*c + d = 0` as if casting a shadow from a given light position/direction `(lightX, lightY, lightZ, lightW)` and store the result in `dest`.
`Matrix4f` ```shadow​(float lightX, float lightY, float lightZ, float lightW, Matrix4fc planeTransform, Matrix4f dest)```
Apply a projection transformation to this matrix that projects onto the plane with the general plane equation `y = 0` as if casting a shadow from a given light position/direction `(lightX, lightY, lightZ, lightW)` and store the result in `dest`.
`Matrix4f` ```shadow​(Vector4f light, float a, float b, float c, float d, Matrix4f dest)```
Apply a projection transformation to this matrix that projects onto the plane specified via the general plane equation `x*a + y*b + z*c + d = 0` as if casting a shadow from a given light position/direction `light` and store the result in `dest`.
`Matrix4f` ```shadow​(Vector4f light, Matrix4fc planeTransform, Matrix4f dest)```
Apply a projection transformation to this matrix that projects onto the plane with the general plane equation `y = 0` as if casting a shadow from a given light position/direction `light` and store the result in `dest`.
`Matrix4f` ```sub​(Matrix4fc subtrahend, Matrix4f dest)```
Component-wise subtract `subtrahend` from `this` and store the result in `dest`.
`Matrix4f` ```sub4x3​(Matrix4fc subtrahend, Matrix4f dest)```
Component-wise subtract the upper 4x3 submatrices of `subtrahend` from `this` and store the result in `dest`.
`boolean` ```testAab​(float minX, float minY, float minZ, float maxX, float maxY, float maxZ)```
Test whether the given axis-aligned box is partly or completely within or outside of the frustum defined by `this` matrix.
`boolean` ```testPoint​(float x, float y, float z)```
Test whether the given point `(x, y, z)` is within the frustum defined by `this` matrix.
`boolean` ```testSphere​(float x, float y, float z, float r)```
Test whether the given sphere is partly or completely within or outside of the frustum defined by `this` matrix.
`Vector4f` ```transform​(float x, float y, float z, float w, Vector4f dest)```
Transform/multiply the vector `(x, y, z, w)` by this matrix and store the result in `dest`.
`Vector4f` `transform​(Vector4f v)`
Transform/multiply the given vector by this matrix and store the result in that vector.
`Vector4f` ```transform​(Vector4fc v, Vector4f dest)```
Transform/multiply the given vector by this matrix and store the result in `dest`.
`Matrix4f` ```transformAab​(float minX, float minY, float minZ, float maxX, float maxY, float maxZ, Vector3f outMin, Vector3f outMax)```
Transform the axis-aligned box given as the minimum corner `(minX, minY, minZ)` and maximum corner `(maxX, maxY, maxZ)` by `this` `affine` matrix and compute the axis-aligned box of the result whose minimum corner is stored in `outMin` and maximum corner stored in `outMax`.
`Matrix4f` ```transformAab​(Vector3fc min, Vector3fc max, Vector3f outMin, Vector3f outMax)```
Transform the axis-aligned box given as the minimum corner `min` and maximum corner `max` by `this` `affine` matrix and compute the axis-aligned box of the result whose minimum corner is stored in `outMin` and maximum corner stored in `outMax`.
`Vector4f` ```transformAffine​(float x, float y, float z, float w, Vector4f dest)```
Transform/multiply the 4D-vector `(x, y, z, w)` by assuming that `this` matrix represents an `affine` transformation (i.e. its last row is equal to `(0, 0, 0, 1)`) and store the result in `dest`.
`Vector4f` `transformAffine​(Vector4f v)`
Transform/multiply the given 4D-vector by assuming that `this` matrix represents an `affine` transformation (i.e. its last row is equal to `(0, 0, 0, 1)`).
`Vector4f` ```transformAffine​(Vector4fc v, Vector4f dest)```
Transform/multiply the given 4D-vector by assuming that `this` matrix represents an `affine` transformation (i.e. its last row is equal to `(0, 0, 0, 1)`) and store the result in `dest`.
`Vector3f` ```transformDirection​(float x, float y, float z, Vector3f dest)```
Transform/multiply the given 3D-vector `(x, y, z)`, as if it was a 4D-vector with w=0, by this matrix and store the result in `dest`.
`Vector3f` `transformDirection​(Vector3f v)`
Transform/multiply the given 3D-vector, as if it was a 4D-vector with w=0, by this matrix and store the result in that vector.
`Vector3f` ```transformDirection​(Vector3fc v, Vector3f dest)```
Transform/multiply the given 3D-vector, as if it was a 4D-vector with w=0, by this matrix and store the result in `dest`.
`Vector3f` ```transformPosition​(float x, float y, float z, Vector3f dest)```
Transform/multiply the 3D-vector `(x, y, z)`, as if it was a 4D-vector with w=1, by this matrix and store the result in `dest`.
`Vector3f` `transformPosition​(Vector3f v)`
Transform/multiply the given 3D-vector, as if it was a 4D-vector with w=1, by this matrix and store the result in that vector.
`Vector3f` ```transformPosition​(Vector3fc v, Vector3f dest)```
Transform/multiply the given 3D-vector, as if it was a 4D-vector with w=1, by this matrix and store the result in `dest`.
`Vector4f` ```transformProject​(float x, float y, float z, float w, Vector4f dest)```
Transform/multiply the vector `(x, y, z, w)` by this matrix, perform perspective divide and store the result in `dest`.
`Vector3f` ```transformProject​(float x, float y, float z, Vector3f dest)```
Transform/multiply the vector `(x, y, z)` by this matrix, perform perspective divide and store the result in `dest`.
`Vector3f` `transformProject​(Vector3f v)`
Transform/multiply the given vector by this matrix, perform perspective divide and store the result in that vector.
`Vector3f` ```transformProject​(Vector3fc v, Vector3f dest)```
Transform/multiply the given vector by this matrix, perform perspective divide and store the result in `dest`.
`Vector4f` `transformProject​(Vector4f v)`
Transform/multiply the given vector by this matrix, perform perspective divide and store the result in that vector.
`Vector4f` ```transformProject​(Vector4fc v, Vector4f dest)```
Transform/multiply the given vector by this matrix, perform perspective divide and store the result in `dest`.
`Matrix4f` ```translate​(float x, float y, float z, Matrix4f dest)```
Apply a translation to this matrix by translating by the given number of units in x, y and z and store the result in `dest`.
`Matrix4f` ```translate​(Vector3fc offset, Matrix4f dest)```
Apply a translation to this matrix by translating by the given number of units in x, y and z and store the result in `dest`.
`Matrix4f` ```translateLocal​(float x, float y, float z, Matrix4f dest)```
Pre-multiply a translation to this matrix by translating by the given number of units in x, y and z and store the result in `dest`.
`Matrix4f` ```translateLocal​(Vector3fc offset, Matrix4f dest)```
Pre-multiply a translation to this matrix by translating by the given number of units in x, y and z and store the result in `dest`.
`Matrix4f` `transpose​(Matrix4f dest)`
Transpose this matrix and store the result in `dest`.
`Matrix3f` `transpose3x3​(Matrix3f dest)`
Transpose only the upper left 3x3 submatrix of this matrix and store the result in `dest`.
`Matrix4f` `transpose3x3​(Matrix4f dest)`
Transpose only the upper left 3x3 submatrix of this matrix and store the result in `dest`.
`Vector3f` ```unproject​(float winX, float winY, float winZ, int[] viewport, Vector3f dest)```
Unproject the given window coordinates `(winX, winY, winZ)` by `this` matrix using the specified viewport.
`Vector4f` ```unproject​(float winX, float winY, float winZ, int[] viewport, Vector4f dest)```
Unproject the given window coordinates `(winX, winY, winZ)` by `this` matrix using the specified viewport.
`Vector3f` ```unproject​(Vector3fc winCoords, int[] viewport, Vector3f dest)```
Unproject the given window coordinates `winCoords` by `this` matrix using the specified viewport.
`Vector4f` ```unproject​(Vector3fc winCoords, int[] viewport, Vector4f dest)```
Unproject the given window coordinates `winCoords` by `this` matrix using the specified viewport.
`Vector3f` ```unprojectInv​(float winX, float winY, float winZ, int[] viewport, Vector3f dest)```
Unproject the given window coordinates `(winX, winY, winZ)` by `this` matrix using the specified viewport.
`Vector4f` ```unprojectInv​(float winX, float winY, float winZ, int[] viewport, Vector4f dest)```
Unproject the given window coordinates `(winX, winY, winZ)` by `this` matrix using the specified viewport.
`Vector3f` ```unprojectInv​(Vector3fc winCoords, int[] viewport, Vector3f dest)```
Unproject the given window coordinates `winCoords` by `this` matrix using the specified viewport.
`Vector4f` ```unprojectInv​(Vector3fc winCoords, int[] viewport, Vector4f dest)```
Unproject the given window coordinates `winCoords` by `this` matrix using the specified viewport.
`Matrix4f` ```unprojectInvRay​(float winX, float winY, int[] viewport, Vector3f originDest, Vector3f dirDest)```
Unproject the given 2D window coordinates `(winX, winY)` by `this` matrix using the specified viewport and compute the origin and the direction of the resulting ray which starts at NDC `z = -1.0` and goes through NDC `z = +1.0`.
`Matrix4f` ```unprojectInvRay​(Vector2fc winCoords, int[] viewport, Vector3f originDest, Vector3f dirDest)```
Unproject the given window coordinates `winCoords` by `this` matrix using the specified viewport and compute the origin and the direction of the resulting ray which starts at NDC `z = -1.0` and goes through NDC `z = +1.0`.
`Matrix4f` ```unprojectRay​(float winX, float winY, int[] viewport, Vector3f originDest, Vector3f dirDest)```
Unproject the given 2D window coordinates `(winX, winY)` by `this` matrix using the specified viewport and compute the origin and the direction of the resulting ray which starts at NDC `z = -1.0` and goes through NDC `z = +1.0`.
`Matrix4f` ```unprojectRay​(Vector2fc winCoords, int[] viewport, Vector3f originDest, Vector3f dirDest)```
Unproject the given 2D window coordinates `winCoords` by `this` matrix using the specified viewport and compute the origin and the direction of the resulting ray which starts at NDC `z = -1.0` and goes through NDC `z = +1.0`.
• Method Detail

• m00

`float m00()`
Return the value of the matrix element at column 0 and row 0.
Returns:
the value of the matrix element
• m01

`float m01()`
Return the value of the matrix element at column 0 and row 1.
Returns:
the value of the matrix element
• m02

`float m02()`
Return the value of the matrix element at column 0 and row 2.
Returns:
the value of the matrix element
• m03

`float m03()`
Return the value of the matrix element at column 0 and row 3.
Returns:
the value of the matrix element
• m10

`float m10()`
Return the value of the matrix element at column 1 and row 0.
Returns:
the value of the matrix element
• m11

`float m11()`
Return the value of the matrix element at column 1 and row 1.
Returns:
the value of the matrix element
• m12

`float m12()`
Return the value of the matrix element at column 1 and row 2.
Returns:
the value of the matrix element
• m13

`float m13()`
Return the value of the matrix element at column 1 and row 3.
Returns:
the value of the matrix element
• m20

`float m20()`
Return the value of the matrix element at column 2 and row 0.
Returns:
the value of the matrix element
• m21

`float m21()`
Return the value of the matrix element at column 2 and row 1.
Returns:
the value of the matrix element
• m22

`float m22()`
Return the value of the matrix element at column 2 and row 2.
Returns:
the value of the matrix element
• m23

`float m23()`
Return the value of the matrix element at column 2 and row 3.
Returns:
the value of the matrix element
• m30

`float m30()`
Return the value of the matrix element at column 3 and row 0.
Returns:
the value of the matrix element
• m31

`float m31()`
Return the value of the matrix element at column 3 and row 1.
Returns:
the value of the matrix element
• m32

`float m32()`
Return the value of the matrix element at column 3 and row 2.
Returns:
the value of the matrix element
• m33

`float m33()`
Return the value of the matrix element at column 3 and row 3.
Returns:
the value of the matrix element
• mul

```Matrix4f mul​(Matrix4fc right,
Matrix4f dest)```
Multiply this matrix by the supplied `right` matrix and store the result in `dest`.

If `M` is `this` matrix and `R` the `right` matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the transformation of the right matrix will be applied first!

Parameters:
`right` - the right operand of the matrix multiplication
`dest` - the destination matrix, which will hold the result
Returns:
dest
• mulLocal

```Matrix4f mulLocal​(Matrix4fc left,
Matrix4f dest)```
Pre-multiply this matrix by the supplied `left` matrix and store the result in `dest`.

If `M` is `this` matrix and `L` the `left` matrix, then the new matrix will be `L * M`. So when transforming a vector `v` with the new matrix by using `L * M * v`, the transformation of `this` matrix will be applied first!

Parameters:
`left` - the left operand of the matrix multiplication
`dest` - the destination matrix, which will hold the result
Returns:
dest
• mulLocalAffine

```Matrix4f mulLocalAffine​(Matrix4fc left,
Matrix4f dest)```
Pre-multiply this matrix by the supplied `left` matrix, both of which are assumed to be `affine`, and store the result in `dest`.

This method assumes that `this` matrix and the given `left` matrix both represent an `affine` transformation (i.e. their last rows are equal to `(0, 0, 0, 1)`) and can be used to speed up matrix multiplication if the matrices only represent affine transformations, such as translation, rotation, scaling and shearing (in any combination).

This method will not modify either the last row of `this` or the last row of `left`.

If `M` is `this` matrix and `L` the `left` matrix, then the new matrix will be `L * M`. So when transforming a vector `v` with the new matrix by using `L * M * v`, the transformation of `this` matrix will be applied first!

Parameters:
`left` - the left operand of the matrix multiplication (the last row is assumed to be `(0, 0, 0, 1)`)
`dest` - the destination matrix, which will hold the result
Returns:
dest
• mul

```Matrix4f mul​(Matrix3x2fc right,
Matrix4f dest)```
Multiply this matrix by the supplied `right` matrix and store the result in `dest`.

If `M` is `this` matrix and `R` the `right` matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the transformation of the right matrix will be applied first!

Parameters:
`right` - the right operand of the matrix multiplication
`dest` - the destination matrix, which will hold the result
Returns:
dest
• mul

```Matrix4f mul​(Matrix4x3fc right,
Matrix4f dest)```
Multiply this matrix by the supplied `right` matrix and store the result in `dest`.

The last row of the `right` matrix is assumed to be `(0, 0, 0, 1)`.

If `M` is `this` matrix and `R` the `right` matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the transformation of the right matrix will be applied first!

Parameters:
`right` - the right operand of the matrix multiplication
`dest` - the destination matrix, which will hold the result
Returns:
dest
• mulPerspectiveAffine

```Matrix4f mulPerspectiveAffine​(Matrix4fc view,
Matrix4f dest)```
Multiply `this` symmetric perspective projection matrix by the supplied `affine` `view` matrix and store the result in `dest`.

If `P` is `this` matrix and `V` the `view` matrix, then the new matrix will be `P * V`. So when transforming a vector `v` with the new matrix by using `P * V * v`, the transformation of the `view` matrix will be applied first!

Parameters:
`view` - the `affine` matrix to multiply `this` symmetric perspective projection matrix by
`dest` - the destination matrix, which will hold the result
Returns:
dest
• mulPerspectiveAffine

```Matrix4f mulPerspectiveAffine​(Matrix4x3fc view,
Matrix4f dest)```
Multiply `this` symmetric perspective projection matrix by the supplied `view` matrix and store the result in `dest`.

If `P` is `this` matrix and `V` the `view` matrix, then the new matrix will be `P * V`. So when transforming a vector `v` with the new matrix by using `P * V * v`, the transformation of the `view` matrix will be applied first!

Parameters:
`view` - the matrix to multiply `this` symmetric perspective projection matrix by
`dest` - the destination matrix, which will hold the result
Returns:
dest
• mulAffineR

```Matrix4f mulAffineR​(Matrix4fc right,
Matrix4f dest)```
Multiply this matrix by the supplied `right` matrix, which is assumed to be `affine`, and store the result in `dest`.

This method assumes that the given `right` matrix represents an `affine` transformation (i.e. its last row is equal to `(0, 0, 0, 1)`) and can be used to speed up matrix multiplication if the matrix only represents affine transformations, such as translation, rotation, scaling and shearing (in any combination).

If `M` is `this` matrix and `R` the `right` matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the transformation of the right matrix will be applied first!

Parameters:
`right` - the right operand of the matrix multiplication (the last row is assumed to be `(0, 0, 0, 1)`)
`dest` - the destination matrix, which will hold the result
Returns:
dest
• mulAffine

```Matrix4f mulAffine​(Matrix4fc right,
Matrix4f dest)```
Multiply this matrix by the supplied `right` matrix, both of which are assumed to be `affine`, and store the result in `dest`.

This method assumes that `this` matrix and the given `right` matrix both represent an `affine` transformation (i.e. their last rows are equal to `(0, 0, 0, 1)`) and can be used to speed up matrix multiplication if the matrices only represent affine transformations, such as translation, rotation, scaling and shearing (in any combination).

This method will not modify either the last row of `this` or the last row of `right`.

If `M` is `this` matrix and `R` the `right` matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the transformation of the right matrix will be applied first!

Parameters:
`right` - the right operand of the matrix multiplication (the last row is assumed to be `(0, 0, 0, 1)`)
`dest` - the destination matrix, which will hold the result
Returns:
dest
• mulTranslationAffine

```Matrix4f mulTranslationAffine​(Matrix4fc right,
Matrix4f dest)```
Multiply this matrix, which is assumed to only contain a translation, by the supplied `right` matrix, which is assumed to be `affine`, and store the result in `dest`.

This method assumes that `this` matrix only contains a translation, and that the given `right` matrix represents an `affine` transformation (i.e. its last row is equal to `(0, 0, 0, 1)`).

This method will not modify either the last row of `this` or the last row of `right`.

If `M` is `this` matrix and `R` the `right` matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the transformation of the right matrix will be applied first!

Parameters:
`right` - the right operand of the matrix multiplication (the last row is assumed to be `(0, 0, 0, 1)`)
`dest` - the destination matrix, which will hold the result
Returns:
dest
• mulOrthoAffine

```Matrix4f mulOrthoAffine​(Matrix4fc view,
Matrix4f dest)```
Multiply `this` orthographic projection matrix by the supplied `affine` `view` matrix and store the result in `dest`.

If `M` is `this` matrix and `V` the `view` matrix, then the new matrix will be `M * V`. So when transforming a vector `v` with the new matrix by using `M * V * v`, the transformation of the `view` matrix will be applied first!

Parameters:
`view` - the affine matrix which to multiply `this` with
`dest` - the destination matrix, which will hold the result
Returns:
dest
• fma4x3

```Matrix4f fma4x3​(Matrix4fc other,
float otherFactor,
Matrix4f dest)```
Component-wise add the upper 4x3 submatrices of `this` and `other` by first multiplying each component of `other`'s 4x3 submatrix by `otherFactor`, adding that to `this` and storing the final result in `dest`.

The other components of `dest` will be set to the ones of `this`.

The matrices `this` and `other` will not be changed.

Parameters:
`other` - the other matrix
`otherFactor` - the factor to multiply each of the other matrix's 4x3 components
`dest` - will hold the result
Returns:
dest

```Matrix4f add​(Matrix4fc other,
Matrix4f dest)```
Component-wise add `this` and `other` and store the result in `dest`.
Parameters:
`other` - the other addend
`dest` - will hold the result
Returns:
dest
• sub

```Matrix4f sub​(Matrix4fc subtrahend,
Matrix4f dest)```
Component-wise subtract `subtrahend` from `this` and store the result in `dest`.
Parameters:
`subtrahend` - the subtrahend
`dest` - will hold the result
Returns:
dest
• mulComponentWise

```Matrix4f mulComponentWise​(Matrix4fc other,
Matrix4f dest)```
Component-wise multiply `this` by `other` and store the result in `dest`.
Parameters:
`other` - the other matrix
`dest` - will hold the result
Returns:
dest

```Matrix4f add4x3​(Matrix4fc other,
Matrix4f dest)```
Component-wise add the upper 4x3 submatrices of `this` and `other` and store the result in `dest`.

The other components of `dest` will be set to the ones of `this`.

Parameters:
`other` - the other addend
`dest` - will hold the result
Returns:
dest
• sub4x3

```Matrix4f sub4x3​(Matrix4fc subtrahend,
Matrix4f dest)```
Component-wise subtract the upper 4x3 submatrices of `subtrahend` from `this` and store the result in `dest`.

The other components of `dest` will be set to the ones of `this`.

Parameters:
`subtrahend` - the subtrahend
`dest` - will hold the result
Returns:
dest
• mul4x3ComponentWise

```Matrix4f mul4x3ComponentWise​(Matrix4fc other,
Matrix4f dest)```
Component-wise multiply the upper 4x3 submatrices of `this` by `other` and store the result in `dest`.

The other components of `dest` will be set to the ones of `this`.

Parameters:
`other` - the other matrix
`dest` - will hold the result
Returns:
dest
• determinant

`float determinant()`
Return the determinant of this matrix.

If `this` matrix represents an `affine` transformation, such as translation, rotation, scaling and shearing, and thus its last row is equal to `(0, 0, 0, 1)`, then `determinantAffine()` can be used instead of this method.

Returns:
the determinant
`determinantAffine()`
• determinant3x3

`float determinant3x3()`
Return the determinant of the upper left 3x3 submatrix of this matrix.
Returns:
the determinant
• determinantAffine

`float determinantAffine()`
Return the determinant of this matrix by assuming that it represents an `affine` transformation and thus its last row is equal to `(0, 0, 0, 1)`.
Returns:
the determinant
• invert

`Matrix4f invert​(Matrix4f dest)`
Invert this matrix and write the result into `dest`.

If `this` matrix represents an `affine` transformation, such as translation, rotation, scaling and shearing, and thus its last row is equal to `(0, 0, 0, 1)`, then `invertAffine(Matrix4f)` can be used instead of this method.

Parameters:
`dest` - will hold the result
Returns:
dest
`invertAffine(Matrix4f)`
• invertPerspective

`Matrix4f invertPerspective​(Matrix4f dest)`
If `this` is a perspective projection matrix obtained via one of the `perspective()` methods, that is, if `this` is a symmetrical perspective frustum transformation, then this method builds the inverse of `this` and stores it into the given `dest`.

This method can be used to quickly obtain the inverse of a perspective projection matrix when being obtained via `perspective()`.

Parameters:
`dest` - will hold the inverse of `this`
Returns:
dest
`perspective(float, float, float, float, Matrix4f)`
• invertOrtho

`Matrix4f invertOrtho​(Matrix4f dest)`
Invert `this` orthographic projection matrix and store the result into the given `dest`.

This method can be used to quickly obtain the inverse of an orthographic projection matrix.

Parameters:
`dest` - will hold the inverse of `this`
Returns:
dest
• invertPerspectiveView

```Matrix4f invertPerspectiveView​(Matrix4fc view,
Matrix4f dest)```
If `this` is a perspective projection matrix obtained via one of the `perspective()` methods, that is, if `this` is a symmetrical perspective frustum transformation and the given `view` matrix is `affine` and has unit scaling (for example by being obtained via `lookAt()`), then this method builds the inverse of `this * view` and stores it into the given `dest`.

This method can be used to quickly obtain the inverse of the combination of the view and projection matrices, when both were obtained via the common methods `perspective()` and `lookAt()` or other methods, that build affine matrices, such as `translate` and `rotate(float, float, float, float, Matrix4f)`, except for `scale()`.

For the special cases of the matrices `this` and `view` mentioned above, this method is equivalent to the following code:

``` dest.set(this).mul(view).invert();
```
Parameters:
`view` - the view transformation (must be `affine` and have unit scaling)
`dest` - will hold the inverse of `this * view`
Returns:
dest
• invertPerspectiveView

```Matrix4f invertPerspectiveView​(Matrix4x3fc view,
Matrix4f dest)```
If `this` is a perspective projection matrix obtained via one of the `perspective()` methods, that is, if `this` is a symmetrical perspective frustum transformation and the given `view` matrix has unit scaling, then this method builds the inverse of `this * view` and stores it into the given `dest`.

This method can be used to quickly obtain the inverse of the combination of the view and projection matrices, when both were obtained via the common methods `perspective()` and `lookAt()` or other methods, that build affine matrices, such as `translate` and `rotate(float, float, float, float, Matrix4f)`, except for `scale()`.

For the special cases of the matrices `this` and `view` mentioned above, this method is equivalent to the following code:

``` dest.set(this).mul(view).invert();
```
Parameters:
`view` - the view transformation (must have unit scaling)
`dest` - will hold the inverse of `this * view`
Returns:
dest
• invertAffine

`Matrix4f invertAffine​(Matrix4f dest)`
Invert this matrix by assuming that it is an `affine` transformation (i.e. its last row is equal to `(0, 0, 0, 1)`) and write the result into `dest`.
Parameters:
`dest` - will hold the result
Returns:
dest
• transpose

`Matrix4f transpose​(Matrix4f dest)`
Transpose this matrix and store the result in `dest`.
Parameters:
`dest` - will hold the result
Returns:
dest
• transpose3x3

`Matrix4f transpose3x3​(Matrix4f dest)`
Transpose only the upper left 3x3 submatrix of this matrix and store the result in `dest`.

All other matrix elements are left unchanged.

Parameters:
`dest` - will hold the result
Returns:
dest
• transpose3x3

`Matrix3f transpose3x3​(Matrix3f dest)`
Transpose only the upper left 3x3 submatrix of this matrix and store the result in `dest`.
Parameters:
`dest` - will hold the result
Returns:
dest
• getTranslation

`Vector3f getTranslation​(Vector3f dest)`
Get only the translation components `(m30, m31, m32)` of this matrix and store them in the given vector `xyz`.
Parameters:
`dest` - will hold the translation components of this matrix
Returns:
dest
• getScale

`Vector3f getScale​(Vector3f dest)`
Get the scaling factors of `this` matrix for the three base axes.
Parameters:
`dest` - will hold the scaling factors for `x`, `y` and `z`
Returns:
dest
• get

`Matrix4f get​(Matrix4f dest)`
Get the current values of `this` matrix and store them into `dest`.
Parameters:
`dest` - the destination matrix
Returns:
the passed in destination
• get4x3

`Matrix4x3f get4x3​(Matrix4x3f dest)`
Get the current values of the upper 4x3 submatrix of `this` matrix and store them into `dest`.
Parameters:
`dest` - the destination matrix
Returns:
the passed in destination
`Matrix4x3f.set(Matrix4fc)`
• get

`Matrix4d get​(Matrix4d dest)`
Get the current values of `this` matrix and store them into `dest`.
Parameters:
`dest` - the destination matrix
Returns:
the passed in destination
• get3x3

`Matrix3f get3x3​(Matrix3f dest)`
Get the current values of the upper left 3x3 submatrix of `this` matrix and store them into `dest`.
Parameters:
`dest` - the destination matrix
Returns:
the passed in destination
`Matrix3f.set(Matrix4fc)`
• get3x3

`Matrix3d get3x3​(Matrix3d dest)`
Get the current values of the upper left 3x3 submatrix of `this` matrix and store them into `dest`.
Parameters:
`dest` - the destination matrix
Returns:
the passed in destination
`Matrix3d.set(Matrix4fc)`
• getUnnormalizedRotation

`Quaternionf getUnnormalizedRotation​(Quaternionf dest)`
Get the current values of `this` matrix and store the represented rotation into the given `Quaternionf`.

This method assumes that the first three column vectors of the upper left 3x3 submatrix are not normalized and thus allows to ignore any additional scaling factor that is applied to the matrix.

Parameters:
`dest` - the destination `Quaternionf`
Returns:
the passed in destination
`Quaternionf.setFromUnnormalized(Matrix4fc)`
• getUnnormalizedRotation

`Quaterniond getUnnormalizedRotation​(Quaterniond dest)`
Get the current values of `this` matrix and store the represented rotation into the given `Quaterniond`.

This method assumes that the first three column vectors of the upper left 3x3 submatrix are not normalized and thus allows to ignore any additional scaling factor that is applied to the matrix.

Parameters:
`dest` - the destination `Quaterniond`
Returns:
the passed in destination
`Quaterniond.setFromUnnormalized(Matrix4fc)`
• get

`java.nio.FloatBuffer get​(java.nio.FloatBuffer buffer)`
Store this matrix in column-major order into the supplied `FloatBuffer` at the current buffer `position`.

This method will not increment the position of the given FloatBuffer.

In order to specify the offset into the FloatBuffer at which the matrix is stored, use `get(int, FloatBuffer)`, taking the absolute position as parameter.

Parameters:
`buffer` - will receive the values of this matrix in column-major order at its current position
Returns:
the passed in buffer
`get(int, FloatBuffer)`
• get

```java.nio.FloatBuffer get​(int index,
java.nio.FloatBuffer buffer)```
Store this matrix in column-major order into the supplied `FloatBuffer` starting at the specified absolute buffer position/index.

This method will not increment the position of the given FloatBuffer.

Parameters:
`index` - the absolute position into the FloatBuffer
`buffer` - will receive the values of this matrix in column-major order
Returns:
the passed in buffer
• get

`java.nio.ByteBuffer get​(java.nio.ByteBuffer buffer)`
Store this matrix in column-major order into the supplied `ByteBuffer` at the current buffer `position`.

This method will not increment the position of the given ByteBuffer.

In order to specify the offset into the ByteBuffer at which the matrix is stored, use `get(int, ByteBuffer)`, taking the absolute position as parameter.

Parameters:
`buffer` - will receive the values of this matrix in column-major order at its current position
Returns:
the passed in buffer
`get(int, ByteBuffer)`
• get

```java.nio.ByteBuffer get​(int index,
java.nio.ByteBuffer buffer)```
Store this matrix in column-major order into the supplied `ByteBuffer` starting at the specified absolute buffer position/index.

This method will not increment the position of the given ByteBuffer.

Parameters:
`index` - the absolute position into the ByteBuffer
`buffer` - will receive the values of this matrix in column-major order
Returns:
the passed in buffer
• get4x3

`java.nio.FloatBuffer get4x3​(java.nio.FloatBuffer buffer)`
Store the upper 4x3 submatrix in column-major order into the supplied `FloatBuffer` at the current buffer `position`.

This method will not increment the position of the given FloatBuffer.

In order to specify the offset into the FloatBuffer at which the matrix is stored, use `get(int, FloatBuffer)`, taking the absolute position as parameter.

Parameters:
`buffer` - will receive the values of the upper 4x3 submatrix in column-major order at its current position
Returns:
the passed in buffer
`get(int, FloatBuffer)`
• get4x3

```java.nio.FloatBuffer get4x3​(int index,
java.nio.FloatBuffer buffer)```
Store the upper 4x3 submatrix in column-major order into the supplied `FloatBuffer` starting at the specified absolute buffer position/index.

This method will not increment the position of the given FloatBuffer.

Parameters:
`index` - the absolute position into the FloatBuffer
`buffer` - will receive the values of the upper 4x3 submatrix in column-major order
Returns:
the passed in buffer
• get4x3

`java.nio.ByteBuffer get4x3​(java.nio.ByteBuffer buffer)`
Store the upper 4x3 submatrix in column-major order into the supplied `ByteBuffer` at the current buffer `position`.

This method will not increment the position of the given ByteBuffer.

In order to specify the offset into the ByteBuffer at which the matrix is stored, use `get(int, ByteBuffer)`, taking the absolute position as parameter.

Parameters:
`buffer` - will receive the values of the upper 4x3 submatrix in column-major order at its current position
Returns:
the passed in buffer
`get(int, ByteBuffer)`
• get4x3

```java.nio.ByteBuffer get4x3​(int index,
java.nio.ByteBuffer buffer)```
Store the upper 4x3 submatrix in column-major order into the supplied `ByteBuffer` starting at the specified absolute buffer position/index.

This method will not increment the position of the given ByteBuffer.

Parameters:
`index` - the absolute position into the ByteBuffer
`buffer` - will receive the values of the upper 4x3 submatrix in column-major order
Returns:
the passed in buffer
• getTransposed

`java.nio.FloatBuffer getTransposed​(java.nio.FloatBuffer buffer)`
Store the transpose of this matrix in column-major order into the supplied `FloatBuffer` at the current buffer `position`.

This method will not increment the position of the given FloatBuffer.

In order to specify the offset into the FloatBuffer at which the matrix is stored, use `getTransposed(int, FloatBuffer)`, taking the absolute position as parameter.

Parameters:
`buffer` - will receive the values of this matrix in column-major order at its current position
Returns:
the passed in buffer
`getTransposed(int, FloatBuffer)`
• getTransposed

```java.nio.FloatBuffer getTransposed​(int index,
java.nio.FloatBuffer buffer)```
Store the transpose of this matrix in column-major order into the supplied `FloatBuffer` starting at the specified absolute buffer position/index.

This method will not increment the position of the given FloatBuffer.

Parameters:
`index` - the absolute position into the FloatBuffer
`buffer` - will receive the values of this matrix in column-major order
Returns:
the passed in buffer
• getTransposed

`java.nio.ByteBuffer getTransposed​(java.nio.ByteBuffer buffer)`
Store the transpose of this matrix in column-major order into the supplied `ByteBuffer` at the current buffer `position`.

This method will not increment the position of the given ByteBuffer.

In order to specify the offset into the ByteBuffer at which the matrix is stored, use `getTransposed(int, ByteBuffer)`, taking the absolute position as parameter.

Parameters:
`buffer` - will receive the values of this matrix in column-major order at its current position
Returns:
the passed in buffer
`getTransposed(int, ByteBuffer)`
• getTransposed

```java.nio.ByteBuffer getTransposed​(int index,
java.nio.ByteBuffer buffer)```
Store the transpose of this matrix in column-major order into the supplied `ByteBuffer` starting at the specified absolute buffer position/index.

This method will not increment the position of the given ByteBuffer.

Parameters:
`index` - the absolute position into the ByteBuffer
`buffer` - will receive the values of this matrix in column-major order
Returns:
the passed in buffer
• get4x3Transposed

`java.nio.FloatBuffer get4x3Transposed​(java.nio.FloatBuffer buffer)`
Store the upper 4x3 submatrix of `this` matrix in row-major order into the supplied `FloatBuffer` at the current buffer `position`.

This method will not increment the position of the given FloatBuffer.

In order to specify the offset into the FloatBuffer at which the matrix is stored, use `get4x3Transposed(int, FloatBuffer)`, taking the absolute position as parameter.

Parameters:
`buffer` - will receive the values of the upper 4x3 submatrix in row-major order at its current position
Returns:
the passed in buffer
`get4x3Transposed(int, FloatBuffer)`
• get4x3Transposed

```java.nio.FloatBuffer get4x3Transposed​(int index,
java.nio.FloatBuffer buffer)```
Store the upper 4x3 submatrix of `this` matrix in row-major order into the supplied `FloatBuffer` starting at the specified absolute buffer position/index.

This method will not increment the position of the given FloatBuffer.

Parameters:
`index` - the absolute position into the FloatBuffer
`buffer` - will receive the values of the upper 4x3 submatrix in row-major order
Returns:
the passed in buffer
• get4x3Transposed

`java.nio.ByteBuffer get4x3Transposed​(java.nio.ByteBuffer buffer)`
Store the upper 4x3 submatrix of `this` matrix in row-major order into the supplied `ByteBuffer` at the current buffer `position`.

This method will not increment the position of the given ByteBuffer.

In order to specify the offset into the ByteBuffer at which the matrix is stored, use `get4x3Transposed(int, ByteBuffer)`, taking the absolute position as parameter.

Parameters:
`buffer` - will receive the values of the upper 4x3 submatrix in row-major order at its current position
Returns:
the passed in buffer
`get4x3Transposed(int, ByteBuffer)`
• get4x3Transposed

```java.nio.ByteBuffer get4x3Transposed​(int index,
java.nio.ByteBuffer buffer)```
Store the upper 4x3 submatrix of `this` matrix in row-major order into the supplied `ByteBuffer` starting at the specified absolute buffer position/index.

This method will not increment the position of the given ByteBuffer.

Parameters:
`index` - the absolute position into the ByteBuffer
`buffer` - will receive the values of the upper 4x3 submatrix in row-major order
Returns:
the passed in buffer

`Matrix4fc getToAddress​(long address)`
Store this matrix in column-major order at the given off-heap address.

This method will throw an `UnsupportedOperationException` when JOML is used with `-Djoml.nounsafe`.

This method is unsafe as it can result in a crash of the JVM process when the specified address range does not belong to this process.

Parameters:
`address` - the off-heap address where to store this matrix
Returns:
this
• get

```float[] get​(float[] arr,
int offset)```
Store this matrix into the supplied float array in column-major order at the given offset.
Parameters:
`arr` - the array to write the matrix values into
`offset` - the offset into the array
Returns:
the passed in array
• get

`float[] get​(float[] arr)`
Store this matrix into the supplied float array in column-major order.

In order to specify an explicit offset into the array, use the method `get(float[], int)`.

Parameters:
`arr` - the array to write the matrix values into
Returns:
the passed in array
`get(float[], int)`
• transform

`Vector4f transform​(Vector4f v)`
Transform/multiply the given vector by this matrix and store the result in that vector.
Parameters:
`v` - the vector to transform and to hold the final result
Returns:
v
`Vector4f.mul(Matrix4fc)`
• transform

```Vector4f transform​(Vector4fc v,
Vector4f dest)```
Transform/multiply the given vector by this matrix and store the result in `dest`.
Parameters:
`v` - the vector to transform
`dest` - will contain the result
Returns:
dest
`Vector4f.mul(Matrix4fc, Vector4f)`
• transform

```Vector4f transform​(float x,
float y,
float z,
float w,
Vector4f dest)```
Transform/multiply the vector `(x, y, z, w)` by this matrix and store the result in `dest`.
Parameters:
`x` - the x coordinate of the vector to transform
`y` - the y coordinate of the vector to transform
`z` - the z coordinate of the vector to transform
`w` - the w coordinate of the vector to transform
`dest` - will contain the result
Returns:
dest
• transformProject

`Vector4f transformProject​(Vector4f v)`
Transform/multiply the given vector by this matrix, perform perspective divide and store the result in that vector.
Parameters:
`v` - the vector to transform and to hold the final result
Returns:
v
`Vector4f.mulProject(Matrix4fc)`
• transformProject

```Vector4f transformProject​(Vector4fc v,
Vector4f dest)```
Transform/multiply the given vector by this matrix, perform perspective divide and store the result in `dest`.
Parameters:
`v` - the vector to transform
`dest` - will contain the result
Returns:
dest
`Vector4f.mulProject(Matrix4fc, Vector4f)`
• transformProject

```Vector4f transformProject​(float x,
float y,
float z,
float w,
Vector4f dest)```
Transform/multiply the vector `(x, y, z, w)` by this matrix, perform perspective divide and store the result in `dest`.
Parameters:
`x` - the x coordinate of the vector to transform
`y` - the y coordinate of the vector to transform
`z` - the z coordinate of the vector to transform
`w` - the w coordinate of the vector to transform
`dest` - will contain the result
Returns:
dest
• transformProject

`Vector3f transformProject​(Vector3f v)`
Transform/multiply the given vector by this matrix, perform perspective divide and store the result in that vector.

This method uses `w=1.0` as the fourth vector component.

Parameters:
`v` - the vector to transform and to hold the final result
Returns:
v
`Vector3f.mulProject(Matrix4fc)`
• transformProject

```Vector3f transformProject​(Vector3fc v,
Vector3f dest)```
Transform/multiply the given vector by this matrix, perform perspective divide and store the result in `dest`.

This method uses `w=1.0` as the fourth vector component.

Parameters:
`v` - the vector to transform
`dest` - will contain the result
Returns:
dest
`Vector3f.mulProject(Matrix4fc, Vector3f)`
• transformProject

```Vector3f transformProject​(float x,
float y,
float z,
Vector3f dest)```
Transform/multiply the vector `(x, y, z)` by this matrix, perform perspective divide and store the result in `dest`.

This method uses `w=1.0` as the fourth vector component.

Parameters:
`x` - the x coordinate of the vector to transform
`y` - the y coordinate of the vector to transform
`z` - the z coordinate of the vector to transform
`dest` - will contain the result
Returns:
dest
• transformDirection

`Vector3f transformDirection​(Vector3f v)`
Transform/multiply the given 3D-vector, as if it was a 4D-vector with w=0, by this matrix and store the result in that vector.

The given 3D-vector is treated as a 4D-vector with its w-component being `0.0`, so it will represent a direction in 3D-space rather than a position. This method will therefore not take the translation part of the matrix into account.

In order to store the result in another vector, use `transformDirection(Vector3fc, Vector3f)`.

Parameters:
`v` - the vector to transform and to hold the final result
Returns:
v
`transformDirection(Vector3fc, Vector3f)`
• transformDirection

```Vector3f transformDirection​(Vector3fc v,
Vector3f dest)```
Transform/multiply the given 3D-vector, as if it was a 4D-vector with w=0, by this matrix and store the result in `dest`.

The given 3D-vector is treated as a 4D-vector with its w-component being `0.0`, so it will represent a direction in 3D-space rather than a position. This method will therefore not take the translation part of the matrix into account.

In order to store the result in the same vector, use `transformDirection(Vector3f)`.

Parameters:
`v` - the vector to transform and to hold the final result
`dest` - will hold the result
Returns:
dest
`transformDirection(Vector3f)`
• transformDirection

```Vector3f transformDirection​(float x,
float y,
float z,
Vector3f dest)```
Transform/multiply the given 3D-vector `(x, y, z)`, as if it was a 4D-vector with w=0, by this matrix and store the result in `dest`.

The given 3D-vector is treated as a 4D-vector with its w-component being `0.0`, so it will represent a direction in 3D-space rather than a position. This method will therefore not take the translation part of the matrix into account.

Parameters:
`x` - the x coordinate of the direction to transform
`y` - the y coordinate of the direction to transform
`z` - the z coordinate of the direction to transform
`dest` - will hold the result
Returns:
dest
• transformAffine

```Vector4f transformAffine​(Vector4fc v,
Vector4f dest)```
Transform/multiply the given 4D-vector by assuming that `this` matrix represents an `affine` transformation (i.e. its last row is equal to `(0, 0, 0, 1)`) and store the result in `dest`.

In order to store the result in the same vector, use `transformAffine(Vector4f)`.

Parameters:
`v` - the vector to transform and to hold the final result
`dest` - will hold the result
Returns:
dest
`transformAffine(Vector4f)`
• transformAffine

```Vector4f transformAffine​(float x,
float y,
float z,
float w,
Vector4f dest)```
Transform/multiply the 4D-vector `(x, y, z, w)` by assuming that `this` matrix represents an `affine` transformation (i.e. its last row is equal to `(0, 0, 0, 1)`) and store the result in `dest`.
Parameters:
`x` - the x coordinate of the direction to transform
`y` - the y coordinate of the direction to transform
`z` - the z coordinate of the direction to transform
`w` - the w coordinate of the direction to transform
`dest` - will hold the result
Returns:
dest
• scale

```Matrix4f scale​(Vector3fc xyz,
Matrix4f dest)```
Apply scaling to `this` matrix by scaling the base axes by the given `xyz.x`, `xyz.y` and `xyz.z` factors, respectively and store the result in `dest`.

If `M` is `this` matrix and `S` the scaling matrix, then the new matrix will be `M * S`. So when transforming a vector `v` with the new matrix by using `M * S * v` , the scaling will be applied first!

Parameters:
`xyz` - the factors of the x, y and z component, respectively
`dest` - will hold the result
Returns:
dest
• scale

```Matrix4f scale​(float xyz,
Matrix4f dest)```
Apply scaling to this matrix by uniformly scaling all base axes by the given `xyz` factor and store the result in `dest`.

If `M` is `this` matrix and `S` the scaling matrix, then the new matrix will be `M * S`. So when transforming a vector `v` with the new matrix by using `M * S * v`, the scaling will be applied first!

Individual scaling of all three axes can be applied using `scale(float, float, float, Matrix4f)`.

Parameters:
`xyz` - the factor for all components
`dest` - will hold the result
Returns:
dest
`scale(float, float, float, Matrix4f)`
• scale

```Matrix4f scale​(float x,
float y,
float z,
Matrix4f dest)```
Apply scaling to `this` matrix by scaling the base axes by the given x, y and z factors and store the result in `dest`.

If `M` is `this` matrix and `S` the scaling matrix, then the new matrix will be `M * S`. So when transforming a vector `v` with the new matrix by using `M * S * v` , the scaling will be applied first!

Parameters:
`x` - the factor of the x component
`y` - the factor of the y component
`z` - the factor of the z component
`dest` - will hold the result
Returns:
dest
• scaleAround

```Matrix4f scaleAround​(float sx,
float sy,
float sz,
float ox,
float oy,
float oz,
Matrix4f dest)```
Apply scaling to `this` matrix by scaling the base axes by the given sx, sy and sz factors while using `(ox, oy, oz)` as the scaling origin, and store the result in `dest`.

If `M` is `this` matrix and `S` the scaling matrix, then the new matrix will be `M * S`. So when transforming a vector `v` with the new matrix by using `M * S * v` , the scaling will be applied first!

This method is equivalent to calling: `translate(ox, oy, oz, dest).scale(sx, sy, sz).translate(-ox, -oy, -oz)`

Parameters:
`sx` - the scaling factor of the x component
`sy` - the scaling factor of the y component
`sz` - the scaling factor of the z component
`ox` - the x coordinate of the scaling origin
`oy` - the y coordinate of the scaling origin
`oz` - the z coordinate of the scaling origin
`dest` - will hold the result
Returns:
dest
• scaleAround

```Matrix4f scaleAround​(float factor,
float ox,
float oy,
float oz,
Matrix4f dest)```
Apply scaling to this matrix by scaling all three base axes by the given `factor` while using `(ox, oy, oz)` as the scaling origin, and store the result in `dest`.

If `M` is `this` matrix and `S` the scaling matrix, then the new matrix will be `M * S`. So when transforming a vector `v` with the new matrix by using `M * S * v`, the scaling will be applied first!

This method is equivalent to calling: `translate(ox, oy, oz, dest).scale(factor).translate(-ox, -oy, -oz)`

Parameters:
`factor` - the scaling factor for all three axes
`ox` - the x coordinate of the scaling origin
`oy` - the y coordinate of the scaling origin
`oz` - the z coordinate of the scaling origin
`dest` - will hold the result
Returns:
this
• scaleLocal

```Matrix4f scaleLocal​(float xyz,
Matrix4f dest)```
Pre-multiply scaling to `this` matrix by scaling all base axes by the given `xyz` factor, and store the result in `dest`.

If `M` is `this` matrix and `S` the scaling matrix, then the new matrix will be `S * M`. So when transforming a vector `v` with the new matrix by using `S * M * v` , the scaling will be applied last!

Parameters:
`xyz` - the factor to scale all three base axes by
`dest` - will hold the result
Returns:
dest
• scaleLocal

```Matrix4f scaleLocal​(float x,
float y,
float z,
Matrix4f dest)```
Pre-multiply scaling to `this` matrix by scaling the base axes by the given x, y and z factors and store the result in `dest`.

If `M` is `this` matrix and `S` the scaling matrix, then the new matrix will be `S * M`. So when transforming a vector `v` with the new matrix by using `S * M * v` , the scaling will be applied last!

Parameters:
`x` - the factor of the x component
`y` - the factor of the y component
`z` - the factor of the z component
`dest` - will hold the result
Returns:
dest
• scaleAroundLocal

```Matrix4f scaleAroundLocal​(float sx,
float sy,
float sz,
float ox,
float oy,
float oz,
Matrix4f dest)```
Pre-multiply scaling to `this` matrix by scaling the base axes by the given sx, sy and sz factors while using the given `(ox, oy, oz)` as the scaling origin, and store the result in `dest`.

If `M` is `this` matrix and `S` the scaling matrix, then the new matrix will be `S * M`. So when transforming a vector `v` with the new matrix by using `S * M * v` , the scaling will be applied last!

This method is equivalent to calling: `new Matrix4f().translate(ox, oy, oz).scale(sx, sy, sz).translate(-ox, -oy, -oz).mul(this, dest)`

Parameters:
`sx` - the scaling factor of the x component
`sy` - the scaling factor of the y component
`sz` - the scaling factor of the z component
`ox` - the x coordinate of the scaling origin
`oy` - the y coordinate of the scaling origin
`oz` - the z coordinate of the scaling origin
`dest` - will hold the result
Returns:
dest
• scaleAroundLocal

```Matrix4f scaleAroundLocal​(float factor,
float ox,
float oy,
float oz,
Matrix4f dest)```
Pre-multiply scaling to this matrix by scaling all three base axes by the given `factor` while using `(ox, oy, oz)` as the scaling origin, and store the result in `dest`.

If `M` is `this` matrix and `S` the scaling matrix, then the new matrix will be `S * M`. So when transforming a vector `v` with the new matrix by using `S * M * v`, the scaling will be applied last!

This method is equivalent to calling: `new Matrix4f().translate(ox, oy, oz).scale(factor).translate(-ox, -oy, -oz).mul(this, dest)`

Parameters:
`factor` - the scaling factor for all three axes
`ox` - the x coordinate of the scaling origin
`oy` - the y coordinate of the scaling origin
`oz` - the z coordinate of the scaling origin
`dest` - will hold the result
Returns:
this
• rotateX

```Matrix4f rotateX​(float ang,
Matrix4f dest)```
Apply rotation about the X axis to this matrix by rotating the given amount of radians and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the rotation will be applied first!

Reference: http://en.wikipedia.org

Parameters:
`ang` - the angle in radians
`dest` - will hold the result
Returns:
dest
• rotateY

```Matrix4f rotateY​(float ang,
Matrix4f dest)```
Apply rotation about the Y axis to this matrix by rotating the given amount of radians and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the rotation will be applied first!

Reference: http://en.wikipedia.org

Parameters:
`ang` - the angle in radians
`dest` - will hold the result
Returns:
dest
• rotateZ

```Matrix4f rotateZ​(float ang,
Matrix4f dest)```
Apply rotation about the Z axis to this matrix by rotating the given amount of radians and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the rotation will be applied first!

Reference: http://en.wikipedia.org

Parameters:
`ang` - the angle in radians
`dest` - will hold the result
Returns:
dest
• rotateTowardsXY

```Matrix4f rotateTowardsXY​(float dirX,
float dirY,
Matrix4f dest)```
Apply rotation about the Z axis to align the local `+X` towards `(dirX, dirY)` and store the result in `dest`.

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the rotation will be applied first!

The vector `(dirX, dirY)` must be a unit vector.

Parameters:
`dirX` - the x component of the normalized direction
`dirY` - the y component of the normalized direction
`dest` - will hold the result
Returns:
this
• rotateXYZ

```Matrix4f rotateXYZ​(float angleX,
float angleY,
float angleZ,
Matrix4f dest)```
Apply rotation of `angleX` radians about the X axis, followed by a rotation of `angleY` radians about the Y axis and followed by a rotation of `angleZ` radians about the Z axis and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the rotation will be applied first!

This method is equivalent to calling: `rotateX(angleX, dest).rotateY(angleY).rotateZ(angleZ)`

Parameters:
`angleX` - the angle to rotate about X
`angleY` - the angle to rotate about Y
`angleZ` - the angle to rotate about Z
`dest` - will hold the result
Returns:
dest
• rotateAffineXYZ

```Matrix4f rotateAffineXYZ​(float angleX,
float angleY,
float angleZ,
Matrix4f dest)```
Apply rotation of `angleX` radians about the X axis, followed by a rotation of `angleY` radians about the Y axis and followed by a rotation of `angleZ` radians about the Z axis and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

This method assumes that `this` matrix represents an `affine` transformation (i.e. its last row is equal to `(0, 0, 0, 1)`) and can be used to speed up matrix multiplication if the matrix only represents affine transformations, such as translation, rotation, scaling and shearing (in any combination).

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the rotation will be applied first!

Parameters:
`angleX` - the angle to rotate about X
`angleY` - the angle to rotate about Y
`angleZ` - the angle to rotate about Z
`dest` - will hold the result
Returns:
dest
• rotateZYX

```Matrix4f rotateZYX​(float angleZ,
float angleY,
float angleX,
Matrix4f dest)```
Apply rotation of `angleZ` radians about the Z axis, followed by a rotation of `angleY` radians about the Y axis and followed by a rotation of `angleX` radians about the X axis and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the rotation will be applied first!

This method is equivalent to calling: `rotateZ(angleZ, dest).rotateY(angleY).rotateX(angleX)`

Parameters:
`angleZ` - the angle to rotate about Z
`angleY` - the angle to rotate about Y
`angleX` - the angle to rotate about X
`dest` - will hold the result
Returns:
dest
• rotateAffineZYX

```Matrix4f rotateAffineZYX​(float angleZ,
float angleY,
float angleX,
Matrix4f dest)```
Apply rotation of `angleZ` radians about the Z axis, followed by a rotation of `angleY` radians about the Y axis and followed by a rotation of `angleX` radians about the X axis and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

This method assumes that `this` matrix represents an `affine` transformation (i.e. its last row is equal to `(0, 0, 0, 1)`) and can be used to speed up matrix multiplication if the matrix only represents affine transformations, such as translation, rotation, scaling and shearing (in any combination).

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the rotation will be applied first!

Parameters:
`angleZ` - the angle to rotate about Z
`angleY` - the angle to rotate about Y
`angleX` - the angle to rotate about X
`dest` - will hold the result
Returns:
dest
• rotateYXZ

```Matrix4f rotateYXZ​(float angleY,
float angleX,
float angleZ,
Matrix4f dest)```
Apply rotation of `angleY` radians about the Y axis, followed by a rotation of `angleX` radians about the X axis and followed by a rotation of `angleZ` radians about the Z axis and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the rotation will be applied first!

This method is equivalent to calling: `rotateY(angleY, dest).rotateX(angleX).rotateZ(angleZ)`

Parameters:
`angleY` - the angle to rotate about Y
`angleX` - the angle to rotate about X
`angleZ` - the angle to rotate about Z
`dest` - will hold the result
Returns:
dest
• rotateAffineYXZ

```Matrix4f rotateAffineYXZ​(float angleY,
float angleX,
float angleZ,
Matrix4f dest)```
Apply rotation of `angleY` radians about the Y axis, followed by a rotation of `angleX` radians about the X axis and followed by a rotation of `angleZ` radians about the Z axis and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

This method assumes that `this` matrix represents an `affine` transformation (i.e. its last row is equal to `(0, 0, 0, 1)`) and can be used to speed up matrix multiplication if the matrix only represents affine transformations, such as translation, rotation, scaling and shearing (in any combination).

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the rotation will be applied first!

Parameters:
`angleY` - the angle to rotate about Y
`angleX` - the angle to rotate about X
`angleZ` - the angle to rotate about Z
`dest` - will hold the result
Returns:
dest
• rotate

```Matrix4f rotate​(float ang,
float x,
float y,
float z,
Matrix4f dest)```
Apply rotation to this matrix by rotating the given amount of radians about the specified `(x, y, z)` axis and store the result in `dest`.

The axis described by the three components needs to be a unit vector.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the rotation will be applied first!

Reference: http://en.wikipedia.org

Parameters:
`ang` - the angle in radians
`x` - the x component of the axis
`y` - the y component of the axis
`z` - the z component of the axis
`dest` - will hold the result
Returns:
dest
• rotateTranslation

```Matrix4f rotateTranslation​(float ang,
float x,
float y,
float z,
Matrix4f dest)```
Apply rotation to this matrix, which is assumed to only contain a translation, by rotating the given amount of radians about the specified `(x, y, z)` axis and store the result in `dest`.

This method assumes `this` to only contain a translation.

The axis described by the three components needs to be a unit vector.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the rotation will be applied first!

Reference: http://en.wikipedia.org

Parameters:
`ang` - the angle in radians
`x` - the x component of the axis
`y` - the y component of the axis
`z` - the z component of the axis
`dest` - will hold the result
Returns:
dest
• rotateAffine

```Matrix4f rotateAffine​(float ang,
float x,
float y,
float z,
Matrix4f dest)```
Apply rotation to this `affine` matrix by rotating the given amount of radians about the specified `(x, y, z)` axis and store the result in `dest`.

This method assumes `this` to be `affine`.

The axis described by the three components needs to be a unit vector.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the rotation will be applied first!

Reference: http://en.wikipedia.org

Parameters:
`ang` - the angle in radians
`x` - the x component of the axis
`y` - the y component of the axis
`z` - the z component of the axis
`dest` - will hold the result
Returns:
dest
• rotateLocal

```Matrix4f rotateLocal​(float ang,
float x,
float y,
float z,
Matrix4f dest)```
Pre-multiply a rotation to this matrix by rotating the given amount of radians about the specified `(x, y, z)` axis and store the result in `dest`.

The axis described by the three components needs to be a unit vector.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `R * M`. So when transforming a vector `v` with the new matrix by using `R * M * v`, the rotation will be applied last!

Reference: http://en.wikipedia.org

Parameters:
`ang` - the angle in radians
`x` - the x component of the axis
`y` - the y component of the axis
`z` - the z component of the axis
`dest` - will hold the result
Returns:
dest
• rotateLocalX

```Matrix4f rotateLocalX​(float ang,
Matrix4f dest)```
Pre-multiply a rotation around the X axis to this matrix by rotating the given amount of radians about the X axis and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `R * M`. So when transforming a vector `v` with the new matrix by using `R * M * v`, the rotation will be applied last!

Reference: http://en.wikipedia.org

Parameters:
`ang` - the angle in radians to rotate about the X axis
`dest` - will hold the result
Returns:
dest
• rotateLocalY

```Matrix4f rotateLocalY​(float ang,
Matrix4f dest)```
Pre-multiply a rotation around the Y axis to this matrix by rotating the given amount of radians about the Y axis and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `R * M`. So when transforming a vector `v` with the new matrix by using `R * M * v`, the rotation will be applied last!

Reference: http://en.wikipedia.org

Parameters:
`ang` - the angle in radians to rotate about the Y axis
`dest` - will hold the result
Returns:
dest
• rotateLocalZ

```Matrix4f rotateLocalZ​(float ang,
Matrix4f dest)```
Pre-multiply a rotation around the Z axis to this matrix by rotating the given amount of radians about the Z axis and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `R` the rotation matrix, then the new matrix will be `R * M`. So when transforming a vector `v` with the new matrix by using `R * M * v`, the rotation will be applied last!

Reference: http://en.wikipedia.org

Parameters:
`ang` - the angle in radians to rotate about the Z axis
`dest` - will hold the result
Returns:
dest
• translate

```Matrix4f translate​(Vector3fc offset,
Matrix4f dest)```
Apply a translation to this matrix by translating by the given number of units in x, y and z and store the result in `dest`.

If `M` is `this` matrix and `T` the translation matrix, then the new matrix will be `M * T`. So when transforming a vector `v` with the new matrix by using `M * T * v`, the translation will be applied first!

Parameters:
`offset` - the number of units in x, y and z by which to translate
`dest` - will hold the result
Returns:
dest
• translate

```Matrix4f translate​(float x,
float y,
float z,
Matrix4f dest)```
Apply a translation to this matrix by translating by the given number of units in x, y and z and store the result in `dest`.

If `M` is `this` matrix and `T` the translation matrix, then the new matrix will be `M * T`. So when transforming a vector `v` with the new matrix by using `M * T * v`, the translation will be applied first!

Parameters:
`x` - the offset to translate in x
`y` - the offset to translate in y
`z` - the offset to translate in z
`dest` - will hold the result
Returns:
dest
• translateLocal

```Matrix4f translateLocal​(Vector3fc offset,
Matrix4f dest)```
Pre-multiply a translation to this matrix by translating by the given number of units in x, y and z and store the result in `dest`.

If `M` is `this` matrix and `T` the translation matrix, then the new matrix will be `T * M`. So when transforming a vector `v` with the new matrix by using `T * M * v`, the translation will be applied last!

Parameters:
`offset` - the number of units in x, y and z by which to translate
`dest` - will hold the result
Returns:
dest
• translateLocal

```Matrix4f translateLocal​(float x,
float y,
float z,
Matrix4f dest)```
Pre-multiply a translation to this matrix by translating by the given number of units in x, y and z and store the result in `dest`.

If `M` is `this` matrix and `T` the translation matrix, then the new matrix will be `T * M`. So when transforming a vector `v` with the new matrix by using `T * M * v`, the translation will be applied last!

Parameters:
`x` - the offset to translate in x
`y` - the offset to translate in y
`z` - the offset to translate in z
`dest` - will hold the result
Returns:
dest
• ortho

```Matrix4f ortho​(float left,
float right,
float bottom,
float top,
float zNear,
float zFar,
boolean zZeroToOne,
Matrix4f dest)```
Apply an orthographic projection transformation for a right-handed coordinate system using the given NDC z range to this matrix and store the result in `dest`.

If `M` is `this` matrix and `O` the orthographic projection matrix, then the new matrix will be `M * O`. So when transforming a vector `v` with the new matrix by using `M * O * v`, the orthographic projection transformation will be applied first! Reference: http://www.songho.ca

Parameters:
`left` - the distance from the center to the left frustum edge
`right` - the distance from the center to the right frustum edge
`bottom` - the distance from the center to the bottom frustum edge
`top` - the distance from the center to the top frustum edge
`zNear` - near clipping plane distance
`zFar` - far clipping plane distance
`zZeroToOne` - whether to use Vulkan's and Direct3D's NDC z range of `[0..+1]` when `true` or whether to use OpenGL's NDC z range of `[-1..+1]` when `false`
`dest` - will hold the result
Returns:
dest
• ortho

```Matrix4f ortho​(float left,
float right,
float bottom,
float top,
float zNear,
float zFar,
Matrix4f dest)```
Apply an orthographic projection transformation for a right-handed coordinate system using OpenGL's NDC z range of `[-1..+1]` to this matrix and store the result in `dest`.

If `M` is `this` matrix and `O` the orthographic projection matrix, then the new matrix will be `M * O`. So when transforming a vector `v` with the new matrix by using `M * O * v`, the orthographic projection transformation will be applied first!

Reference: http://www.songho.ca

Parameters:
`left` - the distance from the center to the left frustum edge
`right` - the distance from the center to the right frustum edge
`bottom` - the distance from the center to the bottom frustum edge
`top` - the distance from the center to the top frustum edge
`zNear` - near clipping plane distance
`zFar` - far clipping plane distance
`dest` - will hold the result
Returns:
dest
• orthoLH

```Matrix4f orthoLH​(float left,
float right,
float bottom,
float top,
float zNear,
float zFar,
boolean zZeroToOne,
Matrix4f dest)```
Apply an orthographic projection transformation for a left-handed coordiante system using the given NDC z range to this matrix and store the result in `dest`.

If `M` is `this` matrix and `O` the orthographic projection matrix, then the new matrix will be `M * O`. So when transforming a vector `v` with the new matrix by using `M * O * v`, the orthographic projection transformation will be applied first!

Reference: http://www.songho.ca

Parameters:
`left` - the distance from the center to the left frustum edge
`right` - the distance from the center to the right frustum edge
`bottom` - the distance from the center to the bottom frustum edge
`top` - the distance from the center to the top frustum edge
`zNear` - near clipping plane distance
`zFar` - far clipping plane distance
`zZeroToOne` - whether to use Vulkan's and Direct3D's NDC z range of `[0..+1]` when `true` or whether to use OpenGL's NDC z range of `[-1..+1]` when `false`
`dest` - will hold the result
Returns:
dest
• orthoLH

```Matrix4f orthoLH​(float left,
float right,
float bottom,
float top,
float zNear,
float zFar,
Matrix4f dest)```
Apply an orthographic projection transformation for a left-handed coordiante system using OpenGL's NDC z range of `[-1..+1]` to this matrix and store the result in `dest`.

If `M` is `this` matrix and `O` the orthographic projection matrix, then the new matrix will be `M * O`. So when transforming a vector `v` with the new matrix by using `M * O * v`, the orthographic projection transformation will be applied first!

Reference: http://www.songho.ca

Parameters:
`left` - the distance from the center to the left frustum edge
`right` - the distance from the center to the right frustum edge
`bottom` - the distance from the center to the bottom frustum edge
`top` - the distance from the center to the top frustum edge
`zNear` - near clipping plane distance
`zFar` - far clipping plane distance
`dest` - will hold the result
Returns:
dest
• orthoSymmetric

```Matrix4f orthoSymmetric​(float width,
float height,
float zNear,
float zFar,
boolean zZeroToOne,
Matrix4f dest)```
Apply a symmetric orthographic projection transformation for a right-handed coordinate system using the given NDC z range to this matrix and store the result in `dest`.

This method is equivalent to calling `ortho()` with `left=-width/2`, `right=+width/2`, `bottom=-height/2` and `top=+height/2`.

If `M` is `this` matrix and `O` the orthographic projection matrix, then the new matrix will be `M * O`. So when transforming a vector `v` with the new matrix by using `M * O * v`, the orthographic projection transformation will be applied first!

Reference: http://www.songho.ca

Parameters:
`width` - the distance between the right and left frustum edges
`height` - the distance between the top and bottom frustum edges
`zNear` - near clipping plane distance
`zFar` - far clipping plane distance
`dest` - will hold the result
`zZeroToOne` - whether to use Vulkan's and Direct3D's NDC z range of `[0..+1]` when `true` or whether to use OpenGL's NDC z range of `[-1..+1]` when `false`
Returns:
dest
• orthoSymmetric

```Matrix4f orthoSymmetric​(float width,
float height,
float zNear,
float zFar,
Matrix4f dest)```
Apply a symmetric orthographic projection transformation for a right-handed coordinate system using OpenGL's NDC z range of `[-1..+1]` to this matrix and store the result in `dest`.

This method is equivalent to calling `ortho()` with `left=-width/2`, `right=+width/2`, `bottom=-height/2` and `top=+height/2`.

If `M` is `this` matrix and `O` the orthographic projection matrix, then the new matrix will be `M * O`. So when transforming a vector `v` with the new matrix by using `M * O * v`, the orthographic projection transformation will be applied first!

Reference: http://www.songho.ca

Parameters:
`width` - the distance between the right and left frustum edges
`height` - the distance between the top and bottom frustum edges
`zNear` - near clipping plane distance
`zFar` - far clipping plane distance
`dest` - will hold the result
Returns:
dest
• orthoSymmetricLH

```Matrix4f orthoSymmetricLH​(float width,
float height,
float zNear,
float zFar,
boolean zZeroToOne,
Matrix4f dest)```
Apply a symmetric orthographic projection transformation for a left-handed coordinate system using the given NDC z range to this matrix and store the result in `dest`.

This method is equivalent to calling `orthoLH()` with `left=-width/2`, `right=+width/2`, `bottom=-height/2` and `top=+height/2`.

If `M` is `this` matrix and `O` the orthographic projection matrix, then the new matrix will be `M * O`. So when transforming a vector `v` with the new matrix by using `M * O * v`, the orthographic projection transformation will be applied first!

Reference: http://www.songho.ca

Parameters:
`width` - the distance between the right and left frustum edges
`height` - the distance between the top and bottom frustum edges
`zNear` - near clipping plane distance
`zFar` - far clipping plane distance
`dest` - will hold the result
`zZeroToOne` - whether to use Vulkan's and Direct3D's NDC z range of `[0..+1]` when `true` or whether to use OpenGL's NDC z range of `[-1..+1]` when `false`
Returns:
dest
• orthoSymmetricLH

```Matrix4f orthoSymmetricLH​(float width,
float height,
float zNear,
float zFar,
Matrix4f dest)```
Apply a symmetric orthographic projection transformation for a left-handed coordinate system using OpenGL's NDC z range of `[-1..+1]` to this matrix and store the result in `dest`.

This method is equivalent to calling `orthoLH()` with `left=-width/2`, `right=+width/2`, `bottom=-height/2` and `top=+height/2`.

If `M` is `this` matrix and `O` the orthographic projection matrix, then the new matrix will be `M * O`. So when transforming a vector `v` with the new matrix by using `M * O * v`, the orthographic projection transformation will be applied first!

Reference: http://www.songho.ca

Parameters:
`width` - the distance between the right and left frustum edges
`height` - the distance between the top and bottom frustum edges
`zNear` - near clipping plane distance
`zFar` - far clipping plane distance
`dest` - will hold the result
Returns:
dest
• ortho2D

```Matrix4f ortho2D​(float left,
float right,
float bottom,
float top,
Matrix4f dest)```
Apply an orthographic projection transformation for a right-handed coordinate system to this matrix and store the result in `dest`.

This method is equivalent to calling `ortho()` with `zNear=-1` and `zFar=+1`.

If `M` is `this` matrix and `O` the orthographic projection matrix, then the new matrix will be `M * O`. So when transforming a vector `v` with the new matrix by using `M * O * v`, the orthographic projection transformation will be applied first!

Reference: http://www.songho.ca

Parameters:
`left` - the distance from the center to the left frustum edge
`right` - the distance from the center to the right frustum edge
`bottom` - the distance from the center to the bottom frustum edge
`top` - the distance from the center to the top frustum edge
`dest` - will hold the result
Returns:
dest
`ortho(float, float, float, float, float, float, Matrix4f)`
• ortho2DLH

```Matrix4f ortho2DLH​(float left,
float right,
float bottom,
float top,
Matrix4f dest)```
Apply an orthographic projection transformation for a left-handed coordinate system to this matrix and store the result in `dest`.

This method is equivalent to calling `orthoLH()` with `zNear=-1` and `zFar=+1`.

If `M` is `this` matrix and `O` the orthographic projection matrix, then the new matrix will be `M * O`. So when transforming a vector `v` with the new matrix by using `M * O * v`, the orthographic projection transformation will be applied first!

Reference: http://www.songho.ca

Parameters:
`left` - the distance from the center to the left frustum edge
`right` - the distance from the center to the right frustum edge
`bottom` - the distance from the center to the bottom frustum edge
`top` - the distance from the center to the top frustum edge
`dest` - will hold the result
Returns:
dest
`orthoLH(float, float, float, float, float, float, Matrix4f)`
• lookAlong

```Matrix4f lookAlong​(Vector3fc dir,
Vector3fc up,
Matrix4f dest)```
Apply a rotation transformation to this matrix to make `-z` point along `dir` and store the result in `dest`.

If `M` is `this` matrix and `L` the lookalong rotation matrix, then the new matrix will be `M * L`. So when transforming a vector `v` with the new matrix by using `M * L * v`, the lookalong rotation transformation will be applied first!

This is equivalent to calling `lookAt` with `eye = (0, 0, 0)` and `center = dir`.

Parameters:
`dir` - the direction in space to look along
`up` - the direction of 'up'
`dest` - will hold the result
Returns:
dest
`lookAlong(float, float, float, float, float, float, Matrix4f)`, `lookAt(Vector3fc, Vector3fc, Vector3fc, Matrix4f)`
• lookAlong

```Matrix4f lookAlong​(float dirX,
float dirY,
float dirZ,
float upX,
float upY,
float upZ,
Matrix4f dest)```
Apply a rotation transformation to this matrix to make `-z` point along `dir` and store the result in `dest`.

If `M` is `this` matrix and `L` the lookalong rotation matrix, then the new matrix will be `M * L`. So when transforming a vector `v` with the new matrix by using `M * L * v`, the lookalong rotation transformation will be applied first!

This is equivalent to calling `lookAt()` with `eye = (0, 0, 0)` and `center = dir`.

Parameters:
`dirX` - the x-coordinate of the direction to look along
`dirY` - the y-coordinate of the direction to look along
`dirZ` - the z-coordinate of the direction to look along
`upX` - the x-coordinate of the up vector
`upY` - the y-coordinate of the up vector
`upZ` - the z-coordinate of the up vector
`dest` - will hold the result
Returns:
dest
`lookAt(float, float, float, float, float, float, float, float, float, Matrix4f)`
• lookAt

```Matrix4f lookAt​(Vector3fc eye,
Vector3fc center,
Vector3fc up,
Matrix4f dest)```
Apply a "lookat" transformation to this matrix for a right-handed coordinate system, that aligns `-z` with `center - eye` and store the result in `dest`.

If `M` is `this` matrix and `L` the lookat matrix, then the new matrix will be `M * L`. So when transforming a vector `v` with the new matrix by using `M * L * v`, the lookat transformation will be applied first!

Parameters:
`eye` - the position of the camera
`center` - the point in space to look at
`up` - the direction of 'up'
`dest` - will hold the result
Returns:
dest
`lookAt(float, float, float, float, float, float, float, float, float, Matrix4f)`
• lookAt

```Matrix4f lookAt​(float eyeX,
float eyeY,
float eyeZ,
float centerX,
float centerY,
float centerZ,
float upX,
float upY,
float upZ,
Matrix4f dest)```
Apply a "lookat" transformation to this matrix for a right-handed coordinate system, that aligns `-z` with `center - eye` and store the result in `dest`.

If `M` is `this` matrix and `L` the lookat matrix, then the new matrix will be `M * L`. So when transforming a vector `v` with the new matrix by using `M * L * v`, the lookat transformation will be applied first!

Parameters:
`eyeX` - the x-coordinate of the eye/camera location
`eyeY` - the y-coordinate of the eye/camera location
`eyeZ` - the z-coordinate of the eye/camera location
`centerX` - the x-coordinate of the point to look at
`centerY` - the y-coordinate of the point to look at
`centerZ` - the z-coordinate of the point to look at
`upX` - the x-coordinate of the up vector
`upY` - the y-coordinate of the up vector
`upZ` - the z-coordinate of the up vector
`dest` - will hold the result
Returns:
dest
`lookAt(Vector3fc, Vector3fc, Vector3fc, Matrix4f)`
• lookAtPerspective

```Matrix4f lookAtPerspective​(float eyeX,
float eyeY,
float eyeZ,
float centerX,
float centerY,
float centerZ,
float upX,
float upY,
float upZ,
Matrix4f dest)```
Apply a "lookat" transformation to this matrix for a right-handed coordinate system, that aligns `-z` with `center - eye` and store the result in `dest`.

This method assumes `this` to be a perspective transformation, obtained via `frustum()` or `perspective()` or one of their overloads.

If `M` is `this` matrix and `L` the lookat matrix, then the new matrix will be `M * L`. So when transforming a vector `v` with the new matrix by using `M * L * v`, the lookat transformation will be applied first!

Parameters:
`eyeX` - the x-coordinate of the eye/camera location
`eyeY` - the y-coordinate of the eye/camera location
`eyeZ` - the z-coordinate of the eye/camera location
`centerX` - the x-coordinate of the point to look at
`centerY` - the y-coordinate of the point to look at
`centerZ` - the z-coordinate of the point to look at
`upX` - the x-coordinate of the up vector
`upY` - the y-coordinate of the up vector
`upZ` - the z-coordinate of the up vector
`dest` - will hold the result
Returns:
dest
• lookAtLH

```Matrix4f lookAtLH​(Vector3fc eye,
Vector3fc center,
Vector3fc up,
Matrix4f dest)```
Apply a "lookat" transformation to this matrix for a left-handed coordinate system, that aligns `+z` with `center - eye` and store the result in `dest`.

If `M` is `this` matrix and `L` the lookat matrix, then the new matrix will be `M * L`. So when transforming a vector `v` with the new matrix by using `M * L * v`, the lookat transformation will be applied first!

Parameters:
`eye` - the position of the camera
`center` - the point in space to look at
`up` - the direction of 'up'
`dest` - will hold the result
Returns:
dest
`lookAtLH(float, float, float, float, float, float, float, float, float, Matrix4f)`
• lookAtLH

```Matrix4f lookAtLH​(float eyeX,
float eyeY,
float eyeZ,
float centerX,
float centerY,
float centerZ,
float upX,
float upY,
float upZ,
Matrix4f dest)```
Apply a "lookat" transformation to this matrix for a left-handed coordinate system, that aligns `+z` with `center - eye` and store the result in `dest`.

If `M` is `this` matrix and `L` the lookat matrix, then the new matrix will be `M * L`. So when transforming a vector `v` with the new matrix by using `M * L * v`, the lookat transformation will be applied first!

Parameters:
`eyeX` - the x-coordinate of the eye/camera location
`eyeY` - the y-coordinate of the eye/camera location
`eyeZ` - the z-coordinate of the eye/camera location
`centerX` - the x-coordinate of the point to look at
`centerY` - the y-coordinate of the point to look at
`centerZ` - the z-coordinate of the point to look at
`upX` - the x-coordinate of the up vector
`upY` - the y-coordinate of the up vector
`upZ` - the z-coordinate of the up vector
`dest` - will hold the result
Returns:
dest
`lookAtLH(Vector3fc, Vector3fc, Vector3fc, Matrix4f)`
• lookAtPerspectiveLH

```Matrix4f lookAtPerspectiveLH​(float eyeX,
float eyeY,
float eyeZ,
float centerX,
float centerY,
float centerZ,
float upX,
float upY,
float upZ,
Matrix4f dest)```
Apply a "lookat" transformation to this matrix for a left-handed coordinate system, that aligns `+z` with `center - eye` and store the result in `dest`.

This method assumes `this` to be a perspective transformation, obtained via `frustumLH()` or `perspectiveLH()` or one of their overloads.

If `M` is `this` matrix and `L` the lookat matrix, then the new matrix will be `M * L`. So when transforming a vector `v` with the new matrix by using `M * L * v`, the lookat transformation will be applied first!

Parameters:
`eyeX` - the x-coordinate of the eye/camera location
`eyeY` - the y-coordinate of the eye/camera location
`eyeZ` - the z-coordinate of the eye/camera location
`centerX` - the x-coordinate of the point to look at
`centerY` - the y-coordinate of the point to look at
`centerZ` - the z-coordinate of the point to look at
`upX` - the x-coordinate of the up vector
`upY` - the y-coordinate of the up vector
`upZ` - the z-coordinate of the up vector
`dest` - will hold the result
Returns:
dest
• perspective

```Matrix4f perspective​(float fovy,
float aspect,
float zNear,
float zFar,
boolean zZeroToOne,
Matrix4f dest)```
Apply a symmetric perspective projection frustum transformation for a right-handed coordinate system using the given NDC z range to this matrix and store the result in `dest`.

If `M` is `this` matrix and `P` the perspective projection matrix, then the new matrix will be `M * P`. So when transforming a vector `v` with the new matrix by using `M * P * v`, the perspective projection will be applied first!

Parameters:
`fovy` - the vertical field of view in radians (must be greater than zero and less than `PI`)
`aspect` - the aspect ratio (i.e. width / height; must be greater than zero)
`zNear` - near clipping plane distance. If the special value `Float.POSITIVE_INFINITY` is used, the near clipping plane will be at positive infinity. In that case, `zFar` may not also be `Float.POSITIVE_INFINITY`.
`zFar` - far clipping plane distance. If the special value `Float.POSITIVE_INFINITY` is used, the far clipping plane will be at positive infinity. In that case, `zNear` may not also be `Float.POSITIVE_INFINITY`.
`dest` - will hold the result
`zZeroToOne` - whether to use Vulkan's and Direct3D's NDC z range of `[0..+1]` when `true` or whether to use OpenGL's NDC z range of `[-1..+1]` when `false`
Returns:
dest
• perspective

```Matrix4f perspective​(float fovy,
float aspect,
float zNear,
float zFar,
Matrix4f dest)```
Apply a symmetric perspective projection frustum transformation for a right-handed coordinate system using OpenGL's NDC z range of `[-1..+1]` to this matrix and store the result in `dest`.

If `M` is `this` matrix and `P` the perspective projection matrix, then the new matrix will be `M * P`. So when transforming a vector `v` with the new matrix by using `M * P * v`, the perspective projection will be applied first!

Parameters:
`fovy` - the vertical field of view in radians (must be greater than zero and less than `PI`)
`aspect` - the aspect ratio (i.e. width / height; must be greater than zero)
`zNear` - near clipping plane distance. If the special value `Float.POSITIVE_INFINITY` is used, the near clipping plane will be at positive infinity. In that case, `zFar` may not also be `Float.POSITIVE_INFINITY`.
`zFar` - far clipping plane distance. If the special value `Float.POSITIVE_INFINITY` is used, the far clipping plane will be at positive infinity. In that case, `zNear` may not also be `Float.POSITIVE_INFINITY`.
`dest` - will hold the result
Returns:
dest
• perspectiveLH

```Matrix4f perspectiveLH​(float fovy,
float aspect,
float zNear,
float zFar,
boolean zZeroToOne,
Matrix4f dest)```
Apply a symmetric perspective projection frustum transformation for a left-handed coordinate system using the given NDC z range to this matrix and store the result in `dest`.

If `M` is `this` matrix and `P` the perspective projection matrix, then the new matrix will be `M * P`. So when transforming a vector `v` with the new matrix by using `M * P * v`, the perspective projection will be applied first!

Parameters:
`fovy` - the vertical field of view in radians (must be greater than zero and less than `PI`)
`aspect` - the aspect ratio (i.e. width / height; must be greater than zero)
`zNear` - near clipping plane distance. If the special value `Float.POSITIVE_INFINITY` is used, the near clipping plane will be at positive infinity. In that case, `zFar` may not also be `Float.POSITIVE_INFINITY`.
`zFar` - far clipping plane distance. If the special value `Float.POSITIVE_INFINITY` is used, the far clipping plane will be at positive infinity. In that case, `zNear` may not also be `Float.POSITIVE_INFINITY`.
`zZeroToOne` - whether to use Vulkan's and Direct3D's NDC z range of `[0..+1]` when `true` or whether to use OpenGL's NDC z range of `[-1..+1]` when `false`
`dest` - will hold the result
Returns:
dest
• perspectiveLH

```Matrix4f perspectiveLH​(float fovy,
float aspect,
float zNear,
float zFar,
Matrix4f dest)```
Apply a symmetric perspective projection frustum transformation for a left-handed coordinate system using OpenGL's NDC z range of `[-1..+1]` to this matrix and store the result in `dest`.

If `M` is `this` matrix and `P` the perspective projection matrix, then the new matrix will be `M * P`. So when transforming a vector `v` with the new matrix by using `M * P * v`, the perspective projection will be applied first!

Parameters:
`fovy` - the vertical field of view in radians (must be greater than zero and less than `PI`)
`aspect` - the aspect ratio (i.e. width / height; must be greater than zero)
`zNear` - near clipping plane distance. If the special value `Float.POSITIVE_INFINITY` is used, the near clipping plane will be at positive infinity. In that case, `zFar` may not also be `Float.POSITIVE_INFINITY`.
`zFar` - far clipping plane distance. If the special value `Float.POSITIVE_INFINITY` is used, the far clipping plane will be at positive infinity. In that case, `zNear` may not also be `Float.POSITIVE_INFINITY`.
`dest` - will hold the result
Returns:
dest
• frustum

```Matrix4f frustum​(float left,
float right,
float bottom,
float top,
float zNear,
float zFar,
boolean zZeroToOne,
Matrix4f dest)```
Apply an arbitrary perspective projection frustum transformation for a right-handed coordinate system using the given NDC z range to this matrix and store the result in `dest`.

If `M` is `this` matrix and `F` the frustum matrix, then the new matrix will be `M * F`. So when transforming a vector `v` with the new matrix by using `M * F * v`, the frustum transformation will be applied first!

Reference: http://www.songho.ca

Parameters:
`left` - the distance along the x-axis to the left frustum edge
`right` - the distance along the x-axis to the right frustum edge
`bottom` - the distance along the y-axis to the bottom frustum edge
`top` - the distance along the y-axis to the top frustum edge
`zNear` - near clipping plane distance. If the special value `Float.POSITIVE_INFINITY` is used, the near clipping plane will be at positive infinity. In that case, `zFar` may not also be `Float.POSITIVE_INFINITY`.
`zFar` - far clipping plane distance. If the special value `Float.POSITIVE_INFINITY` is used, the far clipping plane will be at positive infinity. In that case, `zNear` may not also be `Float.POSITIVE_INFINITY`.
`zZeroToOne` - whether to use Vulkan's and Direct3D's NDC z range of `[0..+1]` when `true` or whether to use OpenGL's NDC z range of `[-1..+1]` when `false`
`dest` - will hold the result
Returns:
dest
• frustum

```Matrix4f frustum​(float left,
float right,
float bottom,
float top,
float zNear,
float zFar,
Matrix4f dest)```
Apply an arbitrary perspective projection frustum transformation for a right-handed coordinate system using OpenGL's NDC z range of `[-1..+1]` to this matrix and store the result in `dest`.

If `M` is `this` matrix and `F` the frustum matrix, then the new matrix will be `M * F`. So when transforming a vector `v` with the new matrix by using `M * F * v`, the frustum transformation will be applied first!

Reference: http://www.songho.ca

Parameters:
`left` - the distance along the x-axis to the left frustum edge
`right` - the distance along the x-axis to the right frustum edge
`bottom` - the distance along the y-axis to the bottom frustum edge
`top` - the distance along the y-axis to the top frustum edge
`zNear` - near clipping plane distance. If the special value `Float.POSITIVE_INFINITY` is used, the near clipping plane will be at positive infinity. In that case, `zFar` may not also be `Float.POSITIVE_INFINITY`.
`zFar` - far clipping plane distance. If the special value `Float.POSITIVE_INFINITY` is used, the far clipping plane will be at positive infinity. In that case, `zNear` may not also be `Float.POSITIVE_INFINITY`.
`dest` - will hold the result
Returns:
dest
• frustumLH

```Matrix4f frustumLH​(float left,
float right,
float bottom,
float top,
float zNear,
float zFar,
boolean zZeroToOne,
Matrix4f dest)```
Apply an arbitrary perspective projection frustum transformation for a left-handed coordinate system using the given NDC z range to this matrix and store the result in `dest`.

If `M` is `this` matrix and `F` the frustum matrix, then the new matrix will be `M * F`. So when transforming a vector `v` with the new matrix by using `M * F * v`, the frustum transformation will be applied first!

Reference: http://www.songho.ca

Parameters:
`left` - the distance along the x-axis to the left frustum edge
`right` - the distance along the x-axis to the right frustum edge
`bottom` - the distance along the y-axis to the bottom frustum edge
`top` - the distance along the y-axis to the top frustum edge
`zNear` - near clipping plane distance. If the special value `Float.POSITIVE_INFINITY` is used, the near clipping plane will be at positive infinity. In that case, `zFar` may not also be `Float.POSITIVE_INFINITY`.
`zFar` - far clipping plane distance. If the special value `Float.POSITIVE_INFINITY` is used, the far clipping plane will be at positive infinity. In that case, `zNear` may not also be `Float.POSITIVE_INFINITY`.
`zZeroToOne` - whether to use Vulkan's and Direct3D's NDC z range of `[0..+1]` when `true` or whether to use OpenGL's NDC z range of `[-1..+1]` when `false`
`dest` - will hold the result
Returns:
dest
• frustumLH

```Matrix4f frustumLH​(float left,
float right,
float bottom,
float top,
float zNear,
float zFar,
Matrix4f dest)```
Apply an arbitrary perspective projection frustum transformation for a left-handed coordinate system using OpenGL's NDC z range of `[-1..+1]` to this matrix and store the result in `dest`.

If `M` is `this` matrix and `F` the frustum matrix, then the new matrix will be `M * F`. So when transforming a vector `v` with the new matrix by using `M * F * v`, the frustum transformation will be applied first!

Reference: http://www.songho.ca

Parameters:
`left` - the distance along the x-axis to the left frustum edge
`right` - the distance along the x-axis to the right frustum edge
`bottom` - the distance along the y-axis to the bottom frustum edge
`top` - the distance along the y-axis to the top frustum edge
`zNear` - near clipping plane distance. If the special value `Float.POSITIVE_INFINITY` is used, the near clipping plane will be at positive infinity. In that case, `zFar` may not also be `Float.POSITIVE_INFINITY`.
`zFar` - far clipping plane distance. If the special value `Float.POSITIVE_INFINITY` is used, the far clipping plane will be at positive infinity. In that case, `zNear` may not also be `Float.POSITIVE_INFINITY`.
`dest` - will hold the result
Returns:
dest
• rotate

```Matrix4f rotate​(Quaternionfc quat,
Matrix4f dest)```
Apply the rotation - and possibly scaling - transformation of the given `Quaternionfc` to this matrix and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `Q` the rotation matrix obtained from the given quaternion, then the new matrix will be `M * Q`. So when transforming a vector `v` with the new matrix by using `M * Q * v`, the quaternion rotation will be applied first!

Reference: http://en.wikipedia.org

Parameters:
`quat` - the `Quaternionfc`
`dest` - will hold the result
Returns:
dest
• rotateAffine

```Matrix4f rotateAffine​(Quaternionfc quat,
Matrix4f dest)```
Apply the rotation - and possibly scaling - transformation of the given `Quaternionfc` to this `affine` matrix and store the result in `dest`.

This method assumes `this` to be `affine`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `Q` the rotation matrix obtained from the given quaternion, then the new matrix will be `M * Q`. So when transforming a vector `v` with the new matrix by using `M * Q * v`, the quaternion rotation will be applied first!

Reference: http://en.wikipedia.org

Parameters:
`quat` - the `Quaternionfc`
`dest` - will hold the result
Returns:
dest
• rotateTranslation

```Matrix4f rotateTranslation​(Quaternionfc quat,
Matrix4f dest)```
Apply the rotation - and possibly scaling - ransformation of the given `Quaternionfc` to this matrix, which is assumed to only contain a translation, and store the result in `dest`.

This method assumes `this` to only contain a translation.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `Q` the rotation matrix obtained from the given quaternion, then the new matrix will be `M * Q`. So when transforming a vector `v` with the new matrix by using `M * Q * v`, the quaternion rotation will be applied first!

Reference: http://en.wikipedia.org

Parameters:
`quat` - the `Quaternionfc`
`dest` - will hold the result
Returns:
dest
• rotateAroundAffine

```Matrix4f rotateAroundAffine​(Quaternionfc quat,
float ox,
float oy,
float oz,
Matrix4f dest)```
Apply the rotation - and possibly scaling - transformation of the given `Quaternionfc` to this `affine` matrix while using `(ox, oy, oz)` as the rotation origin, and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `Q` the rotation matrix obtained from the given quaternion, then the new matrix will be `M * Q`. So when transforming a vector `v` with the new matrix by using `M * Q * v`, the quaternion rotation will be applied first!

This method is only applicable if `this` is an `affine` matrix.

This method is equivalent to calling: `translate(ox, oy, oz, dest).rotate(quat).translate(-ox, -oy, -oz)`

Reference: http://en.wikipedia.org

Parameters:
`quat` - the `Quaternionfc`
`ox` - the x coordinate of the rotation origin
`oy` - the y coordinate of the rotation origin
`oz` - the z coordinate of the rotation origin
`dest` - will hold the result
Returns:
dest
• rotateAround

```Matrix4f rotateAround​(Quaternionfc quat,
float ox,
float oy,
float oz,
Matrix4f dest)```
Apply the rotation - and possibly scaling - transformation of the given `Quaternionfc` to this matrix while using `(ox, oy, oz)` as the rotation origin, and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `Q` the rotation matrix obtained from the given quaternion, then the new matrix will be `M * Q`. So when transforming a vector `v` with the new matrix by using `M * Q * v`, the quaternion rotation will be applied first!

This method is equivalent to calling: `translate(ox, oy, oz, dest).rotate(quat).translate(-ox, -oy, -oz)`

Reference: http://en.wikipedia.org

Parameters:
`quat` - the `Quaternionfc`
`ox` - the x coordinate of the rotation origin
`oy` - the y coordinate of the rotation origin
`oz` - the z coordinate of the rotation origin
`dest` - will hold the result
Returns:
dest
• rotateLocal

```Matrix4f rotateLocal​(Quaternionfc quat,
Matrix4f dest)```
Pre-multiply the rotation - and possibly scaling - transformation of the given `Quaternionfc` to this matrix and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `Q` the rotation matrix obtained from the given quaternion, then the new matrix will be `Q * M`. So when transforming a vector `v` with the new matrix by using `Q * M * v`, the quaternion rotation will be applied last!

Reference: http://en.wikipedia.org

Parameters:
`quat` - the `Quaternionfc`
`dest` - will hold the result
Returns:
dest
• rotateAroundLocal

```Matrix4f rotateAroundLocal​(Quaternionfc quat,
float ox,
float oy,
float oz,
Matrix4f dest)```
Pre-multiply the rotation - and possibly scaling - transformation of the given `Quaternionfc` to this matrix while using `(ox, oy, oz)` as the rotation origin, and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `Q` the rotation matrix obtained from the given quaternion, then the new matrix will be `Q * M`. So when transforming a vector `v` with the new matrix by using `Q * M * v`, the quaternion rotation will be applied last!

This method is equivalent to calling: `translateLocal(-ox, -oy, -oz, dest).rotateLocal(quat).translateLocal(ox, oy, oz)`

Reference: http://en.wikipedia.org

Parameters:
`quat` - the `Quaternionfc`
`ox` - the x coordinate of the rotation origin
`oy` - the y coordinate of the rotation origin
`oz` - the z coordinate of the rotation origin
`dest` - will hold the result
Returns:
dest
• rotate

```Matrix4f rotate​(AxisAngle4f axisAngle,
Matrix4f dest)```
Apply a rotation transformation, rotating about the given `AxisAngle4f` and store the result in `dest`.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `A` the rotation matrix obtained from the given `AxisAngle4f`, then the new matrix will be `M * A`. So when transforming a vector `v` with the new matrix by using `M * A * v`, the `AxisAngle4f` rotation will be applied first!

Reference: http://en.wikipedia.org

Parameters:
`axisAngle` - the `AxisAngle4f` (needs to be `normalized`)
`dest` - will hold the result
Returns:
dest
`rotate(float, float, float, float, Matrix4f)`
• rotate

```Matrix4f rotate​(float angle,
Vector3fc axis,
Matrix4f dest)```
Apply a rotation transformation, rotating the given radians about the specified axis and store the result in `dest`.

The axis described by the `axis` vector needs to be a unit vector.

When used with a right-handed coordinate system, the produced rotation will rotate a vector counter-clockwise around the rotation axis, when viewing along the negative axis direction towards the origin. When used with a left-handed coordinate system, the rotation is clockwise.

If `M` is `this` matrix and `A` the rotation matrix obtained from the given axis-angle, then the new matrix will be `M * A`. So when transforming a vector `v` with the new matrix by using `M * A * v`, the axis-angle rotation will be applied first!

Reference: http://en.wikipedia.org

Parameters:
`angle` - the angle in radians
`axis` - the rotation axis (needs to be `normalized`)
`dest` - will hold the result
Returns:
dest
`rotate(float, float, float, float, Matrix4f)`
• unproject

```Vector4f unproject​(float winX,
float winY,
float winZ,
int[] viewport,
Vector4f dest)```
Unproject the given window coordinates `(winX, winY, winZ)` by `this` matrix using the specified viewport.

This method first converts the given window coordinates to normalized device coordinates in the range `[-1..1]` and then transforms those NDC coordinates by the inverse of `this` matrix.

The depth range of `winZ` is assumed to be `[0..1]`, which is also the OpenGL default.

As a necessary computation step for unprojecting, this method computes the inverse of `this` matrix. In order to avoid computing the matrix inverse with every invocation, the inverse of `this` matrix can be built once outside using `invert(Matrix4f)` and then the method `unprojectInv()` can be invoked on it.

Parameters:
`winX` - the x-coordinate in window coordinates (pixels)
`winY` - the y-coordinate in window coordinates (pixels)
`winZ` - the z-coordinate, which is the depth value in `[0..1]`
`viewport` - the viewport described by `[x, y, width, height]`
`dest` - will hold the unprojected position
Returns:
dest
`unprojectInv(float, float, float, int[], Vector4f)`, `invert(Matrix4f)`
• unproject

```Vector3f unproject​(float winX,
float winY,
float winZ,
int[] viewport,
Vector3f dest)```
Unproject the given window coordinates `(winX, winY, winZ)` by `this` matrix using the specified viewport.

This method first converts the given window coordinates to normalized device coordinates in the range `[-1..1]` and then transforms those NDC coordinates by the inverse of `this` matrix.

The depth range of `winZ` is assumed to be `[0..1]`, which is also the OpenGL default.

As a necessary computation step for unprojecting, this method computes the inverse of `this` matrix. In order to avoid computing the matrix inverse with every invocation, the inverse of `this` matrix can be built once outside using `invert(Matrix4f)` and then the method `unprojectInv()` can be invoked on it.

Parameters:
`winX` - the x-coordinate in window coordinates (pixels)
`winY` - the y-coordinate in window coordinates (pixels)
`winZ` - the z-coordinate, which is the depth value in `[0..1]`
`viewport` - the viewport described by `[x, y, width, height]`
`dest` - will hold the unprojected position
Returns:
dest
`unprojectInv(float, float, float, int[], Vector3f)`, `invert(Matrix4f)`
• unproject

```Vector4f unproject​(Vector3fc winCoords,
int[] viewport,
Vector4f dest)```
Unproject the given window coordinates `winCoords` by `this` matrix using the specified viewport.

This method first converts the given window coordinates to normalized device coordinates in the range `[-1..1]` and then transforms those NDC coordinates by the inverse of `this` matrix.

The depth range of `winCoords.z` is assumed to be `[0..1]`, which is also the OpenGL default.

As a necessary computation step for unprojecting, this method computes the inverse of `this` matrix. In order to avoid computing the matrix inverse with every invocation, the inverse of `this` matrix can be built once outside using `invert(Matrix4f)` and then the method `unprojectInv()` can be invoked on it.

Parameters:
`winCoords` - the window coordinates to unproject
`viewport` - the viewport described by `[x, y, width, height]`
`dest` - will hold the unprojected position
Returns:
dest
`unprojectInv(float, float, float, int[], Vector4f)`, `unproject(float, float, float, int[], Vector4f)`, `invert(Matrix4f)`
• unproject

```Vector3f unproject​(Vector3fc winCoords,
int[] viewport,
Vector3f dest)```
Unproject the given window coordinates `winCoords` by `this` matrix using the specified viewport.

This method first converts the given window coordinates to normalized device coordinates in the range `[-1..1]` and then transforms those NDC coordinates by the inverse of `this` matrix.

The depth range of `winCoords.z` is assumed to be `[0..1]`, which is also the OpenGL default.

As a necessary computation step for unprojecting, this method computes the inverse of `this` matrix. In order to avoid computing the matrix inverse with every invocation, the inverse of `this` matrix can be built once outside using `invert(Matrix4f)` and then the method `unprojectInv()` can be invoked on it.

Parameters:
`winCoords` - the window coordinates to unproject
`viewport` - the viewport described by `[x, y, width, height]`
`dest` - will hold the unprojected position
Returns:
dest
`unprojectInv(float, float, float, int[], Vector3f)`, `unproject(float, float, float, int[], Vector3f)`, `invert(Matrix4f)`
• unprojectRay

```Matrix4f unprojectRay​(float winX,
float winY,
int[] viewport,
Vector3f originDest,
Vector3f dirDest)```
Unproject the given 2D window coordinates `(winX, winY)` by `this` matrix using the specified viewport and compute the origin and the direction of the resulting ray which starts at NDC `z = -1.0` and goes through NDC `z = +1.0`.

This method first converts the given window coordinates to normalized device coordinates in the range `[-1..1]` and then transforms those NDC coordinates by the inverse of `this` matrix.

As a necessary computation step for unprojecting, this method computes the inverse of `this` matrix. In order to avoid computing the matrix inverse with every invocation, the inverse of `this` matrix can be built once outside using `invert(Matrix4f)` and then the method `unprojectInvRay()` can be invoked on it.

Parameters:
`winX` - the x-coordinate in window coordinates (pixels)
`winY` - the y-coordinate in window coordinates (pixels)
`viewport` - the viewport described by `[x, y, width, height]`
`originDest` - will hold the ray origin
`dirDest` - will hold the (unnormalized) ray direction
Returns:
this
`unprojectInvRay(float, float, int[], Vector3f, Vector3f)`, `invert(Matrix4f)`
• unprojectRay

```Matrix4f unprojectRay​(Vector2fc winCoords,
int[] viewport,
Vector3f originDest,
Vector3f dirDest)```
Unproject the given 2D window coordinates `winCoords` by `this` matrix using the specified viewport and compute the origin and the direction of the resulting ray which starts at NDC `z = -1.0` and goes through NDC `z = +1.0`.

This method first converts the given window coordinates to normalized device coordinates in the range `[-1..1]` and then transforms those NDC coordinates by the inverse of `this` matrix.

As a necessary computation step for unprojecting, this method computes the inverse of `this` matrix. In order to avoid computing the matrix inverse with every invocation, the inverse of `this` matrix can be built once outside using `invert(Matrix4f)` and then the method `unprojectInvRay()` can be invoked on it.

Parameters:
`winCoords` - the window coordinates to unproject
`viewport` - the viewport described by `[x, y, width, height]`
`originDest` - will hold the ray origin
`dirDest` - will hold the (unnormalized) ray direction
Returns:
this
`unprojectInvRay(float, float, int[], Vector3f, Vector3f)`, `unprojectRay(float, float, int[], Vector3f, Vector3f)`, `invert(Matrix4f)`
• unprojectInv

```Vector4f unprojectInv​(Vector3fc winCoords,
int[] viewport,
Vector4f dest)```
Unproject the given window coordinates `winCoords` by `this` matrix using the specified viewport.

This method differs from `unproject()` in that it assumes that `this` is already the inverse matrix of the original projection matrix. It exists to avoid recomputing the matrix inverse with every invocation.

The depth range of `winCoords.z` is assumed to be `[0..1]`, which is also the OpenGL default.

This method reads the four viewport parameters from the given int[].

Parameters:
`winCoords` - the window coordinates to unproject
`viewport` - the viewport described by `[x, y, width, height]`
`dest` - will hold the unprojected position
Returns:
dest
`unproject(Vector3fc, int[], Vector4f)`
• unprojectInv

```Vector4f unprojectInv​(float winX,
float winY,
float winZ,
int[] viewport,
Vector4f dest)```
Unproject the given window coordinates `(winX, winY, winZ)` by `this` matrix using the specified viewport.

This method differs from `unproject()` in that it assumes that `this` is already the inverse matrix of the original projection matrix. It exists to avoid recomputing the matrix inverse with every invocation.

The depth range of `winZ` is assumed to be `[0..1]`, which is also the OpenGL default.

Parameters:
`winX` - the x-coordinate in window coordinates (pixels)
`winY` - the y-coordinate in window coordinates (pixels)
`winZ` - the z-coordinate, which is the depth value in `[0..1]`
`viewport` - the viewport described by `[x, y, width, height]`
`dest` - will hold the unprojected position
Returns:
dest
`unproject(float, float, float, int[], Vector4f)`
• unprojectInvRay

```Matrix4f unprojectInvRay​(Vector2fc winCoords,
int[] viewport,
Vector3f originDest,
Vector3f dirDest)```
Unproject the given window coordinates `winCoords` by `this` matrix using the specified viewport and compute the origin and the direction of the resulting ray which starts at NDC `z = -1.0` and goes through NDC `z = +1.0`.

This method differs from `unprojectRay()` in that it assumes that `this` is already the inverse matrix of the original projection matrix. It exists to avoid recomputing the matrix inverse with every invocation.

Parameters:
`winCoords` - the window coordinates to unproject
`viewport` - the viewport described by `[x, y, width, height]`
`originDest` - will hold the ray origin
`dirDest` - will hold the (unnormalized) ray direction
Returns:
this
`unprojectRay(Vector2fc, int[], Vector3f, Vector3f)`
• unprojectInvRay

```Matrix4f unprojectInvRay​(float winX,
float winY,
int[] viewport,
Vector3f originDest,
Vector3f dirDest)```
Unproject the given 2D window coordinates `(winX, winY)` by `this` matrix using the specified viewport and compute the origin and the direction of the resulting ray which starts at NDC `z = -1.0` and goes through NDC `z = +1.0`.

This method differs from `unprojectRay()` in that it assumes that `this` is already the inverse matrix of the original projection matrix. It exists to avoid recomputing the matrix inverse with every invocation.

Parameters:
`winX` - the x-coordinate in window coordinates (pixels)
`winY` - the y-coordinate in window coordinates (pixels)
`viewport` - the viewport described by `[x, y, width, height]`
`originDest` - will hold the ray origin
`dirDest` - will hold the (unnormalized) ray direction
Returns:
this
`unprojectRay(float, float, int[], Vector3f, Vector3f)`
• unprojectInv

```Vector3f unprojectInv​(Vector3fc winCoords,
int[] viewport,
Vector3f dest)```
Unproject the given window coordinates `winCoords` by `this` matrix using the specified viewport.

This method differs from `unproject()` in that it assumes that `this` is already the inverse matrix of the original projection matrix. It exists to avoid recomputing the matrix inverse with every invocation.

The depth range of `winCoords.z` is assumed to be `[0..1]`, which is also the OpenGL default.

Parameters:
`winCoords` - the window coordinates to unproject
`viewport` - the viewport described by `[x, y, width, height]`
`dest` - will hold the unprojected position
Returns:
dest
`unproject(Vector3fc, int[], Vector3f)`
• unprojectInv

```Vector3f unprojectInv​(float winX,
float winY,
float winZ,
int[] viewport,
Vector3f dest)```
Unproject the given window coordinates `(winX, winY, winZ)` by `this` matrix using the specified viewport.

This method differs from `unproject()` in that it assumes that `this` is already the inverse matrix of the original projection matrix. It exists to avoid recomputing the matrix inverse with every invocation.

The depth range of `winZ` is assumed to be `[0..1]`, which is also the OpenGL default.

Parameters:
`winX` - the x-coordinate in window coordinates (pixels)
`winY` - the y-coordinate in window coordinates (pixels)
`winZ` - the z-coordinate, which is the depth value in `[0..1]`
`viewport` - the viewport described by `[x, y, width, height]`
`dest` - will hold the unprojected position
Returns:
dest
`unproject(float, float, float, int[], Vector3f)`
• project

```Vector4f project​(float x,
float y,
float z,
int[] viewport,
Vector4f winCoordsDest)```
Project the given `(x, y, z)` position via `this` matrix using the specified viewport and store the resulting window coordinates in `winCoordsDest`.

This method transforms the given coordinates by `this` matrix including perspective division to obtain normalized device coordinates, and then translates these into window coordinates by using the given `viewport` settings `[x, y, width, height]`.

The depth range of the returned `winCoordsDest.z` will be `[0..1]`, which is also the OpenGL default.

Parameters:
`x` - the x-coordinate of the position to project
`y` - the y-coordinate of the position to project
`z` - the z-coordinate of the position to project
`viewport` - the viewport described by `[x, y, width, height]`
`winCoordsDest` - will hold the projected window coordinates
Returns:
winCoordsDest
• project

```Vector3f project​(float x,
float y,
float z,
int[] viewport,
Vector3f winCoordsDest)```
Project the given `(x, y, z)` position via `this` matrix using the specified viewport and store the resulting window coordinates in `winCoordsDest`.

This method transforms the given coordinates by `this` matrix including perspective division to obtain normalized device coordinates, and then translates these into window coordinates by using the given `viewport` settings `[x, y, width, height]`.

The depth range of the returned `winCoordsDest.z` will be `[0..1]`, which is also the OpenGL default.

Parameters:
`x` - the x-coordinate of the position to project
`y` - the y-coordinate of the position to project
`z` - the z-coordinate of the position to project
`viewport` - the viewport described by `[x, y, width, height]`
`winCoordsDest` - will hold the projected window coordinates
Returns:
winCoordsDest
• project

```Vector4f project​(Vector3fc position,
int[] viewport,
Vector4f winCoordsDest)```
Project the given `position` via `this` matrix using the specified viewport and store the resulting window coordinates in `winCoordsDest`.

This method transforms the given coordinates by `this` matrix including perspective division to obtain normalized device coordinates, and then translates these into window coordinates by using the given `viewport` settings `[x, y, width, height]`.

The depth range of the returned `winCoordsDest.z` will be `[0..1]`, which is also the OpenGL default.

Parameters:
`position` - the position to project into window coordinates
`viewport` - the viewport described by `[x, y, width, height]`
`winCoordsDest` - will hold the projected window coordinates
Returns:
winCoordsDest
`project(float, float, float, int[], Vector4f)`
• project

```Vector3f project​(Vector3fc position,
int[] viewport,
Vector3f winCoordsDest)```
Project the given `position` via `this` matrix using the specified viewport and store the resulting window coordinates in `winCoordsDest`.

This method transforms the given coordinates by `this` matrix including perspective division to obtain normalized device coordinates, and then translates these into window coordinates by using the given `viewport` settings `[x, y, width, height]`.

The depth range of the returned `winCoordsDest.z` will be `[0..1]`, which is also the OpenGL default.

Parameters:
`position` - the position to project into window coordinates
`viewport` - the viewport described by `[x, y, width, height]`
`winCoordsDest` - will hold the projected window coordinates
Returns:
winCoordsDest
`project(float, float, float, int[], Vector4f)`
• reflect

```Matrix4f reflect​(float a,
float b,
float c,
float d,
Matrix4f dest)```
Apply a mirror/reflection transformation to this matrix that reflects about the given plane specified via the equation `x*a + y*b + z*c + d = 0` and store the result in `dest`.

The vector `(a, b, c)` must be a unit vector.

If `M` is `this` matrix and `R` the reflection matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the reflection will be applied first!

Reference: msdn.microsoft.com

Parameters:
`a` - the x factor in the plane equation
`b` - the y factor in the plane equation
`c` - the z factor in the plane equation
`d` - the constant in the plane equation
`dest` - will hold the result
Returns:
dest
• reflect

```Matrix4f reflect​(float nx,
float ny,
float nz,
float px,
float py,
float pz,
Matrix4f dest)```
Apply a mirror/reflection transformation to this matrix that reflects about the given plane specified via the plane normal and a point on the plane, and store the result in `dest`.

If `M` is `this` matrix and `R` the reflection matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the reflection will be applied first!

Parameters:
`nx` - the x-coordinate of the plane normal
`ny` - the y-coordinate of the plane normal
`nz` - the z-coordinate of the plane normal
`px` - the x-coordinate of a point on the plane
`py` - the y-coordinate of a point on the plane
`pz` - the z-coordinate of a point on the plane
`dest` - will hold the result
Returns:
dest
• reflect

```Matrix4f reflect​(Quaternionfc orientation,
Vector3fc point,
Matrix4f dest)```
Apply a mirror/reflection transformation to this matrix that reflects about a plane specified via the plane orientation and a point on the plane, and store the result in `dest`.

This method can be used to build a reflection transformation based on the orientation of a mirror object in the scene. It is assumed that the default mirror plane's normal is `(0, 0, 1)`. So, if the given `Quaternionfc` is the identity (does not apply any additional rotation), the reflection plane will be `z=0`, offset by the given `point`.

If `M` is `this` matrix and `R` the reflection matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the reflection will be applied first!

Parameters:
`orientation` - the plane orientation relative to an implied normal vector of `(0, 0, 1)`
`point` - a point on the plane
`dest` - will hold the result
Returns:
dest
• reflect

```Matrix4f reflect​(Vector3fc normal,
Vector3fc point,
Matrix4f dest)```
Apply a mirror/reflection transformation to this matrix that reflects about the given plane specified via the plane normal and a point on the plane, and store the result in `dest`.

If `M` is `this` matrix and `R` the reflection matrix, then the new matrix will be `M * R`. So when transforming a vector `v` with the new matrix by using `M * R * v`, the reflection will be applied first!

Parameters:
`normal` - the plane normal
`point` - a point on the plane
`dest` - will hold the result
Returns:
dest
• getRow

```Vector4f getRow​(int row,
Vector4f dest)
throws java.lang.IndexOutOfBoundsException```
Get the row at the given `row` index, starting with `0`.
Parameters:
`row` - the row index in `[0..3]`
`dest` - will hold the row components
Returns:
the passed in destination
Throws:
`java.lang.IndexOutOfBoundsException` - if `row` is not in `[0..3]`
• getRow

```Vector3f getRow​(int row,
Vector3f dest)
throws java.lang.IndexOutOfBoundsException```
Get the first three components of the row at the given `row` index, starting with `0`.
Parameters:
`row` - the row index in `[0..3]`
`dest` - will hold the first three row components
Returns:
the passed in destination
Throws:
`java.lang.IndexOutOfBoundsException` - if `row` is not in `[0..3]`
• getColumn

```Vector4f getColumn​(int column,
Vector4f dest)
throws java.lang.IndexOutOfBoundsException```
Get the column at the given `column` index, starting with `0`.
Parameters:
`column` - the column index in `[0..3]`
`dest` - will hold the column components
Returns:
the passed in destination
Throws:
`java.lang.IndexOutOfBoundsException` - if `column` is not in `[0..3]`
• getColumn

```Vector3f getColumn​(int column,
Vector3f dest)
throws java.lang.IndexOutOfBoundsException```
Get the first three components of the column at the given `column` index, starting with `0`.
Parameters:
`column` - the column index in `[0..3]`
`dest` - will hold the first three column components
Returns:
the passed in destination
Throws:
`java.lang.IndexOutOfBoundsException` - if `column` is not in `[0..3]`
• normal

`Matrix4f normal​(Matrix4f dest)`
Compute a normal matrix from the upper left 3x3 submatrix of `this` and store it into the upper left 3x3 submatrix of `dest`. All other values of `dest` will be set to identity.

The normal matrix of `m` is the transpose of the inverse of `m`.

Parameters:
`dest` - will hold the result
Returns:
dest
• normal

`Matrix3f normal​(Matrix3f dest)`
Compute a normal matrix from the upper left 3x3 submatrix of `this` and store it into `dest`.

The normal matrix of `m` is the transpose of the inverse of `m`.

Parameters:
`dest` - will hold the result
Returns:
dest
`Matrix3f.set(Matrix4fc)`, `get3x3(Matrix3f)`
• normalize3x3

`Matrix4f normalize3x3​(Matrix4f dest)`
Normalize the upper left 3x3 submatrix of this matrix and store the result in `dest`.

The resulting matrix will map unit vectors to unit vectors, though a pair of orthogonal input unit vectors need not be mapped to a pair of orthogonal output vectors if the original matrix was not orthogonal itself (i.e. had skewing).

Parameters:
`dest` - will hold the result
Returns:
dest
• normalize3x3

`Matrix3f normalize3x3​(Matrix3f dest)`
Normalize the upper left 3x3 submatrix of this matrix and store the result in `dest`.

The resulting matrix will map unit vectors to unit vectors, though a pair of orthogonal input unit vectors need not be mapped to a pair of orthogonal output vectors if the original matrix was not orthogonal itself (i.e. had skewing).

Parameters:
`dest` - will hold the result
Returns:
dest
• frustumPlane

```Vector4f frustumPlane​(int plane,
Vector4f planeEquation)```
Calculate a frustum plane of `this` matrix, which can be a projection matrix or a combined modelview-projection matrix, and store the result in the given `planeEquation`.

Generally, this method computes the frustum plane in the local frame of any coordinate system that existed before `this` transformation was applied to it in order to yield homogeneous clipping space.

The frustum plane will be given in the form of a general plane equation: `a*x + b*y + c*z + d = 0`, where the given `Vector4f` components will hold the `(a, b, c, d)` values of the equation.

The plane normal, which is `(a, b, c)`, is directed "inwards" of the frustum. Any plane/point test using `a*x + b*y + c*z + d` therefore will yield a result greater than zero if the point is within the frustum (i.e. at the positive side of the frustum plane).

For performing frustum culling, the class `FrustumIntersection` should be used instead of manually obtaining the frustum planes and testing them against points, spheres or axis-aligned boxes.

Parameters:
`plane` - one of the six possible planes, given as numeric constants `PLANE_NX`, `PLANE_PX`, `PLANE_NY`, `PLANE_PY`, `PLANE_NZ` and `PLANE_PZ`
`planeEquation` - will hold the computed plane equation. The plane equation will be normalized, meaning that `(a, b, c)` will be a unit vector
Returns:
planeEquation
• frustumPlane

```Planef frustumPlane​(int which,
Planef plane)```
Calculate a frustum plane of `this` matrix, which can be a projection matrix or a combined modelview-projection matrix, and store the result in the given `plane`.

Generally, this method computes the frustum plane in the local frame of any coordinate system that existed before `this` transformation was applied to it in order to yield homogeneous clipping space.

The plane normal, which is `(a, b, c)`, is directed "inwards" of the frustum. Any plane/point test using `a*x + b*y + c*z + d` therefore will yield a result greater than zero if the point is within the frustum (i.e. at the positive side of the frustum plane).

For performing frustum culling, the class `FrustumIntersection` should be used instead of manually obtaining the frustum planes and testing them against points, spheres or axis-aligned boxes.

Parameters:
`which` - one of the six possible planes, given as numeric constants `PLANE_NX`, `PLANE_PX`, `PLANE_NY`, `PLANE_PY`, `PLANE_NZ` and `PLANE_PZ`
`plane` - will hold the computed plane equation. The plane equation will be normalized, meaning that `(a, b, c)` will be a unit vector
Returns:
planeEquation
• perspectiveOrigin

`Vector3f perspectiveOrigin​(Vector3f origin)`
Compute the eye/origin of the perspective frustum transformation defined by `this` matrix, which can be a projection matrix or a combined modelview-projection matrix, and store the result in the given `origin`.

Note that this method will only work using perspective projections obtained via one of the perspective methods, such as `perspective()` or `frustum()`.

Generally, this method computes the origin in the local frame of any coordinate system that existed before `this` transformation was applied to it in order to yield homogeneous clipping space.

Reference: http://geomalgorithms.com

Parameters:
`origin` - will hold the origin of the coordinate system before applying `this` perspective projection transformation
Returns:
origin
• perspectiveFov

`float perspectiveFov()`
Return the vertical field-of-view angle in radians of this perspective transformation matrix.

Note that this method will only work using perspective projections obtained via one of the perspective methods, such as `perspective()` or `frustum()`.

For orthogonal transformations this method will return `0.0`.

Returns:
the vertical field-of-view angle in radians
• perspectiveNear

`float perspectiveNear()`
Extract the near clip plane distance from `this` perspective projection matrix.

This method only works if `this` is a perspective projection matrix, for example obtained via `perspective(float, float, float, float, Matrix4f)`.

Returns:
the near clip plane distance
• perspectiveFar

`float perspectiveFar()`
Extract the far clip plane distance from `this` perspective projection matrix.

This method only works if `this` is a perspective projection matrix, for example obtained via `perspective(float, float, float, float, Matrix4f)`.

Returns:
the far clip plane distance
• frustumRayDir

```Vector3f frustumRayDir​(float x,
float y,
Vector3f dir)```
Obtain the direction of a ray starting at the center of the coordinate system and going through the near frustum plane.

This method computes the `dir` vector in the local frame of any coordinate system that existed before `this` transformation was applied to it in order to yield homogeneous clipping space.

The parameters `x` and `y` are used to interpolate the generated ray direction from the bottom-left to the top-right frustum corners.

For optimal efficiency when building many ray directions over the whole frustum, it is recommended to use this method only in order to compute the four corner rays at `(0, 0)`, `(1, 0)`, `(0, 1)` and `(1, 1)` and then bilinearly interpolating between them; or to use the `FrustumRayBuilder`.

Parameters:
`x` - the interpolation factor along the left-to-right frustum planes, within `[0..1]`
`y` - the interpolation factor along the bottom-to-top frustum planes, within `[0..1]`
`dir` - will hold the normalized ray direction in the local frame of the coordinate system before transforming to homogeneous clipping space using `this` matrix
Returns:
dir
• positiveZ

`Vector3f positiveZ​(Vector3f dir)`
Obtain the direction of `+Z` before the transformation represented by `this` matrix is applied.

This method uses the rotation component of the upper left 3x3 submatrix to obtain the direction that is transformed to `+Z` by `this` matrix.

This method is equivalent to the following code:

``` Matrix4f inv = new Matrix4f(this).invert();
inv.transformDirection(dir.set(0, 0, 1)).normalize();
```
If `this` is already an orthogonal matrix, then consider using `normalizedPositiveZ(Vector3f)` instead.

Reference: http://www.euclideanspace.com

Parameters:
`dir` - will hold the direction of `+Z`
Returns:
dir
• normalizedPositiveZ

`Vector3f normalizedPositiveZ​(Vector3f dir)`
Obtain the direction of `+Z` before the transformation represented by `this` orthogonal matrix is applied. This method only produces correct results if `this` is an orthogonal matrix.

This method uses the rotation component of the upper left 3x3 submatrix to obtain the direction that is transformed to `+Z` by `this` matrix.

This method is equivalent to the following code:

``` Matrix4f inv = new Matrix4f(this).transpose();
inv.transformDirection(dir.set(0, 0, 1));
```

Reference: http://www.euclideanspace.com

Parameters:
`dir` - will hold the direction of `+Z`
Returns:
dir
• positiveX

`Vector3f positiveX​(Vector3f dir)`
Obtain the direction of `+X` before the transformation represented by `this` matrix is applied.

This method uses the rotation component of the upper left 3x3 submatrix to obtain the direction that is transformed to `+X` by `this` matrix.

This method is equivalent to the following code:

``` Matrix4f inv = new Matrix4f(this).invert();
inv.transformDirection(dir.set(1, 0, 0)).normalize();
```
If `this` is already an orthogonal matrix, then consider using `normalizedPositiveX(Vector3f)` instead.

Reference: http://www.euclideanspace.com

Parameters:
`dir` - will hold the direction of `+X`
Returns:
dir
• normalizedPositiveX

`Vector3f normalizedPositiveX​(Vector3f dir)`
Obtain the direction of `+X` before the transformation represented by `this` orthogonal matrix is applied. This method only produces correct results if `this` is an orthogonal matrix.

This method uses the rotation component of the upper left 3x3 submatrix to obtain the direction that is transformed to `+X` by `this` matrix.

This method is equivalent to the following code:

``` Matrix4f inv = new Matrix4f(this).transpose();
inv.transformDirection(dir.set(1, 0, 0));
```

Reference: http://www.euclideanspace.com

Parameters:
`dir` - will hold the direction of `+X`
Returns:
dir
• positiveY

`Vector3f positiveY​(Vector3f dir)`
Obtain the direction of `+Y` before the transformation represented by `this` matrix is applied.

This method uses the rotation component of the upper left 3x3 submatrix to obtain the direction that is transformed to `+Y` by `this` matrix.

This method is equivalent to the following code:

``` Matrix4f inv = new Matrix4f(this).invert();
inv.transformDirection(dir.set(0, 1, 0)).normalize();
```
If `this` is already an orthogonal matrix, then consider using `normalizedPositiveY(Vector3f)` instead.

Reference: http://www.euclideanspace.com

Parameters:
`dir` - will hold the direction of `+Y`
Returns:
dir
• normalizedPositiveY

`Vector3f normalizedPositiveY​(Vector3f dir)`
Obtain the direction of `+Y` before the transformation represented by `this` orthogonal matrix is applied. This method only produces correct results if `this` is an orthogonal matrix.

This method uses the rotation component of the upper left 3x3 submatrix to obtain the direction that is transformed to `+Y` by `this` matrix.

This method is equivalent to the following code:

``` Matrix4f inv = new Matrix4f(this).transpose();
inv.transformDirection(dir.set(0, 1, 0));
```

Reference: http://www.euclideanspace.com

Parameters:
`dir` - will hold the direction of `+Y`
Returns:
dir
• originAffine

`Vector3f originAffine​(Vector3f origin)`
Obtain the position that gets transformed to the origin by `this` `affine` matrix. This can be used to get the position of the "camera" from a given view transformation matrix.

This method only works with `affine` matrices.

This method is equivalent to the following code:

``` Matrix4f inv = new Matrix4f(this).invertAffine();
inv.transformPosition(origin.set(0, 0, 0));
```
Parameters:
`origin` - will hold the position transformed to the origin
Returns:
origin
• origin

`Vector3f origin​(Vector3f origin)`
Obtain the position that gets transformed to the origin by `this` matrix. This can be used to get the position of the "camera" from a given view/projection transformation matrix.

This method is equivalent to the following code:

``` Matrix4f inv = new Matrix4f(this).invert();
inv.transformPosition(origin.set(0, 0, 0));
```
Parameters:
`origin` - will hold the position transformed to the origin
Returns:
origin

```Matrix4f shadow​(Vector4f light,
float a,
float b,
float c,
float d,
Matrix4f dest)```
Apply a projection transformation to this matrix that projects onto the plane specified via the general plane equation `x*a + y*b + z*c + d = 0` as if casting a shadow from a given light position/direction `light` and store the result in `dest`.

If `light.w` is `0.0` the light is being treated as a directional light; if it is `1.0` it is a point light.

If `M` is `this` matrix and `S` the shadow matrix, then the new matrix will be `M * S`. So when transforming a vector `v` with the new matrix by using `M * S * v`, the reflection will be applied first!

Reference: ftp.sgi.com

Parameters:
`light` - the light's vector
`a` - the x factor in the plane equation
`b` - the y factor in the plane equation
`c` - the z factor in the plane equation
`d` - the constant in the plane equation
`dest` - will hold the result
Returns:
dest

```Matrix4f shadow​(float lightX,
float lightY,
float lightZ,
float lightW,
float a,
float b,
float c,
float d,
Matrix4f dest)```
Apply a projection transformation to this matrix that projects onto the plane specified via the general plane equation `x*a + y*b + z*c + d = 0` as if casting a shadow from a given light position/direction `(lightX, lightY, lightZ, lightW)` and store the result in `dest`.

If `lightW` is `0.0` the light is being treated as a directional light; if it is `1.0` it is a point light.

If `M` is `this` matrix and `S` the shadow matrix, then the new matrix will be `M * S`. So when transforming a vector `v` with the new matrix by using `M * S * v`, the reflection will be applied first!

Reference: ftp.sgi.com

Parameters:
`lightX` - the x-component of the light's vector
`lightY` - the y-component of the light's vector
`lightZ` - the z-component of the light's vector
`lightW` - the w-component of the light's vector
`a` - the x factor in the plane equation
`b` - the y factor in the plane equation
`c` - the z factor in the plane equation
`d` - the constant in the plane equation
`dest` - will hold the result
Returns:
dest

```Matrix4f shadow​(Vector4f light,
Matrix4fc planeTransform,
Matrix4f dest)```
Apply a projection transformation to this matrix that projects onto the plane with the general plane equation `y = 0` as if casting a shadow from a given light position/direction `light` and store the result in `dest`.

Before the shadow projection is applied, the plane is transformed via the specified `planeTransformation`.

If `light.w` is `0.0` the light is being treated as a directional light; if it is `1.0` it is a point light.

If `M` is `this` matrix and `S` the shadow matrix, then the new matrix will be `M * S`. So when transforming a vector `v` with the new matrix by using `M * S * v`, the reflection will be applied first!

Parameters:
`light` - the light's vector
`planeTransform` - the transformation to transform the implied plane `y = 0` before applying the projection
`dest` - will hold the result
Returns:
dest

```Matrix4f shadow​(float lightX,
float lightY,
float lightZ,
float lightW,
Matrix4fc planeTransform,
Matrix4f dest)```
Apply a projection transformation to this matrix that projects onto the plane with the general plane equation `y = 0` as if casting a shadow from a given light position/direction `(lightX, lightY, lightZ, lightW)` and store the result in `dest`.

Before the shadow projection is applied, the plane is transformed via the specified `planeTransformation`.

If `lightW` is `0.0` the light is being treated as a directional light; if it is `1.0` it is a point light.

If `M` is `this` matrix and `S` the shadow matrix, then the new matrix will be `M * S`. So when transforming a vector `v` with the new matrix by using `M * S * v`, the reflection will be applied first!

Parameters:
`lightX` - the x-component of the light vector
`lightY` - the y-component of the light vector
`lightZ` - the z-component of the light vector
`lightW` - the w-component of the light vector
`planeTransform` - the transformation to transform the implied plane `y = 0` before applying the projection
`dest` - will hold the result
Returns:
dest
• pick

```Matrix4f pick​(float x,
float y,
float width,
float height,
int[] viewport,
Matrix4f dest)```
Apply a picking transformation to this matrix using the given window coordinates `(x, y)` as the pick center and the given `(width, height)` as the size of the picking region in window coordinates, and store the result in `dest`.
Parameters:
`x` - the x coordinate of the picking region center in window coordinates
`y` - the y coordinate of the picking region center in window coordinates
`width` - the width of the picking region in window coordinates
`height` - the height of the picking region in window coordinates
`viewport` - the viewport described by `[x, y, width, height]`
`dest` - the destination matrix, which will hold the result
Returns:
dest
• isAffine

`boolean isAffine()`
Determine whether this matrix describes an affine transformation. This is the case iff its last row is equal to `(0, 0, 0, 1)`.
Returns:
`true` iff this matrix is affine; `false` otherwise
• arcball

```Matrix4f arcball​(float radius,
float centerX,
float centerY,
float centerZ,
float angleX,
float angleY,
Matrix4f dest)```
Apply an arcball view transformation to this matrix with the given `radius` and center `(centerX, centerY, centerZ)` position of the arcball and the specified X and Y rotation angles, and store the result in `dest`.

This method is equivalent to calling: `translate(0, 0, -radius).rotateX(angleX).rotateY(angleY).translate(-centerX, -centerY, -centerZ)`

Parameters:
`radius` - the arcball radius
`centerX` - the x coordinate of the center position of the arcball
`centerY` - the y coordinate of the center position of the arcball
`centerZ` - the z coordinate of the center position of the arcball
`angleX` - the rotation angle around the X axis in radians
`angleY` - the rotation angle around the Y axis in radians
`dest` - will hold the result
Returns:
dest
• arcball

```Matrix4f arcball​(float radius,
Vector3fc center,
float angleX,
float angleY,
Matrix4f dest)```
Apply an arcball view transformation to this matrix with the given `radius` and `center` position of the arcball and the specified X and Y rotation angles, and store the result in `dest`.

This method is equivalent to calling: `translate(0, 0, -radius).rotateX(angleX).rotateY(angleY).translate(-center.x, -center.y, -center.z)`

Parameters:
`radius` - the arcball radius
`center` - the center position of the arcball
`angleX` - the rotation angle around the X axis in radians
`angleY` - the rotation angle around the Y axis in radians
`dest` - will hold the result
Returns:
dest
• frustumAabb

```Matrix4f frustumAabb​(Vector3f min,
Vector3f max)```
Compute the axis-aligned bounding box of the frustum described by `this` matrix and store the minimum corner coordinates in the given `min` and the maximum corner coordinates in the given `max` vector.

The matrix `this` is assumed to be the `inverse` of the origial view-projection matrix for which to compute the axis-aligned bounding box in world-space.

The axis-aligned bounding box of the unit frustum is `(-1, -1, -1)`, `(1, 1, 1)`.

Parameters:
`min` - will hold the minimum corner coordinates of the axis-aligned bounding box
`max` - will hold the maximum corner coordinates of the axis-aligned bounding box
Returns:
this
• projectedGridRange

```Matrix4f projectedGridRange​(Matrix4fc projector,
float sLower,
float sUpper,
Matrix4f dest)```
Compute the range matrix for the Projected Grid transformation as described in chapter "2.4.2 Creating the range conversion matrix" of the paper Real-time water rendering - Introducing the projected grid concept based on the inverse of the view-projection matrix which is assumed to be `this`, and store that range matrix into `dest`.

If the projected grid will not be visible then this method returns `null`.

This method uses the `y = 0` plane for the projection.

Parameters:
`projector` - the projector view-projection transformation
`sLower` - the lower (smallest) Y-coordinate which any transformed vertex might have while still being visible on the projected grid
`sUpper` - the upper (highest) Y-coordinate which any transformed vertex might have while still being visible on the projected grid
`dest` - will hold the resulting range matrix
Returns:
the computed range matrix; or `null` if the projected grid will not be visible
• orthoCrop

```Matrix4f orthoCrop​(Matrix4fc view,
Matrix4f dest)```
Build an ortographic projection transformation that fits the view-projection transformation represented by `this` into the given affine `view` transformation.

The transformation represented by `this` must be given as the `inverse` of a typical combined camera view-projection transformation, whose projection can be either orthographic or perspective.

The `view` must be an `affine` transformation which in the application of Cascaded Shadow Maps is usually the light view transformation. It be obtained via any affine transformation or for example via `lookAt()`.

Parameters:
`view` - the view transformation to build a corresponding orthographic projection to fit the frustum of `this`
`dest` - will hold the crop projection transformation
Returns:
dest
• transformAab

```Matrix4f transformAab​(float minX,
float minY,
float minZ,
float maxX,
float maxY,
float maxZ,
Vector3f outMin,
Vector3f outMax)```
Transform the axis-aligned box given as the minimum corner `(minX, minY, minZ)` and maximum corner `(maxX, maxY, maxZ)` by `this` `affine` matrix and compute the axis-aligned box of the result whose minimum corner is stored in `outMin` and maximum corner stored in `outMax`.

Parameters:
`minX` - the x coordinate of the minimum corner of the axis-aligned box
`minY` - the y coordinate of the minimum corner of the axis-aligned box
`minZ` - the z coordinate of the minimum corner of the axis-aligned box
`maxX` - the x coordinate of the maximum corner of the axis-aligned box
`maxY` - the y coordinate of the maximum corner of the axis-aligned box
`maxZ` - the y coordinate of the maximum corner of the axis-aligned box
`outMin` - will hold the minimum corner of the resulting axis-aligned box
`outMax` - will hold the maximum corner of the resulting axis-aligned box
Returns:
this
• transformAab

```Matrix4f transformAab​(Vector3fc min,
Vector3fc max,
Vector3f outMin,
Vector3f outMax)```
Transform the axis-aligned box given as the minimum corner `min` and maximum corner `max` by `this` `affine` matrix and compute the axis-aligned box of the result whose minimum corner is stored in `outMin` and maximum corner stored in `outMax`.
Parameters:
`min` - the minimum corner of the axis-aligned box
`max` - the maximum corner of the axis-aligned box
`outMin` - will hold the minimum corner of the resulting axis-aligned box
`outMax` - will hold the maximum corner of the resulting axis-aligned box
Returns:
this
• lerp

```Matrix4f lerp​(Matrix4fc other,
float t,
Matrix4f dest)```
Linearly interpolate `this` and `other` using the given interpolation factor `t` and store the result in `dest`.

If `t` is `0.0` then the result is `this`. If the interpolation factor is `1.0` then the result is `other`.

Parameters:
`other` - the other matrix
`t` - the interpolation factor between 0.0 and 1.0
`dest` - will hold the result
Returns:
dest
• rotateTowards

```Matrix4f rotateTowards​(Vector3fc dir,
Vector3fc up,
Matrix4f dest)```
Apply a model transformation to this matrix for a right-handed coordinate system, that aligns the local `+Z` axis with `dir` and store the result in `dest`.

If `M` is `this` matrix and `L` the lookat matrix, then the new matrix will be `M * L`. So when transforming a vector `v` with the new matrix by using `M * L * v`, the lookat transformation will be applied first!

This method is equivalent to calling: `mulAffine(new Matrix4f().lookAt(new Vector3f(), new Vector3f(dir).negate(), up).invertAffine(), dest)`

Parameters:
`dir` - the direction to rotate towards
`up` - the up vector
`dest` - will hold the result
Returns:
dest
`rotateTowards(float, float, float, float, float, float, Matrix4f)`
• rotateTowards

```Matrix4f rotateTowards​(float dirX,
float dirY,
float dirZ,
float upX,
float upY,
float upZ,
Matrix4f dest)```
Apply a model transformation to this matrix for a right-handed coordinate system, that aligns the local `+Z` axis with `(dirX, dirY, dirZ)` and store the result in `dest`.

If `M` is `this` matrix and `L` the lookat matrix, then the new matrix will be `M * L`. So when transforming a vector `v` with the new matrix by using `M * L * v`, the lookat transformation will be applied first!

This method is equivalent to calling: `mulAffine(new Matrix4f().lookAt(0, 0, 0, -dirX, -dirY, -dirZ, upX, upY, upZ).invertAffine(), dest)`

Parameters:
`dirX` - the x-coordinate of the direction to rotate towards
`dirY` - the y-coordinate of the direction to rotate towards
`dirZ` - the z-coordinate of the direction to rotate towards
`upX` - the x-coordinate of the up vector
`upY` - the y-coordinate of the up vector
`upZ` - the z-coordinate of the up vector
`dest` - will hold the result
Returns:
dest
`rotateTowards(Vector3fc, Vector3fc, Matrix4f)`
• getEulerAnglesZYX

`Vector3f getEulerAnglesZYX​(Vector3f dest)`
Extract the Euler angles from the rotation represented by the upper left 3x3 submatrix of `this` and store the extracted Euler angles in `dest`.

This method assumes that the upper left of `this` only represents a rotation without scaling.

Note that the returned Euler angles must be applied in the order `Z * Y * X` to obtain the identical matrix. This means that calling `rotateZYX(float, float, float, Matrix4f)` using the obtained Euler angles will yield the same rotation as the original matrix from which the Euler angles were obtained, so in the below code the matrix `m2` should be identical to `m` (disregarding possible floating-point inaccuracies).

``` Matrix4f m = ...; // <- matrix only representing rotation
Matrix4f n = new Matrix4f();
n.rotateZYX(m.getEulerAnglesZYX(new Vector3f()));
```

Reference: http://nghiaho.com/

Parameters:
`dest` - will hold the extracted Euler angles
Returns:
dest
• testPoint

```boolean testPoint​(float x,
float y,
float z)```
Test whether the given point `(x, y, z)` is within the frustum defined by `this` matrix.

This method assumes `this` matrix to be a transformation from any arbitrary coordinate system/space `M` into standard OpenGL clip space and tests whether the given point with the coordinates `(x, y, z)` given in space `M` is within the clip space.

When testing multiple points using the same transformation matrix, `FrustumIntersection` should be used instead.

Parameters:
`x` - the x-coordinate of the point
`y` - the y-coordinate of the point
`z` - the z-coordinate of the point
Returns:
`true` if the given point is inside the frustum; `false` otherwise
• testSphere

```boolean testSphere​(float x,
float y,
float z,
float r)```
Test whether the given sphere is partly or completely within or outside of the frustum defined by `this` matrix.

This method assumes `this` matrix to be a transformation from any arbitrary coordinate system/space `M` into standard OpenGL clip space and tests whether the given sphere with the coordinates `(x, y, z)` given in space `M` is within the clip space.

When testing multiple spheres using the same transformation matrix, or more sophisticated/optimized intersection algorithms are required, `FrustumIntersection` should be used instead.

The algorithm implemented by this method is conservative. This means that in certain circumstances a false positive can occur, when the method returns `true` for spheres that are actually not visible. See iquilezles.org for an examination of this problem.

Parameters:
`x` - the x-coordinate of the sphere's center
`y` - the y-coordinate of the sphere's center
`z` - the z-coordinate of the sphere's center
`r` - the sphere's radius
Returns:
`true` if the given sphere is partly or completely inside the frustum; `false` otherwise
• testAab

```boolean testAab​(float minX,
float minY,
float minZ,
float maxX,
float maxY,
float maxZ)```
Test whether the given axis-aligned box is partly or completely within or outside of the frustum defined by `this` matrix. The box is specified via its min and max corner coordinates.

This method assumes `this` matrix to be a transformation from any arbitrary coordinate system/space `M` into standard OpenGL clip space and tests whether the given axis-aligned box with its minimum corner coordinates `(minX, minY, minZ)` and maximum corner coordinates `(maxX, maxY, maxZ)` given in space `M` is within the clip space.

When testing multiple axis-aligned boxes using the same transformation matrix, or more sophisticated/optimized intersection algorithms are required, `FrustumIntersection` should be used instead.

The algorithm implemented by this method is conservative. This means that in certain circumstances a false positive can occur, when the method returns `-1` for boxes that are actually not visible/do not intersect the frustum. See iquilezles.org for an examination of this problem.

Parameters:
`minX` - the x-coordinate of the minimum corner
`minY` - the y-coordinate of the minimum corner
`minZ` - the z-coordinate of the minimum corner
`maxX` - the x-coordinate of the maximum corner
`maxY` - the y-coordinate of the maximum corner
`maxZ` - the z-coordinate of the maximum corner
Returns:
`true` if the axis-aligned box is completely or partly inside of the frustum; `false` otherwise
• obliqueZ

```Matrix4f obliqueZ​(float a,
float b,
Matrix4f dest)```
Apply an oblique projection transformation to this matrix with the given values for `a` and `b` and store the result in `dest`.

If `M` is `this` matrix and `O` the oblique transformation matrix, then the new matrix will be `M * O`. So when transforming a vector `v` with the new matrix by using `M * O * v`, the oblique transformation will be applied first!

The oblique transformation is defined as:

``` x' = x + a*z
y' = y + a*z
z' = z
```
or in matrix form:
``` 1 0 a 0
0 1 b 0
0 0 1 0
0 0 0 1
```
Parameters:
`a` - the value for the z factor that applies to x
`b` - the value for the z factor that applies to y
`dest` - will hold the result
Returns:
dest
• equals

```boolean equals​(Matrix4fc m,
float delta)```
Compare the matrix elements of `this` matrix with the given matrix using the given `delta` and return whether all of them are equal within a maximum difference of `delta`.

Please note that this method is not used by any data structure such as `ArrayList` `HashSet` or `HashMap` and their operations, such as `ArrayList.contains(Object)` or `HashSet.remove(Object)`, since those data structures only use the `Object.equals(Object)` and `Object.hashCode()` methods.

Parameters:
`m` - the other matrix
`delta` - the allowed maximum difference
Returns:
`true` whether all of the matrix elements are equal; `false` otherwise