1# ICodecImage 2 3 4## 概述 5 6图像编解码器模块接口。 7 8**起始版本:** 4.0 9 10**相关模块:**[Codec](_codec_v20.md) 11 12 13## 汇总 14 15 16### Public 成员函数 17 18| 名称 | 描述 | 19| -------- | -------- | 20| [GetImageCapability](#getimagecapability) ([out] struct [CodecImageCapability](_codec_image_capability_v20.md)[] capList) | 获得图像编解码器功能。 | 21| [Init](#init) ([in] enum [CodecImageRole](_codec_v20.md#codecimagerole) role) | 图像编解码器模块初始化。 | 22| [DeInit](#deinit) ([in] enum [CodecImageRole](_codec_v20.md#codecimagerole) role) | 图像编解码器模块去初始化。 | 23| [DoJpegDecode](#dojpegdecode) ([in] struct [CodecImageBuffer](_codec_image_buffer_v20.md) inBuffer, [in] struct [CodecImageBuffer](_codec_image_buffer_v20.md) outBuffer, [in] struct [CodecJpegDecInfo](_codec_jpeg_dec_info_v20.md) decInfo) | 启动jpeg图像解码。 | 24| [AllocateInBuffer](#allocateinbuffer) ([out] struct [CodecImageBuffer](_codec_image_buffer_v20.md) inBuffer, [in] unsigned int size, [in] [CodecImageRole](_codec_v20.md#codecimagerole) role) | 分配输入缓冲区。 | 25| [FreeInBuffer](#freeinbuffer) ([in] struct [CodecImageBuffer](_codec_image_buffer_v20.md) inBuffer) | 释放输入缓冲区。 | 26 27 28## 成员函数说明 29 30 31### AllocateInBuffer() 32 33``` 34ICodecImage::AllocateInBuffer ([out] struct CodecImageBuffer inBuffer, [in] unsigned int size, [in] CodecImageRole role ) 35``` 36 37**描述** 38 39分配输入缓冲区。 40 41您可以使用此API为图像编解码器分配输入缓冲区。 42 43**起始版本:** 4.0 44 45**参数:** 46 47| 名称 | 描述 | 48| -------- | -------- | 49| inBuffer | 获得的图像编解码器的输入缓冲区[CodecImageBuffer](_codec_image_buffer_v20.md)。 | 50| size | 获得的输入缓冲区的大小[CodecImageBuffer](_codec_image_buffer_v20.md)。 | 51| role | 获取的输入缓冲区的图像编解码器格式[CodecImageRole](_codec_v20.md#codecimagerole)。 | 52 53**返回:** 54 55成功返回HDF_SUCCESS 56 57输入无效参数返回HDF_ERR_INVALID_PARAM 58 59失败返回HDF_FAILURE 60 61如果vendor层返回失败,则返回其他值。其他错误代码详见HDF_STATUS的定义。 62 63 64### DeInit() 65 66``` 67ICodecImage::DeInit ([in] enum CodecImageRole role) 68``` 69 70**描述** 71 72图像编解码器模块去初始化。 73 74您可以使用此API对图像编解码器模块进行去初始化。 75 76**起始版本:** 4.0 77 78**参数:** 79 80| 名称 | 描述 | 81| -------- | -------- | 82| role | 指示获取的图像编解码器格式[CodecImageRole](_codec_v20.md#codecimagerole)。 | 83 84**返回:** 85 86成功返回HDF_SUCCESS 87 88成功返回HDF_SUCCESS 89 90如果vendor层返回失败,则返回其他值。其他错误代码详见HDF_STATUS的定义。 91 92 93### DoJpegDecode() 94 95``` 96ICodecImage::DoJpegDecode ([in] struct CodecImageBuffer inBuffer, [in] struct CodecImageBuffer outBuffer, [in] struct CodecJpegDecInfo decInfo ) 97``` 98 99**描述** 100 101启动jpeg图像解码。 102 103您可以使用此API启动jpeg图像解码。 104 105**起始版本:** 4.0 106 107**参数:** 108 109| 名称 | 描述 | 110| -------- | -------- | 111| inBuffer | 获得的jpeg图像解码的输入缓冲区[CodecImageBuffer](_codec_image_buffer_v20.md)。 | 112| outBuffer | 获得的jpeg图像解码的输出缓冲区[CodecImageBuffer](_codec_image_buffer_v20.md)。 | 113| decInfo | 获得的jpeg图像解码的解码信息[CodecJpegDecInfo](_codec_jpeg_dec_info_v20.md)。 | 114 115**返回:** 116 117成功返回HDF_SUCCESS 118 119输入无效参数返回HDF_ERR_INVALID_PARAM 120 121失败返回HDF_FAILURE 122 123如果vendor层返回失败,则返回其他值。其他错误代码详见HDF_STATUS的定义。 124 125 126### FreeInBuffer() 127 128``` 129ICodecImage::FreeInBuffer ([in] struct CodecImageBuffer inBuffer) 130``` 131 132**描述** 133 134释放输入缓冲区。 135 136您可以使用这个API来释放输入缓冲区用于图像解码。 137 138**起始版本:** 4.0 139 140**参数:** 141 142| 名称 | 描述 | 143| -------- | -------- | 144| buffer | 获得的图像编解码器的输入缓冲区[CodecImageBuffer](_codec_image_buffer_v20.md)。 | 145 146**返回:** 147 148成功返回HDF_SUCCESS 149 150成功返回HDF_SUCCESS 151 152如果vendor层返回失败,则返回其他值。其他错误代码详见HDF_STATUS的定义。 153 154 155### GetImageCapability() 156 157``` 158ICodecImage::GetImageCapability ([out] struct CodecImageCapability[] capList) 159``` 160 161**描述** 162 163获得图像编解码器功能。 164 165您可以使用此API来获得图像编解码器模块提供的编解码能力集。详见[CodecImageCapability](_codec_image_capability_v20.md)。 166 167**起始版本:** 4.0 168 169**参数:** 170 171| 名称 | 描述 | 172| -------- | -------- | 173| capList | 指向获得的图像编解码器能力集[CodecImageCapability](_codec_image_capability_v20.md)。 | 174 175**返回:** 176 177成功返回HDF_SUCCESS 178 179失败返回HDF_FAILURE 180 181 182### Init() 183 184``` 185ICodecImage::Init ([in] enum CodecImageRole role) 186``` 187 188**描述** 189 190图像编解码器模块初始化。 191 192您可以使用此API来初始化图像编解码器模块。 193 194**起始版本:** 4.0 195 196**参数:** 197 198| 名称 | 描述 | 199| -------- | -------- | 200| role | 指示获取的图像编解码器格式[CodecImageRole](_codec_v20.md#codecimagerole)。 | 201 202**返回:** 203 204成功返回HDF_SUCCESS 205 206成功返回HDF_SUCCESS 207 208如果vendor层返回失败,则返回其他值。其他错误代码详见HDF_STATUS的定义。 209