将 TuxGuitar 分叉为 17-EDO 六线谱编辑器
2026年11月18日
TuxGuitar 17EDO 是 TuxGuitar 2.1.0 的一个分叉,面向八度等分为 17 份的吉他。原版 TuxGuitar 在六线谱、五线谱、指板和合成器中都假定每八度 12 个音。该分叉将这四个部分全部改为 17-EDO,且不提供 12-EDO 模式。本页详细描述这些改动,使编码代理无需分叉源码即可将其重新应用到原版检出上。
e |-----0------|
B |-----0.1----|
G |-----0------|
D |-----0.3----|
A |-----3------|
E |------------|
这是 C 大调(C E G C E)。文件中存储的原始品数为 0、1、0、3、4。
模型
歌曲模型或任何文件格式均无变化。音符仍然是整数品数,弦仍然是整数值。分叉将两者都重新解释为 17-EDO 步进:
- 演奏的 MIDI 键为弦值 + 品数,与原版相同。
- 键 k 的频率为 440 * 2^((k - 69) / 17) Hz。键 69 为 A4,键 56 为 C4,17 个键为一个八度。
- 由分叉保存的文件在原版 TuxGuitar 中打开时显示普通整数品数。不要为此修改读取器或写入器。
- 来自原版 TuxGuitar 或 Guitar Pro 的文件在打开时不会被转换。其数字被读取为步进,因此声音不正确。这是有意为之。
EDO 是一个常量,17。早期版本有一个 EDO 设置、启用标志和可配置的参考键。所有这些都已被移除。不要添加它们。
品标记
每个打印品数的地方都改为打印相对于点的标记。带有指板点的品用该点在 12-EDO 琴颈上的编号来标记。点之后的品为 <dot>.<k>,其中 k 是超过该点的步数。琴枕充当一个名为 0 的点。
默认点:对于 12-EDO 中的每个点 c(3、5、7、9、12、15、17、19、21、24),该点位于品 round(c * 17 / 12) 上,并命名为 c:
4:3, 7:5, 10:7, 13:9, 17:12, 21:15, 24:17, 27:19, 30:21, 34:24
格式化品 f:
- f < 0:普通整数。
- 否则取 dot.fret <= f 的最后一个点(如果没有则为琴枕),k = f - dot.fret。如果 k == 0 则返回点名,否则返回 name.k。
| 品 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 13 | 16 | 17 | 19 | 34 | 40 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 标记 | 0 | 0.1 | 0.2 | 0.3 | 3 | 3.1 | 3.2 | 5 | 5.1 | 5.2 | 7 | 9 | 9.3 | 12 | 12.2 | 24 | 24.6 |
点列表是唯一的设置。它是配置键 edo.labels.dots,默认为空,在 工具 > 设置 中一个标题为“Fret labels”的新页面上编辑,包含一个文本字段、一个“Reset to default”按钮以及品 0 到 19 的标记实时预览。
- 格式:以逗号、分号或空白分隔的 fret:name 对。名称为自由文本。
- 空字符串表示使用默认点。
- 没有冒号、一侧为空、品非数字或品 <= 0 的条目会被跳过,并在 stderr 上给出警告。
- 列表按品排序。当两个条目共享同一品时,第一个胜出,并给出警告。
- 保存时,存储规范化后的列表,如果字段为空则存储空字符串。
- 保存会经过现有的设置重载,因此打开的标签页会立即重绘。
使用点 5:A、2:B 时,品 3 为 B.1,品 35 为 A.30。
使用标记的位置:
| Place | Note |
|---|---|
| 六线谱谱表,文本渲染器 | 标签替换整数。连音音符保持 L ,闷音音符为 X ,幽灵音符在标签两侧加括号。 |
| 六线谱谱表,矢量数字渲染器 | 数字使用现有字形。点在基线上绘制为边长 0.18 size 的实心方块,与数字之间的间距相同,为 0.1 size 。 |
| 和弦图第一品数字 | 将预留空间加宽到 max(configured spacing, text width + spacing / 4) ,并在标签或宽度变化时丢弃缓存的图表图像。 |
| 和弦编辑器对话框 | 相同的标签。其品数上限从 24 提高到 99。 |
| 打印、PDF、PNG/JPG、SVG、ASCII 六线谱 | 相同的标签。 |
| 光标 | 在光标框旁边,当选中一个音符时,在背景色矩形上绘制 <raw> = <label> ,例如 19 = 12.2 。原始数字是用户输入的内容。 |
布局样式对象携带格式化器,默认为默认点。桌面端在一个函数中从配置构建它,该函数还会在应用程序上下文中发布格式化器。SVG 写入器、ASCII 写入器和无头 PDF 样式无法访问配置,从上下文中读取它,回退到默认值。否则,导出会忽略自定义点列表。
宽度。标准间距忽略品文本的宽度,因此标记为 24.4 的十六分音符会重叠。计算小节宽度时没有绘制器存在,因此宽度是估算的:每个字符为 0.9 音符字体高度 字体缩放,一个 . 是它的一半。音符通过钩子请求额外空间 max(0, estimate + 6 scale - duration width) ,钩子已经用于额外宽度,并与弯音宽度通过 max 组合。幽灵音符增加 6 scale 。连音和闷音音符不请求任何空间,当六线谱谱表隐藏时也不请求任何空间。在 0.8 时标签接触了。
Track > Properties 中的每轨最大品数微调器从 39 提高到 99。输入品数不变:一秒钟内的两个数字会合并,并限制在轨道的最大品数内。
音符名称与谱表
音高以 Superpyth 记谱法命名,即五度链。全音为 3 步,E-F 和 B-C 为 1 步,升号或降号为 2 步。C# 比 Db 高一步。
音级为 floorMod(key - 56, 17):
| pc | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Name | C | Db | C# | D | Eb | D# | E | F | Gb | F# | G | Ab | G# | A | Bb | A# | B |
- 自然音位于音级 0、3、6、7、10、13、16。
- 八度为 floorDiv(key - 56, 17) + 4。
- 谱表位置和八度映射回 56 + 17 * (octave - 4) + natural step。
- 有效键为 0 到 127。键 0 为 G#0。
四个音级有第二个名称。调号使用 TuxGuitar 的编码:0 为无,1 到 7 为升号,8 到 14 为 1 到 7 个降号。
| pc | Default | Second name | Second name is in the key signature for |
|---|---|---|---|
| 1 | Db | B# | 7 |
| 5 | D# | Fb | 14 |
| 8 | Gb | E# | 6, 7 |
| 15 | A# | Cb | 13, 14 |
当以下条件中恰好一个成立时,音符使用其第二个名称:调号包含它,或音符的“替代等音”标志已设置。该标志在其他 13 个音级上不起作用。B# 属于计算出的八度以下,Cb 属于计算出的八度以上。
当音符的变音与调号为其谱表位置给出的变音不同时,绘制临时记号。所有这些替换了为音符命名的那一个工具类的内部实现,同时保留其公共方法签名,因此乐谱渲染器、指板、矩阵编辑器、打印标题和调音对话框无需编辑即可跟随。其升号名称和降号名称函数返回相同的名称,因为升号和降号是不同的音高。
其他谱表更改:
- 点击谱表输入音符时,升号或降号会添加或减去 2 步,而标准版使用 1 步。
- Tools > Transpose 提供 -17 到 +17,并以步为单位标注。
文章标题:将 TuxGuitar 分叉为 17-EDO 谱面编辑器
正文:
- ASCII 导出使用同样的命名器来命名琴弦。
- 从音阶推测调号时仍保留私有的 12-EDO 表。音阶仍是 12-EDO 数据。
播放
音符编号保持不变,对合成器重新调音。每次通道更新结束时,播放器会:
- 为全部 128 个键发送 MIDI Tuning Standard 批量调音转储。
- 在每个非打击乐通道上,发送 RPN 0,3(调音程序选择),数据输入 MSB 为 0,然后重新选择 RPN 0,0,以便后续数据输入仍表示弯音范围。
该转储为 408 字节:
F0 7E 7F 08 01 00 <16-byte name> 128 x (xx yy zz) <checksum> F7
- 名称:17-EDO,用空格填充。
- 每个键:目标音高以 12-EDO 半音表示为 p = 69 + (k - 69) 12 / 17。xx = floor(p),yy zz 为 round((p - xx) 16384) 得到的 14 位值,高 7 位在前。如果小数部分舍入为 16384,则进位到 xx。
- 校验和:从 F0 之后到最后一个键字节的每个字节的 XOR,掩码为 7 位。
键 69 编码为 45 00 00。键 70 是半音 69,小数部分为 11565。键 52 恰好是半音 57,即 220 Hz。键 35 是 110 Hz。
原版没有 sysex 路径。为合成器和接收器接口添加一个默认无操作的 sendSysex(byte[]) 方法,并在三个端口中实现它:
| 端口 | 方式 |
|---|---|
| Java Sound (Gervill) | 将字节包装为 SysexMessage 并发送到接收器。 |
| TuxGuitar Synth, Gervill processor | 同上,转发到每个通道的处理器。 |
| FluidSynth | 新增 JNI 调用 fluid_synth_sysex ,传入载荷时去掉开头的 F0 和结尾的 F7 。 |
Java Sound 插件有两个端口类。用于 Synthesizer 设备的那个类通过 MidiChannel API 驱动合成器,而该 API 无法携带 sysex。它必须获取 Synthesizer.getReceiver() 并向那里发送。缓存该接收器,出错时丢弃。Gervill 端口就是这个类,因此只修补外部设备端口会让默认合成器停留在 12-EDO。
ALSA、JACK、WinMM、AudioUnit 及其他外部端口保持无操作。Android 共享该库,因此会显示 17-EDO 标签和名称,但播放时不调音。
调弦
将 12-EDO MIDI 音符转换为步值时,以 A4 为基准进行舍入,因此每根 A 弦都是精确的:
step = 69 + round((note - 69) * 17 / 12) clamped to 0..127
| 调弦 | 12-EDO | 步值 | 弦间 |
|---|---|---|---|
| E 标准,低到高 | 40 45 50 55 59 64 | 28 35 42 49 55 62 | 7-7-7-6-7 |
| D 标准 | 38 43 48 53 57 62 | 25 32 39 46 52 59 | 7-7-7-6-7 |
| 4 弦贝斯 | 28 33 38 43 | 11 18 25 32 | 7-7-7 |
新轨道仍从原版 12-EDO 默认值开始,然后再转换:每根弦转换为其步值,最大品数至少为 34。仅在非打击乐轨道上,在恰好以下事件之后运行该转换:
- 加载模板。模板文件保持原版。
- 添加轨道。
- 更改轨道的弦数,仅当弦数确实发生变化时。
- 将轨道从打击乐通道切换为旋律通道。
不要更改歌曲管理器的默认调弦常量。Guitar Pro 写入器也会使用它。
轨道 > 调弦:
- 每个内置预设都以转换后的形式提供。其标签、弦表以及“哪个预设匹配当前调弦”的检查都使用转换后的值。tunings.xml 保持原版。
- 用户自定义组中的预设按原始值存储和应用。
- 两个新按钮,“-1 step”和“+1 step”,移动所选弦,限制在 0..127。
- 如果最高弦加上轨道的最大品数超过 127,显示警告,说明能容纳多少品(127 - 最高弦)。它是对话框内的一个标签。从预设下拉框的选择事件打开的模态框冻结了 SWT 对话框。
- 单弦选择器按名称列出全部 128 个键并带八度,并有一个用于原始步值的微调器,标签为“Step value (17-EDO step, 69 = A4)”。
- 原版在这里有一个 bug,会破坏嵌套组中的预设匹配:递归组搜索在应传递其参数的地方传递了对话框的字段。
指板视图
- 绘制 34 个品,两个八度。
- 第 n 品位于 S * (1 - 2^(-n / 17)),其中 S 的选择使得最后一品落在右边缘。这取代了原版的近似线性间距。对于左手方向,进行镜像。
- 在 17 的倍数上使用双点。在格式化器的其他点品上使用单点。
- 点击命中测试已经基于品位置数组工作,无需更改。
编辑更改
这些与调音无关。
粘性时值。当光标落在某一拍上时,原版会将那一拍的时值复制到选定的时值中。分支版本仅在声部有音符时才复制。否则,输入十六分音符并步进到新小节时,选择会重置为全音符,因为新小节包含全休止符。
移动选择。在活动选择上按住 Ctrl 并用左键拖动,会移动选中的拍。
- 鼠标事件增加了一个 control-down 标志(在 SWT 工具包中为 SWT.MOD1,其他地方为 false)。
- 拖动时,光标跟随鼠标,选择保持不变。
- 释放时,如果鼠标确实拖动了,并且放置拍不是第一个选中的拍:存储选中的拍,清除它们(每个声部的音符、和弦、文本),使用与粘贴相同的例程将存储的拍写入放置拍的精确起始位置,重新选中它们,并将光标放在第一个上。
- 在打击乐和非打击乐轨道之间拒绝操作。
- 剪贴板不受影响。这是一个撤销步骤,带有整曲撤销。
重用粘贴代码路径,因为当目标超出末尾时,它已经会扩展歌曲。
对休止符和空小节执行 Del。当在每个轨道中,一个小节的所有拍都是休止符且没有文本和和弦时,该小节为空。
- 当光标在空小节中时,按 Del 会删除该小节。如果有选择,则选择触及的每个空小节都会被删除,剩余的拍则执行原版删除。
- 歌曲始终保留一个小节。
- 在其他地方,原版行为保持不变:删除休止符会将后续拍向左拉。
- 当小节被移除时,刷新整首歌曲,清除选择,并将光标限制在最后一个小节。
- 此操作的撤销变为整曲撤销。拍范围撤销无法恢复已移除的小节。
没有重复开始的重复结束。在原版播放中,如果在一个已完成的重复之后出现重复结束,且之间没有显式的重复开始,则会被忽略。修复:当重复结束时,将隐式重复开始设置为下一个小节(其索引和开始时间),并保持重复开始状态。
颤音拨弦三
- 在通道设置完成后发送调弦。转储和 RPN 放在通道更新的末尾,即在每个通道都配置好之后。
检查
- 单元:上方 0 到 40 品的标签表;Playback 下列出的转储字节;三行调弦。
- 往返:在分支中保存,在原版中打开,看到普通整数。
- 低音 E 弦在原始第 5 品后接第 4 品的 ASCII 导出会打印 3.1 然后 3。
- 通过耳朵或对渲染音频进行音高检测:空 A 弦为 110 和 220 Hz,低音 E 为 82.7 Hz。
已知限制
- 自然泛音、和弦图中的主音色彩以及导入文件中的和弦名称仍然假设为 12 个音。
- 同一小节同一谱表位置上的两个不同变音记号(先 C# 后 Cb)无法区分。
- LilyPond 和 MusicXML 导出不支持 17-EDO,因此它们未打包。
- 点列表是全局的,而不是每轨或每文件的。每轨设置需要新的文件属性。
- 仅测试了 SWT 桌面构建。
#java #microtonal #midi #spec #tuxguitar