13eaf1cc创建于 2025年3月20日历史提交

ImageProcessing

概述

ImageProcessing模块提供图片处理功能的API接口,包括颜色空间转换和元数据生成。

起始版本: 13

汇总

文件

名称 描述
image_processing.h 声明图片处理函数。
image_processing_types.h 图片处理的类型定义。

结构体

名称 描述
struct ImageProcessing_ColorSpaceInfo 色彩空间信息,用于色彩空间转换能力查询。

类型定义

名称 描述
typedef struct OH_ImageProcessing OH_ImageProcessing 提供OH_ImageProcessing结构体声明。
typedef struct OH_PixelmapNative OH_PixelmapNative 提供OH_PixelmapNative结构体声明。
typedef struct OH_AVFormat OH_AVFormat 提供OH_AVFormat结构体声明。
typedef struct ImageProcessing_ColorSpaceInfo ImageProcessing_ColorSpaceInfo 色彩空间信息,用于色彩空间转换能力查询。
typedef enum ImageDetailEnhancer_QualityLevel ImageDetailEnhancer_QualityLevel 质量级别,用于细节增强能力。
typedef enum ImageProcessing_ErrorCode ImageProcessing_ErrorCode 图片处理接口错误码说明。

枚举

名称 描述
ImageDetailEnhancer_QualityLevel {
IMAGE_DETAIL_ENHANCER_QUALITY_LEVEL_NONE,
IMAGE_DETAIL_ENHANCER_QUALITY_LEVEL_LOW,
IMAGE_DETAIL_ENHANCER_QUALITY_LEVEL_MEDIUM,
IMAGE_DETAIL_ENHANCER_QUALITY_LEVEL_HIGH }
质量级别,用于细节增强能力。
ImageProcessing_ErrorCode {
IMAGE_PROCESSING_SUCCESS,
IMAGE_PROCESSING_ERROR_INVALID_PARAMETER = 401,
IMAGE_PROCESSING_ERROR_UNKNOWN = 29200001,
IMAGE_PROCESSING_ERROR_INITIALIZE_FAILED,
IMAGE_PROCESSING_ERROR_CREATE_FAILED,
IMAGE_PROCESSING_ERROR_PROCESS_FAILED,
IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING,
IMAGE_PROCESSING_ERROR_OPERATION_NOT_PERMITTED,
IMAGE_PROCESSING_ERROR_NO_MEMORY,
IMAGE_PROCESSING_ERROR_INVALID_INSTANCE,
IMAGE_PROCESSING_ERROR_INVALID_VALUE
}
图片处理接口错误码说明。

函数

