net.rim.device.api.math
Class VecMath

java.lang.Object
  |
  +--net.rim.device.api.math.VecMath

public final class VecMath

extends Object

Implementations of a stack for use in matrix multiplication. Does matrix multiplication on 3x3 matrices. Matrix indices are fixed point ints with 16:16 format.

Since:

JDE 4.0.0

Field Summary

static int[]

IDENTITY_3X3 3 x 3 identity matrix.

Constructor Summary

VecMath()

Method Summary

static boolean	intersects(int ax0, int ay0, int ax1, int ay1, int bx0, int by0, int bx1, int by1) Does line segment A intersection line segment B?
static boolean	isIdentity(int[] source, int index) Is this matrix, represented by this array, the indentity matrix?
static void	multiply3x3(int[] a, int aStartIndex, int[] b, int bStartIndex) Deprecated. use multiply3x3(int[],int,int[],int,int[],int) and pass B as the destination matrix.
static void	multiply3x3(int[] a, int aStartIndex, int[] b, int bStartIndex, int[] dest, int destStartIndex) Multiplies 2 3x3 matrices (A x B).
static void	multiply3x3Affine(int[] a, int aStartIndex, int[] b, int bStartIndex, int[] dest, int destStartIndex) Multiplies 2 affine 3x3 matrices (A x B).
static long	multiplyPoint(int[] matrix, int pos, int x, int y)
static void	pointMultiply3x3(int[] a, int aStartIndex, int x, int y, int[] dest, int destStartIndex) Multiplies a given x,y point by a given 3x3 matrix.
static void	transformPoints(int[] matrix, int matrixOffset, int[] coordsX, int[] coordsY, int[] destX, int[] destY)

Methods inherited from class java.lang.Object

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

Field Detail

IDENTITY_3X3

public static final int[] IDENTITY_3X3

3 x 3 identity matrix.

Since:

JDE 4.0.0

Constructor Detail

VecMath

public VecMath()

Since:

JDE 4.0.0

Method Detail

multiplyPoint

public static long multiplyPoint(int[] matrix,
                                 int pos,
                                 int x,
                                 int y)

Since:

JDE 4.0.0

transformPoints

public static void transformPoints(int[] matrix,
                                   int matrixOffset,
                                   int[] coordsX,
                                   int[] coordsY,
                                   int[] destX,
                                   int[] destY)

Since:

JDE 4.0.0

isIdentity

public static final boolean isIdentity(int[] source,
                                       int index)

Is this matrix, represented by this array, the indentity matrix?

Parameters:

source - Integer array containing the matrix.

index - Offset inside the matrix

Returns:

True if it is the identity.

Since:

JDE 4.0.0

intersects

public static boolean intersects(int ax0,
                                 int ay0,
                                 int ax1,
                                 int ay1,
                                 int bx0,
                                 int by0,
                                 int bx1,
                                 int by1)

Does line segment A intersection line segment B? It receives the x and y coordinates of every line segment

Returns:

True is the line intersect.

Since:

JDE 4.0.0

multiply3x3

public static void multiply3x3(int[] a,
                               int aStartIndex,
                               int[] b,
                               int bStartIndex)

Deprecated. use multiply3x3(int[],int,int[],int,int[],int) and pass B as the destination matrix.

Multiplies 2 3x3 matrices (A x B). The result overwrites the second matrix (B). Please note, no bounds checks are made by this method. It assumes that the arrays are non-null and contain enough values for a 3x3 matrix.

Parameters:

a - the array containing matrix A

aStartIndex - the index of the start of matrix A

b - the array containing matrix B

bStartIndex - the index of the start of matrix B

Since:

JDE 4.0.0

multiply3x3

public static void multiply3x3(int[] a,
                               int aStartIndex,
                               int[] b,
                               int bStartIndex,
                               int[] dest,
                               int destStartIndex)

Multiplies 2 3x3 matrices (A x B). The result is stored in the specified destination array. Please note, no bounds checks are made by this method. It assumes that the arrays are non-null and contain enough values/space for a 3x3 matrix. If A or B would be overwritten by the operation, A or B is first copied to a temporary array before the calculation.

Parameters:

a - the array containing matrix A

aStartIndex - the index of the start of matrix A

b - the array containing matrix B

bStartIndex - the index of the start of matrix B

dest - the array to store the result of the multiplication

destStartIndex - the index at which to store the first value in the matrix.

Since:

JDE 4.0.0

multiply3x3Affine

public static void multiply3x3Affine(int[] a,
                                     int aStartIndex,
                                     int[] b,
                                     int bStartIndex,
                                     int[] dest,
                                     int destStartIndex)

Multiplies 2 affine 3x3 matrices (A x B). An affine matrix has the following form:
A C E
B D F
0 0 1

The result is stored in the specified destination array. Please note, no bounds checks are made by this method. It assumes that the arrays are non-null and contain enough values/space for a 3x3 matrix. Also this method is optimized for affine matrices. Using it with non-affine matrices give incorrect and undefined behavior.

Parameters:

a - the array containing matrix A

aStartIndex - the index of the start of matrix A

b - the array containing matrix B

bStartIndex - the index of the start of matrix B

dest - the array to store the result of the multiplication

destStartIndex - the index at which to store the first value in the matrix.

Since:

JDE 4.0.0

pointMultiply3x3

public static void pointMultiply3x3(int[] a,
                                    int aStartIndex,
                                    int x,
                                    int y,
                                    int[] dest,
                                    int destStartIndex)

Multiplies a given x,y point by a given 3x3 matrix. (A x P) The resulting x point is stored at dest[destStartIndex] and the resulting y point is stored at dest[destStartIndex + 1]. It is assumed that the arrays are of sufficient length.

Parameters:

a - the array containing the matrix to multiply.

aStartIndex - the index in a where the matrix begins.

x - the x coordinate (in Fixed 32 notation).

y - the y coordinate (in Fixed 32 notation).

dest - the array in which to store the results.

destStartOffset - the index in dest where the results should be stored.

Since:

JDE 4.0.0