HN 日本語サマリー

← 一覧へ戻る
プログラミング

TuxGuitarを17EDOタブエディタにフォークする

Forking TuxGuitar into a 17-EDO tab editor (frogwizard.bearblog.dev)

6 pointsby speckx6 コメント

要約

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 のフォーマット:

  1. f < 0: プレーンな整数。
  2. f == 0: 0。
  3. それ以外の場合は、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」というタイトルの「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) です。

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です。

4つのピッチクラスにはセカンドネームがあります。キーシグネチャはTuxGuitarのエンコーディングを使用します:0はなし、1から7はシャープ、8から14は1から7フラットです。

pcデフォルトセカンドネームセカンドネームがキーシグネチャに含まれるのは
1DbB#7
5D#Fb14
8GbE#6, 7
15A#Cb13, 14

ノートは、これらのうち1つだけが該当する場合にセカンドネームを使用します:キーシグネチャに含まれているか、ノートの「代替エンハーモニック」フラグが設定されている場合です。フラグは他の13のピッチクラスでは何も効果がありません。B#は計算されたオクターブより下のオクターブに属し、Cbは上のオクターブに属します。

アッチデンタルは、ノートの変更がスタッフ位置のキーシグネチャと異なる場合に描画されます。これらすべてが、音名を付ける1つのユーティリティクラスの内部を置き換えます。そのパブリックメソッドシグネチャは維持されるため、スコアレンダラー、フレットボード、マトリックスエディタ、プリントヘッダー、チューニングダイアログは編集なしで追従します。そのシャープ名とフラット名の関数は、シャープとフラットが異なるピッチであるため、同じ名前を返します。

その他のスタッフの変更点:

  • スタッフをクリックしてノートを入力する場合、標準が1を使用していた場所で、シャープまたはフラットのために2ステップを追加または減算します。
  • Tools > Transpose は -17 から +17 まで提供され、ステップでラベル付けされます。
  • ASCIIエクスポートは、同じネイマーで弦に名前を付けます。
  • スケールからキーシグネチャを推測する場合、プライベートな12EDOテーブルを保持します。スケールは依然として12EDOデータです。

再生

ノート番号はそのままにして、シンセサイザーを再チューニングします。各チャンネルの更新の最後にプレイヤーを呼び出します。

  1. すべての128キーのMIDIチューニングスタンダードバルクチューニングダンプを送信します。
  2. 各非パーカッションチャンネルで、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 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

新しいトラックは、標準の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キーを押しながら左ボタンでドラッグすると、選択されたビートが移動します。

  1. マウスイベントにコントロールダウンフラグ(SWTツールキットでは SWT.MOD1、それ以外では false)が追加されます。
  2. ドラッグ中、キャレットはマウスに追従し、選択範囲は維持されます。
  3. リリース時に、マウスが実際にドラッグし、ドロップビートが最初の選択ビートでない場合:選択されたビートを保存し、それらをクリアし(すべてのボイス、コード、テキストのノート)、ペーストが使用するのと同じルーチンでドロップビートの正確な開始位置に保存されたビートを書き込み、それらを再選択し、キャレットを最初のビートに配置します。
  4. パーカッショントラックと非パーカッショントラック間では拒否されます。
  5. クリップボードは変更されません。これは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デスクトップビルドのみがテストされました。

#java #microtonal #midi #spec #tuxguitar