Collaboration diagram for com.maxst.ar.Matrix:

Static Public Member Functions
static void	multiplyMM (float[] output, int outputOffset, float[] lhs, int lhsOffset, float[] rhs, int rhsOffset)

static void	multiplyMM (float[] output, float[] lhs, float[] rhs)

static void	multiplyMV (float[] output, int outputOffset, float[] lhs, int lhsOffset, float[] rhs, int rhsOffset)

static void	multiplyMV (float[] outputV, float[] inputM, float[] inputV)

static void	multiplyMV3 (float[] outputV, float[] inputM, float[] inputV, float w)

static void	transposeM (float[] mTrans, int mTransOffset, float[] m, int mOffset)

static boolean	invertM (float[] mInv, int mInvOffset, float[] m, int mOffset)

static void	orthoM (float[] m, int mOffset, float left, float right, float bottom, float top, float near, float far)

static void	frustumM (float[] m, int offset, float left, float right, float bottom, float top, float near, float far)

static void	perspectiveM (float[] m, int offset, float fovy, float aspect, float zNear, float zFar)

static float	length (float x, float y, float z)

static void	setIdentityM (float[] sm, int smOffset)

static void	scaleM (float[] sm, int smOffset, float[] m, int mOffset, float x, float y, float z)

static void	scaleM (float[] m, int mOffset, float x, float y, float z)

static void	translateM (float[] tm, int tmOffset, float[] m, int mOffset, float x, float y, float z)

static void	translateM (float[] m, int mOffset, float x, float y, float z)

static void	rotateM (float[] rm, int rmOffset, float[] m, int mOffset, float a, float x, float y, float z)

static void	rotateM (float[] m, int mOffset, float a, float x, float y, float z)

static void	setRotateM (float[] rm, int rmOffset, float a, float x, float y, float z)

static void	setRotateEulerM (float[] rm, int rmOffset, float x, float y, float z)

static void	setLookAtM (float[] rm, int rmOffset, float eyeX, float eyeY, float eyeZ, float centerX, float centerY, float centerZ, float upX, float upY, float upZ)

Detailed Description

Matrix math utilities. These methods operate on OpenGL ES format matrices and vectors stored in float arrays.

Matrices are 4 x 4 column-vector matrices stored in column-major order:

 m[offset +  0] m[offset +  4] m[offset +  8] m[offset + 12]
 m[offset +  1] m[offset +  5] m[offset +  9] m[offset + 13]
 m[offset +  2] m[offset +  6] m[offset + 10] m[offset + 14]
 m[offset +  3] m[offset +  7] m[offset + 11] m[offset + 15]

Vectors are 4 row x 1 column column-vectors stored in order:

v[offset + 0]
v[offset + 1]
v[offset + 2]
v[offset + 3]

Member Function Documentation

◆ frustumM()

static void com.maxst.ar.Matrix.frustumM	(	float[]	m,
		int	offset,
		float	left,
		float	right,
		float	bottom,
		float	top,
		float	near,
		float	far
	)

static

Define a projection matrix in terms of six clip planes

Parameters

m	the float array that holds the perspective matrix
offset	the offset into float array m where the perspective matrix data is written
left
right
bottom
top
near
far

◆ invertM()

static boolean com.maxst.ar.Matrix.invertM	(	float[]	mInv,
		int	mInvOffset,
		float[]	m,
		int	mOffset
	)

static

Inverts a 4 x 4 matrix.

Parameters

mInv	the array that holds the output inverted matrix
mInvOffset	an offset into mInv where the inverted matrix is stored.
m	the input array
mOffset	an offset into m where the matrix is stored.

Returns: true if the matrix could be inverted, false if it could not.

◆ length()

static float com.maxst.ar.Matrix.length	(	float	x,
		float	y,
		float	z
	)

static

Computes the length of a vector

Parameters

x	x coordinate of a vector
y	y coordinate of a vector
z	z coordinate of a vector

Returns: the length of a vector

Here is the caller graph for this function:

◆ multiplyMM() [1/2]

static void com.maxst.ar.Matrix.multiplyMM	(	float[]	output,
		float[]	lhs,
		float[]	rhs
	)

static

◆ multiplyMM() [2/2]

static void com.maxst.ar.Matrix.multiplyMM	(	float[]	output,
		int	outputOffset,
		float[]	lhs,
		int	lhsOffset,
		float[]	rhs,
		int	rhsOffset
	)

static

Multiply two 4x4 matrices together and store the result in a third 4x4 matrix. In matrix notation: result = lhs x rhs. Due to the way matrix multiplication works, the result matrix will have the same effect as first multiplying by the rhs matrix, then multiplying by the lhs matrix. This is the opposite of what you might expect.

