---
title: Histogram
description: "此函数计算源图像每个通道的强度直方图，并将结果存储在hist数组中。实际操作为划分几个区间，指定图像统计的区域，计算区域内在各区间中的像素值的数量："
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_hmpp_06_0187.html
sourcePath: /source/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_hmpp_06_0187.html
indexId: 52ae0274f52aa66549e574710bf4e6b3926b14fb26ac2262dc2d89d6b4dbd56977
---
# Histogram

此函数计算源图像每个通道的强度直方图，并将结果存储在hist数组中。实际操作为划分几个区间，指定图像统计的区域，计算区域内在各区间中的像素值的数量：

- levels是级别数组，长度为levelsLen，一个区间由levels相邻两个值组成，左闭右开；hist数组对区间内数进行统计，因此hist数组长度为levelsLen – 1。
- hist[k]是源图像像素src(x, y)的数量，该像素满足条件levels[k]<=src(x,y)<levels[k+1]。

函数接口声明如下：

- 初始化函数：
  HmppResult HMPPI_HistogramInit(HmppDataType dataType, const float *levels[], int32_t levelsLen[], int32_t numChannels,HmppiHistogramPolicy **policy);

  HmppResult HMPPI_HistogramUniformInit(HmppDataType dataType, float lowerLevel[], float upperLevel[],int32_t levelsLen[], int32_t numChannels, HmppiHistogramPolicy **policy);

- 单通道主函数：
  HmppResult HMPPI_Histogram_8u_C1R(const uint8_t *src, int32_t srcStep, HmppiSize roiSize, uint32_t *hist, const HmppiHistogramPolicy *policy);

  HmppResult HMPPI_Histogram_16u_C1R(const uint16_t *src, int32_t srcStep, HmppiSize roiSize, uint32_t *hist, const HmppiHistogramPolicy *policy);

  HmppResult HMPPI_Histogram_16s_C1R(const int16_t *src, int32_t srcStep, HmppiSize roiSize, uint32_t *hist, const HmppiHistogramPolicy *policy);

  HmppResult HMPPI_Histogram_32f_C1R(const float *src, int32_t srcStep, HmppiSize roiSize, uint32_t *hist, const HmppiHistogramPolicy *policy);

- 多通道主函数：
  HmppResult HMPPI_Histogram_8u_C3R(const uint8_t *src, int32_t srcStep, HmppiSize roiSize, uint32_t *hist[3], const HmppiHistogramPolicy *policy);

  HmppResult HMPPI_Histogram_16u_C3R(const uint16_t *src, int32_t srcStep, HmppiSize roiSize, uint32_t *hist[3], const HmppiHistogramPolicy *policy);

  HmppResult HMPPI_Histogram_16s_C3R(const int16_t *src, int32_t srcStep, HmppiSize roiSize, uint32_t *hist[3], const HmppiHistogramPolicy *policy);

  HmppResult HMPPI_Histogram_32f_C3R(const float *src, int32_t srcStep, HmppiSize roiSize, uint32_t *hist[3], const HmppiHistogramPolicy *policy);

  HmppResult HMPPI_Histogram_8u_C4R(const uint8_t *src, int32_t srcStep, HmppiSize roiSize, uint32_t *hist[4], const HmppiHistogramPolicy *policy);

  HmppResult HMPPI_Histogram_16u_C4R(const uint16_t *src, int32_t srcStep, HmppiSize roiSize, uint32_t *hist[4], const HmppiHistogramPolicy *policy);

  HmppResult HMPPI_Histogram_16s_C4R(const int16_t *src, int32_t srcStep, HmppiSize roiSize, uint32_t *hist[4], const HmppiHistogramPolicy *policy);

  HmppResult HMPPI_Histogram_32f_C4R(const float *src, int32_t srcStep, HmppiSize roiSize, uint32_t *hist[4], const HmppiHistogramPolicy *policy);

- 获取区间边界函数：
  HmppResult HMPPI_HistogramGetLevels(const HmppiHistogramPolicy *policy, float *levels[]);

