Newshot

从 TuxGuitar 分叉出一个 17-EDO 谱面编辑器

Translation(model translation, not the source's own text)

将 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。
品012345678910131617193440
标记00.10.20.333.13.255.15.2799.31212.22424.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。

使用标记的位置:

PlaceNote
六线谱谱表,文本渲染器标签替换整数。连音音符保持 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):

pc012345678910111213141516
NameCDbC#DEbD#EFGbF#GAbG#ABbA#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 个降号。

pcDefaultSecond nameSecond name is in the key signature for
1DbB#7
5D#Fb14
8GbE#6, 7
15A#Cb13, 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 6428 35 42 49 55 627-7-7-6-7
D 标准38 43 48 53 57 6225 32 39 46 52 597-7-7-6-7
4 弦贝斯28 33 38 4311 18 25 327-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

The translation is machine-generated and individual terms may be off. Nothing is rewritten or cut; the original is authoritative.

Published by Hacker News
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