The same float array may be passed for result, lhs, and/or rhs. However, the result element values are undefined if the result elements overlap either the lhs or rhs elements.

Parameters

result	The float array that holds the result.
resultOffset	The offset into the result array where the result is stored.
lhs	The float array that holds the left-hand-side matrix.
lhsOffset	The offset into the lhs array where the lhs is stored
rhs	The float array that holds the right-hand-side matrix.
rhsOffset	The offset into the rhs array where the rhs is stored.

Exceptions

IllegalArgumentException if result, lhs, or rhs are null, or if resultOffset + 16 > result.length or lhsOffset + 16 > lhs.length or rhsOffset + 16 > rhs.length. public static void multiplyMM(float[] result, int resultOffset, float[] lhs, int lhsOffset, float[] rhs, int rhsOffset){ android.opengl.Matrix.multiplyMM(result, resultOffset, lhs, lhsOffset, rhs, rhsOffset); }

Here is the caller graph for this function:

◆ multiplyMV() [1/2]

static void com.maxst.ar.Matrix.multiplyMV	(	float[]	output,
		int	outputOffset,
		float[]	lhs,
		int	lhsOffset,
		float[]	rhs,
		int	rhsOffset
	)

static

Multiply a 4 element vector by a 4x4 matrix and store the result in a 4 element column vector. In matrix notation: result = lhs x rhs

The same float array may be passed for resultVec, lhsMat, and/or rhsVec. However, the resultVec element values are undefined if the resultVec elements overlap either the lhsMat or rhsVec elements.

Parameters

resultVec	The float array that holds the result vector.
resultVecOffset	The offset into the result array where the result vector is stored.
lhsMat	The float array that holds the left-hand-side matrix.
lhsMatOffset	The offset into the lhs array where the lhs is stored
rhsVec	The float array that holds the right-hand-side vector.
rhsVecOffset	The offset into the rhs vector where the rhs vector is stored.

Exceptions

IllegalArgumentException if resultVec, lhsMat, or rhsVec are null, or if resultVecOffset + 4 > resultVec.length or lhsMatOffset + 16 > lhsMat.length or rhsVecOffset + 4 > rhsVec.length.

◆ multiplyMV() [2/2]

static void com.maxst.ar.Matrix.multiplyMV	(	float[]	outputV,
		float[]	inputM,
		float[]	inputV
	)

static

◆ multiplyMV3()

static void com.maxst.ar.Matrix.multiplyMV3	(	float[]	outputV,
		float[]	inputM,
		float[]	inputV,
		float	w
	)

static

◆ orthoM()

static void com.maxst.ar.Matrix.orthoM	(	float[]	m,
		int	mOffset,
		float	left,
		float	right,
		float	bottom,
		float	top,
		float	near,
		float	far
	)

static

Computes an orthographic projection matrix.

Parameters

m	returns the result
mOffset
left
right
bottom
top
near
far

◆ perspectiveM()

static void com.maxst.ar.Matrix.perspectiveM	(	float[]	m,
		int	offset,
		float	fovy,
		float	aspect,
		float	zNear,
		float	zFar
	)

static

Define a projection matrix in terms of a field of view angle, an aspect ratio, and z clip planes

Parameters

m	the float array that holds the perspective matrix
offset	the offset into float array m where the perspective matrix data is written
fovy	field of view in y direction, in degrees
aspect	width to height aspect ratio of the viewport
zNear
zFar

◆ rotateM() [1/2]

static void com.maxst.ar.Matrix.rotateM	(	float[]	m,
		int	mOffset,
		float	a,
		float	x,
		float	y,
		float	z
	)

static

Rotates matrix m in place by angle a (in degrees) around the axis (x, y, z)

Parameters

m	source matrix
mOffset	index into m where the matrix starts
a	angle to rotate in degrees
x	scale factor x
y	scale factor y
z	scale factor z

Here is the call graph for this function:

◆ rotateM() [2/2]

static void com.maxst.ar.Matrix.rotateM	(	float[]	rm,
		int	rmOffset,
		float[]	m,
		int	mOffset,
		float	a,
		float	x,
		float	y,
		float	z
	)

static

Rotates matrix m by angle a (in degrees) around the axis (x, y, z)

Parameters

rm	returns the result
rmOffset	index into rm where the result matrix starts
m	source matrix
mOffset	index into m where the source matrix starts
a	angle to rotate in degrees
x	scale factor x
y	scale factor y
z	scale factor z

Here is the call graph for this function:

◆ scaleM() [1/2]

static void com.maxst.ar.Matrix.scaleM	(	float[]	m,
		int	mOffset,
		float	x,
		float	y,
		float	z
	)

static

Scales matrix m in place by sx, sy, and sz

Parameters

