---
title: GrayToRGB
description: "此类函数将灰度图像转换为RGB图像，并依据以下公式进行颜色转换："
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/2300/accel/kunpengaccel_hmpp_06_0276.html
sourcePath: /source/zh/kunpengboostkithistory/2300/accel/kunpengaccel_hmpp_06_0276.html
indexId: 0a882d0d243d45668b8a3a2387f9e24fcb33559b095089504597d8551b3b425975
---
# GrayToRGB

此类函数将灰度图像转换为RGB图像，并依据以下公式进行颜色转换：


函数的接口声明如下：

对像素阶数据的操作：

HmppResult HMPPI_GrayToRGB_8u_C1C3R(const uint8_t* src, int32_t srcStep, uint8_t* dst, int32_t dstStep, HmppiSize roiSize)

HmppResult HMPPI_GrayToRGB_8u_C1C4R(const uint8_t* src, int32_t srcStep, uint8_t* dst, int32_t dstStep, HmppiSize roiSize, uint8_t aVal)

HmppResult HMPPI_GrayToRGB_16u_C1C3R(const uint16_t* src, int32_t srcStep, uint16_t* dst, int32_t dstStep, HmppiSize roiSize)

HmppResult HMPPI_GrayToRGB_16u_C1C4R(const uint16_t* src, int32_t srcStep, uint16_t* dst, int32_t dstStep, HmppiSize roiSize, uint16_t aVal)

HmppResult HMPPI_GrayToRGB_32f_C1C3R(const float* src, int32_t srcStep, float* dst, int32_t dstStep, HmppiSize roiSize)

HmppResult HMPPI_GrayToRGB_32f_C1C4R(const float* src, int32_t srcStep, float* dst, int32_t dstStep, HmppiSize roiSize, float aVal)

#### 参数

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


#### 返回值

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


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| HMPP\_STS\_NULL\_PTR\_ERR | src或者dst中存在空指针。 |
| HMPP\_STS\_SIZE\_ERR | roiSize的字段为零或负值。 |
| HMPP\_STS\_STEP\_ERR | srcStep或者dstStep中存在零或负值。 |
| HMPP\_STS\_ROI\_ERR | roiSize.width \* 通道数 \* 数据类型所占字节数 > 步长。 |
| HMPP\_STS\_NOT\_EVEN\_STEP\_ERR | 当数据类型不为uint8\_t时，步长为奇数。 |
| HMPP\_STS\_NO\_ERR | 返回值正确，任何其他值表示错误或警告。 |


#### 示例

```
#define SRC_BUFFER_SIZE_T 32
#define DST_BUFFER_SIZE_T 84
void TestExample()
{
HmppiSize roi = { 3, 4 };
const uint16_t src[SRC_BUFFER_SIZE_T] = {
12123, 21243, 13165, 255, 1, 2,
10256, 11193, 30243, 200, 3, 4,
4,     233,   109,    27, 5, 6,
6,     7,     8,       0, 7, 8
};
int32_t srcStep = 6 * sizeof(uint16_t);
uint16_t dst[DST_BUFFER_SIZE_T] = { 0 };
int32_t dstStep = 14 * sizeof(uint16_t);
uint16_t aVal = 0x8000;
HmppResult result = HMPPI_GrayToRGB_16u_C1C4R(src, srcStep, dst, dstStep, roi, aVal);
printf("result = %d \ndst = ", result);
if (result != HMPP_STS_NO_ERR) {
printf("result error: %d\n", result);
}
int32_t dstWidth = dstStep / sizeof(uint16_t);
for (int32_t i = 0; i < DST_BUFFER_SIZE_T; i++) {
if( i % dstWidth == 0 ){
printf("\n");
}
printf("%5d ",dst[i]);
}
printf("\n");
}
int main()
{
TestExample();
return 0;
}
```


运行结果：

```
result = 0
dst =
12123 12123 12123 32768 21243 21243 21243 32768 13165 13165 13165 32768     0     0
10256 10256 10256 32768 11193 11193 11193 32768 30243 30243 30243 32768     0     0
4     4     4 32768   233   233   233 32768   109   109   109 32768     0     0
6     6     6 32768     7     7     7 32768     8     8     8 32768     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
```