名称 描述
ImageProcessing_ErrorCode OH_ImageProcessing_InitializeEnvironment (void) 初始化图片处理模块的全局环境。
ImageProcessing_ErrorCode OH_ImageProcessing_DeinitializeEnvironment (void) 反初始化图片处理模块的全局环境。
bool OH_ImageProcessing_IsColorSpaceConversionSupported (const ImageProcessing_ColorSpaceInfo *sourceImageInfo, const ImageProcessing_ColorSpaceInfo *destinationImageInfo) 查询是否支持当前图片色彩空间转换能力。
bool OH_ImageProcessing_IsCompositionSupported (const ImageProcessing_ColorSpaceInfo *sourceImageInfo, const ImageProcessing_ColorSpaceInfo *sourceGainmapInfo, const ImageProcessing_ColorSpaceInfo *destinationImageInfo) 查询是否支持HDR双层图片转换为HDR单层图片。
bool OH_ImageProcessing_IsDecompositionSupported (const ImageProcessing_ColorSpaceInfo *sourceImageInfo, const ImageProcessing_ColorSpaceInfo *destinationImageInfo, const ImageProcessing_ColorSpaceInfo *destinationGainmapInfo) 查询是否支持HDR单层图片转换为HDR双层图片。
bool OH_ImageProcessing_IsMetadataGenerationSupported (const ImageProcessing_ColorSpaceInfo *sourceImageInfo) 查询是否支持图片元数据生成能力。
ImageProcessing_ErrorCode OH_ImageProcessing_Create (OH_ImageProcessing **imageProcessor, int32_t type) 创建一个图片处理模块实例。
ImageProcessing_ErrorCode OH_ImageProcessing_Destroy (OH_ImageProcessing *imageProcessor) 销毁当前图片处理模块实例。
ImageProcessing_ErrorCode OH_ImageProcessing_SetParameter (OH_ImageProcessing *imageProcessor, const OH_AVFormat *parameter) 设置图片处理模块参数。
ImageProcessing_ErrorCode OH_ImageProcessing_GetParameter (OH_ImageProcessing *imageProcessor, OH_AVFormat *parameter) 获取图片处理模块参数。
ImageProcessing_ErrorCode OH_ImageProcessing_ConvertColorSpace (OH_ImageProcessing *imageProcessor, OH_PixelmapNative *sourceImage, OH_PixelmapNative *destinationImage) 实现单层图片间转换。
ImageProcessing_ErrorCode OH_ImageProcessing_Compose (OH_ImageProcessing *imageProcessor, OH_PixelmapNative *sourceImage, OH_PixelmapNative *sourceGainmap, OH_PixelmapNative *destinationImage) 实现HDR双层图片到HDR单层图片的转换。
ImageProcessing_ErrorCode OH_ImageProcessing_Decompose (OH_ImageProcessing *imageProcessor, OH_PixelmapNative *sourceImage, OH_PixelmapNative *destinationImage, OH_PixelmapNative *destinationGainmap) 实现HDR单层图片到HDR双层图片的转换。
ImageProcessing_ErrorCode OH_ImageProcessing_GenerateMetadata (OH_ImageProcessing *imageProcessor, OH_PixelmapNative *sourceImage) 生成HDR图片元数据。
ImageProcessing_ErrorCode OH_ImageProcessing_EnhanceDetail (OH_ImageProcessing *imageProcessor, OH_PixelmapNative *sourceImage, OH_PixelmapNative *destinationImage) 进行图片清晰度/细节增强。

变量

名称 描述
const int32_t IMAGE_PROCESSING_TYPE_COLOR_SPACE_CONVERSION 用于创建色彩空间转换的图片处理实例。
const int32_t IMAGE_PROCESSING_TYPE_COMPOSITION 用于创建双层HDR图片转换单层HDR图片的图片处理实例。
const int32_t IMAGE_PROCESSING_TYPE_DECOMPOSITION 用于创建单层HDR图片转换双层HDR图片的图片处理实例。
const int32_t IMAGE_PROCESSING_TYPE_METADATA_GENERATION 用于创建元数据生成的图片处理实例。
const int32_t IMAGE_PROCESSING_TYPE_DETAIL_ENHANCER 用于创建细节增强的图片处理实例。
const char * IMAGE_DETAIL_ENHANCER_PARAMETER_KEY_QUALITY_LEVEL 用于设定图像细节增强的质量级别。

类型定义说明

ImageDetailEnhancer_QualityLevel

typedef enum ImageDetailEnhancer_QualityLevel ImageDetailEnhancer_QualityLevel

描述

质量级别,用于细节增强能力。

键参数的值IMAGE_DETAIL_ENHANCER_PARAMETER_KEY_QUALITY_LEVEL

起始版本: 13

参见:

OH_ImageProcessing_SetParameter

OH_ImageProcessing_GetParameter

ImageProcessing_ColorSpaceInfo

typedef struct ImageProcessing_ColorSpaceInfo ImageProcessing_ColorSpaceInfo

描述

色彩空间信息,用于色彩空间转换能力查询。

起始版本: 13

参见:

OH_ImageProcessing_IsColorSpaceConversionSupported

OH_ImageProcessing_IsCompositionSupported

OH_ImageProcessing_IsDecompositionSupported

ImageProcessing_ErrorCode

typedef enum ImageProcessing_ErrorCode ImageProcessing_ErrorCode

描述

图片处理接口错误码说明。

起始版本: 13

OH_AVFormat

typedef struct OH_AVFormat OH_AVFormat

描述

提供OH_AVFormat结构体声明。

起始版本: 13

OH_ImageProcessing

typedef struct OH_ImageProcessing OH_ImageProcessing

描述

提供OH_ImageProcessing结构体声明。

