Matrix44

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

```
public class Matrix44
extends Object
```
Represents a 4x4 matrix.
This class holds an array of 16 floating-point numbers to describe the 4x4 matrix.

从以下版本开始:

4

构造器概要

构造器
构造器	说明
`Matrix44()`	Default constructor used to create a `Matrix44` instance.
`Matrix44(Matrix44 srcMatrix)`	A constructor used to create a `Matrix44` instance by using an existing matrix.
`Matrix44(Matrix44 matrixA, Matrix44 matrixB)`	A constructor used to create a `Matrix44` instance by using two specified matrices.

方法概要

所有方法实例方法具体方法
限定符和类型	方法	说明
`double`	`determinant()`	Calculates the determinant of this `Matrix44`.
`float`	`get(int row, int col)`	Obtains the value at a specified position in this `Matrix44` and returns a float number.
`double`	`getDouble(int row, int col)`	Obtains a double value at a specified position in this `Matrix44`.
`float`	`getFloat(int row, int col)`	Obtains the float value at a specified position in this `Matrix44`.
`boolean`	`hasPerspective()`	Checks whether this `Matrix44` contains perspective elements.
`boolean`	`invert(Matrix44 inverse)`	Inverts this `Matrix44`.
`boolean`	`isIdentity()`	Checks whether this `Matrix44` is an identity matrix.
`boolean`	`isScale()`	Checks whether this `Matrix44` contains scaling or whether it is an identity matrix.
`boolean`	`isScaleTranslate()`	Checks whether this `Matrix44` contains only translation and scaling or whether it is an identity matrix.
`boolean`	`isTranslate()`	Checks whether this `Matrix44` contains translation or whether it is an identity matrix.
`void`	`postConcat(Matrix44 matrixM)`	Post-multiplies this `Matrix44` with a specified matrix and saves the multiplication result in this `Matrix44`.
`void`	`postScale(float scale)`	Post-multiplies this `Matrix44` with the specified scale.
`void`	`postScale(float sx, float sy, float sz)`	Post-multiplies this `Matrix44` with the specified scale.
`void`	`postTranslate(float dx, float dy, float dz)`	Post-multiplies this `Matrix44` with the specified translation.
`void`	`preConcat(Matrix44 matrixM)`	Pre-multiplies this `Matrix44` with a specified matrix and saves the multiplication result in this `Matrix44`.
`void`	`preScale(float scale)`	Pre-multiplies this `Matrix44` with the specified scale.
`void`	`preScale(float sx, float sy, float sz)`	Pre-multiplies this `Matrix44` with the specified scale.
`void`	`preTranslate(float dx, float dy, float dz)`	Pre-multiplies this `Matrix44` with the specified translation.
`void`	`reset()`	Resets this `Matrix44` to an identity matrix.
`void`	`set(int row, int col, float value)`	Sets a value of the float type for a specified position in this `Matrix44`.
`void`	`setConcat(Matrix44 matrixA, Matrix44 matrixB)`	Sets this `Matrix44` to the multiplication result of two specified matrices.
`void`	`setDouble(int row, int col, double value)`	Sets a double value for a specified position in this `Matrix44`.
`void`	`setFloat(int row, int col, float value)`	Sets a float value for a specified position in this `Matrix44`.
`void`	`setIdentity()`	Sets this `Matrix44` to an identity matrix.
`void`	`setRotateAbout(float x, float y, float z, float radians)`	Rotates about the vector [x, y, z] by a specified radian.
`void`	`setRotateAboutUnit(float x, float y, float z, float radians)`	Rotates about the vector [x, y, z] as a unit vector by a specified radian.
`void`	`setRotateDegreesAbout(float x, float y, float z, float degrees)`	Rotates about the vector [x, y, z] by a specified angle.
`void`	`setScale(float scale)`	Scales this `Matrix44` by the specified size.
`void`	`setScale(float sx, float sy, float sz)`	Scales this `Matrix44` by the specified size.
`void`	`setTranslate(float dx, float dy, float dz)`	Translates this `Matrix44` with the specified length.
`void`	`transpose()`	Transposes this `Matrix44`.

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

- 构造器详细资料
  - Matrix44
```
public Matrix44()
```
    Default constructor used to create a Matrix44 instance.
    
    从以下版本开始:
    
    4
  - Matrix44
```
public Matrix44(Matrix44 srcMatrix)
```
    A constructor used to create a Matrix44 instance by using an existing matrix.
    Specifically, the values of the existing matrix are copied to the created Matrix44 instance.
    
    参数:
    
    srcMatrix - Indicates the existing matrix.
    
    从以下版本开始:
    
    4
  - Matrix44
```
public Matrix44(Matrix44 matrixA,
                Matrix44 matrixB)
```
    A constructor used to create a Matrix44 instance by using two specified matrices.
    Specifically, the two specified matrices are multiplied, and the values of the product are copied to the created Matrix44 instance.
    
    参数:
    
    matrixA - Indicates one specified matrix for multiplication.
    
    matrixB - Indicates the other specified matrix for multiplication.
    
    从以下版本开始:
    
    4
- 方法详细资料
  - isIdentity
