简体中文

下载 App

输入关键字搜索

开发者能力认证

鸿蒙高校创新赛

HarmonyOS 7

animation

HarmonyOS行业解决方案

layoutWeight

HarmonyOS模板&组件

bindPopup

bindsheet

CTRL+K

文档管理中心

我的

Hello，

欢迎来到开发者联盟

您当前正在浏览新版开发者文档中心，目录分类和层级有所调整。点击左侧当前文档分类名称前的“☰”图标，可切换文档分类。了解新版目录

图片色彩空间转换

更新时间: 2026-04-20 06:34

复制页面

本文导读

展开章节

调用者可以调用本模块提供的C API接口，实现HDR2SDR、SDR2HDR、SDR2SDR的图片色彩空间转换。

该能力常用于图片编辑中，如下图所示：

规格说明

支持的数据输入格式：

图片色彩空间转换算法为HDR2SDR：

展开

输入ColorSpaceName	输入HdrMetadataType	输入PIXEL_FORMAT	输出ColorSpaceName	输出 HdrMetadataType	输出PIXEL_FORMAT
BT2020_HLG_LIMIT / BT2020_HLG	HDR_METADATA_TYPE_ALTERNATE	PIXEL_FORMAT_YCBCR_P010 / PIXEL_FORMAT_YCRCB_P010 / PIXEL_FORMAT_RGBA_1010102	SRGB_LIMIT/SRGB	HDR_METADATA_TYPE_BASE	PIXEL_FORMAT_RGBA_8888 / PIXEL_FORMAT_BGRA_8888
BT2020_PQ_LIMIT / BT2020_PQ	HDR_METADATA_TYPE_ALTERNATE	YCBCR_P010 YCRCB_P010 RGBA_1010102	SRGB_LIMIT/SRGB	HDR_METADATA_TYPE_BASE	PIXEL_FORMAT_RGBA_8888 / PIXEL_FORMAT_BGRA_8888
BT2020_HLG_LIMIT / BT2020_HLG	HDR_METADATA_TYPE_NONE	YCBCR_P010 YCRCB_P010 RGBA_1010102	SRGB_LIMIT/SRGB	HDR_METADATA_TYPE_BASE	PIXEL_FORMAT_RGBA_8888 / PIXEL_FORMAT_BGRA_8888
BT2020_PQ_LIMIT / BT2020_PQ	HDR_METADATA_TYPE_NONE	YCBCR_P010 YCRCB_P010 RGBA_1010102	SRGB_LIMIT/SRGB	HDR_METADATA_TYPE_BASE	PIXEL_FORMAT_RGBA_8888 / PIXEL_FORMAT_BGRA_8888
BT2020_HLG_LIMIT / BT2020_HLG	HDR_METADATA_TYPE_ALTERNATE	YCBCR_P010 YCRCB_P010 RGBA_1010102	DISPLAY_P3_LIMIT/DISPLAY_P3	HDR_METADATA_TYPE_BASE	PIXEL_FORMAT_RGBA_8888 / PIXEL_FORMAT_BGRA_8888
BT2020_PQ_LIMIT / BT2020_PQ	HDR_METADATA_TYPE_ALTERNATE	YCBCR_P010 YCRCB_P010 RGBA_1010102	DISPLAY_P3_LIMIT/DISPLAY_P3	HDR_METADATA_TYPE_BASE	PIXEL_FORMAT_RGBA_8888 / PIXEL_FORMAT_BGRA_8888
BT2020_HLG_LIMIT / BT2020_HLG	HDR_METADATA_TYPE_NONE	YCBCR_P010 YCRCB_P010 RGBA_1010102	DISPLAY_P3_LIMIT/DISPLAY_P3	HDR_METADATA_TYPE_BASE	PIXEL_FORMAT_RGBA_8888 / PIXEL_FORMAT_BGRA_8888
BT2020_PQ_LIMIT / BT2020_PQ	HDR_METADATA_TYPE_NONE	YCBCR_P010 YCRCB_P010 RGBA_1010102	DISPLAY_P3_LIMIT/DISPLAY_P3	HDR_METADATA_TYPE_BASE	PIXEL_FORMAT_RGBA_8888 / PIXEL_FORMAT_BGRA_8888
BT2020_HLG_LIMIT / BT2020_HLG	HDR_METADATA_TYPE_ALTERNATE	YCBCR_P010 YCRCB_P010 RGBA_1010102	SRGB_LIMIT/SRGB	HDR_METADATA_TYPE_NONE	PIXEL_FORMAT_RGBA_8888 / PIXEL_FORMAT_BGRA_8888
BT2020_PQ_LIMIT / BT2020_PQ	HDR_METADATA_TYPE_ALTERNATE	YCBCR_P010 YCRCB_P010 RGBA_1010102	SRGB_LIMIT/SRGB	HDR_METADATA_TYPE_NONE	PIXEL_FORMAT_RGBA_8888 / PIXEL_FORMAT_BGRA_8888
BT2020_HLG_LIMIT / BT2020_HLG	HDR_METADATA_TYPE_NONE	YCBCR_P010 YCRCB_P010 RGBA_1010102	SRGB_LIMIT/SRGB	HDR_METADATA_TYPE_NONE	PIXEL_FORMAT_RGBA_8888 / PIXEL_FORMAT_BGRA_8888
BT2020_PQ_LIMIT / BT2020_PQ	HDR_METADATA_TYPE_NONE	YCBCR_P010 YCRCB_P010 RGBA_1010102	SRGB_LIMIT/SRGB	HDR_METADATA_TYPE_NONE	PIXEL_FORMAT_RGBA_8888 / PIXEL_FORMAT_BGRA_8888
BT2020_HLG_LIMIT / BT2020_HLG	HDR_METADATA_TYPE_ALTERNATE	YCBCR_P010 YCRCB_P010 RGBA_1010102	DISPLAY_P3_LIMIT/DISPLAY_P3	HDR_METADATA_TYPE_NONE	PIXEL_FORMAT_RGBA_8888 / PIXEL_FORMAT_BGRA_8888
BT2020_PQ_LIMIT / BT2020_PQ	HDR_METADATA_TYPE_ALTERNATE	YCBCR_P010 YCRCB_P010 RGBA_1010102	DISPLAY_P3_LIMIT/DISPLAY_P3	HDR_METADATA_TYPE_NONE	PIXEL_FORMAT_RGBA_8888 / PIXEL_FORMAT_BGRA_8888
BT2020_HLG_LIMIT / BT2020_HLG	HDR_METADATA_TYPE_NONE	YCBCR_P010 YCRCB_P010 RGBA_1010102	DISPLAY_P3_LIMIT/DISPLAY_P3	HDR_METADATA_TYPE_NONE	PIXEL_FORMAT_RGBA_8888 / PIXEL_FORMAT_BGRA_8888
BT2020_PQ_LIMIT / BT2020_PQ	HDR_METADATA_TYPE_NONE	YCBCR_P010 YCRCB_P010 RGBA_1010102	DISPLAY_P3_LIMIT/DISPLAY_P3	HDR_METADATA_TYPE_NONE	PIXEL_FORMAT_RGBA_8888 / PIXEL_FORMAT_BGRA_8888

