鸿蒙OS开发文档 鸿蒙OS Matrix44

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 3

Matrix44

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

public class Matrix44
extends Object

表示一个 4x4 矩阵。

这个类包含一个包含 16 个浮点数的数组来描述 4x4 矩阵。

Since:

4

构造函数摘要

构造函数描述
Matrix44()用于创建 Matrix44 实例的默认构造函数。
Matrix44(Matrix44 srcMatrix)用于使用现有矩阵创建 Matrix44 实例的构造函数。
Matrix44(Matrix44 matrixA, Matrix44 matrixB)用于使用两个指定矩阵创建 Matrix44 实例的构造函数。

方法总结

修饰符和类型方法描述
doubledeterminant()计算此 Matrix44 的行列式。
floatget(int row, int col)获取此 Matrix44 中指定位置的值,并返回一个浮点数。
doublegetDouble(int row, int col)获取此 Matrix44 中指定位置的双精度值。
floatgetFloat(int row, int col)获取此 Matrix44 中指定位置的浮点值。
booleanhasPerspective()检查此 Matrix44 是否包含透视元素。
booleaninvert(Matrix44 inverse)反转此 Matrix44。
booleanisIdentity()检查此 Matrix44 是否为单位矩阵。
booleanisScale()检查此 Matrix44 是否包含缩放或是否为单位矩阵。
booleanisScaleTranslate()检查此 Matrix44 是否仅包含平移和缩放,或者它是否为单位矩阵。
booleanisTranslate()检查此 Matrix44 是否包含平移或是否为单位矩阵。
voidpostConcat(Matrix44 matrixM)将此 Matrix44 与指定矩阵进行后乘,并将乘法结果保存在此 Matrix44 中。
voidpostScale(float scale)将此 Matrix44 后乘以指定的比例。
voidpostScale(float sx, float sy, float sz)将此 Matrix44 后乘以指定的比例。
voidpostTranslate(float dx, float dy, float dz)将此 Matrix44 与指定的平移进行后乘。
voidpreConcat(Matrix44 matrixM)将此 Matrix44 与指定矩阵预乘,并将乘法结果保存在此 Matrix44 中。
voidpreScale(float scale)将此 Matrix44 预乘以指定的比例。
voidpreScale(float sx, float sy, float sz)将此 Matrix44 预乘以指定的比例。
voidpreTranslate(float dx, float dy, float dz)将此 Matrix44 与指定的翻译预乘。
voidreset()将此 Matrix44 重置为单位矩阵。
voidset(int row, int col, float value)为此 Matrix44 中的指定位置设置浮点类型的值。
voidsetConcat(Matrix44 matrixA, Matrix44 matrixB)将此 Matrix44 设置为两个指定矩阵的乘法结果。
voidsetDouble(int row, int col, double value)为此 Matrix44 中的指定位置设置双精度值。
voidsetFloat(int row, int col, float value)设置此 Matrix44 中指定位置的浮点值。
voidsetIdentity()将此 Matrix44 设置为单位矩阵。
voidsetRotateAbout(float x, float y, float z, float radians)围绕向量 [x, y, z] 旋转指定的弧度。
voidsetRotateAboutUnit(float x, float y, float z, float radians)围绕向量 [x, y, z] 作为单位向量旋转指定的弧度。
voidsetRotateDegreesAbout(float x, float y, float z, float degrees)围绕向量 [x, y, z] 旋转指定角度。
voidsetScale(float scale)按指定大小缩放此 Matrix44。
voidsetScale(float sx, float sy, float sz)按指定大小缩放此 Matrix44。
voidsetTranslate(float dx, float dy, float dz)用指定的长度翻译这个 Matrix44。
voidtranspose()转置此 Matrix44。
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造函数详细信息

Matrix44

public Matrix44()

用于创建 Matrix44 实例的默认构造函数。

Since:

4

Matrix44

public Matrix44(Matrix44 srcMatrix)

用于使用现有矩阵创建 Matrix44 实例的构造函数。

具体来说,现有矩阵的值被复制到创建的 Matrix44 实例中。

参数:

参数名称参数描述
srcMatrix表示现有矩阵。

