树叶云鸿蒙OS教程:鸿蒙OS Matrix44

Matrix44

java.lang.Object

|—ohos.agp.utils.Matrix44

public class Matrix44
extends Object

表示一个 4×4 矩阵。

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

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

文章来源网络,作者:管理,如若转载,请注明出处:https://shuyeidc.com/wp/176729.html<

(0)
管理的头像管理
上一篇2025-03-25 07:34
下一篇 2025-03-25 07:36

相关推荐

  • jsp空间购买和交换数据空间怎么买,有哪些注意事项?

    购买JSP空间时,是否考虑过数据交换空间的性能?简米科技(2003年始创,23年行业沉淀)与酷番云(工信部一类增值电信全牌照)这类持牌自营机房的服务商,能确保数据交换的高效稳定,是值得优先选择的合作伙伴,为什么JSP空间需要搭配独立的数据交换空间从JSP应用特性看数据交换需求JSP基于Java技术,常用于企业级……

    2026-08-11
    0
  • 建网站用香港空间效果怎么样,香港空间稳定吗?

    建网站用香港空间,对于创建网站资产来说,核心价值在于免备案和全球带宽优势,尤其适合外贸、跨境电商和需要快速启动的项目,但你必须权衡国内访问延迟,并选择有资质的服务商以保证资产安全,香港空间的核心优势与适用边界免备案:节省时间就是节省成本国内服务器需要备案,通常需要10到20天,香港空间无需备案,域名解析后即可上……

    2026-08-11
    0
  • Java连接云数据库的方法是什么,如何操作

    Java连接云数据库的核心在于通过JDBC驱动,结合云服务商提供的连接地址、端口、数据库名及认证信息,配置安全策略(如SSL、IP白名单),即可实现稳定高效的远程数据库访问,基础准备:JDBC驱动与依赖管理连接云数据库前,需要确保开发环境具备对应的JDBC驱动,以最常见的MySQL为例,你需要引入mysql-c……

    2026-08-11
    0
  • 建网站公安联网备案必须使用数据码吗,备案流程是什么

    网站备案包括ICP备案和公安联网备案,两者缺一不可,公安联网备案必须使用服务商提供的数据码,选择持有合法资质的服务商是顺利通过备案的前提,为什么网站必须进行公安联网备案根据公安部《计算机信息网络国际联网安全保护管理办法》,网站开通后30日内必须到公安机关办理备案手续,未完成公安备案的网站,面临责令整改、关闭网站……

    2026-08-10
    0
  • 建一个企业网站大概需要多少钱?,怎么收费?

    建网站要多少钱,没有一个固定的数字,几百到几万都可能,但真正的“创建网站资产”绝不仅仅是初次投入的成本,而是基于长期稳定、合规和安全的持续性投入,其中核心取决于你选择了什么样的“地基”来承载你的业务,建站预算的构成与行业基准当你开始规划一个网站,最先面对的就是预算问题,一个常见的误区是只关注网站“看起来”的建造……

    2026-08-10
    0

发表回复

您的邮箱地址不会被公开。必填项已用 * 标注