Hexter 技术文档

本文档旨在帮助用户了解和使用 Hexter 项目，一款模拟雅马哈 DX7 合成器的软件合成器。以下是安装指南、使用说明以及项目 API 使用文档的详细内容。

1. 安装指南

Hexter 需要以下依赖：

• DSSI（版本 0.4 或更高）
• liblo（版本 0.12 或更高，推荐版本 0.23 或更高）
• pkgconfig，并正确设置 PKG_CONFIG_PATH
• GTK+（版本 2.4 或更高）
• LADSPA v1.x SDK
• ALSA 头文件（DSSI 插件使用 ALSA 结构，但不需要实际驱动程序安装）
• 非 ALSA 系统的用户可以使用 libdssialsacompat
• 一个工作的 DSSI 主机（如 DSSI 分发中的 jack-dssi-host 或 ghostess）

安装步骤如下：

1. 解压 tar 文件。
2. 确保正确设置 PKG_CONFIG_PATH 以定位 dssi.pc 和 liblo.pc pkgconfig 文件。
3. 进入包目录并执行 ./configure。
4. 根据需要，编辑 src/hexter.h 文件以启用调试信息。
5. 执行 make，希望它能够无警告（或错误）地构建。
6. 执行 make install 以安装相关文件。

2. 使用说明

运行

要在 DSSI 主机下运行 Hexter 插件，请按照以下步骤操作：

1. 启动 JACK。

2. 启动 jack-dssi-host，提供正确的插件路径和文件名：

   $ DSSI_PATH=<prefix>/lib/dssi sudo jack-dssi-host hexter.so
   

   jack-dssi-host 应该会启动，随后 Hexter 的图形用户界面应该会出现。

3. 使用 qjackctl 或 aconnect 将 jack-dssi-host 连接到 MIDI 源，如 vkeybd。

4. 开始演奏声音！如果没有响应，请尝试在 Hexter GUI 中点击“发送测试音符”按钮。

修补导入/导出

Hexter 支持多种格式的 DX7 修补银行文件导入：

• 标准 32 语音批量倾倒 sys-ex 格式
• 标准 单语音（编辑缓冲区）sys-ex 格式
• 原始打包修补数据
• 标准 MIDI 文件包含 sys-ex 消息
• 两个连接的 32 语音批量倾倒 sys-ex 消息
• Steinberg Synthworks 格式
• Transform XSyn 格式
• Voyetra SIDEMAN DX/TX 和 Patchmaster DX7 格式
• 雅马哈 DX200 编辑器格式

可以使用 GUI 中“文件”菜单的“导入修补银行...”选项来导入修补。导入后，还可以使用“文件”菜单的“导出修补银行...”选项导出修补。

3. 项目 API 使用文档

Hexter 项目作为 DSSI 插件运行，支持通过 MIDI 消息和 GUI 编辑器进行音色编辑。项目的 API 主要用于与 DSSI 主机和 MIDI 源进行通信，实现音色加载、保存和实时控制。

安装方式

Hexter 的安装方式已在“安装指南”一节中详细说明，主要通过源代码编译安装。

本文档提供了 Hexter 项目的详细技术指南，帮助用户顺利安装和使用该软件合成器。