Matrix

java.lang.Object
- ohos.agp.utils.Matrix

```
public class Matrix
extends Object
```
Configures a 3x3 matrix which presentation in column major to implement the translation, rotation, and scaling of a Canvas instance.
This class maintains a floating point array (whose length is 9) to form a 3x3 matrix. It provides interfaces to transform values in the array.

从以下版本开始:

3

嵌套类概要

嵌套类
限定符和类型类说明

static class Matrix.ScaleToFit
Enumerates modes of scaling a source rectangle into a destination rectangle.

嵌套类
限定符和类型	类	说明
`static class`	`Matrix.ScaleToFit`	Enumerates modes of scaling a source rectangle into a destination rectangle.

构造器概要

构造器
构造器	说明
`Matrix()`	Default constructor used to create a `Matrix` instance.
`Matrix(float[] srcMatrixArray)`	A constructor used to create a `Matrix` instance.
`Matrix(Matrix srcMatrix)`	A constructor used to create a `Matrix` instance.

方法概要

所有方法实例方法具体方法
限定符和类型	方法	说明
`boolean`	`cheapEqualTo(Matrix matrixM)`	Checks whether this `Matrix` and a specified matrix are represented by identical bit patterns.
`void`	`dirtyMatrixTypeCache()`	Sets internal cache to an unknown state.
`boolean`	`equals(Object object)`	Checks whether this `Matrix` object equals the specified `Matrix` object.
`boolean`	`equalsMatrixValue(Matrix otherMatrix)`	Obtains whether the specified object`s matrix value equals to the current matrix`s value.
`float`	`get(int index)`	Obtains a matrix value based on the array index.
`float[]`	`getData()`	Obtains the floating point array of a matrix.
`void`	`getElements(float[] elements)`	Obtains element values of this `Matrix`.
`float`	`getMaxScale()`	Obtains the maximum scale factor of this `Matrix` by decomposing the scaling and skewing elements.
`float`	`getMinScale()`	Obtains the minimum scale factor of this `Matrix` by decomposing the scaling and skewing elements.
`float`	`getPerspX()`	Obtains the horizontal perspective factor of this `Matrix`.
`float`	`getPerspY()`	Obtains the vertical perspective factor of this `Matrix`.
`float`	`getScaleX()`	Obtains the horizontal scale factor of this `Matrix`.
`float`	`getScaleY()`	Obtains the vertical scale factor of this `Matrix`.
`float`	`getSkewX()`	Obtains the horizontal skew factor of this `Matrix`.
`float`	`getSkewY()`	Obtains the vertical skew factor of this `Matrix`.
`float`	`getTranslateX()`	Obtains the horizontal translation factor of this `Matrix`.
`float`	`getTranslateY()`	Obtains the vertical translation factor of this `Matrix`.
`int`	`hashCode()`	Returns a hash code value for the object.
`boolean`	`hasPerspective()`	Checks whether this `Matrix` contains perspective elements.
`int`	`index(int row, int col)`	Calculates the array index based on the input row and column numbers.
`boolean`	`invert(Matrix inverse)`	Inverts this `Matrix`.
`boolean`	`isFinite()`	Checks whether all elements of this `Matrix` are finite.
`boolean`	`isFixedStepInX()`	Checks whether an x-axis unit step can be represented by a constant vector after matrix transformation is performed on the y axis.
`boolean`	`isIdentity()`	Checks if a matrix is an identity matrix.
`boolean`	`isScaleTranslate()`	Checks whether this `Matrix` has been scaled and translated.
`boolean`	`isSimilarity()`	Checks whether this `Matrix` contains only rotation, uniform scale, and translation.
`boolean`	`isTranslate()`	Checks whether this `Matrix` has been translated.
`void`	`mapPoints(float[] pts)`	Performs a matrix transformation on an array of points, and writes the transformation result into that array.
`void`	`mapPoints(float[] dst, float[] src)`	Performs a matrix transformation on a source array of points, and writes the transformation result into a destination array.
`void`	`mapPoints(float[] dst, int dstIndex, float[] src, int srcIndex, int pointCount)`	Performs a matrix transformation that starts from a specified point in a source array, and writes the transformation result into a destination array.
`float`	`mapRadius(float radius)`	Calculates the mean radius of a circle after being mapped by this `Matrix`.
`boolean`	`mapRect(RectFloat rectFloat)`	Performs a matrix transformation on a rectangle and writes the transformation result into that rectangle.
`boolean`	`mapRect(RectFloat dst, RectFloat src)`	Performs a matrix transformation on a source rectangle and writes the transformation result into a destination rectangle.
`void`	`mapRectScaleTranslate(RectFloat dst, RectFloat src)`	Performs matrix transformation on the source rectangle and stores the transformation result in the destination rectangle.
`void`	`multiply(Matrix otherMatrix)`	Calculates the result of multiplying the current matrix with a specified one.
`boolean`	`postConcat(Matrix otherMatrix)`	Post-multiplies this `Matrix` by a specified matrix.
`boolean`	`postIDiv(int divx, int divy)`	Post-multiplies this `Matrix` with the specified scale factors.
`void`	`postRotate(float degrees)`	Post-multiplies this `Matrix` with the specified rotation.
`boolean`	`postRotate(float degrees, float px, float py)`	Post-multiplies this `Matrix` with the specified rotation and the specified position of the perspective point.
`boolean`	`postScale(float sx, float sy)`	Post-multiplies this `Matrix` with the specified scale.
`boolean`	`postScale(float sx, float sy, float px, float py)`	Post-multiplies this `Matrix` with the specified scale and the specified position of the perspective point.
`boolean`	`postSkew(float kx, float ky)`	Post-multiplies this `Matrix` with the specified skew factors.
`boolean`	`postSkew(float kx, float ky, float px, float py)`	Post-multiplies this `Matrix` around a specified pivot by the specified skew factors.
`boolean`	`postTranslate(float dx, float dy)`	Post-multiplies this `Matrix` with the specified translation.
`boolean`	`preConcat(Matrix otherMatrix)`	Pre-multiplies this `Matrix` by a specified matrix.
`boolean`	`preRotate(float degrees)`	Pre-multiplies this `Matrix` with the specified rotation.
`boolean`	`preRotate(float degrees, float px, float py)`	Pre-multiplies this `Matrix` with the specified rotation and the specified position of the perspective point.
`boolean`	`preScale(float sx, float sy)`	Pre-multiplies this `Matrix` with the specified scale.
`boolean`	`preScale(float sx, float sy, float px, float py)`	Pre-multiplies this `Matrix` with the specified scale and the specified position of the perspective point.
`boolean`	`preservesAxisAlignment()`	Checks whether this `Matrix` can map one `Rect` object to another.
`boolean`	`preservesRightAngles()`	Checks whether this `Matrix` contains only rotation, scale (non-uniform scale allowed), and translation.
`boolean`	`preSkew(float kx, float ky)`	Pre-multiplies this `Matrix` with the specified skew.
`void`	`preSkew(float kx, float ky, float px, float py)`	Pre-multiplies this `Matrix` with the specified skew and the specified position of the perspective point.
`boolean`	`preTranslate(float dx, float dy)`	Pre-multiplies this `Matrix` with the specified translation.
`boolean`	`rectStaysRect()`	Checks whether this `Matrix` can map one rectangle to another.
`void`	`reset()`	Resets this `Matrix` to a unit matrix, also referred to as an identity matrix.
`void`	`rotate(float angle)`	Implements the rotation of a matrix by a specified degree.
`void`	`scale(float scaleX, float scaleY)`	Implements the scaling of a matrix on X-axis and Y-axis.
`boolean`	`setConcat(Matrix matrixA, Matrix matrixB)`	Sets this `Matrix` to matrix A multiplied by matrix B.
`void`	`setElements(float[] elements)`	Sets element values for this `Matrix`.
`void`	`setIdentity()`	Sets the current matrix as an identity matrix.
`void`	`setMatrix(int row, int col, float value)`	Sets a value in a specified row and column of a matrix.
`void`	`setMatrix(Matrix srcMatrix)`	Copies the values in a specified `srcMatrix` matrix to the current one.
`void`	`setPerspX(float v)`	Sets the horizontal perspective factor for this `Matrix`.
`void`	`setPerspY(float v)`	Sets the vertical perspective factor for this `Matrix`.
`boolean`	`setPolyToPoly(float[] src, int srcIndex, float[] dst, int dstIndex, int pointCount)`	Sets this `Matrix` to make the specified source points map to the specified destination points.
`boolean`	`setRectToRect(RectFloat src, RectFloat dst, Matrix.ScaleToFit scaleToFit)`	Sets a source rectangle to be inside a destination rectangle based on the specified scaling mode.
`void`	`setRotate(float degrees)`	Sets the matrix to rotate around the pivot point (0,0) by a specified number of degrees.
`void`	`setRotate(float degrees, float px, float py)`	Sets the matrix to rotate around the pivot point (px,py) by a specified number of degrees.
`void`	`setScale(float sx, float sy)`	Scales this `Matrix` by the specified values.
`void`	`setScale(float sx, float sy, float px, float py)`	Scales this `Matrix` by the specified values and the specified position of the perspective point.
`void`	`setScaleTranslate(float sx, float sy, float tx, float ty)`	Initializes the scale and translation factors of this `Matrix`.
`void`	`setScaleX(float v)`	Sets the horizontal scale factor for this `Matrix`.
`void`	`setScaleY(float v)`	Sets the vertical scale factor for this `Matrix`.
`void`	`setSinCos(float sinValue, float cosValue)`	Sets this `Matrix` to rotate about the perspective point (0,0) by the specified horizontal and vertical components of the rotation vector.
`void`	`setSinCos(float sinValue, float cosValue, float px, float py)`	Sets this `Matrix` to rotate about the perspective point at the specified coordinates by the given horizontal and vertical components of the rotation vector.
`void`	`setSkew(float kx, float ky)`	Skews this `Matrix` by the specified skew factors.
`void`	`setSkew(float kx, float ky, float px, float py)`	Skews this `Matrix` around a specified pivot by the specified skew factors.
`void`	`setSkewX(float v)`	Sets the horizontal skew factor for this `Matrix`.
`void`	`setSkewY(float v)`	Sets the vertical skew factor for this `Matrix`.
`void`	`setTranslate(float dx, float dy)`	Translates this `Matrix` with the specified values.
`void`	`setTranslateX(float v)`	Sets the horizontal translation factor for this `Matrix`.
`void`	`setTranslateY(float v)`	Sets the vertical translation factor for this `Matrix`.
`String`	`toString()`	Obtains a string representation of this `Matrix` object.
`void`	`translate(float transX, float transY)`	Implements the translation of a matrix according to the translation degree on X-axis and Y-axis.
`void`	`transpose()`	Implements the transpose of a matrix.

