鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(图形变换)

鸿蒙Harmony应用开发—ArkTS声明式开发(通用属性:图形变换) ArkTS声明式开发(通用属性:图形变换) 阅读详情

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


图形变换

用于对组件进行旋转、平移、缩放、矩阵变换等操作。

说明

从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

rotate

rotate(value: RotateOptions)

设置组件旋转。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

参数:

参数名类型必填说明
valueRotateOptions是

可使组件在以组件左上角为坐标原点的坐标系中进行旋转(坐标系如下图所示)。其中,(x, y, z)指定一个矢量,作为旋转轴。

旋转轴和旋转中心点都基于坐标系设定,组件发生位移时,坐标系不会随之移动。

默认值: 在x、y、z都不指定时,x、y、z的默认值分别为0、0、1。指定了x、y、z任何一个值时,x、y、z中未指定的值默认为0。

{

centerX: '50%',

centerY: '50%'

centerZ: 0,

perspective: 0

}

单位:vp

centerZ、perspective从API version 10开始支持在ArkTS卡片中使用。

translate

translate(value: TranslateOptions)

设置组件平移。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

参数:

参数名类型必填说明
valueTranslateOptions是

可使组件在以组件左上角为坐标原点的坐标系中进行移动(坐标系如下图所示)。其中,x,y,z的值分别表示在对应轴移动的距离,值为正时表示向对应轴的正向移动,值为负时表示向对应轴的反向移动。移动距离支持数字和字符串(比如'10px',‘10%’)两种类型。

默认值:

{

x: 0,

y: 0,

z: 0

}

单位:vp

说明:

z轴方向移动时由于观察点位置不变,z的值接近观察点组件会有放大效果,远离则缩小。

scale

scale(value: ScaleOptions)

设置组件缩放。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

参数:

参数名类型必填说明
valueScaleOptions是

可以分别设置X轴、Y轴、Z轴的缩放比例,默认值为1,同时可以通过centerX和centerY设置缩放的中心点。

默认值:

{

x: 1,

y: 1,

z: 1,

centerX:'50%',

centerY:'50%'

}

transform

transform(value: object)

设置组件的变换矩阵。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

参数:

参数名类型必填说明
valueobject是设置当前组件的变换矩阵。object当前仅支持Matrix4Transit矩阵对象类型。

RotateOptions对象说明

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

名称类型必填说明
xnumber否

旋转轴向量x坐标。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

ynumber否

旋转轴向量y坐标。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

znumber否

旋转轴向量z坐标。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

anglenumber | string是

旋转角度。取值为正时相对于旋转轴方向顺时针转动,取值为负时相对于旋转轴方向逆时针转动。取值可为string类型,如'90deg'。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

centerXnumber | string否

变换中心点x轴坐标。表示组件变换中心点(即锚点)的x方向坐标。

单位:vp

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

centerYnumber | string否

变换中心点y轴坐标。表示组件变换中心点(即锚点)的y方向坐标。

单位:vp

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

centerZ10+number否

z轴锚点,即3D旋转中心点的z轴分量。

卡片能力: 从API version 10开始,该接口支持在ArkTS卡片中使用。

perspective10+number否

视距,即视点到z=0平面的距离。

旋转轴和旋转中心点都基于坐标系设定,组件发生位移时,坐标系不会随之移动。

卡片能力: 从API version 10开始,该接口支持在ArkTS卡片中使用。

TranslateOptions对象说明

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

名称类型必填说明
xnumber | string否x轴的平移距离。
ynumber | string否y轴的平移距离。
znumber | string否z轴的平移距离。

ScaleOptions对象说明

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

名称类型必填说明
xnumber否x轴的缩放倍数。x>1时以x轴方向放大,0<x<1时以x轴方向缩小,x<0时沿x轴反向并缩放。
ynumber否y轴的缩放倍数。y>1时以y轴方向放大,0<y<1时以y轴方向缩小,y<0时沿y轴反向并缩放。
znumber否z轴的缩放倍数。z>1时以z轴方向放大,0<z<1时以z轴方向缩小,z<0时沿z轴反向并缩放。
centerXnumber | string否

变换中心点x轴坐标。表示组件变换中心点(即锚点)的x方向坐标。

单位:vp

centerYnumber | string否

变换中心点y轴坐标。表示组件变换中心点(即锚点)的y方向坐标。

单位:vp

说明

当组件同时设置了rotate和scale属性时,centerX和centerY的取值会发生冲突,此时centerX和centerY的值以最后设定的属性的值为准。

示例

示例1(为组件添加图形变换效果)

该示例通过rotate、translate、scale、transform为组件添加旋转、平移、缩放、变换矩阵效果。

// xxx.ets
import { matrix4 } from '@kit.ArkUI';

