news 2026/5/16 12:37:52

鸿蒙 图片处理:裁剪、缩放、旋转、翻转

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
鸿蒙 图片处理:裁剪、缩放、旋转、翻转

本文同步发表于微信公众号,微信搜索程语新视界即可关注,每个工作日都有文章更新

一、图像处理

图像处理指对PixelMap进行相关的操作,主要包括:

类型说明
图像处理裁剪、缩放、偏移、旋转、翻转、设置透明度等
位图操作读写像素数据等

备注:本文介绍的是图像处理部分

开发前提

在进行图像变换操作前,需要先完成图片解码,获取PixelMap对象。

二、导入模块

import { image } from '@kit.ImageKit'; import { BusinessError } from '@kit.BasicServicesKit';

三、获取图片信息

在图像变换操作前,可以先获取图片的基本信息。

// 获取图片大小 pixelMap.getImageInfo().then((info: image.ImageInfo) => { console.info('info.width = ' + info.size.width); console.info('info.height = ' + info.size.height); }).catch((err: BusinessError) => { console.error("Failed to obtain the image pixel map information. And the error is: " + err); });

ImageInfo主要属性

属性说明
size.width图片宽度
size.height图片高度
isHdr是否为HDR图片

四、图像变换操作

4.1 裁剪(crop)

方法pixelMap.crop(region: Region)

参数说明

参数类型说明
xnumber裁剪起始点横坐标
ynumber裁剪起始点纵坐标
size.heightnumber裁剪高度(从上往下)
size.widthnumber裁剪宽度(从左到右)

示例:从(0,0)开始,裁剪400×400区域

// x:裁剪起始点横坐标0 // y:裁剪起始点纵坐标0 // height:裁剪高度400,方向为从上往下 // width:裁剪宽度400,方向为从左到右 pixelMap.crop({ x: 0, y: 0, size: { height: 400, width: 400 } });

4.2 缩放(scale)

方法pixelMap.scale(x: number, y: number)

参数说明

参数说明
x水平方向缩放比例(1为原大小,0.5为缩小一半,2为放大一倍)
y垂直方向缩放比例

示例:缩小为原来的0.5倍

// 宽为原来的0.5 // 高为原来的0.5 pixelMap.scale(0.5, 0.5);

4.3 偏移(translate)

方法pixelMap.translate(x: number, y: number)

参数说明

参数说明
x水平方向偏移量(正数向右,负数向左)
y垂直方向偏移量(正数向下,负数向上)

示例:向右向下各偏移100像素

// 向下偏移100 // 向右偏移100 pixelMap.translate(100, 100);

4.4 旋转(rotate)

方法pixelMap.rotate(angle: number)

参数说明

参数说明
angle顺时针旋转角度(度数)

示例:顺时针旋转90度

// 顺时针旋转90° pixelMap.rotate(90);

4.5 翻转(flip)

方法pixelMap.flip(horizontal: boolean, vertical: boolean)

参数说明

参数说明
horizontal是否水平翻转
vertical是否垂直翻转

示例:垂直翻转

// 垂直翻转 pixelMap.flip(false, true);

示例:水平翻转

// 水平翻转 pixelMap.flip(true, false);

4.6 设置透明度(opacity)

方法pixelMap.opacity(alpha: number)

参数说明

参数说明
alpha透明度值,取值范围0-1(0完全透明,1完全不透明)

示例:设置50%透明度

// 透明度0.5 pixelMap.opacity(0.5);

五、注意事项

5.1 操作顺序

图像变换操作会依次生效,不同的顺序会产生不同的最终效果。

// 先裁剪后缩放 vs 先缩放后裁剪,结果不同 pixelMap.crop({ x: 0, y: 0, size: { width: 400, height: 400 } }); pixelMap.scale(0.5, 0.5);

5.2 资源释放

图像变换操作完成后,建议释放不再使用的PixelMap资源。

pixelMap.release(); pixelMap = undefined;

鸿蒙PixelMap图像变换支持裁剪(crop)、缩放(scale)、偏移(translate)、旋转(rotate)、翻转(flip)、透明度(opacity)等操作,通过对应方法即可完成图像的几何变换,操作前需先解码获取PixelMap。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/9 7:17:08

Java垃圾回收分析神器:GCViewer国际化与功能扩展完全指南

Java垃圾回收分析神器:GCViewer国际化与功能扩展完全指南 【免费下载链接】GCViewer Fork of tagtraum industries GCViewer. Tagtraum stopped development in 2008, I aim to improve support for Suns / Oracles java 1.6 garbage collector logs (including G1 …

作者头像 李华
网站建设 2026/4/9 7:15:08

PostgreSQL高效备份实战:PGbackrest全备与增量备份配置详解

1. 为什么选择PGbackrest做PostgreSQL备份 第一次接触PGbackrest是在三年前的一个生产环境事故后。当时我们使用传统的逻辑备份工具,结果在恢复一个200GB的数据库时花了整整6小时——业务停摆的每一分钟都是真金白银的损失。后来切换到PGbackrest做物理备份&#xf…

作者头像 李华
网站建设 2026/4/9 7:12:15

基于VMware的Meixiong Niannian画图引擎多环境测试平台

基于VMware的Meixiong Niannian画图引擎多环境测试平台 1. 引言 你是不是也遇到过这样的情况:好不容易搭建好了AI画图环境,结果换个电脑或者重装系统,一切又得从头再来?或者想要测试不同配置下的生成效果,却苦于没有…

作者头像 李华
网站建设 2026/4/10 12:59:20

Coze-Loop企业级部署指南:高可用架构与GPU资源优化

Coze-Loop企业级部署指南:高可用架构与GPU资源优化 1. 引言 当你需要将AI代码优化服务部署到生产环境时,单机部署显然不够用了。Coze-Loop作为一款专业的AI代码循环优化工具,在企业级场景下需要面对高并发请求、GPU资源管理和服务稳定性等多…

作者头像 李华
网站建设 2026/4/10 20:01:27

Qwen3-ForcedAligner-0.6B效果展示:WAV/MP3混合输入下98.2%字级对齐准确率

Qwen3-ForcedAligner-0.6B效果展示:WAV/MP3混合输入下98.2%字级对齐准确率 1. 惊艳效果开场:语音识别的精准新标杆 想象一下这样的场景:一段包含中文、英文混合的会议录音,背景还有轻微的键盘敲击声。传统的语音识别工具可能只能…

作者头像 李华
网站建设 2026/4/11 5:32:05

Qwen3-TTS-1.7B-Base效果实测:不同语种间韵律迁移与自然停顿

Qwen3-TTS-1.7B-Base效果实测:不同语种间韵律迁移与自然停顿 最近在语音合成领域,一个名为Qwen3-TTS-1.7B-Base的模型引起了我的注意。它最吸引我的地方,是那个听起来有点“科幻”的能力——跨语种韵律迁移。简单来说,就是让一个…

作者头像 李华