ZeroCrossing

计算向量跨零次数。

计算模式由参数zcType指定，计算结果保存在pValZC指向的地址中。计算模式包括以下三类：

ZCType = HMPPZCR，计算公式为：
ZCType = HMPPZCXor，计算公式为：
ZCType = HMPPZCC, 计算公式为：

接口函数的声明如下：

HmppResult HMPPS_ZeroCrossing_16s32f(const int16_t *src, uint32_t len, float *valZcr, HmppZCType zcType);

HmppResult HMPPS_ZeroCrossing_32f(const float *src, uint32_t len, float *valZcr, HmppZCType zcType);

参数

参数名	描述	取值范围	输入/输出
src	指向源向量的指针。	非空	输入
valZcr	指向计算结果的指针。	非空	输出
zcType	跨零计算模式。	HMPPZCR、HMPPZCXor、HMPPZCC	输入
len	向量长度。	正数	输入

返回值

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

错误码

错误码	描述
HMPP_STS_NULL_PTR_ERR	src、valZCR这两个入参中存在空指针。
HMPP_STS_SIZE_ERR	len为0。
HMPP_STS_RANGE_ERR	zcType为无效数值。

注意事项

调用函数时，注意len的数值类型为无符号型，不能误传负数。

示例

#define BUFFER_SIZE_T 10

void ZeroCrossingExample(void)
{
    float src[BUFFER_SIZE_T] = {1.64, 1.63, -1.09, 0.71, -3.20, -0.43, 0.41, -4.83, 5.36, -4.40};
    float valZCR[BUFFER_SIZE_T];
    (void)HMPPS_Zero_32f(valZCR, BUFFER_SIZE_T); // 数组初始化，将valZCR所有元素初始化为0.
    HmppZCType HmppZCR = HMPP_ZCR;

    HmppResult result = HMPPS_ZeroCrossing_32f(src, 10, valZCR, HmppZCR);
    printf("result = %d.\n", result);
    if (result != HMPP_STS_NO_ERR) {
        return;
    }
    printf("valZCR =");
    for (int i = 0; i < BUFFER_SIZE_T; i++) {
        printf(" %.2f", valZCR[i]);
    }
    printf("\n");
}

运行结果：

result = 0.
valZCR = 7.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00

父主题： 基础与通用运算