harmony 鸿蒙@ohos.matrix4 (矩阵变换)

2022-10-28
浏览 (789)

@ohos.matrix4 (矩阵变换)

本模块提供矩阵变换功能，可对图形进行平移、旋转和缩放等。

说明：

本模块首批接口从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

导入模块

import matrix4 from '@ohos.matrix4'

matrix4.init

init(options: [number,number,number,number,number,number,number,number,number,number,number,number,number,number,number,number]): Matrix4Transit

Matrix的构造函数，可以通过传入的参数创建一个四阶矩阵，矩阵为列优先。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
option	[number,number,number,number, number,number,number,number, number,number,number,number, number,number,number,number]	是	参数为长度为16（4*4）的number数组, 详情见四阶矩阵说明。默认值： [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]

返回值：

类型	说明
Matrix4Transit	根据入参创建的四阶矩阵对象。

四阶矩阵说明：

参数名	类型	必填	说明
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'
// 创建一个四阶矩阵
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])
@Entry
@Component
struct Tests {
  build() {
    Column() {
      Image($r("app.media.zh"))
        .width("40%")
        .height(100)
        .transform(matrix)
    }
  }
}

matrix4.identity

identity(): Matrix4Transit

Matrix的初始化函数，可以返回一个单位矩阵对象。

系统能力： SystemCapability.ArkUI.ArkUI.Full

返回值：

类型	说明
Matrix4Transit	单位矩阵对象。

示例：

// matrix1 和 matrix2 效果一致
import matrix4 from '@ohos.matrix4'
let matrix1 = 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])
let matrix2 = matrix4.identity()
@Entry
@Component
struct Tests {
  build() {
    Column() {
      Image($r("app.media.zh"))
        .width("40%")
        .height(100)
        .transform(matrix1)
      Image($r("app.media.zh"))
        .width("40%")
        .height(100)
        .margin({ top: 150 })
        .transform(matrix2)
    }
  }
}

matrix4.copy

copy(): Matrix4Transit

Matrix的拷贝函数，可以拷贝一份当前的矩阵对象。

系统能力： SystemCapability.ArkUI.ArkUI.Full

返回值：

类型	说明
Matrix4Transit	当前矩阵的拷贝对象。

示例：

// xxx.ets
import matrix4 from '@ohos.matrix4'

@Entry
@Component
struct Test {
  private matrix1 = matrix4.identity().translate({ x: 100 })
  // 对matrix1的拷贝矩阵做scale操作，不影响到matrix1
  private matrix2 = this.matrix1.copy().scale({ x: 2 })

  build() {
    Column() {
      Image($r("app.media.bg1"))
        .width("40%")
        .height(100)
        .transform(this.matrix1)
      Image($r("app.media.bg2"))
        .width("40%")
        .height(100)
        .margin({ top: 50 })
        .transform(this.matrix2)
    }
  }
}

zh-cn_image_0000001219744181

matrix4.invert^(deprecated)

invert(): Matrix4Transit

Matrix的逆函数，可以返回一个当前矩阵对象的逆矩阵，即效果正好相反。

该接口从Api 10开始废弃。

系统能力： SystemCapability.ArkUI.ArkUI.Full

返回值：

类型	说明
Matrix4Transit	当前矩阵的逆矩阵对象。

matrix4.combine^(deprecated)

combine(options: Matrix4Transit): Matrix4Transit

Matrix的叠加函数，可以将两个矩阵的效果叠加起来生成一个新的矩阵对象。

该接口从Api 10开始废弃。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
option	Matrix4Transit	是	待叠加的矩阵对象。

返回值：

类型	说明
Matrix4Transit	当前矩阵的逆矩阵对象。

matrix4.translate^(deprecated)

translate(options: TranslateOption): Matrix4Transit

Matrix的平移函数，可以为当前矩阵增加x轴/y轴/z轴平移效果。

该接口从Api 10开始废弃。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
option	TranslateOption	是	设置平移参数。

返回值：

类型	说明
Matrix4Transit	当前矩阵的逆矩阵对象。

matrix4.scale^(deprecated)

scale(options: ScaleOption): Matrix4Transit

Matrix的缩放函数，可以为当前矩阵增加x轴/y轴/z轴缩放效果。

该接口从Api 10开始废弃。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
option	ScaleOption	是	设置缩放参数。

返回值：

类型	说明
Matrix4Transit	当前矩阵的逆矩阵对象。

matrix4.rotate^(deprecated)

rotate(options: RotateOption): Matrix4Transit

Matrix的旋转函数，可以为当前矩阵增加x轴/y轴/z轴旋转效果。

该接口从Api 10开始废弃。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
option	RotateOption	是	设置旋转参数。

返回值：

类型	说明
Matrix4Transit	当前矩阵的逆矩阵对象。

