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