1# image_processing.h 2 3## 概述 4 5声明图片处理函数。提供图片处理能力，包括色彩空间转换，元数据生成及图片缩放。 6 7**引用文件：** <multimedia/video_processing_engine/image_processing.h> 8 9**库：** libimage_processing.so 10 11**系统能力：** SystemCapability.Multimedia.VideoProcessingEngine 12 13**起始版本：** 13 14 15**相关模块：** [ImageProcessing](capi-imageprocessing.md) 16 17## 汇总 18 19### 函数 20 21| 名称 | 描述 | 22| -- | -- | 23| [ImageProcessing_ErrorCode OH_ImageProcessing_InitializeEnvironment(void)](#oh_imageprocessing_initializeenvironment) | 初始化图片处理模块的全局环境。<br>此函数为非必需函数。通常此函数在主进程启动时被调用，用于图片处理模块的全局环境初始化并可以减少[OH_ImageProcessing_Create](capi-image-processing-h.md#oh_imageprocessing_create)的耗时。调用[OH_ImageProcessing_DeinitializeEnvironment](capi-image-processing-h.md#oh_imageprocessing_deinitializeenvironment)进行全局环境反初始化。可用于检查设备GPU是否正常工作。 | 24| [ImageProcessing_ErrorCode OH_ImageProcessing_DeinitializeEnvironment(void)](#oh_imageprocessing_deinitializeenvironment) | 反初始化图片处理模块的全局环境。<br>如果[OH_ImageProcessing_InitializeEnvironment](capi-image-processing-h.md#oh_imageprocessing_initializeenvironment)被调用，则此函数为必需函数。通常此函数在主进程准备退出时被调用，用于反初始化图片处理模块的全局环境（由[OH_ImageProcessing_InitializeEnvironment](capi-image-processing-h.md#oh_imageprocessing_initializeenvironment)接口初始化）。如果此时存在图片处理实例，则不应调用此函数。如果[OH_ImageProcessing_InitializeEnvironment](capi-image-processing-h.md#oh_imageprocessing_initializeenvironment)未被调用，则不应调用此函数。 | 25| [bool OH_ImageProcessing_IsColorSpaceConversionSupported(const ImageProcessing_ColorSpaceInfo* sourceImageInfo, const ImageProcessing_ColorSpaceInfo* destinationImageInfo)](#oh_imageprocessing_iscolorspaceconversionsupported) | 查询是否支持当前图片色彩空间转换能力。 | 26| [bool OH_ImageProcessing_IsCompositionSupported(const ImageProcessing_ColorSpaceInfo* sourceImageInfo, const ImageProcessing_ColorSpaceInfo* sourceGainmapInfo,const ImageProcessing_ColorSpaceInfo* destinationImageInfo)](#oh_imageprocessing_iscompositionsupported) | 查询是否支持HDR双层图片转换为HDR单层图片。 | 27| [bool OH_ImageProcessing_IsDecompositionSupported(const ImageProcessing_ColorSpaceInfo* sourceImageInfo, const ImageProcessing_ColorSpaceInfo* destinationImageInfo,const ImageProcessing_ColorSpaceInfo* destinationGainmapInfo)](#oh_imageprocessing_isdecompositionsupported) | 查询是否支持HDR单层图片转换为HDR双层图片。 | 28| [bool OH_ImageProcessing_IsMetadataGenerationSupported(const ImageProcessing_ColorSpaceInfo* sourceImageInfo)](#oh_imageprocessing_ismetadatagenerationsupported) | 查询是否支持图片元数据生成能力。 | 29| [ImageProcessing_ErrorCode OH_ImageProcessing_Create(OH_ImageProcessing** imageProcessor, int32_t type)](#oh_imageprocessing_create) | 创建一个图片处理模块实例。 | 30| [ImageProcessing_ErrorCode OH_ImageProcessing_Destroy(OH_ImageProcessing* imageProcessor)](#oh_imageprocessing_destroy) | 销毁当前图片处理模块实例。 | 31| [ImageProcessing_ErrorCode OH_ImageProcessing_SetParameter(OH_ImageProcessing* imageProcessor, const OH_AVFormat* parameter)](#oh_imageprocessing_setparameter) | 设置图片处理模块参数。通过特定参数键添加参数。 | 32| [ImageProcessing_ErrorCode OH_ImageProcessing_GetParameter(OH_ImageProcessing* imageProcessor, OH_AVFormat* parameter)](#oh_imageprocessing_getparameter) | 获取图片处理模块参数。通过特定参数键获取参数。 | 33| [ImageProcessing_ErrorCode OH_ImageProcessing_ConvertColorSpace(OH_ImageProcessing* imageProcessor, OH_PixelmapNative* sourceImage, OH_PixelmapNative* destinationImage)](#oh_imageprocessing_convertcolorspace) | 实现单层图片间转换。此函数包括HDR图片到SDR图片的色彩空间转换，SDR图片到HDR图片的色彩空间转换，SDR图片到SDR图片的色彩空间转换和HDR图片的色彩空间转换。 | 34| [ImageProcessing_ErrorCode OH_ImageProcessing_Compose(OH_ImageProcessing* imageProcessor, OH_PixelmapNative* sourceImage, OH_PixelmapNative* sourceGainmap, OH_PixelmapNative* destinationImage)](#oh_imageprocessing_compose) | 实现HDR双层图片到HDR单层图片的转换。此函数通过输入图片与输入Gainmap生成输出图片。 | 35| [ImageProcessing_ErrorCode OH_ImageProcessing_Decompose(OH_ImageProcessing* imageProcessor, OH_PixelmapNative* sourceImage, OH_PixelmapNative* destinationImage, OH_PixelmapNative* destinationGainmap)](#oh_imageprocessing_decompose) | 实现HDR单层图片到HDR双层图片的转换。此函数通过输入图片生成输出图片和输出Gainmap。 | 36| [ImageProcessing_ErrorCode OH_ImageProcessing_GenerateMetadata(OH_ImageProcessing* imageProcessor, OH_PixelmapNative* sourceImage)](#oh_imageprocessing_generatemetadata) | 生成HDR图片元数据。此函数为HDR图片生成元数据。 | 37| [ImageProcessing_ErrorCode OH_ImageProcessing_EnhanceDetail(OH_ImageProcessing* imageProcessor, OH_PixelmapNative* sourceImage, OH_PixelmapNative* destinationImage)](#oh_imageprocessing_enhancedetail) | 进行图片清晰度/细节增强。此函数根据输入图片和输出图片预设的尺寸，对源图片进行必要的缩放操作生成目标图片，并提供了多种缩放方法以平衡性能和图像质量。 | 38 39## 函数说明 40 41### OH_ImageProcessing_InitializeEnvironment() 42 43``` 44ImageProcessing_ErrorCode OH_ImageProcessing_InitializeEnvironment(void) 45``` 46 47**描述** 48 49初始化图片处理模块的全局环境。 50 51此函数为非必需函数。通常此函数在主进程启动时被调用，用于图片处理模块的全局环境初始化并可以减少[OH_ImageProcessing_Create](capi-image-processing-h.md#oh_imageprocessing_create)的耗时。调用[OH_ImageProcessing_DeinitializeEnvironment](capi-image-processing-h.md#oh_imageprocessing_deinitializeenvironment)进行全局环境反初始化。可用于检查设备GPU是否正常工作。 52 53**起始版本：** 13 54 55**返回：** 56 57| 类型 | 说明 | 58| -- | -- | 59| [ImageProcessing_ErrorCode](capi-image-processing-types-h.md#imageprocessing_errorcode) | 如果初始化成功，则返回IMAGE_PROCESSING_SUCCESS，否则返回IMAGE_PROCESSING_ERROR_INITIALIZE_FAILED。 | 60 61### OH_ImageProcessing_DeinitializeEnvironment() 62 63``` 64ImageProcessing_ErrorCode OH_ImageProcessing_DeinitializeEnvironment(void) 65``` 66 67**描述** 68 69反初始化图片处理模块的全局环境。 70 71如果[OH_ImageProcessing_InitializeEnvironment](capi-image-processing-h.md#oh_imageprocessing_initializeenvironment)被调用，则此函数为必需函数。通常此函数在主进程准备退出时被调用，用于反初始化图片处理模块的全局环境（由[OH_ImageProcessing_InitializeEnvironment](capi-image-processing-h.md#oh_imageprocessing_initializeenvironment)接口初始化）。如果此时存在图片处理实例，则不应调用此函数。如果[OH_ImageProcessing_InitializeEnvironment](capi-image-processing-h.md#oh_imageprocessing_initializeenvironment)未被调用，则不应调用此函数。 72 73**起始版本：** 13 74 75**返回：** 76 77| 类型 | 说明 | 78| -- | -- | 79| [ImageProcessing_ErrorCode](capi-image-processing-types-h.md#imageprocessing_errorcode) | 如果反初始化成功，则返回IMAGE_PROCESSING_SUCCESS。<br> 如果存在图片处理实例未被销毁或[OH_ImageProcessing_InitializeEnvironment](capi-image-processing-h.md#oh_imageprocessing_initializeenvironment)接口未被调用，则返回MAGE_PROCESSING_ERROR_OPERATION_NOT_PERMITTED。 | 80 81### OH_ImageProcessing_IsColorSpaceConversionSupported() 82 83``` 84bool OH_ImageProcessing_IsColorSpaceConversionSupported(const ImageProcessing_ColorSpaceInfo* sourceImageInfo,const ImageProcessing_ColorSpaceInfo* destinationImageInfo) 85``` 86 87**描述** 88 89查询是否支持当前图片色彩空间转换能力。 90 91**起始版本：** 13 92 93 94**参数：** 95 96| 参数项 | 描述 | 97| -- | -- | 98| const [ImageProcessing_ColorSpaceInfo](capi-imageprocessing-imageprocessing-colorspaceinfo.md)* sourceImageInfo | 指向输入图片色彩空间信息的指针。 | 99| const [ImageProcessing_ColorSpaceInfo](capi-imageprocessing-imageprocessing-colorspaceinfo.md)* destinationImageInfo | 指向输出图片色彩空间信息的指针， | 100 101**返回：** 102 103| 类型 | 说明 | 104| -- | -- | 105| bool | 如果支持当前色彩空间转换，返回true。<br> 如果不支持当前色彩空间转换，返回false。 | 106 107### OH_ImageProcessing_IsCompositionSupported() 108 109``` 110bool OH_ImageProcessing_IsCompositionSupported(const ImageProcessing_ColorSpaceInfo* sourceImageInfo,const ImageProcessing_ColorSpaceInfo* sourceGainmapInfo,const ImageProcessing_ColorSpaceInfo* destinationImageInfo) 111``` 112 113**描述** 114 115查询是否支持HDR双层图片转换为HDR单层图片。 116 117**起始版本：** 13 118 119 120**参数：** 121 122| 参数项 | 描述 | 123| -- | -- | 124| const [ImageProcessing_ColorSpaceInfo](capi-imageprocessing-imageprocessing-colorspaceinfo.md)* sourceImageInfo | 指向输入图片色彩空间信息的指针。 | 125| const [ImageProcessing_ColorSpaceInfo](capi-imageprocessing-imageprocessing-colorspaceinfo.md)* sourceGainmapInfo | 指向输入Gainmap色彩空间信息的指针。 | 126| const [ImageProcessing_ColorSpaceInfo](capi-imageprocessing-imageprocessing-colorspaceinfo.md)* destinationImageInfo | 指向输出图片色彩空间信息的指针。 | 127 128**返回：** 129 130| 类型 | 说明 | 131| -- | -- | 132| bool | 如果支持HDR双层图片转换HDR单层图片能力，返回true。<br> 如果不支持此能力，返回false。 | 133 134### OH_ImageProcessing_IsDecompositionSupported() 135 136``` 137bool OH_ImageProcessing_IsDecompositionSupported(const ImageProcessing_ColorSpaceInfo* sourceImageInfo,const ImageProcessing_ColorSpaceInfo* destinationImageInfo,const ImageProcessing_ColorSpaceInfo* destinationGainmapInfo) 138``` 139 140**描述** 141 142查询是否支持HDR单层图片转换为HDR双层图片。 143 144**起始版本：** 13 145 146 147**参数：** 148 149| 参数项 | 描述 | 150| -- | -- | 151| const [ImageProcessing_ColorSpaceInfo](capi-imageprocessing-imageprocessing-colorspaceinfo.md)* sourceImageInfo | 指向输入图片色彩空间信息的指针。 | 152| const [ImageProcessing_ColorSpaceInfo](capi-imageprocessing-imageprocessing-colorspaceinfo.md)* destinationImageInfo | 指向输出图片色彩空间信息的指针。 | 153| const [ImageProcessing_ColorSpaceInfo](capi-imageprocessing-imageprocessing-colorspaceinfo.md)* destinationGainmapInfo | 指向输出Gainmap色彩空间信息的指针。 | 154 155**返回：** 156 157| 类型 | 说明 | 158| -- | -- | 159| bool | 如果支持HDR单层图片转换为HDR双层图片能力，返回true。<br> 如果不支持此能力，返回false。 | 160 161### OH_ImageProcessing_IsMetadataGenerationSupported() 162 163``` 164bool OH_ImageProcessing_IsMetadataGenerationSupported(const ImageProcessing_ColorSpaceInfo* sourceImageInfo) 165``` 166 167**描述** 168 169查询是否支持图片元数据生成能力。 170 171**起始版本：** 13 172 173 174**参数：** 175 176| 参数项 | 描述 | 177| -- | -- | 178| const [ImageProcessing_ColorSpaceInfo](capi-imageprocessing-imageprocessing-colorspaceinfo.md)* sourceImageInfo | 指向输入图片色彩空间信息的指针。 | 179 180**返回：** 181 182| 类型 | 说明 | 183| -- | -- | 184| bool | 如果支持图片元数据生成能力，返回true。<br> 如果不支持此能力，返回false。 | 185 186### OH_ImageProcessing_Create() 187 188``` 189ImageProcessing_ErrorCode OH_ImageProcessing_Create(OH_ImageProcessing** imageProcessor, int32_t type) 190``` 191 192**描述** 193 194创建一个图片处理模块实例。 195 196**起始版本：** 13 197 198 199**参数：** 200 201| 参数项 | 描述 | 202| -- | -- | 203| [OH_ImageProcessing](capi-imageprocessing-oh-imageprocessing.md)** imageProcessor | 输出参数。指针\*imageProcessor指向一个新的图片处理对象。指针\*imageProcessor在传递前必须是一个空指针。 | 204| int32_t type | 使用IMAGE_PROCESSING_TYPE_XXX来指定图片处理类型。此实例的类型在创建后不能更改。 | 205 206**返回：** 207 208| 类型 | 说明 | 209| -- | -- | 210| [ImageProcessing_ErrorCode](capi-image-processing-types-h.md#imageprocessing_errorcode) | 如果创建成功，则返回IMAGE_PROCESSING_SUCCESS。<br> 当指定的图片处理类型不支持时，返回IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING，例如如果不支持图片元数据生成能力，则返回不支持该处理类型。<br> 当创建失败时，返回IMAGE_PROCESSING_ERROR_CREATE_FAILED。<br> 当该实例为空或指向该实例的指针为空时，返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。<br> 当指定的图片处理类型无效时，返回IMAGE_PROCESSING_ERROR_INVALID_PARAMETER。 | 211 212### OH_ImageProcessing_Destroy() 213 214``` 215ImageProcessing_ErrorCode OH_ImageProcessing_Destroy(OH_ImageProcessing* imageProcessor) 216``` 217 218**描述** 219 220销毁当前图片处理模块实例。 221 222**起始版本：** 13 223 224 225**参数：** 226 227| 参数项 | 描述 | 228| -- | -- | 229| [OH_ImageProcessing](capi-imageprocessing-oh-imageprocessing.md)* imageProcessor | 指向图片处理模块实例的指针。当实例被销毁时，建议该指针设置为空。 | 230 231**返回：** 232 233| 类型 | 说明 | 234| -- | -- | 235| [ImageProcessing_ErrorCode](capi-image-processing-types-h.md#imageprocessing_errorcode) | 如果销毁成功，则返回IMAGE_PROCESSING_SUCCESS。<br> 当该实例为空或该实例不是图片处理模块实例时，返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。 | 236 237### OH_ImageProcessing_SetParameter() 238 239``` 240ImageProcessing_ErrorCode OH_ImageProcessing_SetParameter(OH_ImageProcessing* imageProcessor,const OH_AVFormat* parameter) 241``` 242 243**描述** 244 245设置图片处理模块参数。通过特定参数键添加参数。 246 247**起始版本：** 13 248 249 250**参数：** 251 252| 参数项 | 描述 | 253| -- | -- | 254| [OH_ImageProcessing](capi-imageprocessing-oh-imageprocessing.md)* imageProcessor | 指向图片处理模块实例的指针。 | 255| const [OH_AVFormat](../apis-avcodec-kit/_core.md#oh_avformat)* parameter | 图片处理参数。 | 256 257**返回：** 258 259| 类型 | 说明 | 260| -- | -- | 261| [ImageProcessing_ErrorCode](capi-image-processing-types-h.md#imageprocessing_errorcode) | 如果设置参数成功，则返回IMAGE_PROCESSING_SUCCESS。<br> 当该实例为空或该实例不是图片处理模块实例时，返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。<br> 当参数为空时，返回IMAGE_PROCESSING_ERROR_INVALID_PARAMETER。<br> 当部分参数无效时，返回IMAGE_PROCESSING_ERROR_INVALID_VALUE，例如参数包含不支持的参数键或值。<br> 当内存分配失败时，返回IMAGE_PROCESSING_ERROR_NO_MEMORY。 | 262 263### OH_ImageProcessing_GetParameter() 264 265``` 266ImageProcessing_ErrorCode OH_ImageProcessing_GetParameter(OH_ImageProcessing* imageProcessor,OH_AVFormat* parameter) 267``` 268 269**描述** 270 271获取图片处理模块参数。通过特定参数键获取参数。 272 273**起始版本：** 13 274 275 276**参数：** 277 278| 参数项 | 描述 | 279| -- | -- | 280| [OH_ImageProcessing](capi-imageprocessing-oh-imageprocessing.md)* imageProcessor | 指向图片处理模块实例的指针。 | 281| [OH_AVFormat](../apis-avcodec-kit/_core.md#oh_avformat)* parameter | 该图片处理模块实例使用的参数。 | 282 283**返回：** 284 285| 类型 | 说明 | 286| -- | -- | 287| [ImageProcessing_ErrorCode](capi-image-processing-types-h.md#imageprocessing_errorcode) | 如果获取参数不成功，则返回IMAGE_PROCESSING_SUCCESS。<br> 当该实例为空或该实例不是图片处理模块实例时，返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。<br> 当参数为空时，返回IMAGE_PROCESSING_ERROR_INVALID_PARAMETER。 | 288 289### OH_ImageProcessing_ConvertColorSpace() 290 291``` 292ImageProcessing_ErrorCode OH_ImageProcessing_ConvertColorSpace(OH_ImageProcessing* imageProcessor,OH_PixelmapNative* sourceImage, OH_PixelmapNative* destinationImage) 293``` 294 295**描述** 296 297实现单层图片间转换。此函数包括HDR图片到SDR图片的色彩空间转换，SDR图片到HDR图片的色彩空间转换，SDR图片到SDR图片的色彩空间转换和HDR图片的色彩空间转换。 298 299**起始版本：** 13 300 301 302**参数：** 303 304| 参数项 | 描述 | 305| -- | -- | 306| [OH_ImageProcessing](capi-imageprocessing-oh-imageprocessing.md)* imageProcessor | 指向图片处理模块实例的指针。该实例应该由IMAGE_PROCESSING_TYPE_COLOR_SPACE_CONVERSION类型创建。 | 307| [OH_PixelmapNative](capi-image-nativemodule-oh-pixelmapnative.md)* sourceImage | 指向输入图片的指针。 | 308| [OH_PixelmapNative](capi-image-nativemodule-oh-pixelmapnative.md)* destinationImage | 指向输出图片的指针。 | 309 310**返回：** 311 312| 类型 | 说明 | 313| -- | -- | 314| [ImageProcessing_ErrorCode](capi-image-processing-types-h.md#imageprocessing_errorcode) | 如果图片处理成功，则返回IMAGE_PROCESSING_SUCCESS。<br> 当该实例为空或该实例不是图片处理模块实例时，返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。<br> 当图片为空时，返回IMAGE_PROCESSING_ERROR_INVALID_PARAMETER。<br> 当图片的某些属性无效时，返回IMAGE_PROCESSING_ERROR_INVALID_VALUE，例如图片的色彩空间时不支持的。<br> 当该图片处理不支持时，返回IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING。<br> 当该图片处理中返回错误时，返回IMAGE_PROCESSING_ERROR_PROCESS_FAILED。<br> 当内存分配失败时，返回IMAGE_PROCESSING_ERROR_NO_MEMORY。 | 315 316### OH_ImageProcessing_Compose() 317 318``` 319ImageProcessing_ErrorCode OH_ImageProcessing_Compose(OH_ImageProcessing* imageProcessor,OH_PixelmapNative* sourceImage, OH_PixelmapNative* sourceGainmap, OH_PixelmapNative* destinationImage) 320``` 321 322**描述** 323 324实现HDR双层图片到HDR单层图片的转换。此函数通过输入图片与输入Gainmap生成输出图片。 325 326**起始版本：** 13 327 328 329**参数：** 330 331| 参数项 | 描述 | 332| -- | -- | 333| [OH_ImageProcessing](capi-imageprocessing-oh-imageprocessing.md)* imageProcessor | 指向图片处理模块实例的指针。该实例应该由IMAGE_PROCESSING_TYPE_COMPOSITION类型创建。 | 334| [OH_PixelmapNative](capi-image-nativemodule-oh-pixelmapnative.md)* sourceImage | 指向输入图片的指针。 | 335| [OH_PixelmapNative](capi-image-nativemodule-oh-pixelmapnative.md)* sourceGainmap | 指向输入Gainmap的指针。 | 336| [OH_PixelmapNative](capi-image-nativemodule-oh-pixelmapnative.md)* destinationImage | 指向输出图片的指针。 | 337 338**返回：** 339 340| 类型 | 说明 | 341| -- | -- | 342| [ImageProcessing_ErrorCode](capi-image-processing-types-h.md#imageprocessing_errorcode) | 如果图片处理成功，则返回IMAGE_PROCESSING_SUCCESS。<br> 当该实例为空或该实例不是图片处理模块实例时，返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。<br> 当图片为空时，返回IMAGE_PROCESSING_ERROR_INVALID_PARAMETER。<br> 当图片的某些属性无效时，返回IMAGE_PROCESSING_ERROR_INVALID_VALUE，例如图片的色彩空间时不支持的。<br> 当该图片处理不支持时，返回IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING。<br> 当该图片处理中返回错误时，返回IMAGE_PROCESSING_ERROR_PROCESS_FAILED。<br> 当内存分配失败时，返回IMAGE_PROCESSING_ERROR_NO_MEMORY。 | 343 344### OH_ImageProcessing_Decompose() 345 346``` 347ImageProcessing_ErrorCode OH_ImageProcessing_Decompose(OH_ImageProcessing* imageProcessor,OH_PixelmapNative* sourceImage, OH_PixelmapNative* destinationImage, OH_PixelmapNative* destinationGainmap) 348``` 349 350**描述** 351 352实现HDR单层图片到HDR双层图片的转换。此函数通过输入图片生成输出图片和输出Gainmap。 353 354**起始版本：** 13 355 356 357**参数：** 358 359| 参数项 | 描述 | 360| -- | -- | 361| [OH_ImageProcessing](capi-imageprocessing-oh-imageprocessing.md)* imageProcessor | 指向图片处理模块实例的指针。该实例应该由IMAGE_PROCESSING_TYPE_DECOMPOSITION类型创建。 | 362| [OH_PixelmapNative](capi-image-nativemodule-oh-pixelmapnative.md)* sourceImage | 指向输入图片的指针。 | 363| [OH_PixelmapNative](capi-image-nativemodule-oh-pixelmapnative.md)* destinationImage | 指向输出图片的指针。 | 364| [OH_PixelmapNative](capi-image-nativemodule-oh-pixelmapnative.md)* destinationGainmap | 指向输出Gainmap的指针。 | 365 366**返回：** 367 368| 类型 | 说明 | 369| -- | -- | 370| [ImageProcessing_ErrorCode](capi-image-processing-types-h.md#imageprocessing_errorcode) | 如果图片处理成功，则返回IMAGE_PROCESSING_SUCCESS。<br> 当该实例为空或该实例不是图片处理模块实例时，返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。<br> 当图片为空时，返回IMAGE_PROCESSING_ERROR_INVALID_PARAMETER。<br> 当图片的某些属性无效时，返回IMAGE_PROCESSING_ERROR_INVALID_VALUE，例如图片的色彩空间时不支持的。<br> 当该图片处理不支持时，返回IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING。<br> 当该图片处理中返回错误时，返回IMAGE_PROCESSING_ERROR_PROCESS_FAILED。<br> 当内存分配失败时，返回IMAGE_PROCESSING_ERROR_NO_MEMORY。 | 371 372### OH_ImageProcessing_GenerateMetadata() 373 374``` 375ImageProcessing_ErrorCode OH_ImageProcessing_GenerateMetadata(OH_ImageProcessing* imageProcessor,OH_PixelmapNative* sourceImage) 376``` 377 378**描述** 379 380生成HDR图片元数据。此函数为HDR图片生成元数据。 381 382**起始版本：** 13 383 384 385**参数：** 386 387| 参数项 | 描述 | 388| -- | -- | 389| [OH_ImageProcessing](capi-imageprocessing-oh-imageprocessing.md)* imageProcessor | 指向图片处理模块实例的指针。该实例应该由IMAGE_PROCESSING_TYPE_METADATA_GENERATION类型创建。 | 390| [OH_PixelmapNative](capi-image-nativemodule-oh-pixelmapnative.md)* sourceImage | 指向输入图片的指针。 | 391 392**返回：** 393 394| 类型 | 说明 | 395| -- | -- | 396| [ImageProcessing_ErrorCode](capi-image-processing-types-h.md#imageprocessing_errorcode) | 如果图片处理成功，则返回IMAGE_PROCESSING_SUCCESS。<br> 当该实例为空或该实例不是图片处理模块实例时，返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。<br> 当图片为空时，返回IMAGE_PROCESSING_ERROR_INVALID_PARAMETER。<br> 当图片的某些属性无效时，返回IMAGE_PROCESSING_ERROR_INVALID_VALUE，例如图片的色彩空间时不支持的。<br> 当该图片处理不支持时，返回IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING。<br> 当该图片处理中返回错误时，返回IMAGE_PROCESSING_ERROR_PROCESS_FAILED。<br> 当内存分配失败时，返回IMAGE_PROCESSING_ERROR_NO_MEMORY。 | 397 398### OH_ImageProcessing_EnhanceDetail() 399 400``` 401ImageProcessing_ErrorCode OH_ImageProcessing_EnhanceDetail(OH_ImageProcessing* imageProcessor,OH_PixelmapNative* sourceImage, OH_PixelmapNative* destinationImage) 402``` 403 404**描述** 405 406进行图片清晰度/细节增强。此函数根据输入图片和输出图片预设的尺寸，对源图片进行必要的缩放操作生成目标图片，并提供了多种缩放方法以平衡性能和图像质量。 407 408**起始版本：** 13 409 410 411**参数：** 412 413| 参数项 | 描述 | 414| -- | -- | 415| [OH_ImageProcessing](capi-imageprocessing-oh-imageprocessing.md)* imageProcessor | 指向图片处理模块实例的指针。该实例应该由IMAGE_PROCESSING_TYPE_DETAIL_ENHANCER类型创建。 | 416| [OH_PixelmapNative](capi-image-nativemodule-oh-pixelmapnative.md)* sourceImage | 指向输入图片的指针。 | 417| [OH_PixelmapNative](capi-image-nativemodule-oh-pixelmapnative.md)* destinationImage | 指向输出图片的指针。 | 418 419**返回：** 420 421| 类型 | 说明 | 422| -- | -- | 423| [ImageProcessing_ErrorCode](capi-image-processing-types-h.md#imageprocessing_errorcode) | 如果图片处理成功，则返回IMAGE_PROCESSING_SUCCESS。<br> 当该实例为空或该实例不是图片处理模块实例时，返回IMAGE_PROCESSING_ERROR_INVALID_INSTANCE。<br> 当图片为空时，返回IMAGE_PROCESSING_ERROR_INVALID_PARAMETER。<br> 当图片的某些属性无效时，返回IMAGE_PROCESSING_ERROR_INVALID_VALUE，例如图片的色彩空间时不支持的。<br> 当该图片处理不支持时，返回IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING。<br> 当该图片处理中返回错误时，返回IMAGE_PROCESSING_ERROR_PROCESS_FAILED。<br> 当内存分配失败时，返回IMAGE_PROCESSING_ERROR_NO_MEMORY。 | 424 425 426