Matrix

MPERSP_0

public static final int MPERSP_0

Constant Value: 6 (0x00000006)

MPERSP_1

public static final int MPERSP_1

Constant Value: 7 (0x00000007)

MPERSP_2

public static final int MPERSP_2

Constant Value: 8 (0x00000008)

MSCALE_X

public static final int MSCALE_X

Constant Value: 0 (0x00000000)

MSCALE_Y

public static final int MSCALE_Y

Constant Value: 4 (0x00000004)

MSKEW_X

public static final int MSKEW_X

Constant Value: 1 (0x00000001)

MSKEW_Y

public static final int MSKEW_Y

Constant Value: 3 (0x00000003)

MTRANS_X

public static final int MTRANS_X

Constant Value: 2 (0x00000002)

MTRANS_Y

public static final int MTRANS_Y

Constant Value: 5 (0x00000005)

IDENTITY_MATRIX

public static final Matrix IDENTITY_MATRIX

The identity matrix. Multiplying by another matrix M returns M. This matrix is immutable, and attempting to modify it will throw an IllegalStateException.

Matrix

public Matrix ()

Create an identity matrix

Matrix

public Matrix (Matrix src)

Create a matrix that is a (deep) copy of src

dump

public final void dump (PrintWriter pw)

Dumps a human-readable shortened string of the matrix into the given stream

equals

public boolean equals (Object obj)

Returns true iff obj is a Matrix and its values equal our values.

getValues

public void getValues (float[] values)

Copy 9 values from the matrix into the array.

hashCode

public int hashCode ()

Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by HashMap.

The general contract of hashCode is:

• Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
• If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
• It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

invert

public boolean invert (Matrix inverse)

If this matrix can be inverted, return true and if inverse is not null, set inverse to be the inverse of this matrix. If this matrix cannot be inverted, ignore inverse and return false.

isAffine

public boolean isAffine ()

Gets whether this matrix is affine. An affine matrix preserves straight lines and has no perspective.

isIdentity

public boolean isIdentity ()

Returns true if the matrix is identity. This maybe faster than testing if (getType() == 0)

mapPoints

public void mapPoints (float[] dst, 
                int dstIndex, 
                float[] src, 
                int srcIndex, 
                int pointCount)

Apply this matrix to the array of 2D points specified by src, and write the transformed points into the array of points specified by dst. The two arrays represent their "points" as pairs of floats [x, y].

mapPoints

public void mapPoints (float[] dst, 
                float[] src)

Apply this matrix to the array of 2D points specified by src, and write the transformed points into the array of points specified by dst. The two arrays represent their "points" as pairs of floats [x, y].

mapPoints

public void mapPoints (float[] pts)

Apply this matrix to the array of 2D points, and write the transformed points back into the array

mapRadius

public float mapRadius (float radius)

Return the mean radius of a circle after it has been mapped by this matrix. NOTE: in perspective this value assumes the circle has its center at the origin.

mapRect

public boolean mapRect (RectF rect)

Apply this matrix to the rectangle, and write the transformed rectangle back into it. This is accomplished by transforming the 4 corners of rect, and then setting it to the bounds of those points

mapRect

public boolean mapRect (RectF dst, 
                RectF src)

Apply this matrix to the src rectangle, and write the transformed rectangle into dst. This is accomplished by transforming the 4 corners of src, and then setting dst to the bounds of those points.

mapVectors

public void mapVectors (float[] vecs)

Apply this matrix to the array of 2D vectors, and write the transformed vectors back into the array. Note: this method does not apply the translation associated with the matrix. Use Matrix#mapPoints(float[]) if you want the translation to be applied.

mapVectors

public void mapVectors (float[] dst, 
                int dstIndex, 
                float[] src, 
                int srcIndex, 
                int vectorCount)

Apply this matrix to the array of 2D vectors specified by src, and write the transformed vectors into the array of vectors specified by dst. The two arrays represent their "vectors" as pairs of floats [x, y]. Note: this method does not apply the translation associated with the matrix. Use Matrix#mapPoints(float[], int, float[], int, int) if you want the translation to be applied.

mapVectors

public void mapVectors (float[] dst, 
                float[] src)

Apply this matrix to the array of 2D vectors specified by src, and write the transformed vectors into the array of vectors specified by dst. The two arrays represent their "vectors" as pairs of floats [x, y]. Note: this method does not apply the translation associated with the matrix. Use Matrix#mapPoints(float[], float[]) if you want the translation to be applied.

postConcat

public boolean postConcat (Matrix other)

Postconcats the matrix with the specified matrix. M' = other * M

postRotate

public boolean postRotate (float degrees, 
                float px, 
                float py)

Postconcats the matrix with the specified rotation. M' = R(degrees, px, py) * M

postRotate

public boolean postRotate (float degrees)

Postconcats the matrix with the specified rotation. M' = R(degrees) * M

postScale

public boolean postScale (float sx, 
                float sy, 
                float px, 
                float py)

Postconcats the matrix with the specified scale. M' = S(sx, sy, px, py) * M

