使用ImagePacker完成图片编码

图片编码指将PixelMap压缩成不同格式的图片文件，用于保存和传输。

支持使用PackToData和PackToFile将PixelMap编码为JPEG、WebP、PNG和HEIC格式。

从API version 18开始，支持使用PackToDataFromPixelmapSequence和PackToFileFromPixelmapSequence将多个PixelMap编码为GIF格式。

开发步骤

图片编码相关API的详细介绍请参见：图片编码接口说明。

图片编码进文件流

导入相关模块包。

// 导入相关模块包。
import { image } from '@kit.ImageKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { common } from '@kit.AbilityKit';
import { fileIo as fs } from '@kit.CoreFileKit';
import { resourceManager } from '@kit.LocalizationKit';

EncodingPixelMap.ets

创建图像编码ImagePacker对象。
```
const imagePackerApi = image.createImagePacker();
```
CodecUtility.ets
设置编码输出流和编码参数。
- format为图像的编码格式；quality为图像质量，范围为[0, 100]，100为最佳质量。
  
  说明： 根据MIME标准，标准编码格式为image/jpeg。当使用image编码时，PackingOption.format设置为image/jpeg，image编码后的文件扩展名可设为.jpg或.jpeg，可在支持image/jpeg解码的平台上使用。
```
let packOpts : image.PackingOption = { format: 'image/jpeg', quality: 95 };
```
  CodecUtility.ets
- 编码为HDR内容。
```
// 资源本身为hdr且设备支持HDR编码则会编码为hdr内容(需要资源本身为hdr且设备支持HDR编码，支持jpeg格式)。
packOpts.desiredDynamicRange = image.PackingDynamicRange.AUTO;
```
  CodecUtility.ets

进行图片编码，并保存编码后的图片。

方法一：通过PixelMap进行编码。

async function packToDataFromPixelMap(pixelMap : image.PixelMap) {
  const imagePackerApi = image.createImagePacker();
  let packOpts : image.PackingOption = { format: 'image/jpeg', quality: 95 };
  // 资源本身为hdr且设备支持HDR编码则会编码为hdr内容(需要资源本身为hdr且设备支持HDR编码，支持jpeg格式)。
  packOpts.desiredDynamicRange = image.PackingDynamicRange.AUTO;
  try{
    let data = await imagePackerApi.packToData(pixelMap, packOpts);
    // data 为编码获取到的文件流，写入文件保存即可得到一张图片。
    copyData = new ArrayBuffer(0);
    copyData = data;
  } catch (error) {
    console.error('Failed to pack the pixelMap to data. And the error is: ' + error);
  }
}

CodecUtility.ets

方法二：通过imageSource进行编码。

async function packToDataFromImageSource(imageSource : image.ImageSource) {
  const imagePackerApi = image.createImagePacker();
  let packOpts : image.PackingOption = { format: 'image/jpeg', quality: 95 };
  try {
    let data = await imagePackerApi.packToData(imageSource, packOpts);
    // data 为编码获取到的文件流，写入文件保存即可得到一张图片。
    copyData = new ArrayBuffer(0);
    copyData = data;
  } catch (error) {
    console.error('Failed to pack the imageSource to data. And the error is: ' + error);
  }
}

CodecUtility.ets

图片编码进文件

在编码时，开发者可以传入对应的文件路径，编码后的内存数据将直接写入文件。

方法一：通过PixelMap编码进文件。

async function packToFileFromPixelMap(context : Context, pixelMap : image.PixelMap) {
  const imagePackerApi = image.createImagePacker();
  let packOpts : image.PackingOption = { format: 'image/jpeg', quality: 95 };
  const path : string = context.cacheDir + '/pixel_map.jpg';
  let file = fs.openSync(path, fs.OpenMode.CREATE | fs.OpenMode.READ_WRITE);
  try {
    await imagePackerApi.packToFile(pixelMap, file.fd, packOpts);
  } catch (error) {
    console.error('Failed to pack the pixelMap to file. And the error is: ' + error);
  }
}

CodecUtility.ets

方法二：通过imageSource编码进文件。

async function packToFileFromImageSource(context : Context, imageSource : image.ImageSource) {
  const imagePackerApi = image.createImagePacker();
  let packOpts : image.PackingOption = { format: 'image/jpeg', quality: 95 };
  const filePath : string = context.cacheDir + '/image_source.jpg';
  let file = fs.openSync(filePath, fs.OpenMode.CREATE | fs.OpenMode.READ_WRITE);
  try {
    await imagePackerApi.packToFile(imageSource, file.fd, packOpts);
  } catch (error) {
    console.error('Failed to pack the imageSource to file. And the error is: ' + error);
  }
}

CodecUtility.ets

图片编码保存进图库

可以将图片编码保存到应用沙箱，然后使用媒体文件管理相关接口保存媒体库资源。