--- title: RGBToYUV420 description: "将RGB图像转换成采样为4:2:0的YUV图像，即每4个Y共用一组UV分量。" url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/2300/accel/kunpengaccel_hmpp_06_0228.html sourcePath: /source/zh/kunpengboostkithistory/2300/accel/kunpengaccel_hmpp_06_0228.html indexId: bb25188130f78c85b69ce6a3c8d6cecd674a9893ed8602235fa502d9084ee1ce75 --- # RGBToYUV420 将RGB图像转换成采样为4:2:0的YUV图像，即每4个Y共用一组UV分量。 函数接口声明如下： - 对像素阶数据的操作： HmppResult HMPPI_RGBToYUV420_8u_C3P3R(const uint8_t *src, int32_t srcStep, uint8_t *dst[3], int32_t dstStep, HmppiSize roiSize); - 对平面数据的操作： HmppResult HMPPI_RGBToYUV420_8u_P3R(const uint8_t *src[3], int32_t srcStep, uint8_t *dst[3], int32_t dstStep, HmppiSize roiSize); HmppResult HMPPI_RGBToYUV420_8u_P3(const uint8_t * src[3], uint8_t * dst[3], HmppiSize imgSize); - 从像素阶到平面数据的转换： HmppResult HMPPI_RGBToYUV420_8u_C3P3(const uint8_t * src, uint8_t * dst[3], HmppiSize imgSize); #### 参数 | 参数名 | 描述 | 取值范围 | 输入/输出 | | --- | --- | --- | --- | | src | 指向像素顺序数据的源缓冲区的指针。在平面数据的情况下，用于分隔源颜色平面的指针数组。 | 非空 | 输入 | | srcStep | 源图像中连续行起点之间的距离（以字节为单位）。 | 非负整数 | 输入 | | dst | 指向像素顺序数据的目标缓冲区的指针。在平面数据的情况下，指向分隔目标颜色平面的指针数组。 | 非空 | 输出 | | dstStep | 指向目标图像中连续行的起点之间的距离（以字节为单位）。 | 非负整数 | 输入 | | roiSize | 源和目标图像感兴趣区域的大小（以像素为单位）。 | roiSize.width∈(0, INT\_MAX]，roiSize.height∈(0, INT\_MAX] | 输入 | | imgSize | 源和目标图像的大小（以像素为单位）。 | 非负整数 | 输入 | #### 返回值 - 成功：返回HMPP_STS_NO_ERR。 - 失败：返回错误码。 #### 错误码 | 错误码 | 描述 | | --- | --- | | HMPP\_STS\_NULL\_PTR\_ERR | src或者dst中存在空指针。 | | HMPP\_STS\_SIZE\_ERR | roiSize或者imgSize的字段为零或负值。 | | HMPP\_STS\_STEP\_ERR | srcStep或者dstStep中存在零或负值。 | | HMPP\_STS\_ROI\_ERR | roiSize.width \* 通道数 \* 数据类型所占字节数 > 步长。 | #### 示例 ``` #define SRC_BUFFER_SIZE_T 90 #define DST_BUFFER_SIZE_T 90 void TestExample() { HmppiSize roi = { 4, 4 }; const uint8_t src[SRC_BUFFER_SIZE_T] = { 11, 22, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33, 11, 22, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33, 11, 22, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33, 11, 22, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33, 11, 22, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33, 11, 22, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33 }; uint8_t a[DST_BUFFER_SIZE_T], b[DST_BUFFER_SIZE_T], c[DST_BUFFER_SIZE_T]; uint8_t *dst[3] = {a, b, c}; int32_t srcStep = 20 * sizeof(uint8_t); int32_t dstStep[3] = {12 * sizeof(uint8_t),12 * sizeof(uint8_t),12 * sizeof(uint8_t)}; HmppResult result = HMPPI_RGBToYUV420_8u_C3P3R(src, srcStep, dst, dstStep, roi); printf("result = %d \ndst = ", result); if (result != HMPP_STS_NO_ERR) { printf("result error: %d\n", result); } for(int32_t i = 0; i < 3; i++){ int32_t dstWidth = dstStep[i] / sizeof(uint8_t); for (int32_t j = 0; j < DST_BUFFER_SIZE_T; j++) { if( j % dstWidth == 0 ){ printf("\n"); } printf("%3d ",dst[i][j]); } } printf("\n"); } int main() { TestExample(); return 0; } ``` 运行结果： ``` result = 0 dst = 19 52 77 79 251 255 0 0 112 17 254 204 74 67 57 18 144 99 21 239 255 255 0 0 68 33 30 63 251 255 0 0 0 0 66 0 19 52 77 79 16 115 254 204 251 255 0 0 16 123 254 204 251 255 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 134 118 21 239 255 255 0 0 88 99 21 239 126 122 0 0 240 2 64 0 0 0 0 0 65 5 64 0 0 0 0 0 120 98 21 239 255 255 0 0 116 98 21 239 255 255 0 0 56 245 216 3 0 0 0 0 0 240 253 204 251 255 0 0 176 98 21 239 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 251 255 0 0 0 0 112 134 254 204 251 255 0 0 176 101 254 204 128 125 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 72 99 21 239 255 255 0 0 88 99 21 239 255 255 0 0 46 16 138 52 0 0 0 0 14 0 0 0 0 0 0 0 14 0 0 0 0 0 0 0 5 0 0 0 0 0 0 0 8 101 254 204 251 255 0 0 0 0 ```