Matrix4x4

java.lang.Object
- ohos.agp.render.render3d.math.Matrix4x4

```
public class Matrix4x4
extends Object
```
Describes a 4x4 matrix in mathematics and provides methods related to the matrix, such as obtaining an identity, translation, rotation, or scale 4x4 matrix.

从以下版本开始:

3

构造器概要

构造器
构造器说明

Matrix4x4()

构造器
构造器	说明
`Matrix4x4()`

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法	说明
`boolean`	`equals(Object other)`	Indicates whether some other object is "equal to" this one.
`Quaternion`	`extractQuaternion()`	Extracts the quaternion representing the rotation part of the matrix.
`void`	`extractRotation(Matrix4x4 rotationOut)`	Uses a 4x4 matrix to extract its rotation part.
`Vector3`	`extractScale()`	Extracts the scale vector of the matrix.
`Vector3`	`extractTranslation()`	Extracts the translation vector of the matrix.
`float`	`get(int index)`	Obtains the matrix value at the specified `index`.
`float`	`get(int row, int column)`	Obtains the matrix value at the specified `row` and `column`.
`float[]`	`getData()`	Obtains values from the matrix into a 16-element array.
`int`	`hashCode()`	Returns a hash code value for the object.
`static Matrix4x4`	`identity()`	Obtains an identity 4x4 matrix.
`static boolean`	`invert(Matrix4x4 inputMatrix, Matrix4x4 out)`	Inverts a given matrix to obtain its inverse.
`void`	`makeRotation(Quaternion rotation)`	Converts this matrix into a rotation matrix based on the given rotation quaternion.
`void`	`makeScale(Vector3 scale)`	Converts this matrix into a scale matrix based on the given scale vector.
`void`	`makeTranslation(Vector3 translation)`	Converts this matrix into a translation matrix based on the given translation vector.
`static void`	`multiply(Matrix4x4 lhs, Matrix4x4 rhs, Matrix4x4 product)`	Multiplies this matrix by the given parameters.
`void`	`set(float[] dataIn, int offset)`	Copies values from a 16-element array in the matrix.
`void`	`set(int index, float value)`	Sets a value at the specified `index`.
`void`	`set(int row, int column, float value)`	Sets the matrix value at the specified `row` and `column`.
`String`	`toString()`	Returns a string representation of the object.
`Vector3`	`transformPoint(Vector3 point)`	Transforms a given point vector to a new point vector based on matrix changes.

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

- 构造器详细资料
  - Matrix4x4
```
public Matrix4x4()
```
- 方法详细资料
  - identity
```
public static Matrix4x4 identity()
```
    Obtains an identity 4x4 matrix.
    
    返回:
    
    Returns the identity 4x4 matrix.
  - get
```
public float get(int index)
```
    Obtains the matrix value at the specified index.
    
    参数:
    
    index - Indicates the index where to obtain the matrix value. For example, if this parameter is set to 5, the value at row-column pair (1, 1) is to be obtained.
    
    返回:
    
    Returns the matrix value at the specified index.
  - get
```
public float get(int row,
                 int column)
```
    Obtains the matrix value at the specified row and column.
    
    参数:
    
    row - Indicates the row of the value to obtain.
    
    column - Indicates the column of the value to obtain.
    
    返回:
    
    Returns the matrix value at the specified row and column.
  - set
```
public void set(int index,
                float value)
```
    Sets a value at the specified index.
    
    参数:
    
    index - Indicates the index where to obtain the matrix value. For example, if this parameter is set to 5, the value at row-column pair (1, 1) is to be obtained.
    
    value - Indicates the value to set at the specified index.
  - set
```
public void set(int row,
                int column,
                float value)
```
    Sets the matrix value at the specified row and column.
    
    参数:
    
    row - Indicates the row of the value to set.
    
    column - Indicates the column of the value to set. * @param value Indicates the value to set.
  - set
```
public void set(float[] dataIn,
                int offset)
```
    Copies values from a 16-element array in the matrix.
    
    参数:
    
    dataIn - Indicates the array to be copied.
    
    offset - Indicates the offset from which the values will be copied in the array.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the specified array is empty or the difference between the array length and offset is less than 16.
  - getData
