函数说明：

将RGB图像转换为YCbCr颜色模型。

此函数根据以下公式将值在[0,255]范围内的伽马校正R'G'B'图像转换为Y'Cb'Cr'图像：

$\text{[math]}$

在YCbCr模型中，Y运算后的取值范围是[16, 235]，Cb和Cr运算后的取值范围是[16,240]。

函数接口声明如下：

对像素阶数据的操作：
HmppResult HMPPI_RGBToYCbCr_8u_C3R(const uint8_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize);

HmppResult HMPPI_RGBToYCbCr_8u_AC4R(const uint8_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize);
对平面数据的操作：
HmppResult HMPPI_RGBToYCbCr_8u_P3R(const uint8_t *src[3], int32_t srcStep, uint8_t *dst[3], int32_t dstStep, HmppiSize roiSize);
从像素阶到平面数据的转换：
HmppResult HMPPI_RGBToYCbCr_8u_C3P3R(const uint8_t *src, int32_t srcStep, uint8_t *dst[3], int32_t dstStep, HmppiSize roiSize);

HmppResult HMPPI_RGBToYCbCr_8u_AC4P3R(const uint8_t *src, int32_t srcStep, uint8_t *dst[3], 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

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
    };
    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_RGBToYCbCr_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();
   return 0;
}

运行结果：

result = 0
dst =
 33 134 122  61 134 122  82 101 128  84 122 134   0   0   0
 80 134 122  74 133 100  65 122 134  32 130 137   0   0   0
 74 122 134  45 117 134  43 134 122  71 134 122   0   0   0
 33 134 122  61 134 122  82 101 128  84 122 134   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