定义了OH_ImageProcessing的空指针并调用OH_ImageProcessing_Create来创建图片处理实例。在创建实例之前,指针应为空。用户可以为不同的处理类型创建多个图片实例。

起始版本: 13

OH_PixelmapNative

typedef struct OH_PixelmapNative OH_PixelmapNative

描述

提供OH_PixelmapNative结构体声明。

起始版本: 13

枚举类型说明

ImageDetailEnhancer_QualityLevel

enum ImageDetailEnhancer_QualityLevel

描述

质量级别,用于细节增强能力。

键参数的值IMAGE_DETAIL_ENHANCER_PARAMETER_KEY_QUALITY_LEVEL

起始版本: 13

参见:

OH_ImageProcessing_SetParameter

OH_ImageProcessing_GetParameter

枚举值 描述
IMAGE_DETAIL_ENHANCER_QUALITY_LEVEL_NONE 无细节增强。
IMAGE_DETAIL_ENHANCER_QUALITY_LEVEL_LOW 细节增强质量较低,但速度较快。默认级别。
IMAGE_DETAIL_ENHANCER_QUALITY_LEVEL_MEDIUM 细节增强质量中等,速度介于低级别与高级别之间。
IMAGE_DETAIL_ENHANCER_QUALITY_LEVEL_HIGH 细节增强质量较高,但速度较慢。

ImageProcessing_ErrorCode

enum ImageProcessing_ErrorCode

描述

图片处理接口错误码说明。

起始版本: 13

枚举值 描述
IMAGE_PROCESSING_SUCCESS 成功。
IMAGE_PROCESSING_ERROR_INVALID_PARAMETER 输入参数无效。
在以下错误条件返回该错误码:
1 - 输入或输出buffer无效,例如图片buffer为空。
2 - 参数无效,例如参数为空。
3 - 类型无效,例如在创建函数中传入的类型不存在。
IMAGE_PROCESSING_ERROR_UNKNOWN 未知错误,例如GPU计算失败或memcpy失败。
IMAGE_PROCESSING_ERROR_INITIALIZE_FAILED 全局环境初始化失败,例如GPU环境初始化失败。
IMAGE_PROCESSING_ERROR_CREATE_FAILED 创建图片处理实例失败,例如实例数量超过上限。
IMAGE_PROCESSING_ERROR_PROCESS_FAILED 处理图片buffer失败,例如处理超时。
IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING 当前处理不支持,可以通过“OH_ImageProcessing_IsXXXSupported”接口查询是否支持该能力。
IMAGE_PROCESSING_ERROR_OPERATION_NOT_PERMITTED 无权限操作,可能由于状态不正确导致。
IMAGE_PROCESSING_ERROR_NO_MEMORY 内存不足。
IMAGE_PROCESSING_ERROR_INVALID_INSTANCE 无效的图片处理实例,可能由于实例为空导致。
IMAGE_PROCESSING_ERROR_INVALID_VALUE 输入值无效。
在以下错误条件下返回该错误码:
1 - 输入或输出图片buffer无效,例如图片buffer的宽度(高度)过大或颜色空间不正确。
2 - 参数无效,例如参数不包括有效信息,例如细节增强的质量级别不正确。

函数说明

OH_ImageProcessing_Compose()

ImageProcessing_ErrorCode OH_ImageProcessing_Compose(OH_ImageProcessing* imageProcessor,OH_PixelmapNative* sourceImage, OH_PixelmapNative* sourceGainmap, OH_PixelmapNative* destinationImage)

描述

实现HDR双层图片到HDR单层图片的转换。

此函数通过输入图片与输入Gainmap生成输出图片。

起始版本: 13

参数:

名称 描述
imageProcessor 指向图片处理模块实例的指针。该实例应该由IMAGE_PROCESSING_TYPE_COMPOSITION类型创建。
sourceImage 指向输入图片的指针。
sourceGainmap 指向输入Gainmap的指针。
destinationImage 指向输出图片的指针。