@Entry
@Component
struct TransformExample {
  build() {
    Column() {
      Text('rotate').width('90%').fontColor(0xCCCCCC).padding(15).fontSize(14)
      Row()
        .rotate({
          x: 0,
          y: 0,
          z: 1,
          centerX: '50%',
          centerY: '50%',
          angle: 300
        }) // 组件以矢量(0,0,1)为旋转轴,绕中心点顺时针旋转300度
        .width(100).height(100).backgroundColor(0xAFEEEE)

      Text('translate').width('90%').fontColor(0xCCCCCC).padding(10).fontSize(14)
      Row()
        .translate({ x: 100, y: 10 }) // x轴方向平移100,y轴方向平移10
        .width(100).height(100).backgroundColor(0xAFEEEE).margin({ bottom: 10 })

      Text('scale').width('90%').fontColor(0xCCCCCC).padding(15).fontSize(14)
      Row()
        .scale({ x: 2, y: 0.5 }) // 高度缩小一倍,宽度放大一倍,z轴在2D下无效果
        .width(100).height(100).backgroundColor(0xAFEEEE)

      Text('Matrix4').width('90%').fontColor(0xCCCCCC).padding(15).fontSize(14)
      Row()
        .width(100).height(100).backgroundColor(0xAFEEEE)
        .transform(matrix4.identity().translate({ x: 50, y: 50 }).scale({ x: 1.5, y: 1 }).rotate({
          x: 0,
          y: 0,
          z: 1,
          angle: 60
        }))
    }.width('100%').margin({ top: 5 })
  }
}

示例2(设置旋转视距)

该示例通过perspective为组件添加视距效果。

// xxx.ets
@Entry
@Component
struct Index {
  @State prep: number = 10;

  build() {
    Row() {
      Column() {
        Stack()
          .width(100)
          .height(100)
          .backgroundColor(Color.Red)
          .rotate({ y: 1, angle: 45, perspective: this.prep })
        Button('change prep')
          .margin({ top: 100 })
          .onClick(() => {
            animateTo({
              duration: 2000,
              curve: Curve.EaseIn,
              iterations: 1,
              playMode: PlayMode.Normal,
              onFinish: () => {
                console.info('play end')
              }
            }, () => {
              this.prep = 500 // 组件视距从10变换到500
            })
          })
      }
      .width('100%')
    }
    .height('100%')
  }
}

示例3(按中心点旋转)

该示例通过设置rotate和transform为不同的参数实现相同的旋转效果。

import { matrix4 } from '@kit.ArkUI'

@Entry
@Component
struct MatrixExample {
  build() {
    Column({ space: 100 }) {
      Text('Hello1')
        .textAlign(TextAlign.Center)
        .width(100)
        .height(60)
        .borderWidth(1)

      Text('Hello2')
        .textAlign(TextAlign.Center)
        .width(100)
        .height(60)
        .borderWidth(1)
          // 绕(100vp,60vp)的锚点旋转90度,rotate或scale的centerX、centerY为组件锚点
        .rotate({
          z: 1,
          angle: 90,
          centerX: 100,
          centerY: 60
        })

      Text('Hello3')
        .textAlign(TextAlign.Center)
        .width(100)
        .height(60)
        .borderWidth(1)
          // 组件锚点(centerX,centerY)默认为(50%,50%),即锚点在(50vp,30vp)
          // transform的rotate指定(centerX,centerY)为(50vp,30vp),相对于在组件本身锚点基础上再额外偏移(50vp,30vp)
          // 此次变换相当于绕(100vp,60vp)旋转,和"Hello2"实现同样的旋转效果
        .transform(matrix4.identity()
          .rotate({
            z: 1,
            angle: 90,
            centerX: vp2px(50),
            centerY: vp2px(30)
          }))

      Text('Hello4')
        .textAlign(TextAlign.Center)
        .width(100)
        .height(60)
        .borderWidth(1)
          // 当设置x或y时,centerX和centerY才能生效
          // 设置组件锚点为(100vp,60vp)
        .scale({
          x: 1,
          y: 1,
          centerX: 100,
          centerY: 60
        })
          // transform的rotate不指定centerX、centerY,此次旋转的中心相对于组件本身锚点没有额外偏移
          // 该组件通过scale设置的锚点,绕(100vp,60vp)进行旋转,和"Hello2"实现同样的旋转效果
        .transform(matrix4.identity().rotate({ z: 1, angle: 90 }))
    }.width('100%')
    .height('100%')
  }
}

鸿蒙Harmony应用开发—ArkTS声明式开发(画布组件:Canvas) ArkTS声明式开发(画布组件:Canvas) 阅读详情

相关推荐

鸿蒙5.0版开发:ArkTS高级组件-@ohos.arkui.advanced.Dialog (弹出框)