从类继承的方法 java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- 构造器详细资料
  - Matrix
```
public Matrix()
```
    Default constructor used to create a Matrix instance.
    
    从以下版本开始:
    
    3
  - Matrix
```
public Matrix(float[] srcMatrixArray)
```
    A constructor used to create a Matrix instance.
    This constructor creates a 3x3 matrix, and copies a specified array to initialize the matrix.
    
    参数:
    
    srcMatrixArray - Indicates the floating point array of the matrix. The array length is 9.
  - Matrix
```
public Matrix(Matrix srcMatrix)
```
    A constructor used to create a Matrix instance.
    
    参数:
    
    srcMatrix - Indicates the matrix from which the values are to copy.
    
    从以下版本开始:
    
    3
- 方法详细资料
  - getData
```
public float[] getData()
```
    Obtains the floating point array of a matrix.
    
    返回:
    
    Returns the floating point array of the matrix. The array length is 9.
  - index
```
public int index(int row,
                 int col)
```
    Calculates the array index based on the input row and column numbers.
    
    参数:
    
    col - - Indicates the row index.
    
    row - - Indicates the column index.
    
    返回:
    
    Returns the array index.
  - setMatrix
```
public void setMatrix(int row,
                      int col,
                      float value)
```
    Sets a value in a specified row and column of a matrix.
    
    参数:
    
    col - Indicates the column in which the value is to be set.
    
    row - Indicates the row in which the value is to be set.
    
    value - Indicates the value to be set.
  - setMatrix