返回:

  • 如果图片处理成功,则返回IMAGE_PROCESSING_SUCCESS。
  • 当该实例为空或该实例不是图片处理模块实例时,返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。
  • 当图片为空时,返回IMAGE_PROCESSING_ERROR_INVALID_PARAMETER。
  • 当图片的某些属性无效时,返回IMAGE_PROCESSING_ERROR_INVALID_VALUE,例如图片的色彩空间时不支持的。
  • 当该图片处理不支持时,返回IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING。
  • 当该图片处理中返回错误时,返回IMAGE_PROCESSING_ERROR_PROCESS_FAILED。
  • 当内存分配失败时,返回IMAGE_PROCESSING_ERROR_NO_MEMORY。

OH_ImageProcessing_ConvertColorSpace()

ImageProcessing_ErrorCode OH_ImageProcessing_ConvertColorSpace(OH_ImageProcessing* imageProcessor, OH_PixelmapNative* sourceImage, OH_PixelmapNative* destinationImage)

描述

实现单层图片间转换。

此函数包括HDR图片到SDR图片的色彩空间转换,SDR图片到HDR图片的色彩空间转换,SDR图片到SDR图片的色彩空间转换和HDR图片的色彩空间转换。

起始版本: 13

参数:

名称 描述
imageProcessor 指向图片处理模块实例的指针。该实例应该由IMAGE_PROCESSING_TYPE_COLOR_SPACE_CONVERSION类型创建。
sourceImage 指向输入图片的指针。
destinationImage 指向输出图片的指针。

返回:

  • 如果图片处理成功,则返回IMAGE_PROCESSING_SUCCESS。
  • 当该实例为空或该实例不是图片处理模块实例时,返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。
  • 当图片为空时,返回IMAGE_PROCESSING_ERROR_INVALID_PARAMETER。
  • 当图片的某些属性无效时,返回IMAGE_PROCESSING_ERROR_INVALID_VALUE,例如图片的色彩空间时不支持的。
  • 当该图片处理不支持时,返回IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING。
  • 当该图片处理中返回错误时,返回IMAGE_PROCESSING_ERROR_PROCESS_FAILED。
  • 当内存分配失败时,返回IMAGE_PROCESSING_ERROR_NO_MEMORY。

OH_ImageProcessing_Create()

ImageProcessing_ErrorCode OH_ImageProcessing_Create(OH_ImageProcessing** imageProcessor, int32_t type)

描述

创建一个图片处理模块实例。

起始版本: 13

参数:

名称 描述
imageProcessor 输出参数。指针*imageProcessor指向一个新的图片处理对象。指针*imageProcessor在传递前必须是一个空指针。
type 使用IMAGE_PROCESSING_TYPE_XXX来指定图片处理类型。此实例的类型在创建后不能更改。

返回:

  • 如果创建成功,则返回IMAGE_PROCESSING_SUCCESS。
  • 当指定的图片处理类型不支持时,返回IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING,例如如果不支持图片元数据生成能力,则返回不支持该处理类型。
  • 当创建失败时,返回IMAGE_PROCESSING_ERROR_CREATE_FAILED。
  • 当该实例为空或指向该实例的指针为空时,返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。
  • 当指定的图片处理类型无效时,返回IMAGE_PROCESSING_ERROR_INVALID_PARAMETER。

OH_ImageProcessing_Decompose()

ImageProcessing_ErrorCode OH_ImageProcessing_Decompose(OH_ImageProcessing* imageProcessor, OH_PixelmapNative* sourceImage, OH_PixelmapNative* destinationImage, OH_PixelmapNative* destinationGainmap)

描述

实现HDR单层图片到HDR双层图片的转换。

此函数通过输入图片生成输出图片和输出Gainmap。

起始版本: 13

参数:

名称 描述
imageProcessor 指向图片处理模块实例的指针。该实例应该由IMAGE_PROCESSING_TYPE_DECOMPOSITION类型创建。
sourceImage 指向输入图片的指针。
destinationImage 指向输出图片的指针。
destinationGainmap 指向输出Gainmap的指针。

返回:

  • 如果图片处理成功,则返回IMAGE_PROCESSING_SUCCESS。
  • 当该实例为空或该实例不是图片处理模块实例时,返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。
  • 当图片为空时,返回IMAGE_PROCESSING_ERROR_INVALID_PARAMETER。
  • 当图片的某些属性无效时,返回IMAGE_PROCESSING_ERROR_INVALID_VALUE,例如图片的色彩空间时不支持的。当该图片处理不支持时,返回IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING。
  • 当该图片处理中返回错误时,返回IMAGE_PROCESSING_ERROR_PROCESS_FAILED。
  • 当内存分配失败时,返回IMAGE_PROCESSING_ERROR_NO_MEMORY。