弹出框是一种模态窗口,通常用于在保持当前的上下文环境时.........

m0_69424697的博客 1214

ArkTS-属性动画和显式动画

鸿蒙开发-属性动画和显式动画

qq_41154522的博客 1850

鸿蒙Harmony应用开发—ArkTS声明式开发(绘制组件:Line)

ArkTS声明式开发(绘制组件:Line)

m0_64420071的博客 2465

鸿蒙Harmony学习(二)ArkTs与ArkUI初识

由struct 修饰的是自定义组件,自定义组件是一个个可复用的UI单元。

danfengw的博客 3419

鸿蒙Harmony应用开发—ArkTS声明式开发(绘制组件:Ellipse)

ArkTS声明式开发(绘制组件:Ellipse)

m0_64420071的博客 1312

从D3 00到FF FF:手把手解析RTCM3.2协议帧结构(附Python解析代码)

本文深入解析RTCM3.2协议帧结构,从同步头标识到CRC校验算法,详细讲解如何通过Python代码实现二进制数据解析。文章包含完整的RTCM3.2解析器实现,涵盖消息类型解码、CRC校验等关键步骤,并附赠特定消息类型(如1005型基准站坐标)的解析示例,帮助开发者快速掌握GNSS差分数据传输协议的核心技术。

weixin_42550052的博客 354

鸿蒙next版开发:ArkTS组件通用属性(图形变换)

通过本文的介绍,你应该对HarmonyOS 5.0中ArkTS组件的图形变换属性有了基本的了解。图形变换是UI开发中的重要工具,合理利用这些属性可以使你的应用界面更加生动和吸引人。希望本文能够帮助你在开发过程中更好地利用ArkTS的图形变换属性。

小淼淼的博客 901

M2DGR数据集在一些SLAM框架上的配置与运行:ORB-SLAM系列、VINS-Mono、LOAM系列、FAST-LIO系列、hdl_graph_slam

为了说明以上这些SLAM框架的测试与数据集适配,以M2DGR数据集为例进行各自的配置与运行,方便我以后适配自己的数据集,运行的SLAM框架包括:ORB-SLAM2、ORB-SLAM3、VINS-Mono、A-LOAM、LeGO-LOAM、LIO-SAM、LVI-SAM、FAST-LIO2、FAST-LIVO、Faster-LIO、hdl_graph_slam。实验基于Ubuntu20.04,其中ORB、VINS-Mono、和LOAM系列的安装参考我以前的博客,有详细的安装方法,其他的框架在后面会简单介绍一下

zardforever123的博客 1万+

鸿蒙API13开发【图形变换】ArkTS组件

用于对组件进行旋转、平移、缩放、矩阵变换等操作。

鸿蒙的技术博客 829

移远EC800M CAT1模块HTTP POST实战:从AT指令到数据上报的完整避坑指南

本文详细介绍了移远EC800M CAT1模块通过AT指令实现HTTP POST数据上报的完整开发流程,包括模块初始化、PDP上下文配置、HTTP POST实现及优化策略。针对实际开发中的常见问题如网络异常、低功耗需求等提供了经过验证的解决方案,帮助开发者快速实现稳定可靠的物联网数据传输功能。

weixin_42556197的博客 482

问题:dpkg-deb: error: paste subprocess was killed by signal (Broken pipe)

 1. 问题:Ubuntu安装软件的过程中出现依赖项的问题 “E: Unmet dependencies. Try 'apt-get -f install' with no packages (or specify a solution).” 按照指示执行如下两条命令都没有解决问题。 sudo apt-get -f install sudo apt-get --fix-broken ...

gloria_littlechi的博客 2万+

【鸿蒙next开发】ArkUI框架:ArkTS组件-图形变换

本文详细介绍了鸿蒙HarmonyOS 5.0中的图形变换功能,包括旋转、平移、缩放和矩阵变换等操作。

m0_73088370的博客 1065

MaxScript批量修改材质、贴图名称

