com.io7m.jtensors

Class MatrixM2x2F

java.lang.Object

com.io7m.jtensors.MatrixM2x2F

public final class MatrixM2x2F
extends Object

Functions over 2x2 mutable matrix types with float elements.

See "Mathematics for 3D Game Programming and Computer Graphics" 2nd Ed for the derivations of most of the code in this class (ISBN: 1-58450-277-0).

See http://en.wikipedia.org/wiki/Row_equivalence#Elementary_row_operations for the three elementary operations defined on matrices.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MatrixM2x2F.ContextMM2F The ContextMM2F type contains the minimum storage required for all of the functions of the MatrixM2x2F class.

Method Summary

Modifier and Type	Method and Description
static <M extends MatrixWritable2x2FType> M	add(MatrixReadable2x2FType m0, MatrixReadable2x2FType m1, M out) Elementwise add of matrices m0 and m1.
static <M extends MatrixWritable2x2FType & MatrixReadable2x2FType> M	addInPlace(M m0, MatrixReadable2x2FType m1) Elementwise add of matrices m0 and m1, returning the result in m0.
static <M extends MatrixWritable2x2FType> M	addRowScaled(MatrixM2x2F.ContextMM2F c, MatrixReadable2x2FType m, int row_a, int row_b, int row_c, float r, M out) Add the values in row row_b to the values in row row_a scaled by r, saving the resulting row in row row_c of the matrix out.
static <M extends MatrixWritable2x2FType & MatrixReadable2x2FType> M	addRowScaledInPlace(MatrixM2x2F.ContextMM2F c, M m, int row_a, int row_b, int row_c, float r) Add the values in row row_b to the values in row row_a scaled by r, saving the resulting row in row row_c of the matrix m.
static boolean	compareElements(MatrixReadable2x2FType m0, MatrixReadable2x2FType m1) Compare matrices.
static <M extends MatrixWritable2x2FType> M	copy(MatrixReadable2x2FType input, M output) Copy the contents of the matrix input to the matrix output, completely replacing all elements.
static float	determinant(MatrixReadable2x2FType m) Calculate the determinant of the matrix m.
static <M extends MatrixWritable2x2FType> M	exchangeRows(MatrixM2x2F.ContextMM2F c, MatrixReadable2x2FType m, int row_a, int row_b, M out) Exchange two rows row_a and row row_b of the matrix m, saving the exchanged rows to out.
static <M extends MatrixWritable2x2FType & MatrixReadable2x2FType> M	exchangeRowsInPlace(MatrixM2x2F.ContextMM2F c, M m, int row_a, int row_b) Exchange two rows row_a and row row_b of the matrix m, saving the exchanged rows to m.
static int	hashElements(MatrixReadable2x2FType m) Hash matrices.
static <M extends MatrixWritable2x2FType> boolean	invert(MatrixReadable2x2FType m, M out) Calculate the inverse of the matrix m, saving the resulting matrix to out.
static <M extends MatrixWritable2x2FType & MatrixReadable2x2FType> boolean	invertInPlace(M m) Calculate the inverse of the matrix m, saving the resulting matrix to m.
static <M extends MatrixWritable2x2FType> M	multiply(MatrixReadable2x2FType m0, MatrixReadable2x2FType m1, M out) Multiply the matrix m0 with the matrix m1, writing the result to out.
static <M extends MatrixWritable2x2FType & MatrixReadable2x2FType> M	multiplyInPlace(M m0, MatrixReadable2x2FType m1) Multiply the matrix m0 with the matrix m1, writing the result to m0.
static <V extends VectorWritable2FType> V	multiplyVector2F(MatrixM2x2F.ContextMM2F c, MatrixReadable2x2FType m, VectorReadable2FType v, V out) Multiply the matrix m with the vector v, writing the resulting vector to out.
static <M extends MatrixWritable2x2FType> M	scale(MatrixReadable2x2FType m, float r, M out) Scale all elements of the matrix m by the scaling value r, saving the result in out.
static <M extends MatrixWritable2x2FType & MatrixReadable2x2FType> M	scaleInPlace(M m, float r) Scale all elements of the matrix m by the scaling value r, saving the result in m.
static <M extends MatrixWritable2x2FType> M	scaleRow(MatrixM2x2F.ContextMM2F c, MatrixReadable2x2FType m, int row, float r, M out) Scale row r of the matrix m by r, saving the result to row r of out.
static <M extends MatrixWritable2x2FType & MatrixReadable2x2FType> M	scaleRowInPlace(MatrixM2x2F.ContextMM2F c, M m, int row, float r) Scale row r of the matrix m by r, saving the result to row r of m.
static <M extends MatrixWritable2x2FType> M	setIdentity(M m) Set the given matrix m to the identity matrix.
static <M extends MatrixWritable2x2FType> M	setZero(M m) Set the given matrix m to the zero matrix.
static void	showElements(MatrixReadable2x2FType m, StringBuilder sb) Show matrices.
static float	trace(MatrixReadable2x2FType m) Return the trace of the matrix m.
static <M extends MatrixWritable2x2FType> M	transpose(MatrixReadable2x2FType m, M out) Transpose the given matrix m, writing the resulting matrix to out.
static <M extends MatrixWritable2x2FType & MatrixReadable2x2FType> M	transposeInPlace(M m) Transpose the given matrix m, writing the resulting matrix to m.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

