1# image_processing_types.h 2 3## 概述 4 5图片处理的类型定义。 6 7**引用文件：** <multimedia/video_processing_engine/image_processing_types.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| 名称 | typedef关键字 | 描述 | 22| -- | -- | -- | 23| [ImageProcessing_ColorSpaceInfo](capi-imageprocessing-imageprocessing-colorspaceinfo.md) | ImageProcessing_ColorSpaceInfo | 色彩空间信息，用于色彩空间转换能力查询。 | 24| [OH_ImageProcessing](capi-imageprocessing-oh-imageprocessing.md) | OH_ImageProcessing | 提供OH_ImageProcessing结构体声明。<br>定义了OH_ImageProcessing的空指针并调用[OH_ImageProcessing_Create](capi-image-processing-h.md#oh_imageprocessing_create)来创建图片处理实例。在创建实例之前，指针应为空。用户可以为不同的处理类型创建多个图片实例。 | 25| [OH_PixelmapNative](capi-image-nativemodule-oh-pixelmapnative.md) | OH_PixelmapNative | 提供OH_PixelmapNative结构体声明。 | 26| [OH_AVFormat](../apis-avcodec-kit/_core.md#oh_avformat) | OH_AVFormat | 提供OH_AVFormat结构体声明。 | 27 28### 枚举 29 30| 名称 | typedef关键字 | 描述 | 31| -- | -- | -- | 32| [ImageDetailEnhancer_QualityLevel](#imagedetailenhancer_qualitylevel) | ImageDetailEnhancer_QualityLevel | 质量级别，用于细节增强能力。<br>键参数的值IMAGE_DETAIL_ENHANCER_PARAMETER_KEY_QUALITY_LEVEL。 | 33| [ImageProcessing_ErrorCode](#imageprocessing_errorcode) | ImageProcessing_ErrorCode | 图片处理接口错误码说明。 | 34 35### 变量 36 37| 名称 | 描述 | 38| -- | -- | 39| const int32_t IMAGE_PROCESSING_TYPE_COLOR_SPACE_CONVERSION | 用于创建色彩空间转换的图片处理实例。<br>色彩空间转换包括单层HDR图片转换SDR图片，SDR图片之间的转换，以及SDR图片转换单层HDR图片，部分能力由厂商支持。使用[OH_ImageProcessing_IsColorSpaceConversionSuported](capi-image-processing-h.md#oh_imageprocessing_iscolorspaceconversionsupported)查询某种转换是否支持在单层图片之间进行。<br>**起始版本：** 13<br>**参考：**[OH_ImageProcessing_Create](capi-image-processing-h.md#oh_imageprocessing_create) | 40| const int32_t IMAGE_PROCESSING_TYPE_COMPOSITION | 用于创建双层HDR图片转换单层HDR图片的图片处理实例。<br>包括从双层HDR图片转换为单层HDR图片的能力。部分能力由厂商支持。使用[OH_ImageProcessing_IsCompositionSupported](capi-image-processing-h.md#oh_imageprocessing_iscompositionsupported)查询是否支持从双层HDR图片到单层HDR图片的转换。<br>**起始版本：** 13<br>**参考：**[OH_ImageProcessing_Create](capi-image-processing-h.md#oh_imageprocessing_create) | 41| const int32_t IMAGE_PROCESSING_TYPE_DECOMPOSITION | 用于创建单层HDR图片转换双层HDR图片的图片处理实例。<br>包括从单层HDR图片转换为双层HDR图片的能力。部分能力由厂商支持。使用[OH_ImageProcessing_IsDecompositionSupported](capi-image-processing-h.md#oh_imageprocessing_isdecompositionsupported)查询是否支持从单层HDR图片到双层HDR图片的转换。<br>**起始版本：** 13<br>**参考：**[OH_ImageProcessing_Create](capi-image-processing-h.md#oh_imageprocessing_create) | 42| const int32_t IMAGE_PROCESSING_TYPE_METADATA_GENERATION | 用于创建元数据生成的图片处理实例。<br>生成单层HDR图片的HDR Vivid元数据。该能力由厂商支持。如果不支持该能力，[OH_ImageProcessing_Create](capi-image-processing-h.md#oh_imageprocessing_create)将返回[IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING](capi-image-processing-types-h.md#imageprocessing_errorcode)。<br>**起始版本：** 13<br>**参考：**[OH_ImageProcessing_Create](capi-image-processing-h.md#oh_imageprocessing_create) | 43| const int32_t IMAGE_PROCESSING_TYPE_DETAIL_ENHANCER | 用于创建细节增强的图片处理实例。<br>按指定图像质量缩放或调整图片大小，或仅增强图像细节以在不更改分辨率的情况下渲染图片。<br>**起始版本：** 13<br>**参考：**[OH_ImageProcessing_Create](capi-image-processing-h.md#oh_imageprocessing_create) | 44| const char * IMAGE_DETAIL_ENHANCER_PARAMETER_KEY_QUALITY_LEVEL | 用于设定图像细节增强的质量级别。<br>使用[ImageDetailEnhancer_QualityLevel](capi-image-processing-types-h.md#imagedetailenhancer_qualitylevel)获取其值。使用[OH_ImageProcessing_SetParameter](capi-image-processing-h.md#oh_imageprocessing_setparameter)设置质量级别。使用[OH_ImageProcessing_GetParameter](capi-image-processing-h.md#oh_imageprocessing_getparameter)获取当前质量级别。<br>**起始版本：** 13 | 45 46## 枚举类型说明 47 48### ImageDetailEnhancer_QualityLevel 49 50``` 51enum ImageDetailEnhancer_QualityLevel 52``` 53 54**描述** 55 56质量级别，用于细节增强能力。 57 58键参数的值IMAGE_DETAIL_ENHANCER_PARAMETER_KEY_QUALITY_LEVEL。 59 60**起始版本：** 13 61 62| 枚举项 | 描述 | 63| -- | -- | 64| IMAGE_DETAIL_ENHANCER_QUALITY_LEVEL_NONE | 无细节增强。 | 65| IMAGE_DETAIL_ENHANCER_QUALITY_LEVEL_LOW | 细节增强质量较低，但速度较快。默认级别。 | 66| IMAGE_DETAIL_ENHANCER_QUALITY_LEVEL_MEDIUM | 细节增强质量中等，速度介于低级别与高级别之间。 | 67| IMAGE_DETAIL_ENHANCER_QUALITY_LEVEL_HIGH | 细节增强质量较高，但速度较慢。 | 68 69**参考：** 70 71[OH_ImageProcessing_SetParameter](capi-image-processing-h.md#oh_imageprocessing_setparameter)，[OH_ImageProcessing_GetParameter](capi-image-processing-h.md#oh_imageprocessing_getparameter) 72 73### ImageProcessing_ErrorCode 74 75``` 76enum ImageProcessing_ErrorCode 77``` 78 79**描述** 80 81图片处理接口错误码说明。 82 83**起始版本：** 13 84 85| 枚举项 | 描述 | 86| -- | -- | 87| IMAGE_PROCESSING_SUCCESS | 成功。 | 88| IMAGE_PROCESSING_ERROR_INVALID_PARAMETER = 401 | 输入参数无效。<br>在以下错误条件返回该错误码：<br>1. 输入或输出buffer无效，例如图片buffer为空。<br>2. 参数无效，例如参数为空。<br>3. 类型无效，例如在创建函数中传入的类型不存在。 | 89| IMAGE_PROCESSING_ERROR_UNKNOWN = 29200001 | 未知错误，例如GPU计算失败或memcpy失败。 | 90| IMAGE_PROCESSING_ERROR_INITIALIZE_FAILED | 全局环境初始化失败，例如GPU环境初始化失败。 | 91| IMAGE_PROCESSING_ERROR_CREATE_FAILED | 创建图片处理实例失败，例如实例数量超过上限。 | 92| IMAGE_PROCESSING_ERROR_PROCESS_FAILED | 处理图片buffer失败，例如处理超时。 | 93| IMAGE_PROCESSING_ERROR_UNSUPPORTED_PROCESSING | 当前处理不支持，可以通过“OH_ImageProcessing_IsXXXSupported”接口查询是否支持该能力。 | 94| IMAGE_PROCESSING_ERROR_OPERATION_NOT_PERMITTED | 无权限操作，可能由于状态不正确导致。 | 95| IMAGE_PROCESSING_ERROR_NO_MEMORY | 内存不足。 | 96| IMAGE_PROCESSING_ERROR_INVALID_INSTANCE | 无效的图片处理实例，可能由于实例为空导致。 | 97| IMAGE_PROCESSING_ERROR_INVALID_VALUE | 输入值无效。<br>在以下错误条件下返回该错误码：<br>1. 输入或输出图片buffer无效，例如图片buffer的宽度（高度）过大或颜色空间不正确。<br>2. 参数无效，例如参数不包括有效信息，例如细节增强的质量级别不正确。 | 98 99 100