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 0937b3daebafc9f3e043bc66e0b8ecce9905d4b8..eacf5672a6704c894f92ce68ad3de208cef8be47 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")