- 释放函数：
  HmppResult HMPPI_HistogramRelease(HmppiHistogramPolicy *policy);


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| src | 指向源图像ROI的指针。 | 非空 | 输入 |
| srcStep | 源图像中连续行的起点之间的距离，以字节为单位。 | (0,INT\_MAX] | 输入 |
| roiSize | 源图像ROI的大小，单位为像素。 | roiSize.width∈(0, INT\_MAX]，roiSize.height∈(0, INT\_MAX] | 输入 |
| hist | 指向计算直方图的指针。在多通道数据的情况下，hist是指向每个通道直方图的指针数组。 | 非空 | 输出 |
| datatype | 源图像的数据类型。 | HMPP8U、HMPP16U HMPP16S、HMPP32F | 输入 |
| Levels | 指向级别数组的指针。 | 非空 | 输入 |
| lowerLevel | Uniform类型直方图的级别下边界，每个通道分开。 | 非空 | 输入 |
| upperLevel | Uniform类型直方图的级别上边界，每个通道分开。 | 非空 | 输入 |
| numChannels | 通道数。 | 1、3、4 | 输入 |
| levelsLen | 级别数组的长度。每个通道都有单独的级别数量。 | 各通道级别数组总长度不超过50,000,000。 一般情况下，整型类接口级别数组长度不会超过该类型最小最大值之间整数的数量，浮点类接口级别数组长度也远不会达到50000000这个级别的数量。 | 输入 |
| policy（init函数中） | 指向HistogramPolicy结构体的双重指针。 | 非空 | 输出 |
| policy（主函数中和release函数中） | 指向Histogram结构体的指针。 | 非空 | 输入 |


#### 返回值

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


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| HMPP\_STS\_NULL\_PTR\_ERR | 当任何指定的指针为空时指示错误。 |
| HMPP\_STS\_DATETYPE\_ERR | 传入的数据类型不是HMPP8U、HMPP16U、HMPP16S、HMPP32F中的一种。 |
| HMPP\_STS\_HISTOLEVELS\_ERR | 级别数组长度小于2。 |
| HMPP\_STS\_NUMCHANNELS\_ERR | 通道数不是1、3、4其中一个。 |
| HMPP\_STS\_MALLOC\_FAILED | 函数中进行内存申请失败。 |
| HMPP\_STS\_OVERFLOW | 各通道的总级别数组长度超过500000000。 |
| HMPPS\_STS\_POLICY\_STATE\_ERR | policy结构体标记值错误。 |
| HMPP\_STS\_STEP\_ERR | srcStep小于或等于0。 |
| HMPP\_STS\_ROI\_ERR | roiSize.width \* 通道数 \* 数据类型所占字节数 > 步长。 |
| HMPP\_STS\_SIZE\_ERR | roiSize.width或roiSize.height小于或等于0。 |
| HMPP\_STS\_RANGE\_ERR | Init模式levels数组不是非递减序列，或Uniform模式lowerLevel大于upperLevel。 |


#### 示例

```
void HistogramExample()
{
const int32_t numChannels = 3;
HmppiSize roiSize = {2,3};
uint8_t src[28] = { 1, 2, 3, 4, 5, 6, 7,
102, 103, 104, 105, 106, 107, 108,
203, 204, 205, 255, 255, 255, 209,
4, 5, 6, 7, 8, 9, 10 };
int32_t srcStep = 7 * sizeof(uint8_t);
int32_t levelsLen[3] = {3, 4, 5};
float p0[3] = {0, 105, 256};
float p1[4] = {0, 100, 200, 256};
float p2[5] = {0, 60, 105, 205, 256};
const float *levels[3] = {p0, p1, p2};
uint32_t h0[2], h1[3], h2[4];
uint32_t *hist[3] = {h0, h1, h2};
HmppiHistogramPolicy *policy = NULL;
HmppResult result = HMPPI_HistogramInit(HMPP8U, levels, levelsLen, numChannels, &policy);
if (result != HMPP_STS_NO_ERR) {
printf("Histogram Init error: %d\n", result);
}
result = HMPPI_Histogram_8u_C3R(src, srcStep, roiSize, hist, policy);
if (result != HMPP_STS_NO_ERR) {
printf("Histogram error: %d\n", result);
}
HMPPI_HistogramRelease(policy);
printf("hist:\n");
for (int32_t i = 0; i < 3; i++){
for (int32_t j = 0; j < levelsLen[i] - 1; j++){
printf("%d ", hist[i][j]);
}
printf("\n");
}
}
int main()
{
HistogramExample();
return 0;
}
```

运行结果：

```
hist:
3 3
2 2 2
2 1 1 2
```