```
public boolean isIdentity()
```
    Checks whether this Matrix44 is an identity matrix.
    
    返回:
    
    Returns true if the matrix is an identity matrix; returns false otherwise.
    
    从以下版本开始:
    
    4
  - isTranslate
```
public boolean isTranslate()
```
    Checks whether this Matrix44 contains translation or whether it is an identity matrix.
    
    返回:
    
    Returns true if the matrix contains translation or it is an identity matrix; returns false otherwise.
    
    从以下版本开始:
    
    4
  - isScaleTranslate
```
public boolean isScaleTranslate()
```
    Checks whether this Matrix44 contains only translation and scaling or whether it is an identity matrix.
    
    返回:
    
    Returns true if the matrix contains translation and scaling or it is an identity matrix; returns false otherwise.
    
    从以下版本开始:
    
    4
  - isScale
```
public boolean isScale()
```
    Checks whether this Matrix44 contains scaling or whether it is an identity matrix.
    
    返回:
    
    Returns true if the matrix contains scaling or it is an identity matrix; returns false otherwise.
    
    从以下版本开始:
    
    4
  - hasPerspective
```
public boolean hasPerspective()
```
    Checks whether this Matrix44 contains perspective elements.
    
    返回:
    
    Returns true if the matrix contains perspective elements; returns false otherwise.
    
    从以下版本开始:
    
    4
  - setIdentity
```
public void setIdentity()
```
    Sets this Matrix44 to an identity matrix.
    
    从以下版本开始:
    
    4
  - reset
```
public void reset()
```
    Resets this Matrix44 to an identity matrix.
    
    从以下版本开始:
    
    4
  - get
```
public float get(int row,
                 int col)
```
    Obtains the value at a specified position in this Matrix44 and returns a float number.
    
    参数:
    
    row - Indicates the row of the specified position.
    
    col - Indicates the column of the specified position.
    
    返回:
    
    Returns the value at the specified position.
    
    从以下版本开始:
    
    4
  - set
```
public void set(int row,
                int col,
                float value)
```
    Sets a value of the float type for a specified position in this Matrix44.
    
    参数:
    
    row - Indicates the row of the specified position.
    
    col - Indicates the column of the specified position.
    
    value - Indicates the value to set.
    
    从以下版本开始:
    
    4
  - getDouble
```
public double getDouble(int row,
                        int col)
```
    Obtains a double value at a specified position in this Matrix44.
    
    参数:
    
    row - Indicates the row of the specified position.
    
    col - Indicates the column of the specified position.
    
    返回:
    
    Returns the double value at the specified position.
    
    从以下版本开始:
    
    4
  - setDouble
```
public void setDouble(int row,
                      int col,
                      double value)
```
    Sets a double value for a specified position in this Matrix44.
    
    参数:
    
    row - Indicates the row of the specified position.
    
    col - Indicates the column of the specified position.
    
    value - Indicates the double value to set.
    
    从以下版本开始:
    
    4
  - getFloat
```
public float getFloat(int row,
                      int col)
```
    Obtains the float value at a specified position in this Matrix44.
    
    参数:
    
    row - Indicates the row of the specified position.
    
    col - Indicates the column of the specified position.
    
    返回:
    
    Returns the float value at the specified position.
    
    从以下版本开始:
    
    4
  - setFloat
```
public void setFloat(int row,
                     int col,
                     float value)
```
    Sets a float value for a specified position in this Matrix44.
    
    参数:
    
    row - Indicates the row of the specified position.
    
    col - Indicates the column of the specified position.
    
    value - Indicates the float value to set.
    
    从以下版本开始:
    
    4
  - setTranslate
```
public void setTranslate(float dx,
                         float dy,
                         float dz)
```
    Translates this Matrix44 with the specified length.
    
    参数:
    
    dx - Indicates the length to translate on the x axis.
    
    dy - Indicates the length to translate on the y axis.
    
    dz - Indicates the length to translate on the z axis.
    
    从以下版本开始:
    
    4
  - preTranslate
```
public void preTranslate(float dx,
                         float dy,
                         float dz)
```
    Pre-multiplies this Matrix44 with the specified translation.
    
    参数:
    
    dx - Indicates the length to translate on the x axis.
    
    dy - Indicates the length to translate on the y axis.
    
    dz - Indicates the length to translate on the z axis.
    
    从以下版本开始:
    
    4
  - postTranslate
```
public void postTranslate(float dx,
                          float dy,
                          float dz)
```
    Post-multiplies this Matrix44 with the specified translation.
    
    参数:
    
    dx - Indicates the length to translate on the x axis.
    
    dy - Indicates the length to translate on the y axis.
    
    dz - Indicates the length to translate on the z axis.
    
    从以下版本开始:
    
    4
  - setScale
```
public void setScale(float sx,
                     float sy,
                     float sz)
```
    Scales this Matrix44 by the specified size.
    
    参数:
    
    sx - Indicates the size to scale on the x axis.
    
    sy - Indicates the size to scale on the y axis.
    
    sz - Indicates the size to scale on the z axis.
    
    从以下版本开始:
    
    4
  - preScale
