Audiveris技术文档

Audiveris技术文档

audiveris audiveris - 一个开源的光学音乐识别(OMR)应用程序，用于将乐谱图像转录为其符号对应物，支持多种数字处理方式。 项目地址: https://gitcode.com/gh_mirrors/au/audiveris

Audiveris是一款开源的光学音乐识别（OMR）应用，旨在将乐谱图像转换为符号表示形式，进而支持播放、编辑等后续数字处理。本文档将详细介绍安装步骤、使用方法、API概览以及安装方式，以帮助用户深入了解并高效地利用Audiveris。

安装指南

稳定版本安装

Windows

1. 访问Audiveris Releases页面下载最新安装程序。
2. 安装过程中，确保您的系统已安装Java 17或更高版本。若未安装，安装器会提示您安装。
3. 该安装包预置了OCR语言：德语(deu)、英语(eng)、法语(fra)、意大利语(ita)。

Linux

1. 通过Flathub安装Audiveris。这不需要额外安装Java，因为所需环境已包含在内。
2. 搜索应用并安装org.audiveris.audiveris。

MacOS

目前没有提供直接的MacOS安装包，您需要从源代码编译（参见开发版本部分）。

开发版本编译与安装

1. 确保拥有git、Gradle以及对应版本的Java JDK（主分支需要Java 17+，开发分支可能要求Java 21+）。
2. 克隆Audiveris仓库：

   git clone https://github.com/Audiveris/audiveris.git
   

3. 切换到合适分支并构建：
   • 主分支：适用于稳定的测试；
   • 开发分支：获取最新的功能和改进。

   cd audiveris
   gradle build
   

4. 根据构建指示运行应用程序。

项目的使用说明

1. 启动: 运行Audiveris后，导入你想转换的乐谱图像文件。
2. 设置: 根据需要调整OMR引擎的预处理选项来优化识别结果。
3. 转录: 启动转录过程，Audiveris将尝试自动识别乐谱中的元素。
4. 校正: 查看识别结果，手动修正错误的音符、符号等，利用编辑工具提高准确性。
5. 导出: 成功校正后，可将其导出为MusicXML或其他支持的格式，以便于进一步编辑或播放。

项目API使用文档

Audiveris的核心信息以XML的.omr文件存储，并可通过Java API访问。开发者可以通过以下步骤集成Audiveris的API：

1. 引入Audiveris的库依赖至你的Java项目中。
2. 使用API进行OMR数据的操作，例如读取.omr文件，访问音乐符号信息，甚至修改后重新生成。
3. 查阅Audiveris手册中的开发者章节，了解详细接口和示例代码。

项目安装方式

• 对于终端用户，推荐直接安装稳定版本，通过上述提供的链接按操作系统选择相应安装途径。
• 开发者和希望使用最新功能的用户，则建议通过克隆仓库并按照开发版本的指导进行编译安装。

请随时参考Audiveris手册和GitHub Wiki获得更详尽的信息和支持。

audiveris audiveris - 一个开源的光学音乐识别(OMR)应用程序，用于将乐谱图像转录为其符号对应物，支持多种数字处理方式。 项目地址: https://gitcode.com/gh_mirrors/au/audiveris