OH_ImageProcessing_DeinitializeEnvironment()

ImageProcessing_ErrorCode OH_ImageProcessing_DeinitializeEnvironment(void)

描述

反初始化图片处理模块的全局环境。

如果OH_ImageProcessing_InitializeEnvironment被调用,则此函数为必需函数。通常此函数在主进程准备退出时被调用,用于反初始化图片处理模块的全局环境(由OH_ImageProcessing_InitializeEnvironment接口 初始化)。如果此时存在图片处理实例,则不应调用此函数。如果OH_ImageProcessing_InitializeEnvironment未被调用,则不应调用此函数。

起始版本: 13

返回:

  • 如果反初始化成功,则返回IMAGE_PROCESSING_SUCCESS。
  • 如果存在图片处理实例未被销毁或OH_ImageProcessing_InitializeEnvironment接口未被调用,则返回 IMAGE_PROCESSING_ERROR_OPERATION_NOT_PERMITTED。

OH_ImageProcessing_Destroy()

ImageProcessing_ErrorCode OH_ImageProcessing_Destroy(OH_ImageProcessing* imageProcessor)

描述

销毁当前图片处理模块实例。

起始版本: 13

参数:

名称 描述
imageProcessor 指向图片处理模块实例的指针。当实例被销毁时,建议该指针设置为空。

返回:

  • 如果销毁成功,则返回IMAGE_PROCESSING_SUCCESS。
  • 当该实例为空或该实例不是图片处理模块实例时,返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。

OH_ImageProcessing_EnhanceDetail()

ImageProcessing_ErrorCode OH_ImageProcessing_EnhanceDetail(OH_ImageProcessing* imageProcessor, OH_PixelmapNative* sourceImage, OH_PixelmapNative* destinationImage)

描述

进行图片清晰度/细节增强。

此函数根据输入图片和输出图片预设的尺寸,对源图片进行必要的缩放操作生成目标图片,并提供了多种缩放方法以平衡性能和图像质量。

起始版本: 13

参数:

名称 描述
imageProcessor 指向图片处理模块实例的指针。该实例应该由IMAGE_PROCESSING_TYPE_DETAIL_ENHANCER类型创建。
sourceImage 指向输入图片的指针。
destinationImage 指向输出图片的指针。

返回:

  • 如果图片处理成功,则返回IMAGE_PROCESSING_SUCCESS。
  • 当该实例为空或该实例不是图片处理模块实例时,返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。
  • 当图片为空时,返回IMAGE_PROCESSING_ERROR_INVALID_PARAMETER。
  • 当图片的某些属性无效时,返回IMAGE_PROCESSING_ERROR_INVALID_VALUE,例如图片的色彩空间时不支持的。
  • 当该图片处理不支持时,返回IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING。
  • 当该图片处理中返回错误时,返回IMAGE_PROCESSING_ERROR_PROCESS_FAILED。
  • 当内存分配失败时,返回IMAGE_PROCESSING_ERROR_NO_MEMORY。

OH_ImageProcessing_GenerateMetadata()

ImageProcessing_ErrorCode OH_ImageProcessing_GenerateMetadata(OH_ImageProcessing* imageProcessor, OH_PixelmapNative* sourceImage)

描述

生成HDR图片元数据。

此函数为HDR图片生成元数据。

起始版本: 13

参数:

名称 描述
imageProcessor 指向图片处理模块实例的指针。该实例应该由IMAGE_PROCESSING_TYPE_METADATA_GENERATION类型创建。
sourceImage 指向输入图片的指针。

返回:

  • 如果图片处理成功,则返回IMAGE_PROCESSING_SUCCESS。
  • 当该实例为空或该实例不是图片处理模块实例时,返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。
  • 当图片为空时,返回IMAGE_PROCESSING_ERROR_INVALID_PARAMETER。
  • 当图片的某些属性无效时,返回IMAGE_PROCESSING_ERROR_INVALID_VALUE,例如图片的色彩空间时不支持的。当该图片处理不支持时,返回IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING。
  • 当该图片处理中返回错误时,返回IMAGE_PROCESSING_ERROR_PROCESS_FAILED。
  • 当内存分配失败时,返回IMAGE_PROCESSING_ERROR_NO_MEMORY。

