Forte.js API:用JavaScript实现Allen Forte音乐理论

需积分: 9 0 下载量 189 浏览量 更新于2024-11-05 收藏 39KB ZIP 举报
资源摘要信息: "Forte.js是一个专门用于描述Allen Forte音乐理论的JavaScript API。Allen Forte理论主要应用于音级集合理论,该理论在音乐理论领域内尤其重要,特别是在分析和解释现代音乐作品方面。Forte.js将复杂的音乐理论转换为简洁的API,允许开发者直接在JavaScript环境中创建、操作和理解音级集合。" 知识点详细说明: 1. 音高等级(PitchClass):在Forte.js中,音高等级(PC)是描述音乐中音符属性的基本单位,可以视为由12个等距的音级构成的一个循环。Allen Forte的理论将音级集合定义为不同音高等级的组合,这些组合在音高上形成特定的关系。在API中,可以通过`withInt(intValue)`方法创建音高等级实例,其中`intValue`参数是一个0到11的整数,代表不同的音高等级。 2. `toString()`方法:该方法用于将音高等级实例转换为字符串表示。如果不指定参数,返回的是一个简明的数字形式,如例子中的'7'。如果指定参数,可以按照不同的音乐记谱系统来表示,例如'latin'表示拉丁音名,'american'表示美国音名。这些参数能够输出不同音乐文化和传统的音名,比如例子中的'Sol'和'g'。 3. `getIntValue()`方法:此方法返回音高等级的整数值,对应的代码为`pc.getIntValue();`,在给定的例子中返回值为7。 4. 音高班组(PitchClassSet):这是Forte.js中用于表示一组音高等级的集合。通过`withArray([integers])`方法可以创建一个新的音高班组实例,数组中的整数代表音高等级。音高班组提供了一系列方法来获取其主要形式和素数反转形式。 5. 主要形式(Prime Form):在音乐理论中,音高班组的主要形式是将音高等级序列转换成标准形式,这个过程涉及对序列进行变换,以达到一系列预定义的规则。在Forte.js中,`getPrimeForm()`方法返回该音高班组的主要形式。 6. 素数反转(Prime Inversion):这与主要形式相关,是一个将音高班组中的音高等级序列按照某个音高等级的中心进行对称反转的过程。在Forte.js中,`getPrimeInversion()`方法返回音高班组的素数反转形式。 API的版本号为0.0.4,表明其尚处于开发的初期阶段,随着版本的更新,可能会增加更多的功能和对Forte理论更深入的实现。 在文件名列表中提到的"forte.js-master"表明这是Forte.js项目的主分支或源代码所在,意味着开发正在积极进行中,用户可以期待后续版本会带来新的特性和改进。 总结来说,Forte.js是一个基于JavaScript的应用程序接口,它提供了一套工具和方法来描述和操作Allen Forte的音乐理论,使得开发者可以在Web应用程序中实现音乐理论的处理,特别是在处理音级集合分析方面。通过这个API,开发者无需深入理解复杂的音乐理论就能在应用中实现对音级集合的创建、操作和分析等功能。