Since:

4

Matrix44

public Matrix44(Matrix44 matrixA, Matrix44 matrixB)

用于使用两个指定矩阵创建 Matrix44 实例的构造函数。

具体而言,将指定的两个矩阵相乘,并将乘积的值复制到创建的 Matrix44 实例中。

参数:

参数名称参数描述
matrixA表示一个指定的乘法矩阵。
matrixB表示另一个指定的乘法矩阵。

Since:

4

方法详情

isIdentity

public boolean isIdentity()

检查此 Matrix44 是否为单位矩阵。

返回:

如果矩阵是单位矩阵,则返回 true; 否则返回 false。

Since:

4

isTranslate

public boolean isTranslate()

检查此 Matrix44 是否包含平移或是否为单位矩阵。

返回:

如果矩阵包含平移或者它是一个单位矩阵,则返回 true; 否则返回 false。

Since:

4

isScaleTranslate

public boolean isScaleTranslate()

检查此 Matrix44 是否仅包含平移和缩放,或者它是否为单位矩阵。

返回:

如果矩阵包含平移和缩放或者它是单位矩阵,则返回 true; 否则返回 false。

Since:

4

isScale

public boolean isScale()

检查此 Matrix44 是否包含缩放或是否为单位矩阵。

返回:

如果矩阵包含缩放或者它是单位矩阵,则返回 true; 否则返回 false。

Since:

4

hasPerspective

public boolean hasPerspective()

检查此 Matrix44 是否包含透视元素。

返回:

如果矩阵包含透视元素,则返回 true; 否则返回 false。

Since:

4

setIdentity

public void setIdentity()

将此 Matrix44 设置为单位矩阵。

Since:

4

reset

public void reset()

将此 Matrix44 重置为单位矩阵。

Since:

4

get

public float get(int row, int col)

获取此 Matrix44 中指定位置的值,并返回一个浮点数。

参数:

参数名称参数描述
row表示指定位置的行。
col表示指定位置的列。

返回:

返回指定位置的值。

Since:

4

set

public void set(int row, int col, float value)

为此 Matrix44 中的指定位置设置浮点类型的值。

参数:

参数名称参数描述
row表示指定位置的行。
col表示指定位置的列。
value表示要设置的值。

Since:

4

getDouble

public double getDouble(int row, int col)

获取此 Matrix44 中指定位置的双精度值。

参数:

参数名称参数描述
row表示指定位置的行。
col表示指定位置的列。

返回:

返回指定位置的双精度值。

Since:

4

setDouble

public void setDouble(int row, int col, double value)

为此 Matrix44 中的指定位置设置双精度值。

参数:

参数名称参数描述
row表示指定位置的行。
col表示指定位置的列。
value指示要设置的双精度值。

Since:

4

getFloat

public float getFloat(int row, int col)

获取此 Matrix44 中指定位置的浮点值。

参数:

参数名称参数描述
row表示指定位置的行。
col表示指定位置的列。

返回:

返回指定位置的浮点值。

Since:

4

setFloat

public void setFloat(int row, int col, float value)

设置此 Matrix44 中指定位置的浮点值。

参数:

参数名称参数描述
row表示指定位置的行。
col表示指定位置的列。
value指示要设置的浮点值。

Since:

4

setTranslate

public void setTranslate(float dx, float dy, float dz)

用指定的长度翻译这个 Matrix44。

参数:

参数名称参数描述
dx指示要在 x 轴上平移的长度。
dy指示要在 y 轴上平移的长度。
dz指示要在 z 轴上平移的长度。

Since:

4

preTranslate

public void preTranslate(float dx, float dy, float dz)

将此 Matrix44 与指定的翻译预乘。

参数:

参数名称参数描述
dx指示要在 x 轴上平移的长度。
dy指示要在 y 轴上平移的长度。
dz指示要在 z 轴上平移的长度。

Since:

4

postTranslate

public void postTranslate(float dx, float dy, float dz)

将此 Matrix44 与指定的平移进行后乘。

参数:

参数名称参数描述
dx指示要在 x 轴上平移的长度。
dy指示要在 y 轴上平移的长度。
dz指示要在 z 轴上平移的长度。

