图片解码

图片解码指将所支持格式的存档图片解码成统一的PixelMap，以便在应用或系统中进行图片显示或图片处理。当前支持的存档图片格式包括JPEG、PNG、GIF、RAW、WebP、BMP、SVG。

开发步骤

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

全局导入Image模块。

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

获取图片。

方法一：获取沙箱路径。具体请参考获取应用文件路径。应用沙箱的介绍及如何向应用沙箱推送文件，请参考文件管理。

// 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";

方法二：通过沙箱路径获取图片的文件描述符。具体请参考file.fs API参考文档。该方法需要先导入@ohos.file.fs模块。

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

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

// 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。具体请参考ResourceManager API参考文档。

// Stage模型
const context = getContext(this);
// 获取resourceManager资源管理器
const resourceMgr = context.resourceManager;

// FA模型
// 导入resourceManager资源管理器
import resourceManager from '@ohos.resourceManager';
const resourceMgr = await resourceManager.getResourceManager();

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

const fileData = await resourceMgr.getRawFileContent('test.jpg');
// 获取图片的ArrayBuffer
const buffer = fileData.buffer;

创建ImageSource实例。
- 方法一：通过沙箱路径创建ImageSource。沙箱路径可以通过步骤2的方法一获取。
```
// path为已获得的沙箱路径
const imageSource = image.createImageSource(filePath);
```
- 方法二：通过文件描述符fd创建ImageSource。文件描述符可以通过步骤2的方法二获取。
```
// fd为已获得的文件描述符
const imageSource = image.createImageSource(fd);
```
- 方法三：通过缓冲区数组创建ImageSource。缓冲区数组可以通过步骤2的方法三获取。
```
const imageSource = image.createImageSource(buffer);
```

设置解码参数DecodingOptions，解码获取PixelMap图片对象。

let decodingOptions = {
    editable: true,
    desiredPixelFormat: 3,
}
// 创建pixelMap并进行简单的旋转和缩放 
const pixelMap = await imageSource.createPixelMap(decodingOptions);

解码完成，获取到PixelMap对象后，可以进行后续图片处理。

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

获取resourceManager资源管理。

const context = getContext(this);
// 获取resourceManager资源管理
const resourceMgr = context.resourceManager;

获取rawfile文件夹下test.jpg的ArrayBuffer。

const fileData = await resourceMgr.getRawFileContent('test.jpg');
// 获取图片的ArrayBuffer
const buffer = fileData.buffer;

创建imageSource。

const imageSource = image.createImageSource(buffer);

创建PixelMap。

const pixelMap = await imageSource.createPixelMap();