Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
“437c98d5028b607f168caf7783c57a057dad4ba2”上不存在“python/git@gitcode.net:s920243400/PaddleDetection.git”
未验证 提交 d9989717 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!9020 matrix4挑单到3.1release 

Merge pull request !9020 from 田雨/OpenHarmony-3.1-Release
上级 8a8779dc 849ee183
隐藏空白更改
内联 并排
Showing with 83 addition and 83 deletion
zh-cn/application-dev/reference/arkui-ts/ts-matrix-transformation.md
浏览文件 @ d9989717
...@@ -6,7 +6,7 @@ ...@@ -6,7 +6,7 @@
## 导入模块 ## 导入模块
``` ```ts
import matrix4 from '@ohos.matrix4' import matrix4 from '@ohos.matrix4'
``` ```
...@@ -30,35 +30,35 @@ Matrix的构造函数，可以通过传入的参数创建一个四阶矩阵， ...@@ -30,35 +30,35 @@ Matrix的构造函数，可以通过传入的参数创建一个四阶矩阵，
| array | Array&lt;number&gt; | 是 | [1,&nbsp;0,&nbsp;0,&nbsp;0,<br/>0,&nbsp;1,&nbsp;0,&nbsp;0,<br/>0,&nbsp;0,&nbsp;1,&nbsp;0,<br/>0,&nbsp;0,&nbsp;0,&nbsp;1] | 参数为长度为16（4\*4）的number数组,&nbsp;详情见参数描述。 | | array | Array&lt;number&gt; | 是 | [1,&nbsp;0,&nbsp;0,&nbsp;0,<br/>0,&nbsp;1,&nbsp;0,&nbsp;0,<br/>0,&nbsp;0,&nbsp;1,&nbsp;0,<br/>0,&nbsp;0,&nbsp;0,&nbsp;1] | 参数为长度为16（4\*4）的number数组,&nbsp;详情见参数描述。 |
- 返回值 - 返回值
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Object | 根据入参创建的四阶矩阵对象。 | | Object | 根据入参创建的四阶矩阵对象。 |
- 参数描述 - 参数描述
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| m00 | number | 是 | x轴缩放值，单位矩阵默认为1。 | | m00 | number | 是 | x轴缩放值，单位矩阵默认为1。 |
| m01 | number | 是 | 第2个值，xyz轴旋转会影响这个值。 | | m01 | number | 是 | 第2个值，xyz轴旋转会影响这个值。 |
| m02 | number | 是 | 第3个值，xyz轴旋转会影响这个值。 | | m02 | number | 是 | 第3个值，xyz轴旋转会影响这个值。 |
| m03 | number | 是 | 无实际意义。 | | m03 | number | 是 | 无实际意义。 |
| m10 | number | 是 | 第5个值，xyz轴旋转会影响这个值。 | | m10 | number | 是 | 第5个值，xyz轴旋转会影响这个值。 |
| m11 | number | 是 | y轴缩放值，单位矩阵默认为1。 | | m11 | number | 是 | y轴缩放值，单位矩阵默认为1。 |
| m12 | number | 是 | 第7个值，xyz轴旋转会影响这个值。 | | m12 | number | 是 | 第7个值，xyz轴旋转会影响这个值。 |
| m13 | number | 是 | 无实际意义。 | | m13 | number | 是 | 无实际意义。 |
| m20 | number | 是 | 第9个值，xyz轴旋转会影响这个值。 | | m20 | number | 是 | 第9个值，xyz轴旋转会影响这个值。 |
| m21 | number | 是 | 第10个值，xyz轴旋转会影响这个值。 | | m21 | number | 是 | 第10个值，xyz轴旋转会影响这个值。 |
| m22 | number | 是 | z轴缩放值，单位矩阵默认为1。 | | m22 | number | 是 | z轴缩放值，单位矩阵默认为1。 |
| m23 | number | 是 | 无实际意义。 | | m23 | number | 是 | 无实际意义。 |
| m30 | number | 是 | x轴平移值，单位px，单位矩阵默认为0。 | | m30 | number | 是 | x轴平移值，单位px，单位矩阵默认为0。 |
| m31 | number | 是 | y轴平移值，单位px，单位矩阵默认为0。 | | m31 | number | 是 | y轴平移值，单位px，单位矩阵默认为0。 |
| m32 | number | 是 | z轴平移值，单位px，单位矩阵默认为0。 | | m32 | number | 是 | z轴平移值，单位px，单位矩阵默认为0。 |
| m33 | number | 是 | 齐次坐标下生效，产生透视投影效果。 | | m33 | number | 是 | 齐次坐标下生效，产生透视投影效果。 |
- 示例 - 示例
``` ```ts
import Matrix4 from '@ohos.matrix4' import matrix4 from '@ohos.matrix4'
// 创建一个四阶矩阵 // 创建一个四阶矩阵
let matrix = Matrix4.init([1.0, 0.0, 0.0, 0.0, let matrix = matrix4.init([1.0, 0.0, 0.0, 0.0,
0.0, 1.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0,
0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 1.0, 0.0,
0.0, 0.0, 0.0, 1.0]) 0.0, 0.0, 0.0, 1.0])
...@@ -74,14 +74,14 @@ Matrix的初始化函数，可以返回一个单位矩阵对象。 ...@@ -74,14 +74,14 @@ Matrix的初始化函数，可以返回一个单位矩阵对象。
- 返回值 - 返回值
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Object | 单位矩阵对象。 | | Object | 单位矩阵对象。 |
- 示例 - 示例
``` ```ts
// matrix1 和 matrix2 效果一致 // matrix1 和 matrix2 效果一致
import Matrix4 from '@ohos.matrix4' import matrix4 from '@ohos.matrix4'
let matrix = Matrix4.init([1.0, 0.0, 0.0, 0.0, let matrix = Matrix4.init([1.0, 0.0, 0.0, 0.0,
0.0, 1.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0,
0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 1.0, 0.0,
...@@ -99,17 +99,17 @@ Matrix的拷贝函数，可以拷贝一份当前的矩阵对象。 ...@@ -99,17 +99,17 @@ Matrix的拷贝函数，可以拷贝一份当前的矩阵对象。
- 返回值 - 返回值
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Object | 当前矩阵的拷贝对象。 | | Object | 当前矩阵的拷贝对象。 |
- 示例 - 示例
``` ```ts
import Matrix4 from '@ohos.matrix4' import matrix4 from '@ohos.matrix4'
@Entry @Entry
@Component @Component
struct Test { struct Test {
private matrix1 = Matrix4.identity().translate({x:100}) private matrix1 = matrix4.identity().translate({x:100})
private matrix2 = this.matrix1.copy().scale({x:2}) private matrix2 = this.matrix1.copy().scale({x:2})
build() { build() {
Column() { Column() {
...@@ -142,23 +142,23 @@ Matrix的叠加函数，可以将两个矩阵的效果叠加起来生成一个 ...@@ -142,23 +142,23 @@ Matrix的叠加函数，可以将两个矩阵的效果叠加起来生成一个
- 参数 - 参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 | | 参数名 | 类型 | 必填 | 默认值 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| matrix | Matrix4 | 是 | - | 待叠加的矩阵对象。 | | matrix | Matrix4 | 是 | - | 待叠加的矩阵对象。 |
- 返回值 - 返回值
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Object | 矩阵叠加后的对象。 | | Object | 矩阵叠加后的对象。 |
- 示例 - 示例
``` ```ts
import Matrix4 from '@ohos.matrix4' import matrix4 from '@ohos.matrix4'
@Entry @Entry
@Component @Component
struct Test { struct Test {
private matrix1 = Matrix4.identity().translate({x:200}).copy() private matrix1 = matrix4.identity().translate({x:200}).copy()
private matrix2 = Matrix4.identity().scale({x:2}).copy() private matrix2 = matrix4.identity().scale({x:2}).copy()
build() { build() {
Column() { Column() {
// 先平移x轴100px，再缩放两倍x轴 // 先平移x轴100px，再缩放两倍x轴
...@@ -183,13 +183,13 @@ Matrix的逆函数，可以返回一个当前矩阵对象的逆矩阵，即效 ...@@ -183,13 +183,13 @@ Matrix的逆函数，可以返回一个当前矩阵对象的逆矩阵，即效
- 返回值 - 返回值
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Object | 当前矩阵的逆矩阵对象。 | | Object | 当前矩阵的逆矩阵对象。 |
- 示例 - 示例
``` ```ts
import Matrix4 from '@ohos.matrix4' import matrix4 from '@ohos.matrix4'
// matrix1(宽放大2倍) 和 matrix2(宽缩小2倍) 效果相反 // matrix1(宽放大2倍) 和 matrix2(宽缩小2倍) 效果相反
let matrix1 = Matrix4.identity().scale({x:2}) let matrix1 = Matrix4.identity().scale({x:2})
let matrix2 = matrix1.copy().invert() let matrix2 = matrix1.copy().invert()
...@@ -205,25 +205,25 @@ Matrix的平移函数，可以为当前矩阵增加x轴/Y轴/Z轴平移效果。 ...@@ -205,25 +205,25 @@ Matrix的平移函数，可以为当前矩阵增加x轴/Y轴/Z轴平移效果。
- 参数 - 参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 | | 参数名 | 类型 | 必填 | 默认值 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| x | number | 否 | 0 | x轴的平移距离，单位px。 | | x | number | 否 | 0 | x轴的平移距离，单位px。 |
| y | number | 否 | 0 | y轴的平移距离，单位px。 | | y | number | 否 | 0 | y轴的平移距离，单位px。 |
| z | number | 否 | 0 | z轴的平移距离，单位px。 | | z | number | 否 | 0 | z轴的平移距离，单位px。 |
- 返回值 - 返回值
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Object | 增加好平移效果后的矩阵对象。 | | Object | 增加好平移效果后的矩阵对象。 |
- 示例 - 示例
``` ```ts
import Matrix4 from '@ohos.matrix4' import matrix4 from '@ohos.matrix4'
@Entry @Entry
@Component @Component
struct Test { struct Test {
private matrix1 = Matrix4.identity().translate({x:100, y:200, z:30}) private matrix1 = matrix4.identity().translate({x:100, y:200, z:30})
build() { build() {
Column() { Column() {
Image($r("app.media.bg1")).transform(this.matrix1) Image($r("app.media.bg1")).transform(this.matrix1)
...@@ -246,27 +246,27 @@ Matrix的缩放函数，可以为当前矩阵增加x轴/Y轴/Z轴缩放效果。 ...@@ -246,27 +246,27 @@ Matrix的缩放函数，可以为当前矩阵增加x轴/Y轴/Z轴缩放效果。
- 参数 - 参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 | | 参数名 | 类型 | 必填 | 默认值 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| x | number | 否 | 1 | x轴的缩放倍数。 | | x | number | 否 | 1 | x轴的缩放倍数。 |
| y | number | 否 | 1 | y轴的缩放倍数。 | | y | number | 否 | 1 | y轴的缩放倍数。 |
| z | number | 否 | 1 | z轴的缩放倍数。 | | z | number | 否 | 1 | z轴的缩放倍数。 |
| centerX | number | 否 | 0 | 变换中心点x轴坐标。 | | centerX | number | 否 | 0 | 变换中心点x轴坐标。 |
| centerY | number | 否 | 0 | 变换中心点y轴坐标。 | | centerY | number | 否 | 0 | 变换中心点y轴坐标。 |
- 返回值 - 返回值
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Object | 增加好缩放效果后的矩阵对象。 | | Object | 增加好缩放效果后的矩阵对象。 |
- 示例 - 示例
``` ```ts
import Matrix4 from '@ohos.matrix4' import matrix4 from '@ohos.matrix4'
@Entry @Entry
@Component @Component
struct Test { struct Test {
private matrix1 = Matrix4.identity().scale({x:2, y:3, z:4, centerX:50, centerY:50}) private matrix1 = matrix4.identity().scale({x:2, y:3, z:4, centerX:50, centerY:50})
build() { build() {
Column() { Column() {
Image($r("app.media.bg1")).transform(this.matrix1) Image($r("app.media.bg1")).transform(this.matrix1)
...@@ -289,28 +289,28 @@ Matrix的旋转函数，可以为当前矩阵增加x轴/Y轴/Z轴旋转效果。 ...@@ -289,28 +289,28 @@ Matrix的旋转函数，可以为当前矩阵增加x轴/Y轴/Z轴旋转效果。
- 参数 - 参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 | | 参数名 | 类型 | 必填 | 默认值 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| x | number | 否 | 1 | 旋转轴向量x坐标。 | | x | number | 否 | 1 | 旋转轴向量x坐标。 |
| y | number | 否 | 1 | 旋转轴向量y坐标。 | | y | number | 否 | 1 | 旋转轴向量y坐标。 |
| z | number | 否 | 1 | 旋转轴向量z坐标。 | | z | number | 否 | 1 | 旋转轴向量z坐标。 |
| angle | number | 否 | 0 | 旋转角度。 | | angle | number | 否 | 0 | 旋转角度。 |
| centerX | number | 否 | 0 | 变换中心点x轴坐标。 | | centerX | number | 否 | 0 | 变换中心点x轴坐标。 |
| centerY | number | 否 | 0 | 变换中心点y轴坐标。 | | centerY | number | 否 | 0 | 变换中心点y轴坐标。 |
- 返回值 - 返回值
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Object | 增加好旋转效果后的矩阵对象。 | | Object | 增加好旋转效果后的矩阵对象。 |
- 示例 - 示例
``` ```ts
import Matrix4 from '@ohos.matrix4' import matrix4 from '@ohos.matrix4'
@Entry @Entry
@Component @Component
struct Test { struct Test {
private matrix1 = Matrix4.identity().rotate({x:1, y:1, z:2, angle:30}) private matrix1 = matrix4.identity().rotate({x:1, y:1, z:2, angle:30})
build() { build() {
Column() { Column() {
Image($r("app.media.bg1")).transform(this.matrix1) Image($r("app.media.bg1")).transform(this.matrix1)
...@@ -333,25 +333,25 @@ Matrix的坐标点转换函数，可以将当前的变换效果作用到一个 ...@@ -333,25 +333,25 @@ Matrix的坐标点转换函数，可以将当前的变换效果作用到一个
- 参数 - 参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 | | 参数名 | 类型 | 必填 | 默认值 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| point | Point | 是 | - | 需要转换的坐标点。 | | point | Point | 是 | - | 需要转换的坐标点。 |
- 返回值 - 返回值
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Point | 返回矩阵变换后的Point对象。 | | Point | 返回矩阵变换后的Point对象。 |
- 示例 - 示例
``` ```ts
import Matrix4 from '@ohos.matrix4' import matrix4 from '@ohos.matrix4'
import prompt from '@system.prompt' import prompt from '@system.prompt'
@Entry @Entry
@Component @Component
struct Test { struct Test {
private matrix1 = Matrix4.identity().transformPoint([100, 10]) private matrix1 = matrix4.identity().transformPoint([100, 10])
build() { build() {
Column() { Column() {
Button("get Point") Button("get Point")
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或