图片色彩空间转换算法为SDR2HDR：

展开

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

图片色彩空间转换算法为SDR2SDR：

展开

输入ColorSpaceName	输入HdrMetadataType	输入PIXEL_FORMAT	输出ColorSpaceName	输出 HdrMetadataType	输出PIXEL_FORMAT
SRGB	HDR_METADATA_TYPE_NONE	RGBA_8888, BGRA_8888	SRGB	HDR_METADATA_TYPE_NONE	RGBA_8888
DISPLAY_P3	HDR_METADATA_TYPE_NONE	RGBA_8888, BGRA_8888	SRGB	HDR_METADATA_TYPE_NONE	RGBA_8888
ADOBE_RGB_1998	HDR_METADATA_TYPE_NONE	RGBA_8888, BGRA_8888	SRGB	HDR_METADATA_TYPE_NONE	RGBA_8888
SRGB	HDR_METADATA_TYPE_NONE	RGBA_8888, BGRA_8888	DISPLAY_P3	HDR_METADATA_TYPE_NONE	RGBA_8888
DISPLAY_P3	HDR_METADATA_TYPE_NONE	RGBA_8888, BGRA_8888	DISPLAY_P3	HDR_METADATA_TYPE_NONE	RGBA_8888
ADOBE_RGB_1998	HDR_METADATA_TYPE_NONE	RGBA_8888, BGRA_8888	DISPLAY_P3	HDR_METADATA_TYPE_NONE	RGBA_8888

