双层HDR图片转换单层

调用者可以调用本模块提供的C API接口，实现将双层HDR图片转换为单层HDR图片。

该能力常用于图片分享中，如下图所示：

规格说明

支持的数据输入格式：

使用图片双层HDR转单层HDR转换算法Compose。

输入ColorSpaceName	输入HdrMetadataType	输入PIXEL_FORMAT	输出ColorSpaceName	输出 HdrMetadataType	输出PIXEL_FORMAT
DISPLAY_P3_LIMIT/DISPLAY_P3	HDR_METADATA_TYPE_BASE	RGBA_8888	BT2020_HLG	HDR_METADATA_TYPE_ALTERNATE	YCBCR_P010 / RGBA_1010102
SRGB_LIMIT/SRGB	HDR_METADATA_TYPE_BASE	RGBA_8888	BT2020_HLG	HDR_METADATA_TYPE_ALTERNATE	YCBCR_P010 / RGBA_1010102
DISPLAY_P3_LIMIT/DISPLAY_P3	HDR_METADATA_TYPE_BASE	RGBA_8888	BT2020_PQ	HDR_METADATA_TYPE_ALTERNATE	YCBCR_P010 / RGBA_1010102
SRGB_LIMIT/SRGB	HDR_METADATA_TYPE_BASE	RGBA_8888	BT2020_PQ	HDR_METADATA_TYPE_ALTERNATE	YCBCR_P010 / RGBA_1010102

分辨率规格：

最小分辨率（单位：像素）	最大分辨率（单位：像素）
32*32	8880*8880

内存规格：

处理的PixelMap对象需为DMA内存。

开发指导

具体实现可参考示例工程。

在 CMake 脚本中链接动态库

add_library(entry SHARED napi_init.cpp ImageProcessing/ImageProcessing.cpp)
target_link_libraries(entry PUBLIC ${BASE_LIBRARY})

ArkTS侧调用的开发步骤

1. 创建10 bit的PixelMap。

   let opts: image.InitializationOptions = {
     editable: true,
     pixelFormat: image.PixelMapFormat.YCBCR_P010,
     size: {
       height: this.inputHeight,
       width: this.inputWidth
     }
   };
   let outPutPixelMap = image.createPixelMapSync(opts);

2. 创建8 bit的PixelMap。

   let sdrpixelMap : image.PixelMap = nativePix.createPixelMapTest(imageInfo.size.height, imageInfo.size.width);
   let gainmappixelMap : image.PixelMap = nativePix.createPixelMapTest(imageInfo.size.height, imageInfo.size.width);

3. 配置色彩框架和元数据信息。

   let colorSpaceDISPLAY_P3 : colorSpaceManager.ColorSpaceManager = colorSpaceManager.create(colorSpaceManager.ColorSpace.DISPLAY_P3);
   let colorSpaceBT2020_HLG : colorSpaceManager.ColorSpaceManager = colorSpaceManager.create(colorSpaceManager.ColorSpace.BT2020_HLG);
   sdrpixelMap.setColorSpace(colorSpaceDISPLAY_P3);
   sdrpixelMap.setMetadata(image.HdrMetadataKey.HDR_METADATA_TYPE, image.HdrMetadataType.BASE);
   gainmappixelMap.setColorSpace(colorSpaceDISPLAY_P3);
   gainmappixelMap.setMetadata(image.HdrMetadataKey.HDR_METADATA_TYPE, image.HdrMetadataType.GAINMAP);
   hdrpixelMap.setColorSpace(colorSpaceBT2020_HLG);
   hdrpixelMap.setMetadata(image.HdrMetadataKey.HDR_METADATA_TYPE, image.HdrMetadataType.ALTERNATE);

Native侧调用的开发步骤

1. 添加头文件。

   #include <multimedia/image_framework/image_mdk_common.h>
   #include <multimedia/image_framework/image_pixel_map_mdk.h>
   #include <multimedia/image_framework/image/pixelmap_native.h>
   #include <multimedia/video_processing_engine/image_processing.h>
   #include <multimedia/video_processing_engine/image_processing_types.h>
   #include <native_color_space_manager/native_color_space_manager.h>

2. （可选）初始化环境。

   一般在进程内第一次使用时调用，可提前完成部分耗时操作。

   ImageProcessing_ErrorCode ret =  OH_ImageProcessing_InitializeEnvironment();

