TuxGuitarを17EDOタブエディタにフォークする
Forking TuxGuitar into a 17-EDO tab editor (frogwizard.bearblog.dev)
要約
TuxGuitar 2.1.0を17平均律(17-EDO)に対応させるためにフォークしたプロジェクトについて解説しています。このフォークは、標準の12平均律ではなく、17平均律を前提としてタブ譜、五線譜、フレットボード、シンセサイザーのすべてを変更しています。モデル、フレットラベル、音名、スタッフ表記、再生機能、チューニング、フレットボード表示、編集機能など、多岐にわたる変更点が詳細に説明されています。
全文翻訳
TuxGuitarを17EDOタブエディタにフォークする
2026年11月18日
TuxGuitar 17EDO は、TuxGuitar 2.1.0 を、1オクターブを17等分するギター向けにフォークしたものです。標準のTuxGuitarは、タブ譜、五線譜、フレットボード、シンセサイザーのすべてで1オクターブあたり12音を前提としています。このフォークは、これら4つすべてを17EDOに変更し、12EDOモードは持っていません。このページでは、コーディングエージェントがフォークのソースなしで標準のチェックアウトに適用できる程度に詳細な変更点を説明します。
e |-----0------|
B |-----0.1----|
G |-----0------|
D |-----0.3----|
A |-----3------|
E |------------|
これはCメジャー(C E G C E)です。ファイルに保存されている生のフレット値は 0、1、0、3、4 です。
モデル
楽曲モデルやファイルフォーマットに変更はありません。音符は依然として整数フレットであり、弦は整数値です。フォークはこの両方を17EDOステップとして再解釈します。
- 再生されるMIDIキーは、標準と同様に
string value + fretです。 - キー
kは440 * 2^((k - 69) / 17)Hz で鳴ります。キー69はA4、キー56はC4、17キーで1オクターブです。 - フォークによって保存されたファイルは、標準のTuxGuitarで開くとプレーンな整数フレットが表示されます。これのためにリーダーやライターを変更しないでください。
- 標準のTuxGuitarやGuitar Proのファイルは、開いたときに変換されません。それらの数値はステップとして読み取られ、間違った音で鳴ります。これは意図的です。
EDOは定数17です。以前のバージョンにはEDO設定、イネーブルフラグ、設定可能な基準キーがありましたが、すべて削除されました。それらを追加しないでください。
フレットラベル
フレット番号を表示するすべての場所で、ドット相対ラベルが表示されます。フレットボードのドットがあるフレットは、12EDOネック上のそのドットの名前でラベル付けされます。ドットより先のフレットは <dot>.<k> となり、k はそのドットからのステップ数です。ナットは 0 という名前のドットとして機能します。
デフォルトのドット:3、5、7、9、12、15、17、19、21、24の各12EDOドット c について、ドットはフレット 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: プレーンな整数。f == 0: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」というタイトルの「Tools > Settings」で編集され、テキストフィールド、リセットボタン、0から19フレットまでのライブプレビューが含まれます。
- フォーマット:
fret:nameのペアをカンマ、セミコロン、または空白で区切ります。名前は自由テキストです。 - 空文字列はデフォルトのドットを意味します。
- コロンがないエントリ、片側が空のエントリ、数値でないフレット、またはフレットが
<= 0のエントリは、stderrに警告を出してスキップされます。 - リストはフレットでソートされます。2つのエントリが同じフレットを共有する場合、最初のエントリが優先され、警告が表示されます。
- 保存時に、正規化されたリスト、またはフィールドが空白だった場合は空文字列を保存します。
- 保存は既存の設定リロードを経由するため、開いているタブはすぐに再描画されます。
ドットが 5:A, 2:B の場合、フレット3は B.1、フレット35は A.30 となります。
ラベルが使用される場所:
| 場所 | 注記 |
|---|---|
| タブ譜、テキストレンダラー | ラベルが整数を置き換えます。タイノートは L、デッドノートは X、ゴーストノートはラベルを括弧で囲みます。 |
| タブ譜、ベクター描画レンダラー | 数字は既存のグリフを使用します。ドットはベースライン上の 0.18 * size の正方形で、数字間の 0.1 * size のギャップと同じです。 |
| コードダイアグラムの最初のフレット番号 | 予約スペースを max(設定されたスペーシング, テキスト幅 + スペーシング / 4) に広げ、ラベルまたは幅が変更されたときにキャッシュされたダイアグラム画像を破棄します。 |
| コードエディタダイアログ | 同じラベル。フレット制限が24から99に増加します。 |
| 印刷、PDF、PNG/JPG、SVG、ASCIIタブ | 同じラベル。 |
| キャレット | キャレットボックスの隣に、ノートが選択されている場合、<raw> = <label> を背景色付きの長方形に描画します。例: 19 = 12.2。生の数字はユーザーが入力するものです。 |
レイアウトスタイルオブジェクトはフォーマッターを保持し、デフォルトでデフォルトのドットになります。デスクトップビルドは1つの関数で設定から構築し、その関数はアプリケーションコンテキストにフォーマッターを公開します。SVGライター、ASCIIライター、ヘッドレスPDFスタイルは設定にアクセスできず、コンテキストから読み込み、デフォルトにフォールバックします。これがないと、エクスポートはカスタムドットリストを無視します。
幅。 標準のスペーシングはフレットテキストの幅を無視するため、16分音符に 24.4 とラベル付けすると重なります。測定幅が計算されている間はペインターが存在しないため、幅は推定されます。各文字は 0.9 * note font height * font scale、. はその半分です。ノートは、フックがすでに余分な幅に使用している max(0, estimate + 6 * scale - duration width) の余分なスペースを要求し、ベンド幅と max で結合されます。ゴーストノートは 6 * scale を追加します。タイノートとデッドノートは何も要求せず、タブ譜が非表示の場合は何も要求されません。0.8でラベルが接触しました。
トラックごとの最大フレットスピナー(Track > Properties)は39から99になります。フレットの入力は変更されません。2桁は1秒以内に結合され、トラックの最大フレットにクランプされます。
音名とスタッフ
音高はSuperpy notationで命名され、五度連鎖です。全音は3ステップ、E-FとB-Cは1ステップ、シャープまたはフラットは2ステップです。C#はDbより1ステップ上です。
ピッチクラスは 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です。
4つのピッチクラスにはセカンドネームがあります。キーシグネチャはTuxGuitarのエンコーディングを使用します:0はなし、1から7はシャープ、8から14は1から7フラットです。
| pc | デフォルト | セカンドネーム | セカンドネームがキーシグネチャに含まれるのは |
|---|---|---|---|
| 1 | Db | B# | 7 |
| 5 | D# | Fb | 14 |
| 8 | Gb | E# | 6, 7 |
| 15 | A# | Cb | 13, 14 |
ノートは、これらのうち1つだけが該当する場合にセカンドネームを使用します:キーシグネチャに含まれているか、ノートの「代替エンハーモニック」フラグが設定されている場合です。フラグは他の13のピッチクラスでは何も効果がありません。B#は計算されたオクターブより下のオクターブに属し、Cbは上のオクターブに属します。
アッチデンタルは、ノートの変更がスタッフ位置のキーシグネチャと異なる場合に描画されます。これらすべてが、音名を付ける1つのユーティリティクラスの内部を置き換えます。そのパブリックメソッドシグネチャは維持されるため、スコアレンダラー、フレットボード、マトリックスエディタ、プリントヘッダー、チューニングダイアログは編集なしで追従します。そのシャープ名とフラット名の関数は、シャープとフラットが異なるピッチであるため、同じ名前を返します。
その他のスタッフの変更点:
- スタッフをクリックしてノートを入力する場合、標準が1を使用していた場所で、シャープまたはフラットのために2ステップを追加または減算します。
- Tools > Transpose は -17 から +17 まで提供され、ステップでラベル付けされます。
- ASCIIエクスポートは、同じネイマーで弦に名前を付けます。
- スケールからキーシグネチャを推測する場合、プライベートな12EDOテーブルを保持します。スケールは依然として12EDOデータです。
再生
ノート番号はそのままにして、シンセサイザーを再チューニングします。各チャンネルの更新の最後にプレイヤーを呼び出します。
- すべての128キーのMIDIチューニングスタンダードバルクチューニングダンプを送信します。
- 各非パーカッションチャンネルで、RPN 0,3(チューニングプログラム選択)をデータエントリーMSB 0で送信し、その後RPN 0,0を再選択して、後続のデータエントリーがピッチベンドレンジを意味するようにします。
ダンプは408バイトです。
F0 7E 7F 08 01 00 <16バイトの名前> 128 x (xx yy zz) <チェックサム> F7
- 名前:スペースでパディングされた
17-EDO。 - 各キー:ターゲットピッチ(12EDOセミトーン)は
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パスがありません。シンセサイザーとレシーバーインターフェースにデフォルトで no-op の sendSysex(byte[]) メソッドを追加し、3つのポートで実装します。
| ポート | 方法 |
|---|---|
| Java Sound (Gervill) | バイトを SysexMessage でラップし、レシーバーに送信します。 |
| TuxGuitar Synth, Gervill processor | 同様に、各チャンネルのプロセッサーに転送します。 |
| FluidSynth | 新しいJNI呼び出し fluid_synth_sysex を使用し、ペイロードを先頭の F0 と末尾の F7 なしで渡します。 |
Java Soundプラグインには2つのポートクラスがあります。Synthesizer デバイス用のものは MidiChannel API を介してシンセを駆動しますが、これはSYSEXを運ぶことができません。Synthesizer.getReceiver() を取得してそこに送信する必要があります。レシーバーをキャッシュし、エラー時に破棄します。Gervillポートはこのクラスであるため、外部デバイスポートのみをパッチすると、デフォルトシンセは12EDOのままになります。
ALSA、JACK、WinMM、AudioUnitなどの外部ポートは no-op のままです。Androidはライブラリを共有するため、17EDOラベルと名前が表示されますが、チューニングはされません。
チューニング
12EDO MIDIノートをステップ値に変換する際は、A4を基準に丸められるため、すべてのA弦が正確になります。
step = 69 + round((note - 69) * 17 / 12) clamped to 0..127
| チューニング | 12EDO | ステップ | 弦間の音程 |
|---|---|---|---|
| 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 |
新しいトラックは、標準の12EDOデフォルトから開始され、その後変換されます。各弦はステップ値に、最大フレットは少なくとも34に設定されます。この変換は、非パーカッショントラックでのみ、以下のイベントの直後に実行されます。
- File > New。
- テンプレートの読み込み。テンプレートファイルは標準のままです。
- トラックの追加。
- トラックの弦数を変更した場合のみ、実際に変更された場合。
- トラックをパーカッションチャンネルからメロディックチャンネルに切り替えた場合。
ソングマネージャーのデフォルトチューニング定数は変更しないでください。Guitar Proライターもそれを使用します。
Track > Tuning:
- すべての組み込みプリセットは変換されて提供されます。そのラベル、弦テーブル、「現在のチューニングに一致するプリセット」チェックはすべて変換された値を使用します。
tunings.xmlは標準のままです。 - ユーザーのカスタムグループのプリセットは、生のまま保存および適用されます。
- 2つの新しいボタン、「-1 step」と「+1 step」は、選択された弦を0から127の範囲で移動させます。
- 最上位の弦にトラックの最大フレットを加えた値が127を超える場合、何フレットまで収まるかを示す警告が表示されます(
127 - highest)。これはダイアログ内のラベルです。プリセットドロップダウンの選択イベントから開かれたモーダルダイアログは、SWTダイアログをフリーズさせました。 - シングルストリングセレクターは、オクターブ付きのすべての128キーを名前でリストし、生のステップ値用のスピナー(「Step value (17-EDO step, 69 = A4)」とラベル付け)を備えています。
- 標準にはここにバグがあり、ネストされたグループでのプリセットマッチングが壊れています。再帰的なグループ検索は、パラメータを渡すべきところにダイアログのフィールドを渡してしまいます。
フレットボードビュー
- 34フレット、2オクターブを描画します。
- フレット
nはS * (1 - 2^(-n / 17))に配置され、Sは最後のフレットが右端に収まるように選択されます。これは標準の線形に近いスペーシングに取って代わります。左利き方向のためにミラーリングします。 - 17の倍数にはダブルドット、フォーマッターの他のドットフレットにはシングルドット。
- クリック時のヒットテストは、フレット位置配列からすでに機能しており、変更は不要です。
編集の変更点
これらはチューニングとは無関係です。
スティッキーデュレーション。 キャレットがビートに着地すると、標準はそのビートのデュレーションを選択されたデュレーションにコピーします。フォークは、ボイスにノートがある場合のみコピーします。それ以外の場合、16分音符を入力して新しい小節に入ると、新しい小節には全休符が含まれるため、選択は全音符にリセットされます。
選択範囲の移動。 アクティブな選択範囲上でCtrlキーを押しながら左ボタンでドラッグすると、選択されたビートが移動します。
- マウスイベントにコントロールダウンフラグ(SWTツールキットでは
SWT.MOD1、それ以外では false)が追加されます。 - ドラッグ中、キャレットはマウスに追従し、選択範囲は維持されます。
- リリース時に、マウスが実際にドラッグし、ドロップビートが最初の選択ビートでない場合:選択されたビートを保存し、それらをクリアし(すべてのボイス、コード、テキストのノート)、ペーストが使用するのと同じルーチンでドロップビートの正確な開始位置に保存されたビートを書き込み、それらを再選択し、キャレットを最初のビートに配置します。
- パーカッショントラックと非パーカッショントラック間では拒否されます。
- クリップボードは変更されません。これは1つのアンドゥステップであり、曲全体のアンドゥです。
宛先が終端を超えて実行する場合にすでに曲を拡張しているため、ペーストコードパスを再利用します。
休符と空の小節でのDelキー。 小節が空であるとは、すべてのトラックで、その小節のすべてのビートがテキストもコードもない休符である場合です。
- 空の小節でキャレットが空の小節にある状態でDelキーを押すと、小節が削除されます。選択範囲がある場合、選択範囲が触れるすべての空の小節が削除され、残りのビートは標準の削除処理を受けます。
- 曲は常に1つの小節を保持します。
- それ以外では、標準の動作は維持されます。休符を削除すると、後続のビートが左に引き寄せられます。
- 小節が削除された場合、曲全体をリフレッシュし、選択範囲をクリアし、キャレットを最後の小節にクランプします。
このアクションのアンドゥは、曲全体のアンドゥになります。ビート範囲のアンドゥでは、削除された小節を復元できません。
リピートオープンなしのリピートクローズ。 標準の再生では、明示的なリピートオープンがない、完了したリピートの後に続くリピートクローズは無視されます。修正:リピートが終了したときに、次の小節(そのインデックスと開始時間)を暗黙のリピート開始として設定し、リピートオープン状態を維持します。
トレモロピッキングトリプレット。 トレモロピッキングダイアログに、エフェクトデュレーションの分割を3:2に設定するトリプレットチェックボックスが追加されます。
- スタッフでは、3という数字がトレモロスラッシュの隣に描画されます。
.tgファイルでは、トレモロピッキング要素のオプションの子として、通常でない場合にのみ書き込まれます:<divisionType enters="3" times="2"/>。それがないファイルは以前と同じように読み込まれます。- 16分音符トリプレットのトレモロは、4分音符の6分の1の長さになります。
削除されたもの
標準のこれらのツールは12音しか認識せず、非表示になっています。それらのアクションは登録されたままで、ソースはツリーに残ります。
| ツール | から削除 |
|---|---|
| コードエディタ | コードメニュー項目、編集ツールバーボタン、メインツールバーアイテムマップ。保存されたカスタムコードは、コードメニューから引き続き挿入できます。 |
| スケールツール | ツールメニュー、フレットボードのスケールボタン、名前ラベル、スケールオーバーレイ。 |
| ピアノビュー | 表示メニュー、メインツールバーアイテムマップ。 |
| チューナー、LilyPond、MusicXMLプラグイン | すべてのデスクトップビルドスクリプトのモジュールとアーティファクトリスト。 |
アプリケーション名は TuxGuitar 17EDO で、アプリ名定数とmacOSのバンドル名に含まれます。
静かに壊れるもの
java.util.loggingがない。 macOSバンドルはjlink --add-modules java.desktopで作成されたJREを同梱しており、java.loggingモジュールがありません。それをインポートしたライブラリクラスは、スプラッシュスクリーンでアプリをハングさせました。警告はSystem.errに出力されます。- ラベルが収まる場合、追加の幅はゼロである必要があります。 そうでないと、すべての小節が標準と比較して再フローします。
- チャンネルがセットアップされた後にチューニングを送信する。 ダンプとRPNは、各チャンネルが設定された後、チャンネル更新の最後に送信されます。
チェック
- 単体テスト:上記のフレット0から40までのラベルテーブル。再生の下にリストされたダンプバイト。3つのチューニング行。
- ラウンドトリップ:フォークで保存し、標準で開いて、プレーンな整数を確認します。
- 低音E弦のフレット5の後にフレット4のASCIIエクスポートは、
3.1、次に3と表示されます。 - 音で、またはレンダリングされたオーディオのピッチ検出で:A弦を110Hzと220Hzで、低音E弦を82.7Hzで開きます。
既知の制限
- ナチュラルハーモニクス、コードダイアグラムのトニックカラー、インポートされたファイルからのコード名は、依然として12音を前提としています。
- 1つの小節内で、1つのスタッフ位置に2つの異なるアッチデンタル(C#、次にCb)がある場合、区別されません。
- LilyPondおよびMusicXMLエクスポートには17EDOサポートがないため、パッケージ化されていません。
- ドットリストはグローバルであり、トラックごとまたはファイルごとではありません。トラックごとの設定には新しいファイル属性が必要です。
- SWTデスクトップビルドのみがテストされました。