matrix4.transformPoint^(deprecated)

transformPoint(options: [number, number]): [number, number]

Matrix的坐标点转换函数，可以将当前的变换效果作用到一个坐标点上。

该接口从Api 10开始废弃。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
option	[number, number]	是	需要转换的坐标点。

返回值：

类型	说明
[number, number]	返回矩阵变换后的Point对象。

Matrix4Transit

combine

combine(options: Matrix4Transit): Matrix4Transit

Matrix的叠加函数，可以将两个矩阵的效果叠加起来生成一个新的矩阵对象。会改变调用该函数的原始矩阵。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
option	Matrix4Transit	是	待叠加的矩阵对象。

返回值：

类型	说明
Matrix4Transit	矩阵叠加后的对象。

示例：

// xxx.ets
import matrix4 from '@ohos.matrix4'

@Entry
@Component
struct Test {
  private matrix1 = matrix4.identity().translate({ x: 200 })
  private matrix2 = matrix4.identity().scale({ x: 2 })

  build() {
    Column() {
      // 矩阵变换前
      Image($r("app.media.icon"))
        .width("40%")
        .height(100)
        .margin({ top: 50 })
      // 先平移x轴200px，再缩放两倍x轴，得到矩阵变换后的效果图
      Image($r("app.media.icon"))
        .transform(this.matrix1.copy().combine(this.matrix2))
        .width("40%")
        .height(100)
        .margin({ top: 50 })
    }
  }
}

zh-cn_image_0000001118642902

invert

invert(): Matrix4Transit

Matrix的逆函数，可以返回一个当前矩阵对象的逆矩阵，即效果正好相反。会改变调用该函数的原始矩阵。

系统能力： SystemCapability.ArkUI.ArkUI.Full

返回值：

类型	说明
Matrix4Transit	当前矩阵的逆矩阵对象。

示例：

import matrix4 from '@ohos.matrix4'
// matrix1(宽放大2倍) 和 matrix2(宽缩小2倍) 效果相反
let matrix1 = matrix4.identity().scale({ x: 2 })
let matrix2 = matrix1.copy().invert()

@Entry
@Component
struct Tests {
  build() {
    Column() {
      Image($r("app.media.zh"))
        .width(200)
        .height(100)
        .transform(matrix1)
        .margin({ top: 100 })
      Image($r("app.media.zh"))
        .width(200)
        .height(100)
        .margin({ top: 150 })
        .transform(matrix2)
    }
  }
}

translate

translate(options: TranslateOption): Matrix4Transit

Matrix的平移函数，可以为当前矩阵增加x轴/y轴/z轴平移效果。会改变调用该函数的原始矩阵。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
option	TranslateOption	是	设置平移参数。

返回值：

类型	说明
Matrix4Transit	平移效果后的矩阵对象。

示例：

// xxx.ets
import matrix4 from '@ohos.matrix4'

@Entry
@Component
struct Test {
  private matrix1 = matrix4.identity().translate({ x: 100, y: 200, z: 30 })

  build() {
    Column() {
      Image($r("app.media.bg1")).transform(this.matrix1)
        .width("40%")
        .height(100)
    }
  }
}

zh-cn_image_0000001219662645

scale

scale(options: ScaleOption): Matrix4Transit

Matrix的缩放函数，可以为当前矩阵增加x轴/y轴/z轴缩放效果。会改变调用该函数的原始矩阵。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
option	ScaleOption	是	设置缩放参数。

返回值：

类型	说明
Matrix4Transit	缩放效果后的矩阵对象。

示例：

// xxx.ets
import matrix4 from '@ohos.matrix4'
@Entry
@Component
struct Test {
  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)
        .width("40%")
        .height(100)
    }
  }
}

zh-cn_image_0000001219864131

rotate

rotate(options: RotateOption): Matrix4Transit

Matrix的旋转函数，可以为当前矩阵增加x轴/y轴/z轴旋转效果。会改变调用该函数的原始矩阵。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
option	RotateOption	是	设置旋转参数。

返回值：

类型	说明
Matrix4Transit	旋转效果后的矩阵对象。

示例：

// xxx.ets
import matrix4 from '@ohos.matrix4'

@Entry
@Component
struct Test {
  private matrix1 = matrix4.identity().rotate({ x: 1, y: 1, z: 2, angle: 30 })

  build() {
    Column() {
      Image($r("app.media.bg1")).transform(this.matrix1)
        .width("40%")
        .height(100)
    }.width("100%").margin({ top: 50 })
  }
}

zh-cn_image_0000001174422898

transformPoint

transformPoint(options: [number, number]): [number, number]

Matrix的坐标点转换函数，可以将当前的变换效果作用到一个坐标点上。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
option	[number, number]	是	需要转换的坐标点。

返回值：

类型	说明
[number, number]	返回矩阵变换后的Point对象。