OH_ImageProcessing_GetParameter()

ImageProcessing_ErrorCode OH_ImageProcessing_GetParameter(OH_ImageProcessing* imageProcessor, OH_AVFormat* parameter)

描述

获取图片处理模块参数。

通过特定参数键获取参数。

起始版本: 13

参数:

名称 描述
imageProcessor 指向图片处理模块实例的指针。
parameter 该图片处理模块实例使用的参数。

返回:

  • 如果获取参数不成功,则返回IMAGE_PROCESSING_SUCCESS。
  • 当该实例为空或该实例不是图片处理模块实例时,返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。
  • 当参数为空时,返回IMAGE_PROCESSING_ERROR_INVALID_PARAMETER。

OH_ImageProcessing_InitializeEnvironment()

ImageProcessing_ErrorCode OH_ImageProcessing_InitializeEnvironment(void)

描述

初始化图片处理模块的全局环境。

此函数为非必需函数。通常此函数在主进程启动时被调用,用于图片处理模块的全局环境初始化并可以减少OH_ImageProcessing_Create的耗时。调用OH_ImageProcessing_DeinitializeEnvironment进行全局环境反初始化。可用于检查设备GPU是否正常工作。

起始版本: 13

返回:

如果初始化成功,则返回IMAGE_PROCESSING_SUCCESS,否则返回IMAGE_PROCESSING_ERROR_INITIALIZE_FAILED。

OH_ImageProcessing_IsColorSpaceConversionSupported()

bool OH_ImageProcessing_IsColorSpaceConversionSupported(const ImageProcessing_ColorSpaceInfo* sourceImageInfo, const ImageProcessing_ColorSpaceInfo* destinationImageInfo)

描述

查询是否支持当前图片色彩空间转换能力。

起始版本: 13

参数:

名称 描述
sourceImageInfo 指向输入图片色彩空间信息的指针。
destinationImageInfo 指向输出图片色彩空间信息的指针。

返回:

如果支持当前色彩空间转换,返回true。如果不支持当前色彩空间转换,返回false。

OH_ImageProcessing_IsCompositionSupported()

bool OH_ImageProcessing_IsCompositionSupported(const ImageProcessing_ColorSpaceInfo* sourceImageInfo, const ImageProcessing_ColorSpaceInfo* sourceGainmapInfo, const ImageProcessing_ColorSpaceInfo* destinationImageInfo)

描述

查询是否支持HDR双层图片转换为HDR单层图片。

起始版本: 13

参数:

名称 描述
sourceImageInfo 指向输入图片色彩空间信息的指针。
sourceGainmapInfo 指向输入Gainmap色彩空间信息的指针。
destinationImageInfo 指向输出图片色彩空间信息的指针。

返回:

如果支持HDR双层图片转换HDR单层图片能力,返回true。如果不支持此能力,返回false。

OH_ImageProcessing_IsDecompositionSupported()

bool OH_ImageProcessing_IsDecompositionSupported(const ImageProcessing_ColorSpaceInfo* sourceImageInfo, const ImageProcessing_ColorSpaceInfo* destinationImageInfo, const ImageProcessing_ColorSpaceInfo* destinationGainmapInfo)

描述

查询是否支持HDR单层图片转换为HDR双层图片。

起始版本: 13

参数:

名称 描述
sourceImageInfo 指向输入图片色彩空间信息的指针。
destinationImageInfo 指向输出图片色彩空间信息的指针。
destinationGainmapInfo 指向输出Gainmap色彩空间信息的指针。

返回:

如果支持HDR单层图片转换为HDR双层图片能力,返回true。如果不支持此能力,返回false。

OH_ImageProcessing_IsMetadataGenerationSupported()

bool OH_ImageProcessing_IsMetadataGenerationSupported(const ImageProcessing_ColorSpaceInfo* sourceImageInfo)

描述

查询是否支持图片元数据生成能力。

