npm 包 pitch-fq 使用教程

阅读时长 3 分钟读完

pitch-fq 是一个方便计算音高和音调频率的 npm 包,支持传统的西洋音乐音高表示方式,比如 C4 代表中央 C,A4 代表 440 Hz 等。此外,它还支持其他音高标准,比如 MIDI 数字标记,如 A4 对应 69,中文传统音高表示方式,如唐调中,中央 C 对应“一”等。

安装

使用 npm 安装 pitch-fq:

使用

示例代码如下:

-- -------------------- ---- -------
-- -- -------- --
----- ----- - --------------------

-- -- -------- --
----- --------- - ----  

----- ------- - -----------------

-- ------
----- ------- - ---------------

-- ----------
------------------------- ---- ---------- -----

输出结果如下:

API

pitch-fq 提供了多个方法,包括创建 pitch-tq 实例、计算音调频率等。

pitch(pitchName)

创建 pitch-tq 实例,传入的参数 pitchName 表示音高名称,支持多种表示方式,如传统的西洋音高表示方式,MIDI 数字标记,中文传统音高表示方式等。

.name()

返回音高名称,如果实例创建时传入了非法值,此方法将返回 undefined。

.midi()

返回 MIDI 数字标记,此标记用于在 MIDI 消息中表示音符音高。

.freq()

返回音调频率。默认情况下,当前实例对象使用的音高标准是“标准中央 C = C4, 440 Hz”,即 A4 的频率为 440 Hz。实例化时也可以通过传入一个对象覆盖默认的音高标准:

其中,standard 表示音高标准,tuningHz 表示调弦频率。

总结

使用 pitch-fq 可以方便地进行各种常见的音高和音调频率计算,支持多种音高标准表示方式,可以直接在项目中使用,为前端开发提供了方便和便利。但是,在实际使用中,需要注意参数传入的合法性和可能存在的错误情况。有了 pitch-fq 的帮助,我们可以更好地专注于前端领域的开发工作。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/5eef45e6efcef77a054b7564

纠错
反馈