鸿蒙OS 中实现对各种图片格式的解码，转换为统一的 PixelMap 对象

图片解码是将各种格式的图片文件（如JPEG、PNG、GIF、RAW、WebP、BMP、SVG）解码成统一的PixelMap，以便在应用或系统中进行显示或处理。

以下是如何使用鸿蒙OS的图片解码API进行图片解码的详细步骤。

步骤1：全局导入Image模块

import image from '@ohos.multimedia.image';

步骤2：获取图片

有三种方法可以获取图片：通过沙箱路径、通过文件描述符、通过资源管理器。

方法一：获取沙箱路径

获取应用沙箱路径以获取图片文件的路径。

Stage模型：

const context = getContext(this);
const filePath = context.cacheDir + '/test.jpg';

FA模型：

import featureAbility from '@ohos.ability.featureAbility';

const context = featureAbility.getContext();
const filePath = context.getCacheDir() + "/test.jpg";

方法二：通过沙箱路径获取图片的文件描述符

首先导入@ohos.file.fs模块，然后调用fs.openSync()获取文件描述符。

import fs from '@ohos.file.fs';

// Stage模型
const context = getContext(this);
const filePath = context.cacheDir + '/test.jpg';
const file = fs.openSync(filePath, fs.OpenMode.READ_WRITE);
const fd = file?.fd;

// FA模型
import featureAbility from '@ohos.ability.featureAbility';

const context = featureAbility.getContext();
const filePath = context.getCacheDir() + "/test.jpg";
const file = fs.openSync(filePath, fs.OpenMode.READ_WRITE);
const fd = file?.fd;

方法三：通过资源管理器获取资源文件的ArrayBuffer

获取资源管理器并使用resourceMgr.getRawFileContent()获取资源文件的ArrayBuffer。

Stage模型：

const context = getContext(this);
const resourceMgr = context.resourceManager;
const fileData = await resourceMgr.getRawFileContent('test.jpg');
const buffer = fileData.buffer;

FA模型：

import resourceManager from '@ohos.resourceManager';

const resourceMgr = await resourceManager.getResourceManager();
const fileData = await resourceMgr.getRawFileContent('test.jpg');
const buffer = fileData.buffer;

步骤3：创建ImageSource实例

有三种方法可以创建ImageSource实例：通过沙箱路径、通过文件描述符、通过缓冲区数组。

方法一：通过沙箱路径创建ImageSource

const imageSource = image.createImageSource(filePath);

方法二：通过文件描述符创建ImageSource

const imageSource = image.createImageSource(fd);

方法三：通过缓冲区数组创建ImageSource

const imageSource = image.createImageSource(buffer);

步骤4：设置解码参数并获取PixelMap图片对象

设置解码参数DecodingOptions，并调用imageSource.createPixelMap进行解码。

let decodingOptions = {
    editable: true,
    desiredPixelFormat: 3,
};

const pixelMap = await imageSource.createPixelMap(decodingOptions);

示例：对资源文件中的图片进行解码

步骤1：获取resourceManager资源管理器

const context = getContext(this);
const resourceMgr = context.resourceManager;

步骤2：获取rawfile文件夹下test.jpg的ArrayBuffer

const fileData = await resourceMgr.getRawFileContent('test.jpg');
const buffer = fileData.buffer;

步骤3：创建ImageSource实例

const imageSource = image.createImageSource(buffer);

步骤4：创建PixelMap

const pixelMap = await imageSource.createPixelMap();