示例：

// xxx.ets
import matrix4 from '@ohos.matrix4'

@Entry
@Component
struct Test {
  private originPoint: number[] = [50, 50]
  private matrix_1 = matrix4.identity().translate({ x: 150, y: -50 })
  private transformPoint = this.matrix_1.transformPoint([this.originPoint[0], this.originPoint[1]])
  private matrix_2 = matrix4.identity().translate({ x: this.transformPoint[0], y: this.transformPoint[1] })

  build() {
    Column() {
      Text(`矩阵变换前的坐标：[${this.originPoint}]`)
        .fontSize(16)
      Image($r("app.media.image"))
        .width('600px')
        .height('300px')
        .margin({ top: 50 })
      Text(`矩阵变换后的坐标：[${this.transformPoint}]`)
        .fontSize(16)
        .margin({ top: 100 })
      Image($r("app.media.image"))
        .width('600px')
        .height('300px')
        .margin({ top: 50 })
        .transform(this.matrix_2)
    }.width("100%").padding(50)
  }
}

zh-cn_image_0000001219864133

TranslateOption

系统能力： SystemCapability.ArkUI.ArkUI.Full

名称	类型	必填	说明
x	number	否	x轴的平移距离，单位px。默认值：0 取值范围 (-∞, +∞)
y	number	否	y轴的平移距离，单位px。默认值：0 取值范围 (-∞, +∞)
z	number	否	z轴的平移距离，单位px。默认值：0 取值范围 (-∞, +∞)

ScaleOption

系统能力： SystemCapability.ArkUI.ArkUI.Full

名称	类型	必填	说明
x	number	否	x轴的缩放倍数。x>1时以x轴方向放大，0<x<1时以x轴方向缩小，x<0时沿x轴反向并缩放。默认值：1 取值范围 (-∞, +∞)
y	number	否	y轴的缩放倍数。y>1时以y轴方向放大，0<y<1时以y轴方向缩小，y<0时沿y轴反向并缩放。默认值：1 取值范围 (-∞, +∞)
z	number	否	z轴的缩放倍数。z>1时以z轴方向放大，0<z<1时以z轴方向缩小，z<0时沿z轴反向并缩放。默认值：1 取值范围 (-∞, +∞)
centerX	number	否	变换中心点x轴坐标。默认值：0。取值范围 (-∞, +∞)
centerY	number	否	变换中心点y轴坐标。默认值：0。取值范围 (-∞, +∞)

RotateOption

系统能力： SystemCapability.ArkUI.ArkUI.Full

名称	类型	必填	说明
x	number	否	旋转轴向量x坐标。默认值：0。取值范围 (-∞, +∞)
y	number	否	旋转轴向量y坐标。默认值：0。取值范围 (-∞, +∞)
z	number	否	旋转轴向量z坐标。默认值：0。取值范围 (-∞, +∞)。说明：旋转向量中x、y、z至少有一个不为0才有意义。
angle	number	否	旋转角度。默认值：0
centerX	number	否	变换中心点x轴坐标。默认值：0
centerY	number	否	变换中心点y轴坐标。默认值：0

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述（仅对系统应用开放）

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

0 赞

所属分类： 后端技术
本文标签：
版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/d45ff6c3ddb041709353062c8196a52f

harmony 鸿蒙@ohos.matrix4 (矩阵变换)

@ohos.matrix4 (矩阵变换)

导入模块

matrix4.init

matrix4.identity

matrix4.copy

matrix4.invert^(deprecated)

matrix4.combine^(deprecated)

matrix4.translate^(deprecated)

matrix4.scale^(deprecated)

matrix4.rotate^(deprecated)

matrix4.transformPoint^(deprecated)

Matrix4Transit

combine

invert

translate

scale

rotate

transformPoint

TranslateOption

ScaleOption

RotateOption

你可能感兴趣的鸿蒙文章

热门推荐

标签云

最新文章

本文目录

harmony 鸿蒙@ohos.matrix4 (矩阵变换)

@ohos.matrix4 (矩阵变换)

导入模块

matrix4.init

matrix4.identity

matrix4.copy

matrix4.invert(deprecated)

matrix4.combine(deprecated)

matrix4.translate(deprecated)

matrix4.scale(deprecated)

matrix4.rotate(deprecated)

matrix4.transformPoint(deprecated)

Matrix4Transit

combine

invert

translate

scale

rotate

transformPoint

TranslateOption

ScaleOption

RotateOption

你可能感兴趣的鸿蒙文章

热门推荐

标签云

最新文章

本文目录

matrix4.invert^(deprecated)

matrix4.combine^(deprecated)

matrix4.translate^(deprecated)

matrix4.scale^(deprecated)

matrix4.rotate^(deprecated)

matrix4.transformPoint^(deprecated)