```
public float[] getData()
```
    Obtains values from the matrix into a 16-element array.
    
    返回:
    
    Returns an array of the matrix values.
  - makeTranslation
```
public void makeTranslation(Vector3 translation)
```
    Converts this matrix into a translation matrix based on the given translation vector.
    
    参数:
    
    translation - Indicates the translation vector used in the translation matrix.
  - makeRotation
```
public void makeRotation(Quaternion rotation)
```
    Converts this matrix into a rotation matrix based on the given rotation quaternion.
    
    参数:
    
    rotation - Indicates the rotation quaternion used in the rotation matrix.
  - makeScale
```
public void makeScale(Vector3 scale)
```
    Converts this matrix into a scale matrix based on the given scale vector.
    
    参数:
    
    scale - Indicates the scale vector used in the scale matrix.
  - extractTranslation
```
public Vector3 extractTranslation()
```
    Extracts the translation vector of the matrix.
    
    返回:
    
    Returns the translation vector of the matrix.
  - extractScale
```
public Vector3 extractScale()
```
    Extracts the scale vector of the matrix.
    
    返回:
    
    Returns the scale vector of the matrix.
  - extractRotation
```
public void extractRotation(Matrix4x4 rotationOut)
```
    Uses a 4x4 matrix to extract its rotation part.
    
    参数:
    
    rotationOut - Indicates the non-null quaternion used to store the rotation part extracted from the matrix.
  - extractQuaternion
```
public Quaternion extractQuaternion()
```
    Extracts the quaternion representing the rotation part of the matrix.
    
    返回:
    
    Returns the quaternion representing the rotation part of the matrix.
  - multiply
```
public static void multiply(Matrix4x4 lhs,
                            Matrix4x4 rhs,
                            Matrix4x4 product)
```
    Multiplies this matrix by the given parameters.
    
    参数:
    
    lhs - Indicates the left-hand-side operand to multiply the matrix.
    
    rhs - Indicates the right-hand-side operand to multiply the matrix.
    
    product - Indicates the product of matrix multiplication.
  - invert
```
public static boolean invert(Matrix4x4 inputMatrix,
                             Matrix4x4 out)
```
    Inverts a given matrix to obtain its inverse.
    
    参数:
    
    inputMatrix - Indicates the matrix to invert.
    
    out - Indicates the inverse matrix used to store inputMatrix.
    
    返回:
    
    Returns True if the specified inverse matrix exists; returns False otherwise.
  - transformPoint
```
public Vector3 transformPoint(Vector3 point)
```
    Transforms a given point vector to a new point vector based on matrix changes.
    
    参数:
    
    point - Indicates the given point vector.
    
    返回:
    
    Returns a new point vector.
  - equals
```
public boolean equals(Object other)
```
    从类复制的说明: Object
    Indicates whether some other object is "equal to" this one.
    The equals method implements an equivalence relation on non-null object references:
    - It is reflexive: for any non-null reference value x, x.equals(x) should return true.
    - It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
    - It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
    - It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
    - For any non-null reference value x, x.equals(null) should return false.
    The equals method for class Object implements the most discriminating possible equivalence relation on objects; that is, for any non-null reference values x and y, this method returns true if and only if x and y refer to the same object (x == y has the value true).
    Note that it is generally necessary to override the hashCode method whenever this method is overridden, so as to maintain the general contract for the hashCode method, which states that equal objects must have equal hash codes.
    覆盖:
    
    equals 在类中 Object
    
    参数:
    
    other - the reference object with which to compare.
    
    返回:
    
    true if this object is the same as the obj argument; false otherwise.
    
    另请参阅:
    
    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()
```
    从类复制的说明: Object
    Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.
    The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:
    getClass().getName() + '@' + Integer.toHexString(hashCode())
    覆盖:
    
    toString 在类中 Object
    
    返回:
    
    a string representation of the object.

类 Matrix4x4

构造器概要

方法概要

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

构造器详细资料

Matrix4x4

方法详细资料

identity

get

get

set

set

set

getData

makeTranslation

makeRotation

makeScale

extractTranslation

extractScale

extractRotation

extractQuaternion

multiply

invert

transformPoint

equals

hashCode

toString