add

public static <M extends MatrixWritable2x2FType> M add(MatrixReadable2x2FType m0,
                                                       MatrixReadable2x2FType m1,
                                                       M out)

Elementwise add of matrices m0 and m1.

Type Parameters:

M - The precise type of matrix

Parameters:

m0 - The left input matrix

m1 - The right input matrix

out - The output matrix

Returns:

out

addInPlace

public static <M extends MatrixWritable2x2FType & MatrixReadable2x2FType> M addInPlace(M m0,
                                                                                       MatrixReadable2x2FType m1)

Elementwise add of matrices m0 and m1, returning the result in m0.

Type Parameters:

M - The precise type of matrix

Parameters:

m0 - The left input matrix

m1 - The right input matrix

Returns:

m0

Since:

5.0.0

addRowScaled

public static <M extends MatrixWritable2x2FType> M addRowScaled(MatrixM2x2F.ContextMM2F c,
                                                                MatrixReadable2x2FType m,
                                                                int row_a,
                                                                int row_b,
                                                                int row_c,
                                                                float r,
                                                                M out)

Add the values in row row_b to the values in row row_a scaled by r, saving the resulting row in row row_c of the matrix out.

This is one of the three elementary operations defined on matrices.

Type Parameters:

M - The precise type of matrix

Parameters:

c - Preallocated storage

m - The input matrix

row_a - The row on the lefthand side of the addition

row_b - The row on the righthand side of the addition

row_c - The destination row

r - The scaling value

out - The output matrix

Returns:

out

addRowScaledInPlace

public static <M extends MatrixWritable2x2FType & MatrixReadable2x2FType> M addRowScaledInPlace(MatrixM2x2F.ContextMM2F c,
                                                                                                M m,
                                                                                                int row_a,
                                                                                                int row_b,
                                                                                                int row_c,
                                                                                                float r)

Add the values in row row_b to the values in row row_a scaled by r, saving the resulting row in row row_c of the matrix m.

This is one of the three elementary operations defined on matrices.

Type Parameters:

M - The precise type of matrix

Parameters:

c - Preallocated storage

m - The input matrix

row_a - The row on the lefthand side of the addition

row_b - The row on the righthand side of the addition

row_c - The destination row

r - The scaling value

Returns:

m

copy

public static <M extends MatrixWritable2x2FType> M copy(MatrixReadable2x2FType input,
                                                        M output)

