HarmonyOS开发实例:【图片编辑应用】

介绍

本篇Codelab通过动态设置元素样式的方式,实现几种常见的图片操作,包括裁剪、旋转、缩放和镜像。效果如图所示:

相关概念

  • [image组件]:图片组件,用来渲染展示图片。
  • [div组件]:基础容器组件,用作页面结构的根节点或将内容进行分组。
  • [text组件]:文本组件,用于呈现一段信息。
  • [setstyle]:动态设置组件样式的方法。

环境搭建

软件要求

  • DevEco Studio版本:DevEco Studio 3.1 Release及以上版本。
  • OpenHarmony SDK版本:API version 9及以上版本。

硬件要求

  • 开发板类型:[润和RK3568开发板]。
  • OpenHarmony系统:3.2 Release及以上版本。

环境搭建

完成本篇Codelab我们首先要完成开发环境的搭建,本示例以RK3568开发板为例,参照以下步骤进行:

  1. [获取OpenHarmony系统版本]:标准系统解决方案(二进制)。以3.2 Release版本为例:

  2. 搭建烧录环境。

    1. [完成DevEco Device Tool的安装]
    2. [完成RK3568开发板的烧录]
  3. 搭建开发环境。

    1. 开始前请参考[工具准备],完成DevEco Studio的安装和开发环境配置。
    2. 开发环境配置完成后,请参考[使用工程向导]创建工程(模板选择"Empty Ability")。
    3. 工程创建完成后,选择使用[真机进行调测]。
    4. 鸿蒙开发指导文档:gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。

代码结构解读

本篇Codelab只对核心代码进行讲解,对于完整代码,我们会在gitee中提供。

HarmonyOS与OpenHarmony鸿蒙文档籽料:mau123789是v直接拿

├──entry/src/main/js	              // 代码区
│  └──MainAbility
│     ├──common
│     │  ├──constants
│     │  │  └──commonConstants.js     // 公共数据常量
│     │  └──images
│     ├──i18n		                  // 中英文	
│     │  ├──en-US.json			
│     │  └──zh-CN.json			
│     └──pages
│        └──index
│           ├──index.css              // 首页样式文件	
│           ├──index.hml              // 首页布局文件
│           └──index.js               // 首页脚本文件
└──entry/src/main/resources           // 应用资源目录

构建界面

本示例主界面由上至下分为三部分:顶部标题栏、中间图片区域、底部操作栏。

标题栏中的元素呈水平分布,包含"返回"图标、"编辑"标题和"保存"图标。div容器内元素默认为水平分布,开发者将对应元素置于div容器组件中即可。"返回"图标和"编辑"标题置于同一个子div容器中,组成一个新元素,与"保存"图标分别置于父div容器的水平两侧。

<!-- index.hml -->
<!-- 顶部标题栏 -->
<div class="title-container">
    <div>
        <image src="/common/images/ic_back.png" class="image-back"></image>
        <text class="title-text">{{ $t('strings.edit') }}</text>
    </div>
    <image src="/common/images/ic_save.png" class="image-save"></image>
</div>

/* index.css */
.title-container {
    justify-content: space-between;
    width: 100%;
    padding-top: 13vp;
    padding-left: 26vp;
    padding-bottom: 15vp;
    padding-right: 24vp;
}

图片区域用于展示被编辑的图片,使用div容器组件限定区域范围。再通过设置样式,使范围内的图片居中展示。图片组件image设置object-fit属性为contain,确保图片保持宽高比缩放,并在区域内完整展示。

<!-- index.hml -->
<!-- 图片区域 -->
<div class="image-container">
    <image id="picture" src="/common/images/ic_meals.png" class="picture"></image>
</div>

/* index.css */
.image-container {
    justify-content: center;
    width: 100%;
    height: 68%;
    flex-direction: column;
    align-items: center;
}

.picture {
    object-fit: contain;
}

操作栏包含裁剪、旋转、缩放和镜像四种常见操作按钮。他们的布局和数据结构相同,可采用for循环的方式进行渲染。每个按钮的图标和文字都是垂直分布,也是通过设置对应样式达到效果。

<!-- index.hml -->
<!-- 操作栏 -->
<div>
    <div class="button-container" for="item in buttonList" on:click="pictureManipulation({{ item.buttonType }})">
        <image src="{{ item.src }}" class="button-icon">
        </image>
        <text class="operation-text">{{ item.description }}</text>
    </div>
