From 849ee1833ac0bbbb49136cebb8d2481aba91b8ef Mon Sep 17 00:00:00 2001 From: tianyu Date: Thu, 1 Sep 2022 19:57:58 +0800 Subject: [PATCH] uodate marrix4 Signed-off-by: tianyu --- .../arkui-ts/ts-matrix-transformation.md | 166 +++++++++--------- 1 file changed, 83 insertions(+), 83 deletions(-) diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-matrix-transformation.md b/zh-cn/application-dev/reference/arkui-ts/ts-matrix-transformation.md index 0937b3daeb..eacf5672a6 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-matrix-transformation.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-matrix-transformation.md @@ -6,7 +6,7 @@ ## 导入模块 -``` +```ts import matrix4 from '@ohos.matrix4' ``` @@ -30,35 +30,35 @@ Matrix的构造函数，可以通过传入的参数创建一个四阶矩阵， | array | Array<number> | 是 | [1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
0, 0, 0, 1] | 参数为长度为16（4\*4）的number数组, 详情见参数描述。 | - 返回值 - | 类型 | 说明 | + | 类型 | 说明 | | -------- | -------- | - | Object | 根据入参创建的四阶矩阵对象。 | + | Object | 根据入参创建的四阶矩阵对象。 | - 参数描述 - | 参数名 | 类型 | 必填 | 说明 | + | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | m00 | number | 是 | x轴缩放值，单位矩阵默认为1。 | - | m01 | number | 是 | 第2个值，xyz轴旋转会影响这个值。 | - | m02 | number | 是 | 第3个值，xyz轴旋转会影响这个值。 | - | m03 | number | 是 | 无实际意义。 | - | m10 | number | 是 | 第5个值，xyz轴旋转会影响这个值。 | - | m11 | number | 是 | y轴缩放值，单位矩阵默认为1。 | - | m12 | number | 是 | 第7个值，xyz轴旋转会影响这个值。 | - | m13 | number | 是 | 无实际意义。 | - | m20 | number | 是 | 第9个值，xyz轴旋转会影响这个值。 | - | m21 | number | 是 | 第10个值，xyz轴旋转会影响这个值。 | - | m22 | number | 是 | z轴缩放值，单位矩阵默认为1。 | - | m23 | number | 是 | 无实际意义。 | - | m30 | number | 是 | x轴平移值，单位px，单位矩阵默认为0。 | - | m31 | number | 是 | y轴平移值，单位px，单位矩阵默认为0。 | - | m32 | number | 是 | z轴平移值，单位px，单位矩阵默认为0。 | - | m33 | number | 是 | 齐次坐标下生效，产生透视投影效果。 | + | m00 | number | 是 | x轴缩放值，单位矩阵默认为1。 | + | m01 | number | 是 | 第2个值，xyz轴旋转会影响这个值。 | + | m02 | number | 是 | 第3个值，xyz轴旋转会影响这个值。 | + | m03 | number | 是 | 无实际意义。 | + | m10 | number | 是 | 第5个值，xyz轴旋转会影响这个值。 | + | m11 | number | 是 | y轴缩放值，单位矩阵默认为1。 | + | m12 | number | 是 | 第7个值，xyz轴旋转会影响这个值。 | + | m13 | number | 是 | 无实际意义。 | + | m20 | number | 是 | 第9个值，xyz轴旋转会影响这个值。 | + | m21 | number | 是 | 第10个值，xyz轴旋转会影响这个值。 | + | m22 | number | 是 | z轴缩放值，单位矩阵默认为1。 | + | m23 | number | 是 | 无实际意义。 | + | m30 | number | 是 | x轴平移值，单位px，单位矩阵默认为0。 | + | m31 | number | 是 | y轴平移值，单位px，单位矩阵默认为0。 | + | m32 | number | 是 | z轴平移值，单位px，单位矩阵默认为0。 | + | m33 | number | 是 | 齐次坐标下生效，产生透视投影效果。 | - 示例 - ``` - import Matrix4 from '@ohos.matrix4' + ```ts + 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, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 1.0]) @@ -74,14 +74,14 @@ Matrix的初始化函数，可以返回一个单位矩阵对象。 - 返回值 - | 类型 | 说明 | + | 类型 | 说明 | | -------- | -------- | - | Object | 单位矩阵对象。 | + | Object | 单位矩阵对象。 | - 示例 - ``` + ```ts // matrix1 和 matrix2 效果一致 - import Matrix4 from '@ohos.matrix4' + import matrix4 from '@ohos.matrix4' let matrix = Matrix4.init([1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, @@ -99,17 +99,17 @@ Matrix的拷贝函数，可以拷贝一份当前的矩阵对象。 - 返回值 - | 类型 | 说明 | + | 类型 | 说明 | | -------- | -------- | - | Object | 当前矩阵的拷贝对象。 | + | Object | 当前矩阵的拷贝对象。 | - 示例 - ``` - import Matrix4 from '@ohos.matrix4' + ```ts + import matrix4 from '@ohos.matrix4' @Entry @Component struct Test { - private matrix1 = Matrix4.identity().translate({x:100}) + private matrix1 = matrix4.identity().translate({x:100}) private matrix2 = this.matrix1.copy().scale({x:2}) build() { Column() { @@ -142,23 +142,23 @@ Matrix的叠加函数，可以将两个矩阵的效果叠加起来生成一个 - 参数 - | 参数名 | 类型 | 必填 | 默认值 | 说明 | + | 参数名 | 类型 | 必填 | 默认值 | 说明 | | -------- | -------- | -------- | -------- | -------- | - | matrix | Matrix4 | 是 | - | 待叠加的矩阵对象。 | + | matrix | Matrix4 | 是 | - | 待叠加的矩阵对象。 | - 返回值 - | 类型 | 说明 | + | 类型 | 说明 | | -------- | -------- | - | Object | 矩阵叠加后的对象。 | + | Object | 矩阵叠加后的对象。 | - 示例 - ``` - import Matrix4 from '@ohos.matrix4' + ```ts + import matrix4 from '@ohos.matrix4' @Entry @Component struct Test { - private matrix1 = Matrix4.identity().translate({x:200}).copy() - private matrix2 = Matrix4.identity().scale({x:2}).copy() + private matrix1 = matrix4.identity().translate({x:200}).copy() + private matrix2 = matrix4.identity().scale({x:2}).copy() build() { Column() { // 先平移x轴100px，再缩放两倍x轴 @@ -183,13 +183,13 @@ Matrix的逆函数，可以返回一个当前矩阵对象的逆矩阵，即效 - 返回值 - | 类型 | 说明 | + | 类型 | 说明 | | -------- | -------- | - | Object | 当前矩阵的逆矩阵对象。 | + | Object | 当前矩阵的逆矩阵对象。 | - 示例 - ``` - import Matrix4 from '@ohos.matrix4' + ```ts + import matrix4 from '@ohos.matrix4' // matrix1(宽放大2倍) 和 matrix2(宽缩小2倍) 效果相反 let matrix1 = Matrix4.identity().scale({x:2}) let matrix2 = matrix1.copy().invert() @@ -205,25 +205,25 @@ Matrix的平移函数，可以为当前矩阵增加x轴/Y轴/Z轴平移效果。 - 参数 - | 参数名 | 类型 | 必填 | 默认值 | 说明 | + | 参数名 | 类型 | 必填 | 默认值 | 说明 | | -------- | -------- | -------- | -------- | -------- | - | x | number | 否 | 0 | x轴的平移距离，单位px。 | - | y | number | 否 | 0 | y轴的平移距离，单位px。 | - | z | number | 否 | 0 | z轴的平移距离，单位px。 | + | x | number | 否 | 0 | x轴的平移距离，单位px。 | + | y | number | 否 | 0 | y轴的平移距离，单位px。 | + | z | number | 否 | 0 | z轴的平移距离，单位px。 | - 返回值 - | 类型 | 说明 | + | 类型 | 说明 | | -------- | -------- | - | Object | 增加好平移效果后的矩阵对象。 | + | Object | 增加好平移效果后的矩阵对象。 | - 示例 - ``` - import Matrix4 from '@ohos.matrix4' + ```ts + import matrix4 from '@ohos.matrix4' @Entry @Component 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() { Column() { Image($r("app.media.bg1")).transform(this.matrix1) @@ -246,27 +246,27 @@ Matrix的缩放函数，可以为当前矩阵增加x轴/Y轴/Z轴缩放效果。 - 参数 - | 参数名 | 类型 | 必填 | 默认值 | 说明 | + | 参数名 | 类型 | 必填 | 默认值 | 说明 | | -------- | -------- | -------- | -------- | -------- | - | x | number | 否 | 1 | x轴的缩放倍数。 | - | y | number | 否 | 1 | y轴的缩放倍数。 | - | z | number | 否 | 1 | z轴的缩放倍数。 | - | centerX | number | 否 | 0 | 变换中心点x轴坐标。 | - | centerY | number | 否 | 0 | 变换中心点y轴坐标。 | + | x | number | 否 | 1 | x轴的缩放倍数。 | + | y | number | 否 | 1 | y轴的缩放倍数。 | + | z | number | 否 | 1 | z轴的缩放倍数。 | + | centerX | number | 否 | 0 | 变换中心点x轴坐标。 | + | centerY | number | 否 | 0 | 变换中心点y轴坐标。 | - 返回值 - | 类型 | 说明 | + | 类型 | 说明 | | -------- | -------- | - | Object | 增加好缩放效果后的矩阵对象。 | + | Object | 增加好缩放效果后的矩阵对象。 | - 示例 - ``` - import Matrix4 from '@ohos.matrix4' + ```ts + import matrix4 from '@ohos.matrix4' @Entry @Component 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() { Column() { Image($r("app.media.bg1")).transform(this.matrix1) @@ -289,28 +289,28 @@ Matrix的旋转函数，可以为当前矩阵增加x轴/Y轴/Z轴旋转效果。 - 参数 - | 参数名 | 类型 | 必填 | 默认值 | 说明 | + | 参数名 | 类型 | 必填 | 默认值 | 说明 | | -------- | -------- | -------- | -------- | -------- | - | x | number | 否 | 1 | 旋转轴向量x坐标。 | - | y | number | 否 | 1 | 旋转轴向量y坐标。 | - | z | number | 否 | 1 | 旋转轴向量z坐标。 | - | angle | number | 否 | 0 | 旋转角度。 | - | centerX | number | 否 | 0 | 变换中心点x轴坐标。 | - | centerY | number | 否 | 0 | 变换中心点y轴坐标。 | + | x | number | 否 | 1 | 旋转轴向量x坐标。 | + | y | number | 否 | 1 | 旋转轴向量y坐标。 | + | z | number | 否 | 1 | 旋转轴向量z坐标。 | + | angle | number | 否 | 0 | 旋转角度。 | + | centerX | number | 否 | 0 | 变换中心点x轴坐标。 | + | centerY | number | 否 | 0 | 变换中心点y轴坐标。 | - 返回值 - | 类型 | 说明 | + | 类型 | 说明 | | -------- | -------- | - | Object | 增加好旋转效果后的矩阵对象。 | + | Object | 增加好旋转效果后的矩阵对象。 | - 示例 - ``` - import Matrix4 from '@ohos.matrix4' + ```ts + import matrix4 from '@ohos.matrix4' @Entry @Component 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() { Column() { Image($r("app.media.bg1")).transform(this.matrix1) @@ -333,25 +333,25 @@ Matrix的坐标点转换函数，可以将当前的变换效果作用到一个 - 参数 - | 参数名 | 类型 | 必填 | 默认值 | 说明 | + | 参数名 | 类型 | 必填 | 默认值 | 说明 | | -------- | -------- | -------- | -------- | -------- | - | point | Point | 是 | - | 需要转换的坐标点。 | + | point | Point | 是 | - | 需要转换的坐标点。 | - 返回值 - | 类型 | 说明 | + | 类型 | 说明 | | -------- | -------- | - | Point | 返回矩阵变换后的Point对象。 | + | Point | 返回矩阵变换后的Point对象。 | - 示例 - ``` - import Matrix4 from '@ohos.matrix4' + ```ts + import matrix4 from '@ohos.matrix4' import prompt from '@system.prompt' @Entry @Component struct Test { - private matrix1 = Matrix4.identity().transformPoint([100, 10]) + private matrix1 = matrix4.identity().transformPoint([100, 10]) build() { Column() { Button("get Point") -- GitLab