postScale

public boolean postScale (float sx, 
                float sy)

Postconcats the matrix with the specified scale. M' = S(sx, sy) * M

postSkew

public boolean postSkew (float kx, 
                float ky)

Postconcats the matrix with the specified skew. M' = K(kx, ky) * M

postSkew

public boolean postSkew (float kx, 
                float ky, 
                float px, 
                float py)

Postconcats the matrix with the specified skew. M' = K(kx, ky, px, py) * M

postTranslate

public boolean postTranslate (float dx, 
                float dy)

Postconcats the matrix with the specified translation. M' = T(dx, dy) * M

preConcat

public boolean preConcat (Matrix other)

Preconcats the matrix with the specified matrix. M' = M * other

preRotate

public boolean preRotate (float degrees)

Preconcats the matrix with the specified rotation. M' = M * R(degrees)

preRotate

public boolean preRotate (float degrees, 
                float px, 
                float py)

Preconcats the matrix with the specified rotation. M' = M * R(degrees, px, py)

preScale

public boolean preScale (float sx, 
                float sy)

Preconcats the matrix with the specified scale. M' = M * S(sx, sy)

preScale

public boolean preScale (float sx, 
                float sy, 
                float px, 
                float py)

Preconcats the matrix with the specified scale. M' = M * S(sx, sy, px, py)

preSkew

public boolean preSkew (float kx, 
                float ky)

Preconcats the matrix with the specified skew. M' = M * K(kx, ky)

preSkew

public boolean preSkew (float kx, 
                float ky, 
                float px, 
                float py)

Preconcats the matrix with the specified skew. M' = M * K(kx, ky, px, py)

preTranslate

public boolean preTranslate (float dx, 
                float dy)

Preconcats the matrix with the specified translation. M' = M * T(dx, dy)

rectStaysRect

public boolean rectStaysRect ()

Returns true if will map a rectangle to another rectangle. This can be true if the matrix is identity, scale-only, or rotates a multiple of 90 degrees.

reset

public void reset ()

Set the matrix to identity

set

public void set (Matrix src)

(deep) copy the src matrix into this matrix. If src is null, reset this matrix to the identity matrix.

setConcat

public boolean setConcat (Matrix a, 
                Matrix b)

Set the matrix to the concatenation of the two specified matrices and return true.

Either of the two matrices may also be the target matrix, that is matrixA.setConcat(matrixA, matrixB); is valid.

In Build.VERSION_CODES.GINGERBREAD_MR1 and below, this function returns true only if the result can be represented. In Build.VERSION_CODES.HONEYCOMB and above, it always returns true.

setPolyToPoly

public boolean setPolyToPoly (float[] src, 
                int srcIndex, 
                float[] dst, 
                int dstIndex, 
                int pointCount)

Set the matrix such that the specified src points would map to the specified dst points. The "points" are represented as an array of floats, order [x0, y0, x1, y1, ...], where each "point" is 2 float values.

setRectToRect

public boolean setRectToRect (RectF src, 
                RectF dst, 
                Matrix.ScaleToFit stf)

Set the matrix to the scale and translate values that map the source rectangle to the destination rectangle, returning true if the result can be represented.

setRotate

public void setRotate (float degrees, 
                float px, 
                float py)

Set the matrix to rotate by the specified number of degrees, with a pivot point at (px, py). The pivot point is the coordinate that should remain unchanged by the specified transformation.

setRotate

public void setRotate (float degrees)

Set the matrix to rotate about (0,0) by the specified number of degrees.

setScale

public void setScale (float sx, 
                float sy)

Set the matrix to scale by sx and sy.

setScale

public void setScale (float sx, 
                float sy, 
                float px, 
                float py)

Set the matrix to scale by sx and sy, with a pivot point at (px, py). The pivot point is the coordinate that should remain unchanged by the specified transformation.

setSinCos

public void setSinCos (float sinValue, 
                float cosValue, 
                float px, 
                float py)

Set the matrix to rotate by the specified sine and cosine values, with a pivot point at (px, py). The pivot point is the coordinate that should remain unchanged by the specified transformation.

setSinCos

public void setSinCos (float sinValue, 
                float cosValue)

Set the matrix to rotate by the specified sine and cosine values.

setSkew

public void setSkew (float kx, 
                float ky)

Set the matrix to skew by sx and sy.

setSkew

public void setSkew (float kx, 
                float ky, 
                float px, 
                float py)

Set the matrix to skew by sx and sy, with a pivot point at (px, py). The pivot point is the coordinate that should remain unchanged by the specified transformation.

setTranslate

public void setTranslate (float dx, 
                float dy)

Set the matrix to translate by (dx, dy).

setValues

public void setValues (float[] values)

Copy 9 values from the array into the matrix. Depending on the implementation of Matrix, these may be transformed into 16.16 integers in the Matrix, such that a subsequent call to getValues() will not yield exactly the same values.

toShortString

public String toShortString ()

toString

public String toString ()

Returns a string representation of the object.