```
public void setMatrix(Matrix srcMatrix)
```
    Copies the values in a specified srcMatrix matrix to the current one.
    
    参数:
    
    srcMatrix - Indicates the matrix from which the values are to copy.
  - setIdentity
```
public void setIdentity()
```
    Sets the current matrix as an identity matrix.
    
    从以下版本开始:
    
    3
  - reset
```
public void reset()
```
    Resets this Matrix to a unit matrix, also referred to as an identity matrix.
    
    从以下版本开始:
    
    3
  - isIdentity
```
public boolean isIdentity()
```
    Checks if a matrix is an identity matrix.
    
    返回:
    
    Returns true if the matrix is an identity matrix; returns false otherwise.
  - equalsMatrixValue
```
public boolean equalsMatrixValue(Matrix otherMatrix)
```
    Obtains whether the specified object`s matrix value equals to the current matrix`s value.
    
    参数:
    
    otherMatrix - Indicates the specified matrix.
    
    返回:
    
    Returns true if the specified object`s matrix value equals to the current matrix, returns false otherwise.
    
    从以下版本开始:
    
    3
  - multiply
```
public void multiply(Matrix otherMatrix)
```
    Calculates the result of multiplying the current matrix with a specified one.
    The specified matrix is placed to the right of the multiplication sign.
    
    参数:
    
    otherMatrix - Indicates the specified matrix to be multiplied with.
  - rotate
```
public void rotate(float angle)
```
    Implements the rotation of a matrix by a specified degree.
    The matrix rotates clockwise if angle is a positive value, and counterclockwise if it is a negative value.
    
    参数:
    
    angle - Indicates the rotation degree of the matrix.
  - scale
```
public void scale(float scaleX,
                  float scaleY)
