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

父主题： 图像统计功能