m	matrix to scale
mOffset	index into m where the matrix starts
x	scale factor x
y	scale factor y
z	scale factor z

◆ scaleM() [2/2]

static void com.maxst.ar.Matrix.scaleM	(	float[]	sm,
		int	smOffset,
		float[]	m,
		int	mOffset,
		float	x,
		float	y,
		float	z
	)

static

Scales matrix m by x, y, and z, putting the result in sm

Parameters

sm	returns the result
smOffset	index into sm where the result matrix starts
m	source matrix
mOffset	index into m where the source matrix starts
x	scale factor x
y	scale factor y
z	scale factor z

◆ setIdentityM()

static void com.maxst.ar.Matrix.setIdentityM	(	float[]	sm,
		int	smOffset
	)

static

Sets matrix m to the identity matrix.

Parameters

sm	returns the result
smOffset	index into sm where the result matrix starts

Here is the caller graph for this function:

◆ setLookAtM()

static void com.maxst.ar.Matrix.setLookAtM	(	float[]	rm,
		int	rmOffset,
		float	eyeX,
		float	eyeY,
		float	eyeZ,
		float	centerX,
		float	centerY,
		float	centerZ,
		float	upX,
		float	upY,
		float	upZ
	)

static

Define a viewing transformation in terms of an eye point, a center of view, and an up vector.

Parameters

rm	returns the result
rmOffset	index into rm where the result matrix starts
eyeX	eye point X
eyeY	eye point Y
eyeZ	eye point Z
centerX	center of view X
centerY	center of view Y
centerZ	center of view Z
upX	up vector X
upY	up vector Y
upZ	up vector Z

Here is the call graph for this function:

◆ setRotateEulerM()

static void com.maxst.ar.Matrix.setRotateEulerM	(	float[]	rm,
		int	rmOffset,
		float	x,
		float	y,
		float	z
	)

static

Converts Euler angles to a rotation matrix

Parameters

rm	returns the result
rmOffset	index into rm where the result matrix starts
x	angle of rotation, in degrees
y	angle of rotation, in degrees
z	angle of rotation, in degrees

◆ setRotateM()

static void com.maxst.ar.Matrix.setRotateM	(	float[]	rm,
		int	rmOffset,
		float	a,
		float	x,
		float	y,
		float	z
	)

static

Rotates matrix m by angle a (in degrees) around the axis (x, y, z)

Parameters

rm	returns the result
rmOffset	index into rm where the result matrix starts
a	angle to rotate in degrees
x	scale factor x
y	scale factor y
z	scale factor z

Here is the call graph for this function:

Here is the caller graph for this function:

◆ translateM() [1/2]

static void com.maxst.ar.Matrix.translateM	(	float[]	m,
		int	mOffset,
		float	x,
		float	y,
		float	z
	)

static

Translates matrix m by x, y, and z in place.

Parameters

m	matrix
mOffset	index into m where the matrix starts
x	translation factor x
y	translation factor y
z	translation factor z

◆ translateM() [2/2]

static void com.maxst.ar.Matrix.translateM	(	float[]	tm,
		int	tmOffset,
		float[]	m,
		int	mOffset,
		float	x,
		float	y,
		float	z
	)

static

Translates matrix m by x, y, and z, putting the result in tm

Parameters

tm	returns the result
tmOffset	index into sm where the result matrix starts
m	source matrix
mOffset	index into m where the source matrix starts
x	translation factor x
y	translation factor y
z	translation factor z

Here is the caller graph for this function:

◆ transposeM()

static void com.maxst.ar.Matrix.transposeM	(	float[]	mTrans,
		int	mTransOffset,
		float[]	m,
		int	mOffset
	)

static

Transposes a 4 x 4 matrix.

Parameters

mTrans	the array that holds the output inverted matrix
mTransOffset	an offset into mInv where the inverted matrix is stored.
m	the input array
mOffset	an offset into m where the matrix is stored.

The documentation for this class was generated from the following file:

/Users/acper/work/c_maxstarsdk_season3/Platform/MaxstARAndroid/MaxstAR/src/main/java/com/maxst/ar/Matrix.java

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ frustumM()

◆ invertM()

◆ length()

◆ multiplyMM() [1/2]

◆ multiplyMM() [2/2]

◆ multiplyMV() [1/2]

◆ multiplyMV() [2/2]

◆ multiplyMV3()

◆ orthoM()

◆ perspectiveM()

◆ rotateM() [1/2]

◆ rotateM() [2/2]

◆ scaleM() [1/2]

◆ scaleM() [2/2]

◆ setIdentityM()

◆ setLookAtM()

◆ setRotateEulerM()

◆ setRotateM()

◆ translateM() [1/2]

◆ translateM() [2/2]

◆ transposeM()