```
    Implements the scaling of a matrix on X-axis and Y-axis.
    
    参数:
    
    scaleX - Indicates the scaling ratio on X-axis.
    
    scaleY - Indicates the scaling ratio on Y-axis.
  - translate
```
public void translate(float transX,
                      float transY)
```
    Implements the translation of a matrix according to the translation degree on X-axis and Y-axis.
    
    参数:
    
    transX - Indicates the X-axis translation degree.
    
    transY - Indicates the Y-axis translation degree.
  - transpose
```
public void transpose()
```
    Implements the transpose of a matrix.
  - setRotate
```
public void setRotate(float degrees)
```
    Sets the matrix to rotate around the pivot point (0,0) by a specified number of degrees.
    
    参数:
    
    degrees - Indicates the number of degrees to rotate.
    
    从以下版本开始:
    
    3
  - setRotate
```
public void setRotate(float degrees,
                      float px,
                      float py)
```
    Sets the matrix to rotate around the pivot point (px,py) by a specified number of degrees.
    
    参数:
    
    degrees - Indicates the number of degrees to rotate.
    
    px - Indicates the X coordinate of the pivot point.
    
    py - Indicates the Y coordinate of the pivot point.
    
    从以下版本开始:
    
    3
  - getElements
```
public void getElements(float[] elements)
```
    Obtains element values of this Matrix.
    
    参数:
    
    elements - Indicates an array for storing the obtained element values.
    
    从以下版本开始:
    
    3
  - setElements
```
public void setElements(float[] elements)
```
    Sets element values for this Matrix.
    
    参数:
    
    elements - Indicates an array of element values to be set for this Matrix.
    
    从以下版本开始:
    
    3
  - invert
```
public boolean invert(Matrix inverse)
```
    Inverts this Matrix.
    
    参数:
    
    inverse - Indicates the matrix to hold the inverse of this Matrix.
    
    返回:
    
    Returns true if this Matrix is inverted; returns false otherwise.
    
    从以下版本开始:
    
    3
  - mapPoints
```
public void mapPoints(float[] pts)
```
    Performs a matrix transformation on an array of points, and writes the transformation result into that array.
    
    参数:
    
    pts - Indicates the array of points to transform.
    
    从以下版本开始:
    
    3
  - mapPoints
```
public void mapPoints(float[] dst,
                      float[] src)
```
    Performs a matrix transformation on a source array of points, and writes the transformation result into a destination array.
    
    参数:
    
    dst - Indicates the destination array for storing transformed points.
    
    src - Indicates the source array of points to transform.
    
    从以下版本开始:
    
    3
  - mapPoints
```
public void mapPoints(float[] dst,
                      int dstIndex,
                      float[] src,
                      int srcIndex,
                      int pointCount)
```
    Performs a matrix transformation that starts from a specified point in a source array, and writes the transformation result into a destination array.
    
    参数:
    
    dst - Indicates the destination array for storing transformed points.
    
    dstIndex - Indicates the index of the first transformed point in the destination array.
    
    src - Indicates the source array of points to transform.
    
    srcIndex - Indicates the index of the first point to transform in the source array.
    
    pointCount - Indicates the number of points to transform.
    
    从以下版本开始:
    
    3
  - postConcat
```
public boolean postConcat(Matrix otherMatrix)
```
    Post-multiplies this Matrix by a specified matrix.
    
    参数:
    
    otherMatrix - Indicates the specified matrix for post-multiplication.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - postScale
```
public boolean postScale(float sx,
                         float sy)
```
    Post-multiplies this Matrix with the specified scale.
    
    参数:
    
    sx - Indicates the horizontal scale.
    
    sy - Indicates the vertical scale.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - postScale
```
public boolean postScale(float sx,
                         float sy,
                         float px,
                         float py)
```
    Post-multiplies this Matrix with the specified scale and the specified position of the perspective point.
    
    参数:
    
    sx - Indicates the horizontal scale.
    
    sy - Indicates the vertical scale.
    
    px - Indicates the X coordinate of the center point for scaling.
    
    py - Indicates the Y coordinate of the center point for scaling.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - postTranslate
```
public boolean postTranslate(float dx,
                             float dy)
```
    Post-multiplies this Matrix with the specified translation.
    
    参数:
    
    dx - Indicates the horizontal length to translate.
    
    dy - Indicates the vertical length to translate.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - preConcat
```
public boolean preConcat(Matrix otherMatrix)
```
    Pre-multiplies this Matrix by a specified matrix.
    
    参数:
    
    otherMatrix - Indicates the specified matrix for pre-multiplication.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - preRotate
```
public boolean preRotate(float degrees)
```
    Pre-multiplies this Matrix with the specified rotation.
    
    参数:
    
    degrees - Indicates the number of degrees to rotate.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - preRotate
```
public boolean preRotate(float degrees,
                         float px,
                         float py)
