鸿蒙5.0版开发:图片开发(ArkTS)-使用ImageSource完成图片解码

 往期鸿蒙全套实战文章必看:


使用ImageSource完成图片解码

图片解码指将所支持格式的存档图片解码成统一的PixelMap,以便在应用或系统中进行图片显示或图片处理。当前支持的存档图片格式包括JPEG、PNG、GIF、WebP、BMP、SVG、ICO、DNG、HEIF(不同硬件设备支持情况不同)。

开发步骤

图片解码相关API的详细介绍。

  1. 全局导入Image模块。

    import { image } from '@kit.ImageKit';
  2. 获取图片。

    • 方法一:获取沙箱路径。应用沙箱的介绍及如何向应用沙箱推送文件。

      // Stage模型参考如下代码
      const context : Context = getContext(this);
      const filePath : string = context.cacheDir + '/test.jpg';
      // FA模型参考如下代码
      import { featureAbility } from '@kit.AbilityKit';
      
      const context = featureAbility.getContext();
      const filePath = context.getCacheDir() + "/test.jpg";
    • 方法二:通过沙箱路径获取图片的文件描述符。

      该方法需要先导入@kit.CoreFileKit模块。

      import { fileIo as fs } from '@kit.CoreFileKit';

      然后调用fs.openSync()获取文件描述符。

      // Stage模型参考如下代码
      const context = getContext(this);
      const filePath = context.cacheDir + '/test.jpg';
      const file : fs.File = fs.openSync(filePath, fs.OpenMode.READ_WRITE);
      const fd : number = file?.fd;
      // FA模型参考如下代码
      import { featureAbility } from '@kit.AbilityKit';
      
      const context = featureAbility.getContext();
      const filePath = context.getCacheDir() + "/test.jpg";
      const file : fs.File = fs.openSync(filePath, fs.OpenMode.READ_WRITE);
      const fd : number = file?.fd;
    • 方法三:通过资源管理器获取资源文件的ArrayBuffer。

      // Stage模型
      const context : Context = getContext(this);
      // 获取resourceManager资源管理器
      const resourceMgr : resourceManager.ResourceManager = context.resourceManager;
      // FA模型
      // 导入resourceManager资源管理器
      import { resourceManager } from '@kit.LocalizationKit';
      import { BusinessError } from '@kit.BasicServicesKit';
      resourceManager.getResourceManager().then((resourceMgr : resourceManager.ResourceManager) => {
         console.log("Succeeded in getting resourceManager")
      }).catch((err : BusinessError) => {
         console.error("Failed to get resourceManager")
      });

      不同模型获取资源管理器的方式不同,获取资源管理器后,再调用resourceMgr.getRawFileContent()获取资源文件的ArrayBuffer。

      resourceMgr.getRawFileContent('test.jpg').then((fileData : Uint8Array) => {
         console.log("Succeeded in getting RawFileContent")
         // 获取图片的ArrayBuffer
         const buffer = fileData.buffer.slice(0);
      }).catch((err : BusinessError) => {
         console.error("Failed to get RawFileContent")
      });
    • 方法四:通过资源管理器获取资源文件的RawFileDescriptor。

      // Stage模型
      const context : Context = getContext(this);
      // 获取resourceManager资源管理器
      const resourceMgr : resourceManager.ResourceManager = context.resourceManager;
      // FA模型
      // 导入resourceManager资源管理器
      import { resourceManager } from '@kit.LocalizationKit';
      import { BusinessError } from '@kit.BasicServicesKit';
      resourceManager.getResourceManager().then((resourceMgr : resourceManager.ResourceManager) => {
         console.log("Succeeded in getting resourceManager")
      }).catch((err : BusinessError) => {
         console.error("Failed to get resourceManager")
      });

      不同模型获取资源管理器的方式不同,获取资源管理器后,再调用resourceMgr.getRawFd()获取资源文件的RawFileDescriptor。

      resourceMgr.getRawFd('test.jpg').then((rawFileDescriptor : resourceManager.RawFileDescriptor) => {
         console.log("Succeeded in getting RawFileDescriptor")
      }).catch((err : BusinessError) => {
         console.error("Failed to get RawFileDescriptor")
      });
  3. 创建ImageSource实例。

    • 方法一:通过沙箱路径创建ImageSource。沙箱路径可以通过步骤2的方法一获取。

      // path为已获得的沙箱路径
      const imageSource : image.ImageSource = image.createImageSource(filePath);
    • 方法二:通过文件描述符fd创建ImageSource。文件描述符可以通过步骤2的方法二获取。

      // fd为已获得的文件描述符
      const imageSource : image.ImageSource = image.createImageSource(fd);
    • 方法三:通过缓冲区数组创建ImageSource。缓冲区数组可以通过步骤2的方法三获取。

      const imageSource : image.ImageSource = image.createImageSource(buffer);
    • 方法四:通过资源文件的RawFileDescriptor创建ImageSource。RawFileDescriptor可以通过步骤2的方法四获取。

      const imageSource : image.ImageSource = image.createImageSource(rawFileDescriptor);
  4. 设置解码参数DecodingOptions,解码获取pixelMap图片对象。

    • 设置期望的format进行解码:
      import { BusinessError } from '@kit.BasicServicesKit';
      import image from '@ohos.multimedia.image';
      let img = await getContext(this).resourceManager.getMediaContent($r('app.media.image'));
      let imageSource:image.ImageSource = image.createImageSource(img.buffer.slice(0));
      let decodingOptions : image.DecodingOptions = {
         editable: true,
         desiredPixelFormat: 3,
      }
      // 创建pixelMap
      imageSource.createPixelMap(decodingOptions).then((pixelMap : image.PixelMap) => {
         console.log("Succeeded in creating PixelMap")
      }).catch((err : BusinessError) => {
         console.error("Failed to create PixelMap")
      });
    • HDR图片解码
      import { BusinessError } from '@kit.BasicServicesKit';
      import image from '@ohos.multimedia.image';
      let img = await getContext(this).resourceManager.getMediaContent($r('app.media.CUVAHdr'));
      let imageSource:image.ImageSource = image.createImageSource(img.buffer.slice(0));
      let decodingOptions : image.DecodingOptions = {
         //设置为AUTO会根据图片资源格式解码,如果图片资源为HDR资源则会解码为HDR的pixelmap。
         desiredDynamicRange: image.DecodingDynamicRange.AUTO,
      }
      // 创建pixelMap
      imageSource.createPixelMap(decodingOptions).then((pixelMap : image.PixelMap) => {
         console.log("Succeeded in creating PixelMap")
         // 判断pixelmap是否为hdr内容
         let info = pixelMap.getImageInfoSync();
         console.log("pixelmap isHdr:" + info.isHdr);
      }).catch((err : BusinessError) => {
         console.error("Failed to create PixelMap")
      });

    解码完成,获取到pixelMap对象后,可以进行后续图片处理

  5. 释放pixelMap。

    pixelMap.release();

