---
title: YUV420ToBGR
description: "将采样格式为4:2:0的YUV图像转换为BGR颜色模型。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/251RC1/accel/kunpengaccel_hmpp_06_0225.html
sourcePath: /source/zh/kunpengboostkithistory/251RC1/accel/kunpengaccel_hmpp_06_0225.html
indexId: ad3f173fae83135e68cb509c56edc9bed23e5023e7a5707a2797ceaa31a9ec6e77
---
# YUV420ToBGR

将采样格式为4:2:0的YUV图像转换为BGR颜色模型。

函数接口声明如下：

HmppResult HMPPI_YUV420ToBGR_8u_P3C3R(const uint8_t* src[3], int srcStep[3], uint8_t *dst, int dstStep,HmppiSize roiSize);

#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| src | 指向源图像的指针。该数组存储指向源平面图像的颜色平面的指针。 | 非空 | 输入 |
| srcStep | 源图像中连续行的起点之间的距离（以字节为单位）。 | 非负整数 | 输入 |
| dst | 指向目的图像感兴趣区域的指针。该数组存储指向目标平面图像的颜色平面的指针。 | 非空 | 输出 |
| dstStep | 目标图像中连续行的起点之间的距离（以字节为单位）。 | 非负整数 | 输入 |
| roiSize | 源和目标图像感兴趣区域的大小（以像素为单位）。 | roiSize.width∈(0, INT\_MAX]，roiSize.height∈(0, INT\_MAX] | 输入 |
| imgSize | 对于无ROI的操作，源图像和目标图像的大小。 | 非负整数 | 输入 |


#### 返回值

- 成功：返回HMPP_STS_NO_ERR。
- 失败：返回错误码。


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| HMPP\_STS\_NULL\_PTR\_ERR | src中存在空指针。 |
| HMPP\_STS\_SIZE\_ERR | roiSize的字段为零或负值。 |
| HMPP\_STS\_STEP\_ERR | srcStep中存在零或负值。 |
| HMPP\_STS\_ROI\_ERR | roiSize.width \* 通道数 \* 数据类型所占字节数 > 步长。 |


#### 示例

```
#define SRC_BUFFER_SIZE_T 90
#define DST_BUFFER_SIZE_T 90
void TestExample_YUV420ToBGR()
{
HmppiSize roi = { 4, 4 };
const uint8_t src1[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
};
const uint8_t src2[SRC_BUFFER_SIZE_T] = {
11, 22, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33,
21, 23, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33,
31, 24, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33,
41, 25, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33,
51, 26, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33,
61, 27, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33
};
const uint8_t src3[SRC_BUFFER_SIZE_T] = {
11, 12, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33,
12, 22, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33,
13, 32, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33,
14, 42, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33,
15, 52, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33,
16, 62, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33
};
const uint8_t *src[3] = {src1, src2, src3};
int32_t srcStep[3] = {20 * sizeof(uint8_t), 20 * sizeof(uint8_t), 20 * sizeof(uint8_t)};
int32_t dstStep = 20 * sizeof(uint8_t);;
uint8_t dst[DST_BUFFER_SIZE_T] = {0};
HmppResult result = HMPPI_YUV420ToBGR_8u_P3C3R(src, srcStep, dst, dstStep, roi);
printf("result = %d \ndst = ", result);
if (result != HMPP_STS_NO_ERR) {
printf("result error: %d\n", result);
}
int32_t dstWidth = dstStep / sizeof(uint8_t);
for(int32_t i = 0; i < DST_BUFFER_SIZE_T; i++){
if (i % dstWidth == 0) {
printf("\n");
}
printf("%3d ",dst[i]);
}
printf("\n");
}
int main()
{
TestExample_YUV420ToBGR();
return 0;
}
```

运行结果：

```
result = 0
dst =
0 124   0   0 135   0   0 141   0   0 152   0   0   0   0   0   0   0   0   0
0 179   0   0 190   0   0 196   0   0 130   0   0   0   0   0   0   0   0   0
0 137   6   0 126   0   0 104   0   0  93   0   0   0   0   0   0   0   0   0
0  71   0   0  82   0   0  82   0   0  93   0   0   0   0   0   0   0   0   0
0   0   0   0   0   0   0   0   0   0
```