产生给定频率、相位和幅度的音调。

函数接口声明如下：

整型数的操作：
HmppResult HMPPS_Tone_16s(int16_t *dst, int32_t len, int16_t magn, float freq, float *phase);

HmppResult HMPPS_Tone_16sc(Hmpp16sc *dst, int32_t len, int16_t magn, float freq, float *phase);
浮点数的操作：
HmppResult HMPPS_Tone_32f(float *dst, int32_t len, float magn, float freq, float *phase);

HmppResult HMPPS_Tone_64f(double *dst, int32_t len, double magn, double freq, double *phase);

HmppResult HMPPS_Tone_32fc(Hmpp32fc *dst, int32_t len, float magn, float freq, float *phase);

HmppResult HMPPS_Tone_64fc(Hmpp64fc *dst, int32_t len, double magn, double freq, double *phase);

参数

参数名	描述	取值范围	输入/输出
dst	指向目的向量的指针。	非空	输出
len	向量长度。	(0,INT_MAX]	输入
phase	指向相位的指针。	[0.0, 2π)	输入
magn	震幅。	视类型而定	输入
freq	频率。	实数：[0.0, 0.5) 复数：[0.0, 1.0)	输入

返回值

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

错误码

错误码	描述
HMPP_STS_NULL_PTR_ERR	dst这个入参中存在空指针。
HMPP_STS_SIZE_ERR	len小于或等于0。
HMPP_STS_PARAMETER_ERR	振幅小于0，频率，相位超出范围。

示例

#define BUFFER_SIZE_T 10

int main()
{
    int16_t dst[BUFFER_SIZE_T];
    int32_t i;
    int16_t magn = 25;
    float freq = 0.4;
    float phase = 5.1415901;

    HmppResult result = HMPPS_Tone_16s(dst, BUFFER_SIZE_T, magn, freq, &phase);
    printf("result = %d \ndst =", result);
    for (i = 0; i < BUFFER_SIZE_T; i++) {
        printf(" %d    ", dst[i]);
    }

    return 0;
}

运行结果：

result = 0
dst = 10    4    -18    24    -21    10    4    -18    24    -21