开发示例-对资源文件中的图片进行解码

  1. 获取resourceManager资源管理。

    const context : Context = getContext(this);
    // 获取resourceManager资源管理
    const resourceMgr : resourceManager.ResourceManager = context.resourceManager;
  2. 创建ImageSource。

    • 通过rawfile文件夹下test.jpg的ArrayBuffer创建。

       resourceMgr.getRawFileContent('test.jpg').then((fileData : Uint8Array) => {
          console.log("Succeeded in getting RawFileContent")
          // 获取图片的ArrayBuffer
          const buffer = fileData.buffer.slice(0);
          const imageSource : image.ImageSource = image.createImageSource(buffer);
       }).catch((err : BusinessError) => {
          console.error("Failed to get RawFileContent")
       });
    • 通过rawfile文件夹下test.jpg的RawFileDescriptor创建。

       resourceMgr.getRawFd('test.jpg').then((rawFileDescriptor : resourceManager.RawFileDescriptor) => {
          console.log("Succeeded in getting RawFd")
          const imageSource : image.ImageSource = image.createImageSource(rawFileDescriptor);
       }).catch((err : BusinessError) => {
          console.error("Failed to get RawFd")
       });
  3. 创建pixelMap。

    imageSource.createPixelMap().then((pixelMap: image.PixelMap) => {
       console.log("Succeeded in creating PixelMap")
    }).catch((err : BusinessError) => {
       console.error("Failed to creating PixelMap")
    });
  4. 释放pixelMap。

    pixelMap.release();

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值