分辨率规格：

展开

最小分辨率（单位：像素）	最大分辨率（单位：像素）
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侧调用的开发步骤

创建8 bit的PixelMap。

let srcPixelMap = nativePix.createPixelMap(this.inputHeight, this.inputWidth);
let outPutPixelMap = nativePix.createPixelMap(this.inputHeight, this.inputWidth);

配置色彩空间和元数据信息。

let colorSpaceDISPLAY_P3 : colorSpaceManager.ColorSpaceManager = colorSpaceManager.create(colorSpaceManager.ColorSpace.DISPLAY_P3);
let colorSpaceSrgb : colorSpaceManager.ColorSpaceManager = colorSpaceManager.create(colorSpaceManager.ColorSpace.SRGB);
inputpixelMap.setColorSpace(colorSpaceDISPLAY_P3);
inputpixelMap.setMetadata(image.HdrMetadataKey.HDR_METADATA_TYPE, image.HdrMetadataType.NONE);
outputpixelMap.setColorSpace(colorSpaceSrgb);
outputpixelMap.setMetadata(image.HdrMetadataKey.HDR_METADATA_TYPE, image.HdrMetadataType.NONE);

Native侧调用的开发步骤

添加头文件。

#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>

（可选）初始化环境。

一般在进程内第一次使用时调用，可提前完成部分耗时操作。
```
ImageProcessing_ErrorCode ret =  OH_ImageProcessing_InitializeEnvironment();
```

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

//输入格式
ImageProcessing_ColorSpaceInfo SRC_INFO;
ImageProcessing_ColorSpaceInfo DST_GAIN_INFO;
ImageProcessing_ColorSpaceInfo DST_INFO;
SRC_INFO.colorSpace = DISPLAY_P3;
SRC_INFO.metadataType = HDR_METADATA_TYPE_NONE;
SRC_INFO.pixelFormat = PIXEL_FORMAT_RGBA_8888;
DST_INFO.colorSpace = SRGB;
DST_INFO.metadataType = HDR_METADATA_TYPE_NONE;
DST_INFO.pixelFormat = PIXEL_FORMAT_RGBA_8888;
//能力查询
bool flag = OH_ImageProcessing_IsColorSpaceConversionSupported(&SRC_INFO, &DST_INFO);

创建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;
}

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

OH_PixelmapNative* srcImg = nullptr;
OH_PixelmapNative_ConvertPixelmapNativeFromNapi(env, argValue[0], &srcImg);
OH_PixelmapNative* dstImg= nullptr;
OH_PixelmapNative_ConvertPixelmapNativeFromNapi(env, argValue[1], &dstImg);

创建图片色彩空间转换模块。

应用可以通过图片处理引擎模块类型来创建图片色彩空间转换模块。示例中的变量说明如下：
- instance：图片处理模块实例。
- IMAGE_PROCESSING_TYPE_COLOR_SPACE_CONVERSION：图片色彩空间转换。
- 预期返回值：IMAGE_PROCESSING_SUCCESS
```
OH_ImageProcessing* instance = nullptr;
ret = OH_ImageProcessing_Create(&instance, IMAGE_PROCESSING_TYPE_COLOR_SPACE_CONVERSION);
```

执行算法。

ret = OH_ImageProcessing_ConvertColorSpace(instance, srcImg, dstImg);

释放实例资源。

ret = OH_ImageProcessing_Destroy(instance);
instance = nullptr;

释放初始化环境资源。

ret = OH_ImageProcessing_DeinitializeEnvironment();

完整示例代码

ArkTS示例代码：

ImageColorSpaceConversion.ets示例代码

C++相关示例代码：

图片动态元数据生成

单层HDR图片转换双层

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问 AI 助手提问