3. （可选）查询能力支持。建议在使用对应能力前调用。

   //输入格式
   DST_INFO.colorSpace = BT2020_HLG;
   DST_INFO.metadataType = HDR_METADATA_TYPE_ALTERNATE;
   DST_INFO.pixelFormat = PIXEL_FORMAT_RGBA_1010102;
   SRC_INFO.colorSpace = DISPLAY_P3;
   SRC_INFO.metadataType = HDR_METADATA_TYPE_BASE;
   SRC_INFO.pixelFormat = PIXEL_FORMAT_RGBA_8888;
   SRC_GAIN_INFO.colorSpace = DISPLAY_P3;
   SRC_GAIN_INFO.metadataType = HDR_METADATA_TYPE_GAINMAP;
   SRC_GAIN_INFO.pixelFormat = PIXEL_FORMAT_RGBA_8888;
   //能力查询
   bool flag = OH_ImageProcessing_IsCompositionSupported(&SRC_INFO, &SRC_GAIN_INFO, &DST_INFO);

4. 创建8 bit的PixelMap。

   napi_value ImageProcessing::CreatePixelMap(napi_env env, napi_callback_info info)
   {
       napi_value udfVar = nullptr;
       napi_value pixelMap = nullptr;
       napi_value thisVar = nullptr;
       napi_value argValue[2] = {0};
       size_t argCount = 2;
       size_t count = 2;
       if (napi_get_cb_info(env, info, &argCount, argValue, &thisVar, nullptr) != napi_ok || argCount < count ||
           argValue[0] == nullptr || argValue[1] == nullptr) {
           return nullptr;
       }
       int32_t width = 0;
       int32_t height = 0;
       napi_get_value_int32(env, argValue[1], &width);
       napi_get_value_int32(env, argValue[0], &height);
       struct OhosPixelMapCreateOps createOps;
       createOps.width = width;
       createOps.height = height;
       int32_t rgba8888 = 3;
       createOps.pixelFormat = rgba8888;
       createOps.alphaType = 0;
       
       size_t bufferSize = createOps.width * createOps.height * 4;
       void *buff = malloc(bufferSize);
       int32_t res = OH_PixelMap_CreatePixelMapWithStride(env, createOps, (uint8_t *)buff, bufferSize, createOps.width * 4,
           &pixelMap);
       free(buff);
       OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, "createPixelMap",
           "OH_PixelMap_CreatePixelMapWithStride %{public}d", res);
       if (res != IMAGE_RESULT_SUCCESS || pixelMap == nullptr) {
           return udfVar;
       }
       return pixelMap;
   }

5. 将ArkTS中的PixelMap转换为C++的PixelMap。

   OH_PixelmapNative* sdr = nullptr;
   OH_PixelmapNative_ConvertPixelmapNativeFromNapi(env, argValue[0], &sdr);
   OH_PixelmapNative* gainmap = nullptr;
   OH_PixelmapNative_ConvertPixelmapNativeFromNapi(env, argValue[1], &gainmap);
   OH_PixelmapNative* hdr = nullptr;
   OH_PixelmapNative_ConvertPixelmapNativeFromNapi(env, argValue[2], &hdr);

6. 创建图片HDR双层转单层模块。

   应用可以通过图片处理引擎模块类型来创建图片HDR双层转单层模块。示例中的变量说明如下：

   • instance：图片处理模块实例。
   • IMAGE_PROCESSING_TYPE_COMPOSITION：HDR双层转单层。
   • 预期返回值：IMAGE_PROCESSING_SUCCESS

   OH_ImageProcessing* instance = nullptr;
   ret = OH_ImageProcessing_Create(&instance, IMAGE_PROCESSING_TYPE_COMPOSITION);

7. 执行算法。

   ret = OH_ImageProcessing_Compose(instance, sdr, gainmap, hdr);

8. 释放实例资源。

   ret = OH_ImageProcessing_Destroy(instance);
   instance = nullptr;

9. 释放初始化环境资源。

   ret = OH_ImageProcessing_DeinitializeEnvironment();

完整示例代码

ArkTS示例代码：

• compose.ets示例代码

C++相关示例代码：

• CMakeLists.txt示例代码
• ImageProcessing.h示例代码
• ImageProcessing.cpp示例代码