Since:

4

setScale

public void setScale(float sx, float sy, float sz)

按指定大小缩放此 Matrix44。

参数:

参数名称参数描述
sx指示要在 x 轴上缩放的大小。
sy指示要在 y 轴上缩放的大小。
sz指示要在 z 轴上缩放的大小。

Since:

4

preScale

public void preScale(float sx, float sy, float sz)

将此 Matrix44 预乘以指定的比例。

参数:

参数名称参数描述
sx指示要在 x 轴上缩放的大小。
sy指示要在 y 轴上缩放的大小。
sz指示要在 z 轴上缩放的大小。

Since:

4

postScale

public void postScale(float sx, float sy, float sz)

将此 Matrix44 后乘以指定的比例。

参数:

参数名称参数描述
sx指示要在 x 轴上缩放的大小。
sy指示要在 y 轴上缩放的大小。
sz指示要在 z 轴上缩放的大小。

Since:

4

setScale

public void setScale(float scale)

按指定大小缩放此 Matrix44。

参数:

参数名称参数描述
scale指示要缩放的大小。 该值由 x、y 和 z 轴共享。

Since:

4

preScale

public void preScale(float scale)

将此 Matrix44 预乘以指定的比例。

参数:

参数名称参数描述
scale指示要缩放的大小。 该值由 x、y 和 z 轴共享。

Since:

4

postScale

public void postScale(float scale)

将此 Matrix44 后乘以指定的比例。

参数:

参数名称参数描述
scale指示要缩放的大小。 该值由 x、y 和 z 轴共享。

Since:

4

setRotateDegreesAbout

public void setRotateDegreesAbout(float x, float y, float z, float degrees)

围绕向量 [x, y, z] 旋转指定角度。

参数:

参数名称参数描述
x指示要旋转的向量的第一个元素。
y指示要旋转的向量的第二个元素。
z指示要旋转的向量的第三个元素。
degrees指示要旋转的度数。

Since:

4

setRotateAbout

public void setRotateAbout(float x, float y, float z, float radians)

围绕向量 [x, y, z] 旋转指定的弧度。 如果向量 [x, y, z] 不是单位向量,则会自动调整大小。

参数:

参数名称参数描述
x指示要旋转的向量的第一个元素。
y指示要旋转的向量的第二个元素。
z指示要旋转的向量的第三个元素。
radians指示要旋转的弧度数。

Since:

4

setRotateAboutUnit

public void setRotateAboutUnit(float x, float y, float z, float radians)

围绕向量 [x, y, z] 作为单位向量旋转指定的弧度。 此方法不检查向量长度。

参数:

参数名称参数描述
x指示要旋转的向量的第一个元素。
y指示要旋转的向量的第二个元素。
z指示要旋转的向量的第三个元素。
radians指示要旋转的弧度数。

Since:

4

setConcat

public void setConcat(Matrix44 matrixA, Matrix44 matrixB)

将此 Matrix44 设置为两个指定矩阵的乘法结果。

参数:

参数名称参数描述
matrixA表示一个乘法矩阵。
matrixB表示用于乘法的另一个矩阵。

Since:

4

preConcat

public void preConcat(Matrix44 matrixM)

将此 Matrix44 与指定矩阵预乘,并将乘法结果保存在此 Matrix44 中。

参数:

参数名称参数描述
matrixM表示指定的矩阵。

Since:

4

postConcat

public void postConcat(Matrix44 matrixM)

将此 Matrix44 与指定矩阵进行后乘,并将乘法结果保存在此 Matrix44 中。

参数:

参数名称参数描述
matrixM表示指定的矩阵。

Since:

4

invert

public boolean invert(Matrix44 inverse)

反转此 Matrix44。

参数:

参数名称参数描述
inverse指示要保存此 Matrix44 的逆矩阵的矩阵。

返回:

如果此 Matrix44 可逆,则返回 true; 否则返回 false。

Since:

4

transpose

public void transpose()

转置此 Matrix44。

Since:

4

determinant

public double determinant()

计算此 Matrix44 的行列式。

返回:

返回行列式。

Since:

4