```
public void preScale(float sx,
                     float sy,
                     float sz)
```
    Pre-multiplies this Matrix44 with the specified scale.
    
    参数:
    
    sx - Indicates the size to scale on the x axis.
    
    sy - Indicates the size to scale on the y axis.
    
    sz - Indicates the size to scale on the z axis.
    
    从以下版本开始:
    
    4
  - postScale
```
public void postScale(float sx,
                      float sy,
                      float sz)
```
    Post-multiplies this Matrix44 with the specified scale.
    
    参数:
    
    sx - Indicates the size to scale on the x axis.
    
    sy - Indicates the size to scale on the y axis.
    
    sz - Indicates the size to scale on the z axis.
    
    从以下版本开始:
    
    4
  - setScale
```
public void setScale(float scale)
```
    Scales this Matrix44 by the specified size.
    
    参数:
    
    scale - Indicates the size to scale. The value is shared by the x, y, and z axes.
    
    从以下版本开始:
    
    4
  - preScale
```
public void preScale(float scale)
```
    Pre-multiplies this Matrix44 with the specified scale.
    
    参数:
    
    scale - Indicates the size to scale. The value is shared by the x, y, and z axes.
    
    从以下版本开始:
    
    4
  - postScale
```
public void postScale(float scale)
```
    Post-multiplies this Matrix44 with the specified scale.
    
    参数:
    
    scale - Indicates the size to scale. The value is shared by the x, y, and z axes.
    
    从以下版本开始:
    
    4
  - setRotateDegreesAbout
```
public void setRotateDegreesAbout(float x,
                                  float y,
                                  float z,
                                  float degrees)
```
    Rotates about the vector [x, y, z] by a specified angle.
    
    参数:
    
    x - Indicates the first element of the vector to rotate.
    
    y - Indicates the second element of the vector to rotate.
    
    z - Indicates the third element of the vector to rotate.
    
    degrees - Indicates the number of degrees to rotate.
    
    从以下版本开始:
    
    4
  - setRotateAbout
```
public void setRotateAbout(float x,
                           float y,
                           float z,
                           float radians)
```
    Rotates about the vector [x, y, z] by a specified radian. If the vector [x, y, z] is not a unit vector, it will be automatically resized.
    
    参数:
    
    x - Indicates the first element of the vector to rotate.
    
    y - Indicates the second element of the vector to rotate.
    
    z - Indicates the third element of the vector to rotate.
    
    radians - Indicates the number of radians to rotate.
    
    从以下版本开始:
    
    4
  - setRotateAboutUnit
```
public void setRotateAboutUnit(float x,
                               float y,
                               float z,
                               float radians)
```
    Rotates about the vector [x, y, z] as a unit vector by a specified radian. This method does not check the vector length.
    
    参数:
    
    x - Indicates the first element of the vector to rotate.
    
    y - Indicates the second element of the vector to rotate.
    
    z - Indicates the third element of the vector to rotate.
    
    radians - Indicates the number of radians to rotate.
    
    从以下版本开始:
    
    4
  - setConcat
```
public void setConcat(Matrix44 matrixA,
                      Matrix44 matrixB)
```
    Sets this Matrix44 to the multiplication result of two specified matrices.
    
    参数:
    
    matrixA - Indicates one matrix for multiplication.
    
    matrixB - Indicates the other matrix for multiplication.
    
    从以下版本开始:
    
    4
  - preConcat
```
public void preConcat(Matrix44 matrixM)
```
    Pre-multiplies this Matrix44 with a specified matrix and saves the multiplication result in this Matrix44.
    
    参数:
    
    matrixM - Indicates the specified matrix.
    
    从以下版本开始:
    
    4
  - postConcat
```
public void postConcat(Matrix44 matrixM)
```
    Post-multiplies this Matrix44 with a specified matrix and saves the multiplication result in this Matrix44.
    
    参数:
    
    matrixM - Indicates the specified matrix.
    
    从以下版本开始:
    
    4
  - invert
```
public boolean invert(Matrix44 inverse)
```
    Inverts this Matrix44.
    
    参数:
    
    inverse - Indicates the matrix to hold the inverse of this Matrix44.
    
    返回:
    
    Returns true if this Matrix44 is invertible; returns false otherwise.
    
    从以下版本开始:
    
    4
  - transpose
```
public void transpose()
```
    Transposes this Matrix44.
    
    从以下版本开始:
    
    4
  - determinant
```
public double determinant()
```
    Calculates the determinant of this Matrix44.
    
    返回:
    
    Returns the determinant.
    
    从以下版本开始:
    
    4

类 Matrix44

构造器概要

方法概要

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

构造器详细资料

Matrix44

Matrix44

Matrix44

方法详细资料

isIdentity

isTranslate

isScaleTranslate

isScale

hasPerspective

setIdentity

reset

get

set

getDouble

setDouble

getFloat

setFloat

setTranslate

preTranslate

postTranslate

setScale

preScale

postScale

setScale

preScale

postScale

setRotateDegreesAbout

setRotateAbout

setRotateAboutUnit

setConcat

preConcat

postConcat

invert

transpose

determinant