```
    Pre-multiplies this Matrix with the specified rotation and the specified position of the perspective point.
    
    参数:
    
    degrees - Indicates the number of degrees to rotate.
    
    px - Indicates the X coordinate of the center point for rotation.
    
    py - Indicates the Y coordinate of the center point for rotation.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - setScale
```
public void setScale(float sx,
                     float sy)
```
    Scales this Matrix by the specified values.
    
    参数:
    
    sx - Indicates the horizontal scale.
    
    sy - Indicates the vertical scale.
    
    从以下版本开始:
    
    3
  - setScale
```
public void setScale(float sx,
                     float sy,
                     float px,
                     float py)
```
    Scales this Matrix by the specified values and the specified position of the perspective point.
    
    参数:
    
    sx - Indicates the horizontal scale.
    
    sy - Indicates the vertical scale.
    
    px - Indicates the X coordinate of the center point for scaling.
    
    py - Indicates the Y coordinate of the center point for scaling.
    
    从以下版本开始:
    
    3
  - preTranslate
```
public boolean preTranslate(float dx,
                            float dy)
```
    Pre-multiplies this Matrix with the specified translation.
    
    参数:
    
    dx - Indicates the horizontal length to translate.
    
    dy - Indicates the vertical length to translate.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - setTranslate
```
public void setTranslate(float dx,
                         float dy)
```
    Translates this Matrix with the specified values.
    
    参数:
    
    dx - Indicates the horizontal length to translate.
    
    dy - Indicates the vertical length to translate.
    
    从以下版本开始:
    
    3
  - preScale
```
public boolean preScale(float sx,
                        float sy)
```
    Pre-multiplies this Matrix with the specified scale.
    
    参数:
    
    sx - Indicates the horizontal scale.
    
    sy - Indicates the vertical scale.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - preScale
```
public boolean preScale(float sx,
                        float sy,
                        float px,
                        float py)
```
    Pre-multiplies this Matrix with the specified scale and the specified position of the perspective point.
    
    参数:
    
    sx - Indicates the horizontal scale.
    
    sy - Indicates the vertical scale.
    
    px - Indicates the X coordinate of the center point for scaling.
    
    py - Indicates the Y coordinate of the center point for scaling.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - preSkew
```
public boolean preSkew(float kx,
                       float ky)
```
    Pre-multiplies this Matrix with the specified skew.
    
    参数:
    
    kx - Indicates the horizontal skew.
    
    ky - Indicates the vertical skew.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - mapRadius
```
public float mapRadius(float radius)
```
    Calculates the mean radius of a circle after being mapped by this Matrix.
    
    参数:
    
    radius - Indicates the radius of the circle after being mapped.
    
    返回:
    
    Returns the mean radius of the circle after being mapped.
    
    从以下版本开始:
    
    3
  - postRotate
```
public boolean postRotate(float degrees,
                          float px,
                          float py)
```
    Post-multiplies this Matrix with the specified rotation and the specified position of the perspective point.
    
    参数:
    
    degrees - Indicates the number of degrees to rotate.
    
    px - Indicates the X coordinate of the center point for rotation.
    
    py - Indicates the Y coordinate of the center point for rotation.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - mapRect
```
public boolean mapRect(RectFloat rectFloat)
```
    Performs a matrix transformation on a rectangle and writes the transformation result into that rectangle.
    
    参数:
    
    rectFloat - Indicates the rectangle to transform.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - mapRect
```
public boolean mapRect(RectFloat dst,
                       RectFloat src)
```
    Performs a matrix transformation on a source rectangle and writes the transformation result into a destination rectangle.
    
    参数:
    
    dst - Indicates the destination rectangle for storing the transformation result.
    
    src - Indicates the source rectangle to transform.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - setRectToRect
```
public boolean setRectToRect(RectFloat src,
                             RectFloat dst,
                             Matrix.ScaleToFit scaleToFit)
```
    Sets a source rectangle to be inside a destination rectangle based on the specified scaling mode.
    
    参数:
    
    src - Indicates the source rectangle.
    
    dst - Indicates the destination rectangle
    
    scaleToFit - Indicates the scaling mode, as enumerated in ScaleToFit.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - setSkew
```
public void setSkew(float kx,
                    float ky)
```
    Skews this Matrix by the specified skew factors.
    
    参数:
    
    kx - Indicates the horizontal skew factor.
    
    ky - Indicates the vertical skew factor.
    
    从以下版本开始:
    
    4
  - setSkew
```
public void setSkew(float kx,
                    float ky,
                    float px,
                    float py)