Copy the contents of the matrix input to the matrix output, completely replacing all elements.

Type Parameters:

M - The precise type of matrix

Parameters:

input - The input vector

output - The output vector

Returns:

output

determinant

public static float determinant(MatrixReadable2x2FType m)

Calculate the determinant of the matrix m.

Parameters:

m - The input matrix

Returns:

The determinant

exchangeRows

public static <M extends MatrixWritable2x2FType> M exchangeRows(MatrixM2x2F.ContextMM2F c,
                                                                MatrixReadable2x2FType m,
                                                                int row_a,
                                                                int row_b,
                                                                M out)

Exchange two rows row_a and row row_b of the matrix m, saving the exchanged rows to out.

This is one of the three elementary operations defined on matrices.

Type Parameters:

M - The precise type of matrix

Parameters:

c - Preallocated storage

m - The input matrix

row_a - The first row

row_b - The second row

out - The output matrix

Returns:

out

exchangeRowsInPlace

public static <M extends MatrixWritable2x2FType & MatrixReadable2x2FType> M exchangeRowsInPlace(MatrixM2x2F.ContextMM2F c,
                                                                                                M m,
                                                                                                int row_a,
                                                                                                int row_b)

Exchange two rows row_a and row row_b of the matrix m, saving the exchanged rows to m.

This is one of the three elementary operations defined on matrices.

Type Parameters:

M - The precise type of matrix

Parameters:

c - Preallocated storage

m - The input matrix

row_a - The first row

row_b - The second row

Returns:

m

invert

public static <M extends MatrixWritable2x2FType> boolean invert(MatrixReadable2x2FType m,
                                                                M out)

Calculate the inverse of the matrix m, saving the resulting matrix to out. The function returns Some(out) iff it was possible to invert the matrix, and None otherwise. It is not possible to invert a matrix that has a determinant of 0. If the function returns None, m is untouched.

Type Parameters:

M - The precise type of matrix

Parameters:

m - The input matrix

out - The output matrix

Returns:

true iff the matrix was invertible

See Also:

determinant(MatrixReadable2x2FType)

invertInPlace

public static <M extends MatrixWritable2x2FType & MatrixReadable2x2FType> boolean invertInPlace(M m)

Calculate the inverse of the matrix m, saving the resulting matrix to m. The function returns Some(m) iff it was possible to invert the matrix, and None otherwise. It is not possible to invert a matrix that has a determinant of 0. If the function returns None, m is untouched.

Type Parameters:

M - The precise type of matrix

Parameters:

m - The input matrix

Returns:

true iff the matrix was invertible

See Also:

determinant(MatrixReadable2x2FType)

multiply

public static <M extends MatrixWritable2x2FType> M multiply(MatrixReadable2x2FType m0,
                                                            MatrixReadable2x2FType m1,
                                                            M out)

Multiply the matrix m0 with the matrix m1, writing the result to out.

Type Parameters:

M - The precise type of matrix

Parameters:

m0 - The left input matrix

m1 - The right input matrix

out - The output matrix

Returns:

out

multiplyInPlace

public static <M extends MatrixWritable2x2FType & MatrixReadable2x2FType> M multiplyInPlace(M m0,
                                                                                            MatrixReadable2x2FType m1)

Multiply the matrix m0 with the matrix m1, writing the result to m0.

Type Parameters:

M - The precise type of matrix

Parameters:

m0 - The left input vector

m1 - The right input vector

Returns:

out

multiplyVector2F

public static <V extends VectorWritable2FType> V multiplyVector2F(MatrixM2x2F.ContextMM2F c,
                                                                  MatrixReadable2x2FType m,
                                                                  VectorReadable2FType v,
                                                                  V out)

Multiply the matrix m with the vector v, writing the resulting vector to out.

Type Parameters:

V - The precise type of writable vector

Parameters:

c - Preallocated storage

m - The input matrix

v - The input vector

out - The output vector

