使用ImageSource获取RAW数据

开发步骤

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

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

   收起

   自动换行

   深色代码主题

   复制

   // 导入相关模块。
   import { image } from '@kit.ImageKit';
   import { BusinessError } from '@kit.BasicServicesKit';
   import { common } from '@kit.AbilityKit';
   import { fileIo } from '@kit.CoreFileKit';
   import { resourceManager } from '@kit.LocalizationKit';

   DecodingPixelMap.ets

2. 获取图片。

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

     收起

     自动换行

     深色代码主题

     复制

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

     CodecUtility.ets

   • 方法二：通过沙箱路径获取图片的文件描述符。具体请参考@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;
       }
     }

     CodecUtility.ets

   • 方法三：通过资源管理器获取资源文件的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;
       }
     }

     CodecUtility.ets

   • 方法四：通过资源管理器获取资源文件的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;
       }
     }

     CodecUtility.ets

3. 创建ImageSource实例。

   • 方法一：通过沙箱路径创建ImageSource。沙箱路径可以通过步骤2的方法一获取。

     收起

     自动换行

     深色代码主题

     复制

     // path为已获得的沙箱路径。
     const imageSource : image.ImageSource = image.createImageSource(filePath);

     CodecUtility.ets

   • 方法二：通过文件描述符fd创建ImageSource。文件描述符可以通过步骤2的方法二获取。

     收起

     自动换行

     深色代码主题

     复制

     // fd为已获得的文件描述符。
     const imageSource: image.ImageSource = image.createImageSource(fd);

     CodecUtility.ets

   • 方法三：通过缓冲区数组创建ImageSource。缓冲区数组可以通过步骤2的方法三获取。

     收起

     自动换行

     深色代码主题

     复制

     const imageSource: image.ImageSource = image.createImageSource(buffer);

     CodecUtility.ets

   • 方法四：通过资源文件的RawFileDescriptor创建ImageSource。RawFileDescriptor可以通过步骤2的方法四获取。

     收起

     自动换行

     深色代码主题

     复制

     const imageSource: image.ImageSource = image.createImageSource(rawFileDescriptor);

     CodecUtility.ets

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

   收起

   自动换行

   深色代码主题

   复制

   async createImageRawData(imageSource: image.ImageSource | undefined) : Promise<image.ImageRawData | undefined> {
     if (!imageSource) {
       console.error('imageSource is undefined.');
       return undefined;
     }
     try {
       const data = await imageSource.createImageRawData();
       if (data.bitsPerPixel == 16 && data.buffer) {
         let array: Uint16Array = 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) {
       console.error(`get dng rawdata failed.err: ${JSON.stringify(err)}`);
       return undefined;
     }
   }

   CodecUtility.ets

5. 释放imageSource。

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

   收起

   自动换行

   深色代码主题

   复制

   async release() {
     try {
       await this.pixelMap?.release();
     } catch (error) {
       console.error(`Failed to release PixelMap: ${error}.`);
     } finally {
       this.pixelMap = undefined;
     }
   
     try {
       await this.imageSource?.release();
     } catch (error) {
       console.error(`Failed to release ImageSource: ${error}.`);
     } finally {
       this.imageSource = undefined;
     }
   }

   DecodingPixelMap.ets