```
    Skews this Matrix around a specified pivot by the specified skew factors.
    
    参数:
    
    kx - Indicates the horizontal skew factor.
    
    ky - Indicates the vertical skew factor.
    
    px - Indicates the x coordinate of the skew pivot.
    
    py - Indicates the y coordinate of the skew pivot.
    
    从以下版本开始:
    
    4
  - setConcat
```
public boolean setConcat(Matrix matrixA,
                         Matrix matrixB)
```
    Sets this Matrix to matrix A multiplied by matrix B.
    
    参数:
    
    matrixA - Indicates matrix A.
    
    matrixB - Indicates matrix B.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    4
  - postSkew
```
public boolean postSkew(float kx,
                        float ky)
```
    Post-multiplies this Matrix with the specified skew factors.
    
    参数:
    
    kx - Indicates the horizontal skew factor.
    
    ky - Indicates the vertical skew factor.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    4
  - postSkew
```
public boolean postSkew(float kx,
                        float ky,
                        float px,
                        float py)
```
    Post-multiplies this Matrix around a specified pivot by the specified skew factors.
    
    参数:
    
    kx - Indicates the horizontal skew factor.
    
    ky - Indicates the vertical skew factor.
    
    px - Indicates the x coordinate of the skew pivot.
    
    py - Indicates the y coordinate of the skew pivot.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    4
  - setPolyToPoly
```
public boolean setPolyToPoly(float[] src,
                             int srcIndex,
                             float[] dst,
                             int dstIndex,
                             int pointCount)
```
    Sets this Matrix to make the specified source points map to the specified destination points.
    
    参数:
    
    src - Indicates the array of source points.
    
    srcIndex - Indicates the index of the first pair of points to be used in the source point array.
    
    dst - Indicates the array of destination points.
    
    dstIndex - Indicates the index of the first pair of points to be used in the destination point array.
    
    pointCount - Indicates the number of points.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
    
    从以下版本开始:
    
    4
  - rectStaysRect
```
public boolean rectStaysRect()
```
    Checks whether this Matrix can map one rectangle to another. This method is equivalent to preservesAxisAlignment().
    
    返回:
    
    Returns true if this Matrix can map one rectangle to another; returns false otherwise.
    
    从以下版本开始:
    
    4
  - isScaleTranslate
```
public boolean isScaleTranslate()
```
    Checks whether this Matrix has been scaled and translated.
    
    返回:
    
    Returns true if scaling and translation have been performed; returns false otherwise.
    
    从以下版本开始:
    
    4
  - isTranslate
```
public boolean isTranslate()
```
    Checks whether this Matrix has been translated.
    
    返回:
    
    Returns true if translation has been performed; returns false otherwise.
    
    从以下版本开始:
    
    4
  - preservesAxisAlignment
```
public boolean preservesAxisAlignment()
```
    Checks whether this Matrix can map one Rect object to another. This method is equivalent to rectStaysRect().
    
    返回:
    
    Returns true if this Matrix can map one Rect object to another; returns false otherwise.
    
    从以下版本开始:
    
    4
  - hasPerspective
```
public boolean hasPerspective()
```
    Checks whether this Matrix contains perspective elements.
    
    返回:
    
    Returns true if perspective elements are contained; returns false otherwise.
    
    从以下版本开始:
    
    4
  - isSimilarity
```
public boolean isSimilarity()
```
    Checks whether this Matrix contains only rotation, uniform scale, and translation.
    
    返回:
    
    Returns true if only rotation, uniform scale, and translation are contained; returns false otherwise.
    
    从以下版本开始:
    
    4
  - preservesRightAngles
```
public boolean preservesRightAngles()
```
    Checks whether this Matrix contains only rotation, scale (non-uniform scale allowed), and translation.
    
    返回:
    
    Returns true if only rotation, scale (non-uniform scale allowed), and translation are contained; returns false otherwise.
    
    从以下版本开始:
    
    4
  - get
```
public float get(int index)
```
    Obtains a matrix value based on the array index.
    
    参数:
    
    index - Indicates the array index, ranging from 0 to 8.
    
    返回:
    
    Returns the matrix value.
    
    从以下版本开始:
    
    4
  - getScaleX
```
public float getScaleX()
```
    Obtains the horizontal scale factor of this Matrix.
    
    返回:
    
    Returns the horizontal scale factor.
    
    从以下版本开始:
    
    4
  - getScaleY
```
public float getScaleY()
```
    Obtains the vertical scale factor of this Matrix.
    
    返回:
    
    Returns the vertical scale factor.
    
    从以下版本开始:
    
    4
  - getSkewY
```
public float getSkewY()
```
    Obtains the vertical skew factor of this Matrix.
    
    返回:
    
    Returns the vertical skew factor.
    
    从以下版本开始:
    
    4
  - getSkewX
```
public float getSkewX()
```
    Obtains the horizontal skew factor of this Matrix.
    
    返回:
    
    Returns the horizontal skew factor.
    
    从以下版本开始:
    
    4
  - getTranslateX
```
public float getTranslateX()
```
    Obtains the horizontal translation factor of this Matrix.
    
    返回:
    
    Returns the horizontal translation factor.
    
    从以下版本开始:
    
    4
  - getTranslateY
```
public float getTranslateY()
```
    Obtains the vertical translation factor of this Matrix.
    
    返回:
    
    Returns the vertical translation factor.
    
    从以下版本开始:
    
    4
  - getPerspX
```
public float getPerspX()
```
    Obtains the horizontal perspective factor of this Matrix.
    
    返回:
    
    Returns the horizontal perspective factor.
    
    从以下版本开始:
    
    4
  - getPerspY
```
public float getPerspY()
```
    Obtains the vertical perspective factor of this Matrix.
    
    返回:
    
    Returns the vertical perspective factor.
    
    从以下版本开始:
    
    4
  - setScaleX
```
public void setScaleX(float v)
```
    Sets the horizontal scale factor for this Matrix.
    
    参数:
    
    v - Indicates the horizontal scale factor to set.
    
    从以下版本开始:
    
    4
  - setScaleY
```
public void setScaleY(float v)
```
    Sets the vertical scale factor for this Matrix.
    
    参数:
    
    v - Indicates the vertical scale factor to set.
    
    从以下版本开始:
    
    4
  - setSkewX
```
public void setSkewX(float v)
```
    Sets the horizontal skew factor for this Matrix.
    
    参数:
    
    v - Indicates the horizontal skew factor to set.
    
    从以下版本开始:
    
    4
  - setSkewY
```
public void setSkewY(float v)
```
    Sets the vertical skew factor for this Matrix.
    
    参数:
    
    v - Indicates the vertical skew factor to set.
    
    从以下版本开始:
    
    4
  - setTranslateX
```
public void setTranslateX(float v)
```
    Sets the horizontal translation factor for this Matrix.
    
    参数:
    
    v - Indicates the horizontal translation factor to set.
    
    从以下版本开始:
    
    4
  - setTranslateY
```
public void setTranslateY(float v)
```
    Sets the vertical translation factor for this Matrix.
    
    参数:
    
    v - Indicates the vertical translation factor to set.
    
    从以下版本开始:
    
    4
  - setPerspX
```
public void setPerspX(float v)
```
    Sets the horizontal perspective factor for this Matrix.
    
    参数:
    
    v - Indicates the horizontal perspective factor to set.
    
    从以下版本开始:
    
    4
  - setPerspY
```
public void setPerspY(float v)
```
    Sets the vertical perspective factor for this Matrix.
    
    参数:
    
    v - Indicates the vertical perspective factor to set.
    
    从以下版本开始:
    
    4
  - setSinCos
```
public void setSinCos(float sinValue,
                      float cosValue,
                      float px,
                      float py)