Returns:

out

scale

public static <M extends MatrixWritable2x2FType> M scale(MatrixReadable2x2FType m,
                                                         float r,
                                                         M out)

Scale all elements of the matrix m by the scaling value r, saving the result in out.

Type Parameters:

M - The precise type of matrix

Parameters:

m - The input matrix

r - The scaling value

out - The output matrix

Returns:

out

scaleInPlace

public static <M extends MatrixWritable2x2FType & MatrixReadable2x2FType> M scaleInPlace(M m,
                                                                                         float r)

Scale all elements of the matrix m by the scaling value r, saving the result in m.

Type Parameters:

M - The precise type of matrix

Parameters:

m - The input matrix

r - The scaling value

Returns:

m

scaleRow

public static <M extends MatrixWritable2x2FType> M scaleRow(MatrixM2x2F.ContextMM2F c,
                                                            MatrixReadable2x2FType m,
                                                            int row,
                                                            float r,
                                                            M out)

Scale row r of the matrix m by r, saving the result to row r of out.

This is one of the three elementary operations defined on matrices.

Type Parameters:

M - The precise type of matrix

Parameters:

c - Preallocated storage

m - The input matrix

row - The index of the row (0 <= row < 2)

r - The scaling value

out - The output matrix

Returns:

out

scaleRowInPlace

public static <M extends MatrixWritable2x2FType & MatrixReadable2x2FType> M scaleRowInPlace(MatrixM2x2F.ContextMM2F c,
                                                                                            M m,
                                                                                            int row,
                                                                                            float r)

Scale row r of the matrix m by r, saving the result to row r of m.

This is one of the three elementary operations defined on matrices.

Type Parameters:

M - The precise type of matrix

Parameters:

c - Preallocated storage

m - The input matrix

row - The index of the row (0 <= row < 2)

r - The scaling value

Returns:

m

setIdentity

public static <M extends MatrixWritable2x2FType> M setIdentity(M m)

Set the given matrix m to the identity matrix.

Type Parameters:

M - The precise type of matrix

Parameters:

m - The matrix

Returns:

m

setZero

public static <M extends MatrixWritable2x2FType> M setZero(M m)

Set the given matrix m to the zero matrix.

Type Parameters:

M - The precise type of matrix

Parameters:

m - The matrix

Returns:

m

trace

public static float trace(MatrixReadable2x2FType m)

Return the trace of the matrix m. The trace is defined as the sum of the diagonal elements of the matrix.

Parameters:

m - The input matrix

Returns:

The trace of the matrix

Since:

5.0.0

transpose

public static <M extends MatrixWritable2x2FType> M transpose(MatrixReadable2x2FType m,
                                                             M out)

Transpose the given matrix m, writing the resulting matrix to out.

Type Parameters:

M - The precise type of matrix

Parameters:

m - The input matrix

out - The output matrix

Returns:

out

transposeInPlace

public static <M extends MatrixWritable2x2FType & MatrixReadable2x2FType> M transposeInPlace(M m)

Transpose the given matrix m, writing the resulting matrix to m.

Type Parameters:

M - The precise type of matrix

Parameters:

m - The input matrix

Returns:

m

compareElements

public static boolean compareElements(MatrixReadable2x2FType m0,
                                      MatrixReadable2x2FType m1)

Compare matrices.

Parameters:

m0 - The left matrix

m1 - The right matrix

Returns:

true if all elements of m0 are equal to m1.

Since:

7.0.0

hashElements

public static int hashElements(MatrixReadable2x2FType m)

Hash matrices.

Parameters:

m - The input matrix

Returns:

The hash of all the elements of m

Since:

7.0.0

showElements

public static void showElements(MatrixReadable2x2FType m,
                                StringBuilder sb)

Show matrices. Print all of the elements of m in square-bracketed matrix form.

Parameters:

m - The input matrix

sb - The string builder

Since:

7.0.0