树叶云鸿蒙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

相关推荐

  • 个人主题怎么制作?

    制作个人主题是一个将个人风格、兴趣或专业领域转化为视觉化或结构化内容的过程,无论是用于个人博客、作品集、社交媒体账号还是品牌形象,核心都是围绕“个人特色”展开,以下从定位、内容规划、视觉设计、技术实现四个维度,详细拆解制作个人主题的完整流程,明确主题定位:找到个人特色的核心主题定位是所有工作的起点,需要先回答……

    2025-11-20
    0
  • 社群营销管理关键是什么?

    社群营销的核心在于通过建立有温度、有价值、有归属感的社群,实现用户留存、转化和品牌传播,其管理需贯穿“目标定位-内容运营-用户互动-数据驱动-风险控制”全流程,以下从五个维度展开详细说明:明确社群定位与目标社群管理的首要任务是精准定位,需明确社群的核心价值(如行业交流、产品使用指导、兴趣分享等)、目标用户画像……

    2025-11-20
    0
  • 香港公司网站备案需要什么材料?

    香港公司进行网站备案是一个涉及多部门协调、流程相对严谨的过程,尤其需兼顾中国内地与香港两地的监管要求,由于香港公司注册地与中国内地不同,其网站若主要服务内地用户或使用内地服务器,需根据服务器位置、网站内容性质等,选择对应的备案路径(如工信部ICP备案或公安备案),以下从备案主体资格、流程步骤、材料准备、注意事项……

    2025-11-20
    0
  • 如何企业上云推广

    企业上云已成为数字化转型的核心战略,但推广过程中需结合行业特性、企业痛点与市场需求,构建系统性、多维度的推广体系,以下从市场定位、策略设计、执行落地及效果优化四个维度,详细拆解企业上云推广的实践路径,精准定位:明确目标企业与核心价值企业上云并非“一刀切”的方案,需先锁定目标客户群体,提炼差异化价值主张,客户分层……

    2025-11-20
    0
  • PS设计搜索框的实用技巧有哪些?

    在PS中设计一个美观且功能性的搜索框需要结合创意构思、视觉设计和用户体验考量,以下从设计思路、制作步骤、细节优化及交互预览等方面详细说明,帮助打造符合需求的搜索框,设计前的规划明确使用场景:根据网站或APP的整体风格确定搜索框的调性,例如极简风适合细线条和纯色,科技感适合渐变和发光效果,电商类则可能需要突出搜索……

    2025-11-20
    0

发表回复

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