MaxScript批量修改材质、贴图名称1 实现效果1.1 修改前材质、贴图名称1.2 修改后2 代码 1 实现效果 1.1 修改前材质、贴图名称 1.2 修改后 2 代码 prefixName = "prefiname" maxFile = "maxfilepath" makeDir "newBitmappath" mapsPath = newbitmappath + "\\" fn formatStr index = ( str = index as string newS

郑德帅 3242

【鸿蒙next开发】ArkUI框架:ArkTS组件-Shape

本文介绍了鸿蒙HarmonyOS 5.0中Shape组件的使用方法和属性设置。

m0_73088370的博客 729

北斗导航 | 从北一到北二再到北三,你应该知道的北斗导航系统

博主github:https://github.com/MichaelBeechan 博主优快云:https://blog.csdn.net/u011344545 一、引言 我国高度重视北斗系统的建设和发展。自20世纪80年代开始探索适合我们国家国情的卫星导航系统发展道路,形成了“三步走”的发展战略:2000年底,建成北斗一号导航系统,向我国广大用户提供服务;2012年底,建成北斗二号导航系统,...

尘世冰封的专栏 3082

微信小程序转发功能异常报错 由于小程序违规分享功能暂时无法使用的解决办法

小程序右上角转发功能被封,不代表你违规了,而可能是你没认证、没备案!很多功能都是“先合规、后开发”,踩坑就晚了,别像我一样绕了三圈才发现问题。

代码简单说 Vue、JAVA、PHP、Node.js 熟练运用,接口、架构、性能全搞定。 2633

【鸿蒙next开发】ArkUI框架:ArkTS组件-ImageBitmap

本文详细介绍了鸿蒙HarmonyOS中的ImageBitmap功能,涵盖API 8至12版本的核心特性。

m0_73088370的博客 1112

YOLOv11 改进 - 主干网络| 清华大学CloFormer AttnConv :利用共享权重和上下文感知权重增强局部感知,注意力机制与卷积的完美融合

本文介绍了轻量级视觉变换器CloFormer及其核心模块AttnConv在YOLOv11中的结合应用。为解决视觉变换器缩小到移动设备友好尺寸时性能下降的问题,提出CloFormer,其引入AttnConv操作符。AttnConv融合共享权重和上下文感知权重,先通过深度卷积提取局部表示,再用上下文感知权重增强特征,还结合传统注意力减少FLOPs,使模型感知高频和低频信息。我们将AttnConv集成进YOLOv11,实验表明,CloFormer在多个视觉任务中表现优越,改进后的YOLOv11也取得了良好实验结果

魔改工程师的博客 989

【鸿蒙next开发】ArkUI框架:ArkTS组件-XComponent

本文介绍了HarmonyOS中XComponent组件的开发指南。

m0_73088370的博客 1139

复分析 阿尔福斯(Ahlfors) 第三版答案 英文

答案分为十章,有部分习题没有答案,全英文复分析阿尔福斯(Ahlfors) 第三版答案

计算机控制技术及应用

《计算机控制技术及应用》通过总结作者的科研成果和吸收国内外的先进理论、方法和技术,以计算机控制系统的网络化、开放化、智能化和集成化发展趋势为主线索,主要介绍计算机控制系统的基本概念和计算机控制系统的典型形式,计算机控制系统的数学描述与基本分析方法,以及数字PID控制器、最少拍控制系统、达林算法、状态变量设计法等设计方法及其各种改进算法。重点突出计算机控制系统输入输出通道接口的设计方法和典型控制系统的设计案例与实现方法等。

【鸿蒙next开发】ArkUI框架:ArkTS组件-Canvas

本文介绍了鸿蒙HarmonyOS 5.0中Canvas组件的核心开发知识与实战应用。

m0_73088370的博客 925

文档:亲测可用解决vnc灰屏,黑屏,鼠标大黑叉情况

主要解决vnc-viewer灰屏,黑屏,鼠标大黑叉等现象,详细见文档。

初识基于鸿蒙系统(HarmonyOS)的App开发

网传鸿蒙系统的下一个版本不再支持安卓,这几天看了一遍基于鸿蒙系统的App开发,现在二刷,顺便写一些心得或笔记吧。

Winter的博客 3993

pscad IEEE标准系统搭建说明

pscad IEEE标准系统搭建说明,包含典型的IEEE 9节点、14节点、30节点、39节点和118节点系统。内含标准测试系统的原始数据和潮流结果。

鸿蒙5.0开发进阶:UI框架-ArkTS组件(XComponent)

提供用于图形绘制和媒体数据写入的Surface...........

Androidbye的博客 1238

【鸿蒙next开发】ArkUI框架:ArkTS组件-弹出框 (Dialog)

本文全面介绍了鸿蒙5.0(HarmonyOS Next)中的对话框组件,包含TipsDialog、SelectDialog、ConfirmDialog、AlertDialog、LoadingDialog和CustomContentDialog六大类型。

m0_73088370的博客 1295

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(自定义绘制设置)

当某些组件本身的绘制内容不满足需求时...........

Androidbye的博客 1058

【鸿蒙next开发】ArkUI框架:ArkTS组件-OffscreenCanvas

OffscreenCanvas是鸿蒙系统提供的屏幕外渲染组件............

m0_73088370的博客 954

【鸿蒙next开发】ArkUI框架:ArkTS组件-自定义绘制设置

本文介绍了鸿蒙5.0开发中的自定义组件绘制功能,详细讲解了如何使用DrawModifier接口进行组件的前景、内容和背景的自定义绘制。

m0_73088370的博客 957
上一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(Z序控制)
下一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(图像效果)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值