使用ImageSource获取RAW数据

图像的 RAW 数据是直接从图像传感器获取的原始数据，完整保留了所有传感器信息且无任何压缩损失。通过使用RAW数据，开发者可以获得最高质量的图像信息，并根据具体需求自定义图像处理算法，实现更灵活的图像处理和优化效果。

从API version 24开始，支持将符合格式的图片文件解码为ImageRawData，以便在应用或系统中获取RAW数据。RAW数据包含图像缓冲区和像素位数。

当前支持的图片文件格式为DNG。

开发步骤

获取图片RAW数据相关API的详细介绍请参见：createImageRawData。

全局导入Image模块，根据实际需求导入对应的Kit模块。

// 导入相关模块。
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';

获取图片。

方法一：通过沙箱路径直接获取，此方法仅适用于应用沙箱中的图片。获取方式请参考获取应用文件路径。

function getFilePath(context: Context, fileName: string): string {
  const filePath: string = context.cacheDir + '/' + fileName;
  return filePath;
}

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

function getFileFd(context: Context, fileName: string): number|undefined {
  try {
    const filePath: string = context.cacheDir + '/' + fileName;
    const file: fileIo.File = fileIo.openSync(filePath, fileIo.OpenMode.READ_ONLY);
    const fd: number = file?.fd;
    return fd;
  } catch (err) {
    console.error(`Failed to get the fileFd with error: ${err}.`);
    return undefined;
  }
}

方法三：通过资源管理器获取资源文件的ArrayBuffer。具体请参考getRawFileContent接口。该方法需要导入@kit.LocalizationKit模块。

async function getFileBuffer(context: Context, fileName: string): Promise<ArrayBuffer|undefined> {
  try {
    const resourceMgr: resourceManager.ResourceManager = context.resourceManager;
    // 获取资源文件内容，返回Uint8Array。
    const fileData: Uint8Array = await resourceMgr.getRawFileContent(fileName);
    console.info('Successfully get the RawFileContent.');
    // 转为ArrayBuffer并返回。
    const buffer: ArrayBuffer = fileData.buffer.slice(0);
    return buffer;
  } catch (error) {
    console.error(`Failed to get the RawFileContent with error: ${error}.`);
    return undefined;
  }
}

方法四：通过资源管理器获取资源文件的RawFileDescriptor。具体请参考getRawFd接口。该方法需要导入@kit.LocalizationKit模块。

async function getRawFd(context: Context, fileName: string): Promise<resourceManager.RawFileDescriptor|undefined> {
  try {
    const resourceMgr: resourceManager.ResourceManager = context.resourceManager;
    const rawFileDescriptor: resourceManager.RawFileDescriptor = await resourceMgr.getRawFd(fileName);
    console.info('Successfully get the RawFileDescriptor.');
    return rawFileDescriptor;
  } catch (error) {
    console.error(`Failed to get the RawFileDescriptor with error: ${error}.`);
    return undefined;
  }
}

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

获取ImageRawData图片对象并打印像素值。

async  createImageRawData(imageSource: image.ImageSource|undefined) : Promise<image.ImageRawData|undefined> {
  if (!imageSource) {
    console.error('imageSource is undefined.');
    return undefined;
  }
  await imageSource.createImageRawData().then((data: image.ImageRawData) => {
    let array: Uint16Array = new Uint16Array();
    if (data.bitsPerPixel == 16 && data.buffer) {
      array = new Uint16Array(data.buffer);
    }
    let length = array.byteLength.valueOf();
    console.info(`uint16Array length: ${length}`);
    let value: string = '';
    for (let i = 0; i < array.length && i < 10; i++) {
      value += array[i] + ', ';
    }
    console.info(`get dng rawdata is:${value}.`);
    return data
  }).catch((err: BusinessError) => {
    console.error(`get dng rawdata failed.err: ${JSON.stringify(err)}`);
    return undefined;
  })
  return undefined;
}

释放imageSource。

确认imageSource的异步方法已经执行完成，不再使用该变量后，可按需手动调用下面方法释放。

async release(pixelMap: image.PixelMap|undefined, imageSource: image.ImageSource|undefined) {
  pixelMap?.release();
  pixelMap = undefined;
  imageSource?.release();
  imageSource = undefined;
}