图片编码(ArkTS)

图片编码指将PixelMap编码成不同格式的存档图片(当前仅支持打包为JPEG、WebP 和 png 格式),用于后续处理,如保存、传输等。

开发步骤

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

图片编码进文件流

  1. 创建图像编码ImagePacker对象。

    // 导入相关模块包
    import image from '@ohos.multimedia.image';
    
    const imagePackerApi = image.createImagePacker();
    
  2. 设置编码输出流和编码参数。

    format为图像的编码格式;quality为图像质量,范围从0-100,100为最佳质量。

    let packOpts : image.PackingOption = { format:"image/jpeg", quality:98 };
    
  3. 创建PixelMap对象或创建ImageSource对象。

  4. 进行图片编码,并保存编码后的图片。

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

    import {BusinessError} from '@ohos.base'
    imagePackerApi.packing(pixelMap, packOpts).then( (data : ArrayBuffer) => {
      // data 为打包获取到的文件流,写入文件保存即可得到一张图片
    }).catch((error : BusinessError) => { 
      console.error('Failed to pack the image. And the error is: ' + error); 
    })
    

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

    import {BusinessError} from '@ohos.base'
    imagePackerApi.packing(imageSource, packOpts).then( (data : ArrayBuffer) => {
        // data 为打包获取到的文件流,写入文件保存即可得到一张图片
    }).catch((error : BusinessError) => { 
      console.error('Failed to pack the image. And the error is: ' + error); 
    })
    

图片编码进文件

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

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

import {BusinessError} from '@ohos.base'
import fs from '@ohos.file.fs'
const context : Context = getContext(this);
const path : string = context.cacheDir + "/pixel_map.jpg";
let file = fs.openSync(path, fs.OpenMode.CREATE | fs.OpenMode.READ_WRITE);
imagePackerApi.packToFile(pixelMap, file.fd, packOpts).then(() => {
    // 直接打包进文件
}).catch((error : BusinessError) => { 
  console.error('Failed to pack the image. And the error is: ' + error); 
})

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

import {BusinessError} from '@ohos.base'
import fs from '@ohos.file.fs'
const context : Context = getContext(this);
const filePath : string = context.cacheDir + "/image_source.jpg";
let file = fs.openSync(filePath, fs.OpenMode.CREATE | fs.OpenMode.READ_WRITE);
imagePackerApi.packToFile(imageSource, file.fd, packOpts).then(() => {
    // 直接打包进文件
}).catch((error : BusinessError) => { 
  console.error('Failed to pack the image. And the error is: ' + error); 
})