RGBToYUV
该接口将RGB图像转换为YUV颜色模型。
此函数根据以下公式将伽马校正的R'G'B'图像src转换为Y'U'V'图像dst：
Y' = 0.299*R' + 0.587*G' + 0.114*B'
U' = -0.147*R' - 0.289*G' + 0.436*B' = 0.492*(B'-Y')
V' = 0.615*R' - 0.515*G' - 0.100*B' = 0.877*(R'-Y')
对于范围[0,255]内的数字RGB值，Y'的范围为[0,255]，U'在范围[-112,112]内变化，V'在范围[-157,157]内变化。为了适应[0,255]的范围，将常量值128添加到计算的U'和V'值中，并对V'取饱和运算。
函数接口声明如下：
- 对像素阶数据的操作：
HmppResult HMPPI_RGBToYUV_8u_C3R(const uint8_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize);
HmppResult HMPPI_RGBToYUV_8u_AC4R(const uint8_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize);
- 对平面数据的操作：
HmppResult HMPPI_RGBToYUV_8u_P3R(const uint8_t *src[3], int32_t srcStep, uint8_t *dst[3], int32_t dstStep, HmppiSize roiSize);
- 从像素阶到平面数据的转换：
HmppResult HMPPI_RGBToYUV_8u_C3P3R(const uint8_t *src, int32_t srcStep, uint8_t *dst[3], int32_t dstStep, HmppiSize roiSize);
HmppResult HMPPI_RGBToYUV_8u_AC4P4R(const uint8_t *src, int32_t srcStep, uint8_t *dst[4], int32_t dstStep, HmppiSize roiSize);
参数
参数名 |
描述 |
取值范围 |
输入/输出 |
|---|---|---|---|
src |
指向源图像的指针。该数组存储指向源平面图像的颜色平面的指针。 |
非空 |
输入 |
srcStep |
源图像中连续行的起点之间的距离（以字节为单位）。 |
非负整数 |
输入 |
dst |
指向目的图像感兴趣区域的指针。该数组存储指向目标平面图像的颜色平面的指针。 |
非空 |
输出 |
dstStep |
目标图像中连续行的起点之间的距离（以字节为单位）。 |
非负整数 |
输入 |
roiSize |
源和目标图像感兴趣区域的大小（以像素为单位）。 |
roiSize.width∈(0, INT_MAX]，roiSize.height∈(0, INT_MAX] |
输入 |
返回值
- 成功：返回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
#include "hmpp.h"
void TestExample_RGBToYUV()
{
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
};
int32_t srcStep = 20 * sizeof(uint8_t);
int32_t dstStep = 15 * sizeof(uint8_t);;
uint8_t dst[DST_BUFFER_SIZE_T] = {0};
HmppResult result = HMPPI_RGBToYUV_8u_C3R(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_RGBToYUV();
return 0;
}
运行结果：
result = 0 dst = 19 134 120 52 134 120 77 100 128 79 121 135 0 0 0 74 134 120 67 132 88 57 121 135 18 129 140 0 0 0 68 121 135 33 116 136 30 134 120 63 134 120 0 0 0 19 134 120 52 134 120 77 100 128 79 121 135 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