```
    Sets this Matrix to rotate about the perspective point at the specified coordinates by the given horizontal and vertical components of the rotation vector.
    
    参数:
    
    sinValue - Indicates the horizontal component of the rotation vector.
    
    cosValue - Indicates the vertical component of the rotation vector.
    
    px - Indicates the x coordinate of the perspective point.
    
    py - Indicates the y coordinate of the perspective point.
    
    从以下版本开始:
    
    4
  - setSinCos
```
public void setSinCos(float sinValue,
                      float cosValue)
```
    Sets this Matrix to rotate about the perspective point (0,0) by the specified horizontal and vertical components of the rotation vector.
    
    参数:
    
    sinValue - Indicates the horizontal component of the rotation vector.
    
    cosValue - Indicates the vertical component of the rotation vector.
    
    从以下版本开始:
    
    4
  - preSkew
```
public void preSkew(float kx,
                    float ky,
                    float px,
                    float py)
```
    Pre-multiplies this Matrix with the specified skew and the specified position of the perspective point.
    
    参数:
    
    kx - Indicates the horizontal skew factor.
    
    ky - Indicates the vertical skew factor.
    
    px - Indicates the x coordinate of the skew pivot.
    
    py - Indicates the y coordinate of the skew pivot.
    
    从以下版本开始:
    
    4
  - postIDiv
```
public boolean postIDiv(int divx,
                        int divy)
```
    Post-multiplies this Matrix with the specified scale factors.
    
    参数:
    
    divx - Indicates the reciprocal of the horizontal scale factor.
    
    divy - Indicates the reciprocal of the vertical scale factor.
    
    返回:
    
    Returns true if the operation is successful; returns false if either divx or divy is 0.
    
    从以下版本开始:
    
    4
  - postRotate
```
public void postRotate(float degrees)
```
    Post-multiplies this Matrix with the specified rotation.
    
    参数:
    
    degrees - Indicates the number of degrees to rotate.
    
    从以下版本开始:
    
    4
  - mapRectScaleTranslate
```
public void mapRectScaleTranslate(RectFloat dst,
                                  RectFloat src)
