pitch-fq 是一个方便计算音高和音调频率的 npm 包,支持传统的西洋音乐音高表示方式,比如 C4 代表中央 C,A4 代表 440 Hz 等。此外,它还支持其他音高标准,比如 MIDI 数字标记,如 A4 对应 69,中文传统音高表示方式,如唐调中,中央 C 对应“一”等。
安装
使用 npm 安装 pitch-fq:
npm install pitch-fq --save
使用
示例代码如下:
-- -------------------- ---- ------- -- -- -------- -- ----- ----- - -------------------- -- -- -------- -- ----- --------- - ---- ----- ------- - ----------------- -- ------ ----- ------- - --------------- -- ---------- ------------------------- ---- ---------- -----
输出结果如下:
C4 的频率为 261.6255653005986 Hz
API
pitch-fq 提供了多个方法,包括创建 pitch-tq 实例、计算音调频率等。
pitch(pitchName)
const pitchTq = pitch(pitchName);
创建 pitch-tq 实例,传入的参数 pitchName
表示音高名称,支持多种表示方式,如传统的西洋音高表示方式,MIDI 数字标记,中文传统音高表示方式等。
.name()
const pitchName = pitchTq.name();
返回音高名称,如果实例创建时传入了非法值,此方法将返回 undefined。
.midi()
const midiNum = pitchTq.midi();
返回 MIDI 数字标记,此标记用于在 MIDI 消息中表示音符音高。
.freq()
const pitchfq = pitchTq.freq();
返回音调频率。默认情况下,当前实例对象使用的音高标准是“标准中央 C = C4, 440 Hz”,即 A4 的频率为 440 Hz。实例化时也可以通过传入一个对象覆盖默认的音高标准:
const pitchTq = pitch('C4', { standard: 'XXX', tuningHz: 123 });
其中,standard
表示音高标准,tuningHz
表示调弦频率。
总结
使用 pitch-fq 可以方便地进行各种常见的音高和音调频率计算,支持多种音高标准表示方式,可以直接在项目中使用,为前端开发提供了方便和便利。但是,在实际使用中,需要注意参数传入的合法性和可能存在的错误情况。有了 pitch-fq 的帮助,我们可以更好地专注于前端领域的开发工作。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/5eef45e6efcef77a054b7564