---
title: CountInRange
description: "此函数功能是统计源图像指定区域内像素值处于上下界区间内的像素个数，并保存至counts中。在多通道情况下，给定范围的像素数在每个通道上分别计算并存储到数组counts中。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/2300/accel/kunpengaccel_hmpp_06_0186.html
sourcePath: /source/zh/kunpengboostkithistory/2300/accel/kunpengaccel_hmpp_06_0186.html
indexId: 4b9a890b77ae2a684a77a4082fac958a06aa53ed82e20fd20fccf5b4c4d0823e75
---
# CountInRange

此函数功能是统计源图像指定区域内像素值处于上下界区间内的像素个数，并保存至counts中。在多通道情况下，给定范围的像素数在每个通道上分别计算并存储到数组counts中。

函数接口声明如下：

- 单通道操作：
  HmppResult HMPPI_CountInRange_32f_C1R(const float *src, int32_t srcStep, HmppiSize roiSize, int32_t *counts, float lowerBound, float upperBound);

  HmppResult HMPPI_CountInRange_8u_C1R(const uint8_t *src, int32_t srcStep, HmppiSize roiSize, int32_t *counts, uint8_t lowerBound, uint8_t upperBound);

- 多通道操作：
  HmppResult HMPPI_CountInRange_8u_C3R(const uint8_t *src, int32_t srcStep, HmppiSize roiSize, int32_t counts[3], uint8_t lowerBound[3], uint8_t upperBound[3]);

  HmppResult HMPPI_CountInRange_8u_AC4R(const uint8_t *src, int32_t srcStep, HmppiSize roiSize, int32_t counts[3], uint8_t lowerBound[3], uint8_t upperBound[3]);

  HmppResult HMPPI_CountInRange_32f_C3R(const float *src, int32_t srcStep, HmppiSize roiSize, int32_t counts[3], float lowerBound[3], float upperBound[3]);

  HmppResult HMPPI_CountInRange_32f_AC4R(const float *src, int32_t srcStep, HmppiSize roiSize, int32_t counts[3], float lowerBound[3], float upperBound[3]);


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| src | 指向源图像感兴趣区域的指针。 | 非空 | 输入 |
| srcStep | 源图像中连续行起点之间的距离（以字节为单位）。 | 非负整数 | 输入 |
| roiSize | 源和目标图像感兴趣区域的大小（以像素为单位）。 | roiSize.width∈(0, INT\_MAX]，roiSize.height∈(0, INT\_MAX] | 输入 |
| counts | 指向像素值在给定范围的像素数的指针（用于单通道函数）。 | 非负整数 | 输入/输出 |
| counts[] | 包含各个通道像素值在给定范围内像素数的数组（用于多通道函数）。 | 非负整数 | 输入/输出 |
| lowerBound | 给定强度范围的下界（用于单通道数据）。 | 输入数据类型的范围 | 输入 |
| lowerBound[] | 包含各个通道的给定强度范围的下界的数组（用于多通道数据）。 | 输入数据类型的范围 | 输入 |
| upperBound | 给定强度范围的上界（用于单通道数据）。 | 输入数据类型的范围 | 输入 |
| upperBound[] | 包含各个通道的给定强度范围的上界的数组（用于多通道数据）。 | 输入数据类型的范围 | 输入 |


#### 返回值

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


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| HMPP\_STS\_NULL\_PTR\_ERR | src中存在空指针。 |
| HMPP\_STS\_SIZE\_ERR | roiSize的width、height存在零或负值。 |
| HMPP\_STS\_STEP\_ERR | srcStep中存在零或负值。 |
| HMPP\_STS\_NOT\_EVEN\_STEP\_ERR | srcStep不能被src所属数据类型的字节长度整除的错误条件。 |
| HMPP\_STS\_ROI\_ERR | roiSize.width > 步长。 |
| HMPP\_STS\_RANGE\_ERR | lowerBound大于upperBound。 |


#### 示例

```
void CountInRangeExample()
{
HmppiSize roi = {3, 4};
uint8_t src[9 * 4] = {1, 1, 1, 2, 2, 2, 3, 3, 3,
4, 4, 4, 5, 5, 5, 6, 6, 6,
7, 7, 7, 8, 8, 8, 9, 9, 9,
10, 10, 10, 11, 11, 11, 12, 12, 12};
int32_t srcStep =9*sizeof(uint8_t);
int32_t counts[3] = {0};
uint8_t lowerBound[3] = {0, 2, 4};
uint8_t upperBound[3] = {8, 8, 8};
int32_t i;
HmppResult result =HMPPI_CountInRange_8u_C3R(src, srcStep, roi, counts, lowerBound, upperBound);
printf("result = %d\n", result);
if (result != HMPP_STS_NO_ERR) {
return;
}
for(i =0; i <3; i++) {
printf("%d ", counts[i]);
}
printf("\n");
}
```

运行结果：

```
result = 0
8 7 5
```