2025年4月12日 星期六 8:21pm

鸿蒙HarmonyOS开发实战—多媒体开发（图像开发 一）

id="article_content" class="article_content clearfix"> id="content_views" class="htmledit_views">

图像开发概述

HarmonyOS图像模块支持图像业务的开发，常见功能如图像解码、图像编码、基本的位图操作、图像编辑等。当然，也支持通过接口组合来实现更复杂的图像处理逻辑。

基本概念
  • 图像解码 图像解码就是不同的存档格式图片（如JPEG、PNG等）解码为无压缩的位图格式，以方便在应用或者系统中进行相应的处理。
  • PixelMap PixelMap是图像解码后无压缩的位图格式，用于图像显示或者进一步的处理。
  • 渐进式解码 渐进式解码是在无法一次性提供完整图像文件数据的场景下，随着图像文件数据的逐步增加，通过多次增量解码逐步完成图像解码的模式。
  • 预乘 预乘时，RGB各通道的值被替换为原始值乘以Alpha通道不透明的比例（0~1）后的值，方便后期直接合成叠加；不预乘指RGB各通道的数值是图像的原始值，与Alpha通道的值无关。
  • 图像编码 图像编码就是将无压缩的位图格式，编码成不同格式的存档格式图片（JPEG、PNG等），以方便在应用或者系统中进行相应的处理。
约束与限制

为及时释放本地资源，建议在图像解码的ImageSource对象、位图图像PixelMap对象或图像编码的ImagePacker对象使用完成后，主动调用ImageSource、PixelMap和ImagePacker的release()方法。

图像解码开发

场景介绍

图像解码就是将所支持格式的存档图片解码成统一的PixelMap图像，用于后续图像显示或其他处理，比如旋转、缩放、裁剪等。当前支持格式包括JPEG、PNG、GIF、HEIF、WebP、BMP。

接口说明

ImageSource主要用于图像解码。

class="table-box">

接口名

描述

create(String pathName, SourceOptions opts)

从图像文件路径创建图像数据源。

create(InputStream is, SourceOptions opts)

从输入流创建图像数据源。

create(byte[] data, SourceOptions opts)

从字节数组创建图像源。

create(byte[] data, int offset, int length, SourceOptions opts)

从字节数组指定范围创建图像源。

create(File file, SourceOptions opts)

从文件对象创建图像数据源。

create(FileDescriptor fd, SourceOptions opts)

从文件描述符创建图像数据源。

createIncrementalSource(SourceOptions opts)

创建渐进式图像数据源。

createIncrementalSource(IncrementalSourceOptions opts)

创建渐进式图像数据源，支持设置渐进式数据更新模式。

createPixelmap(DecodingOptions opts)

从图像数据源解码并创建PixelMap图像。

createPixelmap(int index, DecodingOptions opts)

从图像数据源解码并创建PixelMap图像，如果图像数据源支持多张图片的话，支持指定图像索引。

updateData(byte[] data, boolean isFinal)

更新渐进式图像源数据。

updateData(byte[] data, int offset, int length, boolean isFinal)

更新渐进式图像源数据，支持设置输入数据的有效数据范围。

getImageInfo()

获取图像基本信息。

getImageInfo(int index)

根据特定的索引获取图像基本信息。

getSourceInfo()

获取图像源信息。

release()

释放对象关联的本地资源。

普通解码开发步骤

1. 创建图像数据源ImageSource对象，可以通过SourceOptions指定数据源的格式信息，此格式信息仅为给解码器的提示，正确提供能帮助提高解码效率，如果不设置或设置不正确，会自动检测正确的图像格式。不使用该选项时，可以将create接口传入的SourceOptions设置为null。

  1.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="1">