</div>

/* index.css */
.button-icon {
    width: 27vp;
    height: 27vp;
    margin-left: 24vp;
    margin-right: 24vp;
    margin-top: 52vp;
    margin-bottom: 6vp;
}

.operation-text {
    font-size: 12fp;
    color: #182431;
}

.button-container {
    justify-content: center;
    flex-direction: column;
    align-items: center;
    width: 100%;
}

编辑图片

使用指定元素的setStyle(name: string, value: string)方法,可以动态设置该元素样式。当前示例正是基于此方式,实现了对图片裁剪、旋转、缩放以及镜像操作。

  • 裁剪操作:使用clip-path样式,设置组件的裁剪区域,只显示区域内的部分,实现对图片的裁剪操作。

  • 旋转操作:使用transform动画样式,设置组件的旋转动画属性,实现对图片的旋转操作。

  • 缩放操作:动态等比例设置组件宽、高属性,实现对图片的缩放操作。

  • 镜像操作:使用transform动画样式,设置组件的Y轴方向旋转动画属性,实现对图片的旋转操作。

    // index.js
    pictureManipulation(buttonType) {
    if (this.isCropped || this.isRotated || this.isZoomed || this.isMirror) {
    this.element('picture').setStyle('clipPath', 'inset(0, 0, 0, 0'); this.element('picture').setStyle('transform', 'rotate(0)');
    this.element('picture').setStyle('height', this.imageHeight); this.element('picture').setStyle('width', this.imageWidth);
    this.element('picture').setStyle('transform', 'rotateY(0)'); this.degrees = 0; this.rotateY = 0; this.isCropped = false; this.isRotated = false; this.isZoomed = false; this.isMirror = false; } else { switch (buttonType) { case CommonConstants.OperationType.CROP: this.element('picture')
    .setStyle('clipPath', 'inset(0, 0, ' + (this.imageHeight / CommonConstants.SPLIT_IN_HALF) + ', 0');
    this.isCropped = true;
    break;
    case CommonConstants.OperationType.ROTATE:
    this.degrees = this.degrees + CommonConstants.ROTATE_DEGREE;
    this.element('picture').setStyle('transform', 'rotate(' + this.degrees + ')'); this.isRotated = true; break; case CommonConstants.OperationType.ZOOM: this.element('picture').setStyle('height', this.imageHeight / CommonConstants.SPLIT_IN_HALF);
    this.element('picture').setStyle('width', this.imageWidth / CommonConstants.SPLIT_IN_HALF); this.isZoomed = true; break; case CommonConstants.OperationType.MIRROR: this.rotateY = this.rotateY + CommonConstants.ROTATE_Y; this.element('picture').setStyle('transform', 'rotateY(' + this.rotateY + ')');
    this.isMirror = true;
    break;
    default:
    hilog.info(0x0000, 'ImageOperation', '%{public}s', 'Operation type is wrong!');
    break;
    }
    }
    }

相关推荐
枫叶丹45 小时前
【HarmonyOS之旅】HarmonyOS开发基础知识(三)
华为od·华为·华为云·harmonyos
SoraLuna10 小时前
「Mac畅玩鸿蒙与硬件47」UI互动应用篇24 - 虚拟音乐控制台
开发语言·macos·ui·华为·harmonyos
黄油饼卷咖喱鸡就味增汤拌孜然羊肉炒饭11 小时前
SpringBoot如何实现缓存预热?
java·spring boot·spring·缓存·程序员
AORO_BEIDOU13 小时前
单北斗+鸿蒙系统+国产芯片,遨游防爆手机自主可控“三保险”
华为·智能手机·harmonyos
博览鸿蒙14 小时前
鸿蒙操作系统(HarmonyOS)的应用开发入门
华为·harmonyos
少年姜太公15 小时前
从零开始详解js中的this(下)
前端·javascript·程序员
凌虚16 小时前
Kubernetes APF(API 优先级和公平调度)简介
后端·程序员·kubernetes
小华同学ai20 小时前
ShowDoc:Star12.3k,福利项目,个人小团队的在线文档“简单、易用、轻量化”还专门针对API文档、技术文档做了优化
前端·程序员·github
Damon小智21 小时前
HarmonyOS NEXT 技术实践-基于基础视觉服务的多目标识别
华为·harmonyos
一條狗1 天前
隨筆 20241224 ts寫入excel表
开发语言·前端·typescript