HarmonyOS 图片处理：使用 image.createPixelMap 创建 PixelMap

HarmonyOS 的 @ohos.multimedia.image 模块提供了强大的图片处理功能。image.createPixelMap 方法允许开发者通过颜色数组和属性创建 PixelMap 对象，用于进一步的图像操作。

适用场景

• 自定义图像生成：从零开始创建一个具有特定颜色分布和尺寸的图像。
• 图像编辑：开发一个图像编辑应用，需要让用户能够自由绘制或修改图像的像素数据。
• 动态图像生成：在需要动态生成图像内容的场景中，如根据用户输入或实时数据来创建图像。

方法详解

image.createPixelMap(colors: ArrayBuffer, options: 
InitializationOptions): Promise<PixelMap>

• 功能：使用指定的颜色数组和属性创建一个 PixelMap 对象。默认采用 BGRA_8888 格式处理数据。
• 参数：
  • colors: (ArrayBuffer, 必填) BGRA_8888 格式的颜色数组。数组长度应为 height * width * 4 字节，其中 height 和 width 是图片的高度和宽度。
  • options: (InitializationOptions, 必填) 创建 PixelMap 的属性，包含以下字段:
    • editable: (boolean) 是否可编辑。
    • pixelFormat: (number) 像素格式。
    • size: (object) 图片尺寸，包含 height 和 width 属性。
    • alphaType: (number) 透明度类型 (可选)。
    • scale: (number) 缩略值 (可选)。
• 返回值：
  • Promise<PixelMap>: 返回一个 Promise 对象，成功时包含创建的 PixelMap 对象，失败时包含错误信息。
• 系统能力：SystemCapability.Multimedia.Image.Core
• 支持版本：API version 6 及以上

注意：当创建的 PixelMap 大小超过原图大小时，将返回原图 PixelMap 大小。

代码示例

const color = new ArrayBuffer(96);  // 96 为需要创建的像素 buffer 大小，取值为：height * width * 4
let bufferArr = new Uint8Array(color);
// 设置 PixelMap 属性，包括可编辑性、像素格式和尺寸
let opts = { editable: true, pixelFormat: 3, size: { height: 4, width: 6 } };
// 使用颜色数组和属性创建 PixelMap
image.createPixelMap(color, opts)
  .then((pixelmap) => {
    console.log('Succeeded in creating pixelmap.');
    // 在这里可以使用创建的 pixelmap 进行图像操作
  })
  .catch(error => {
    console.log('Failed to create pixelmap.');
  });

总结

image.createPixelMap 方法为开发者提供了灵活创建 PixelMap 对象的方式，可以根据需求自定义颜色数组和属性，为进一步的图像处理奠定基础。