class="hljs-ln-code"> class="hljs-ln-line">ImageSource.SourceOptions srcOpts = new ImageSource.SourceOptions();
  • class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="2">
    • class="hljs-ln-code"> class="hljs-ln-line">srcOpts.formatHint = "image/png";
  • class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="3"> class="hljs-ln-code"> class="hljs-ln-line">// 此处传入用户自定义的图像路径
  • class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="4"> class="hljs-ln-code"> class="hljs-ln-line">String pathName = "/sdcard/image.png";
  • class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="5"> class="hljs-ln-code"> class="hljs-ln-line">ImageSource imageSource = ImageSource.create(pathName, srcOpts);
    •  class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}" onclick="hljs.signin(event)"> 

    1.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="1"> class="hljs-ln-code"> class="hljs-ln-line">// 不通过SourceOptions指定数据源格式信息
    2.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="2"> class="hljs-ln-code"> class="hljs-ln-line">ImageSource imageSourceNoOptions = ImageSource.create(pathName, null);
     class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}" onclick="hljs.signin(event)">

    2. 设置解码参数，解码获取PixelMap图像对象，解码过程中同时支持图像处理操作。

    如果只需要解码原始图像，不使用该选项时，可将给createPixelMap传入的DecodingOptions 设置为null。

    1.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="1"> class="hljs-ln-code"> class="hljs-ln-line">// 普通解码叠加缩放、裁剪、旋转
    2.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="2"> class="hljs-ln-code"> class="hljs-ln-line">ImageSource.DecodingOptions decodingOpts = new ImageSource.DecodingOptions();
    3.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="3"> class="hljs-ln-code"> class="hljs-ln-line">decodingOpts.desiredSize = new Size(100, 2000);
    4.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="4"> class="hljs-ln-code"> class="hljs-ln-line">decodingOpts.desiredRegion = new Rect(0, 0, 100, 100);
    5.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="5"> class="hljs-ln-code"> class="hljs-ln-line">decodingOpts.rotateDegrees = 90;
    6.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="6"> class="hljs-ln-code"> class="hljs-ln-line">PixelMap pixelMap = imageSource.createPixelmap(decodingOpts); 
     class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}" onclick="hljs.signin(event)">
    1.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="1"> class="hljs-ln-code"> class="hljs-ln-line">// 普通解码
    2.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="2"> class="hljs-ln-code"> class="hljs-ln-line">PixelMap pixelMapNoOptions = imageSource.createPixelmap(null);
     class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}" onclick="hljs.signin(event)">

    3. 解码完成获取到PixelMap对象后，可以进行后续处理，比如渲染显示等。

    渐进式解码开发步骤

    1. 创建渐进式图像数据源ImageSource对象。

    可以通过SourceOptions指定数据源的格式信息，此格式信息仅为提示，如果填写不正确，会自动检测正确的图像格式。使用IncrementalSourceOptions指定图像数据的更新方式为渐进式更新。

    1.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="1"> class="hljs-ln-code"> class="hljs-ln-line">ImageSource.SourceOptions srcOpts = new ImageSource.SourceOptions();
    2.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="2"> class="hljs-ln-code"> class="hljs-ln-line">srcOpts.formatHint = "image/jpeg";
    3.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="3"> class="hljs-ln-code"> class="hljs-ln-line">ImageSource.IncrementalSourceOptions incOpts = new ImageSource.IncrementalSourceOptions();
    4.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="4"> class="hljs-ln-code"> class="hljs-ln-line">incOpts.opts = srcOpts;
    5.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="5"> class="hljs-ln-code"> class="hljs-ln-line">incOpts.mode = ImageSource.UpdateMode.INCREMENTAL_DATA;
    6.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="6"> class="hljs-ln-code"> class="hljs-ln-line">ImageSource imageSource = ImageSource.createIncrementalSource(incOpts);
     class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}" onclick="hljs.signin(event)">

    2. 渐进式更新数据。在未获取到全部图像时，支持先更新部分数据来尝试解码，调用updateData更新数据，将参数isFinal设置为false；当获取到全部数据后，最后一次更新数据时设置isFinal为true，表示数据更新完毕。设置解码参数同普通解码。

    1.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="1"> class="hljs-ln-code"> class="hljs-ln-line">// 传入本地图片路径作为图像数据源
    2.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="2"> class="hljs-ln-code"> class="hljs-ln-line">File file = new File("/sdcard/test.jpg");
    3.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="3"> class="hljs-ln-code"> class="hljs-ln-line">FileInputStream fis = null;
    4.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="4"> class="hljs-ln-code"> class="hljs-ln-line">try {
    5.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="5"> class="hljs-ln-code"> class="hljs-ln-line">    fis = new FileInputStream(file);
    6.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="6"> class="hljs-ln-code"> class="hljs-ln-line">    ByteArrayOutputStream bos = new ByteArrayOutputStream();
    7.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="7"> class="hljs-ln-code"> class="hljs-ln-line">    byte[] data = new byte[1024];
    8.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="8"> class="hljs-ln-code"> class="hljs-ln-line">    int len = -1;
    9.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="9"> class="hljs-ln-code"> class="hljs-ln-line">    while((len = fis.read(data)) != -1) {
    10.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="10"> class="hljs-ln-code"> class="hljs-ln-line">        bos.write(data, 0, len);
    11.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="11"> class="hljs-ln-code"> class="hljs-ln-line">    }
    12.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="12"> class="hljs-ln-code"> class="hljs-ln-line">    byte[] fileByte = bos.toByteArray();
    13.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="13"> class="hljs-ln-code"> class="hljs-ln-line">// 获取到一定的数据时尝试解码
    14.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="14"> class="hljs-ln-code"> class="hljs-ln-line">    imageSource.updateData(fileByte, 0, fileByte.length / 2, false);
    15.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="15"> class="hljs-ln-code"> class="hljs-ln-line">    ImageSource.DecodingOptions decodingOpts = new ImageSource.DecodingOptions();
    16.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="16"> class="hljs-ln-code"> class="hljs-ln-line">    PixelMap pixelMap = imageSource.createPixelmap(decodingOpts);
    17.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="17"> class="hljs-ln-code"> class="hljs-ln-line"> 
    18.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="18"> class="hljs-ln-code"> class="hljs-ln-line">// 更新数据再次解码，重复调用直到数据全部更新完成
    19.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="19"> class="hljs-ln-code"> class="hljs-ln-line">    imageSource.updateData(fileByte, fileByte.length / 2, fileByte.length / 4, false);
    20.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="20"> class="hljs-ln-code"> class="hljs-ln-line">    pixelMap = imageSource.createPixelmap(decodingOpts);
    21.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="21"> class="hljs-ln-code"> class="hljs-ln-line"> 
    22.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="22"> class="hljs-ln-code"> class="hljs-ln-line">// 数据全部更新完成时需要传入isFinal为true
    23.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="23"> class="hljs-ln-code"> class="hljs-ln-line">    imageSource.updateData(fileByte, fileByte.length * 3 / 4, fileByte.length / 4, true);
    24.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="24"> class="hljs-ln-code"> class="hljs-ln-line">    pixelMap = imageSource.createPixelmap(decodingOpts);
    25.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="25"> class="hljs-ln-code"> class="hljs-ln-line">} catch (IOException e) {
    26.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="26"> class="hljs-ln-code"> class="hljs-ln-line">    e.printStackTrace();
    27.  class="hljs-ln-numbers"> class="hljs-ln-line hljs-ln-n" data-line-number="27"> class="hljs-ln-code"> class="hljs-ln-line">}
     class="hide-preCode-box"> class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}" onclick="hljs.signin(event)">

    3. 解码完成获取到PixelMap对象后，可以进行后续处理，比如渲染显示等。

    最后，为了能让大家更好的去学习提升鸿蒙 (Harmony OS) 开发技术，小编连夜整理了一份30个G纯血版学习资料（含视频、电子书、学习文档等）以及一份在Github上持续爆火霸榜的《纯血版华为鸿蒙 (Harmony OS)开发手册》（共计890页），希望对大家有所帮助。

    纯血版鸿蒙 HarmonyOS 4.0 视频学习资料

     需要以上视频学习资料小伙伴

    请点击→纯血版全套鸿蒙HarmonyOS学习资料

    《纯血版华为鸿蒙 (Harmony OS)开发手册》

    这份手册涵盖了当前鸿蒙 (Harmony OS) 开发技术必掌握的核心知识点

    纯血版鸿蒙 (Harmony OS)开发手册部分精彩内容

    HarmonyOS 概念：

    如何快速入门？


    开发基础知识： 

    基于ArkTS 开发：

    获取以上文中提到的这份纯血版鸿蒙 (Harmony OS) 开发资料的小伙伴 

    请点击→纯血版全套鸿蒙HarmonyOS学习资料

    🚀写在最后

    data-report-view="{"mod":"1585297308_001","spm":"1001.2101.3001.6548","dest":"https://blog.csdn.net/shudaoshanQAQ/article/details/135698667","extend1":"pc","ab":"new"}">> id="blogExtensionBox" style="width:400px;margin:auto;margin-top:12px" class="blog-extension-box"> class="blog_extension blog_extension_type2" id="blog_extension"> class="extension_official" data-report-click="{"spm":"1001.2101.3001.6471"}" data-report-view="{"spm":"1001.2101.3001.6471"}"> class="blog_extension_card_left"> class="blog_extension_card_cont"> 最新鸿蒙Next全套学习资料请扫码 class="blog_extension_card_cont_r"> 微信名片
    注：本文转载自blog.csdn.net的蜀道山QAQ的文章"https://blog.csdn.net/shudaoshanQAQ/article/details/135698667"。版权归原作者所有，此博客不拥有其著作权，亦不承担相应法律责任。如有侵权，请联系我们删除。
    复制链接
    复制链接
    相关推荐
    发表评论

    评论记录：

    未查询到任何数据！