```
    Performs matrix transformation on the source rectangle and stores the transformation result in the destination rectangle.
    
    参数:
    
    dst - Indicates the destination rectangle for storing the transformation result.
    
    src - Indicates the source rectangle to transform.
    
    从以下版本开始:
    
    4
  - isFixedStepInX
```
public boolean isFixedStepInX()
```
    Checks whether an x-axis unit step can be represented by a constant vector after matrix transformation is performed on the y axis.
    
    返回:
    
    Returns true if the x-aix unit step can be represented by a constant vector, that is, this Matrix does not have complex perspective; returns false otherwise.
    
    从以下版本开始:
    
    4
  - cheapEqualTo
```
public boolean cheapEqualTo(Matrix matrixM)
```
    Checks whether this Matrix and a specified matrix are represented by identical bit patterns.
    
    参数:
    
    matrixM - Indicates the specified matrix to compare.
    
    返回:
    
    Returns true if this Matrix and the specified matrix have identical bit patterns; returns false otherwise.
    
    从以下版本开始:
    
    4
  - getMinScale
```
public float getMinScale()
```
    Obtains the minimum scale factor of this Matrix by decomposing the scaling and skewing elements.
    
    返回:
    
    Returns the minimum scale factor.
    
    从以下版本开始:
    
    4
  - getMaxScale
```
public float getMaxScale()
```
    Obtains the maximum scale factor of this Matrix by decomposing the scaling and skewing elements.
    
    返回:
    
    Returns the maximum scale factor.
    
    从以下版本开始:
    
    4
  - dirtyMatrixTypeCache
```
public void dirtyMatrixTypeCache()
```
    Sets internal cache to an unknown state.
    
    从以下版本开始:
    
    4
  - setScaleTranslate
```
public void setScaleTranslate(float sx,
                              float sy,
                              float tx,
                              float ty)
```
    Initializes the scale and translation factors of this Matrix.
    
    参数:
    
    sx - Indicates the horizontal scale factor to initialize.
    
    sy - Indicates the vertical scale factor to initialize.
    
    tx - Indicates the horizontal translation factor to initialize.
    
    ty - Indicates the vertical translation factor to initialize.
    
    从以下版本开始:
    
    4
  - isFinite
```
public boolean isFinite()
```
    Checks whether all elements of this Matrix are finite.
    
    返回:
    
    Returns true if all elements are finite; returns false otherwise.
    
    从以下版本开始:
    
    4
  - equals
```
public boolean equals(Object object)
```
    Checks whether this Matrix object equals the specified Matrix object.
    
    覆盖:
    
    equals 在类中 Object
    
    参数:
    
    object - Indicates the Matrix object to compare.
    
    返回:
    
    Returns true if the two objects are equal; returns false otherwise.
    
    从以下版本开始:
    
    5
    
    另请参阅:
    
    Object.hashCode(), HashMap
  - hashCode
```
public int hashCode()
```
    从类复制的说明: Object
    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(Object) 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 Object.equals(java.lang.Object) 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.
    As much as is reasonably practical, the hashCode method defined by class Object does return distinct integers for distinct objects. (This is typically implemented by converting the internal address of the object into an integer, but this implementation technique is not required by the Java™ programming language.)
    覆盖:
    
    hashCode 在类中 Object
    
    返回:
    
    a hash code value for this object.
    
    另请参阅:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    Obtains a string representation of this Matrix object.
    
    覆盖:
    
    toString 在类中 Object
    
    返回:
    
    Returns a string representation.
    
    从以下版本开始:
    
    5

类 Matrix

嵌套类概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

Matrix

Matrix

Matrix

方法详细资料

getData

index

setMatrix

setMatrix

setIdentity

reset

isIdentity

equalsMatrixValue

multiply

rotate

scale

translate

transpose

setRotate

setRotate

getElements

setElements

invert

mapPoints

mapPoints

mapPoints

postConcat

postScale

postScale

postTranslate

preConcat

preRotate

preRotate

setScale

setScale

preTranslate

setTranslate

preScale

preScale

preSkew

mapRadius

postRotate

mapRect

mapRect

setRectToRect

setSkew

setSkew

setConcat

postSkew

postSkew

setPolyToPoly

rectStaysRect

isScaleTranslate

isTranslate

preservesAxisAlignment

hasPerspective

isSimilarity

preservesRightAngles

get

getScaleX

getScaleY

getSkewY

getSkewX

getTranslateX

getTranslateY

getPerspX

getPerspY

setScaleX

setScaleY

setSkewX

setSkewY

setTranslateX

setTranslateY

setPerspX

setPerspY