起始版本: 13

参数:

名称 描述
sourceImageInfo 指向输入图片色彩空间信息的指针。

返回:

如果支持图片元数据生成能力,返回true。如果不支持此能力,返回false。

OH_ImageProcessing_SetParameter()

ImageProcessing_ErrorCode OH_ImageProcessing_SetParameter(OH_ImageProcessing* imageProcessor, const OH_AVFormat* parameter)

描述

设置图片处理模块参数。

通过特定参数键添加参数。

起始版本: 13

参数:

名称 描述
imageProcessor 指向图片处理模块实例的指针。
parameter 图片处理参数。

返回:

  • 如果设置参数成功,则返回IMAGE_PROCESSING_SUCCESS。
  • 当该实例为空或该实例不是图片处理模块实例时,返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。
  • 当参数为空时,返回IMAGE_PROCESSING_ERROR_INVALID_PARAMETER。
  • 当部分参数无效时,返回IMAGE_PROCESSING_ERROR_INVALID_VALUE,例如参数包含不支持的参数键或值。
  • 当内存分配失败时,返回IMAGE_PROCESSING_ERROR_NO_MEMORY。

变量说明

IMAGE_DETAIL_ENHANCER_PARAMETER_KEY_QUALITY_LEVEL

const char* IMAGE_DETAIL_ENHANCER_PARAMETER_KEY_QUALITY_LEVEL

描述

用于设定图像细节增强的质量级别。

使用ImageDetailEnhancer_QualityLevel获取其值。使用OH_ImageProcessing_SetParameter设置质量级别。使用OH_ImageProcessing_GetParameter获取当前质量级别。

起始版本: 13

参见:

OH_VideoProcessing_SetParameter

OH_VideoProcessing_GetParameter

IMAGE_PROCESSING_TYPE_COLOR_SPACE_CONVERSION

const int32_t IMAGE_PROCESSING_TYPE_COLOR_SPACE_CONVERSION

描述

用于创建色彩空间转换的图片处理实例。

色彩空间转换包括单层HDR图片转换SDR图片,SDR图片之间的转换,以及SDR图片转换单层HDR图片,部分能力由厂商支持。使用OH_ImageProcessing_IsColorSpaceConversionSuported查询某种转换是否支持在单层图片之间进行。

起始版本: 13

参见:

OH_ImageProcessing_Create

IMAGE_PROCESSING_TYPE_COMPOSITION

const int32_t IMAGE_PROCESSING_TYPE_COMPOSITION

描述

用于创建双层HDR图片转换单层HDR图片的图片处理实例。

包括从双层HDR图片转换为单层HDR图片的能力。部分能力由厂商支持。使用OH_ImageProcessing_IsCompositionSupported查询是否支持从双层HDR图片到单层HDR图片的转换。

起始版本: 13

参见:

OH_ImageProcessing_Create

IMAGE_PROCESSING_TYPE_DECOMPOSITION

const int32_t IMAGE_PROCESSING_TYPE_DECOMPOSITION

描述

用于创建单层HDR图片转换双层HDR图片的图片处理实例。

包括从单层HDR图片转换为双层HDR图片的能力。部分能力由厂商支持。使用OH_ImageProcessing_IsDecompositionSupported查询是否支持从单层HDR图片到双层HDR图片的转换。

起始版本: 13

参见:

OH_ImageProcessing_Create

IMAGE_PROCESSING_TYPE_DETAIL_ENHANCER

const int32_t IMAGE_PROCESSING_TYPE_DETAIL_ENHANCER

描述

用于创建细节增强的图片处理实例。

按指定图像质量缩放或调整图片大小,或仅增强图像细节以在不更改分辨率的情况下渲染图片。

起始版本: 13

参见:

OH_ImageProcessing_Create

IMAGE_PROCESSING_TYPE_METADATA_GENERATION

const int32_t IMAGE_PROCESSING_TYPE_METADATA_GENERATION

描述

用于创建元数据生成的图片处理实例。

生成单层HDR图片的HDR Vivid元数据。该能力由厂商支持。如果不支持该能力,OH_ImageProcessing_Create将返回 IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING。

起始版本: 13

参见:

OH_ImageProcessing_Create