セルのコストなしでターミナル境界線を実現する
Terminal borders that don't cost a cell (joshka.net)
要約
この記事では、従来のUnicodeボックス描画文字が画面スペースを消費するという問題に対処するため、セルの端に細い線を描画する新しいターミナルプロトコルについて解説しています。このプロトコルにより、行や列を犠牲にすることなく、境界線、メニュー、ウィジェットなどをより効率的かつ美しく表示できるようになります。実装例や既存技術との比較、プロトコルの詳細についても触れられています。
全文翻訳
セルのコストなしでターミナル境界線を実現する
この記事(およびその背後にあるコード)は、AIの多大な助けを借りて執筆されました。そのことについて謝罪するつもりはありません。もしそれが気になるなら、タブを閉じていただいて構いません。
私はRatatuiをメンテナンスしているので、人々が構築する多くのTUIを目にします。その多くは、どこか似たり寄ったりな見た目になりがちです。つまり、退屈な背景にプレーンなボックスがあり、他のメディアにおける優れたデザインが私たちにもたらす多くの要素が欠けているのです。
境界線も問題の一部です。それらはスペースを占有する必要があるため、人々が構築したいパネルの一部となります。一つの選択肢はそれらを削除して色だけを使用することですが、境界線は物事を区切り、囲むのに非常に役立ちます。ターミナルで境界線を得る方法はたくさんありますが、100%良いものはありません。私は手作業で十分な┌──┐を描いてきたので、この件については意見があります。
通常の手段は、線、角、結合のために128文字を持つUnicodeボックス描画ブロックです。それでも十分ではありません。
[画像: GhosttyでレンダリングされたUnicodeボックス描画ブロック、U+2500からU+257F]
そこで私は、代わりにセルの端に細い線を描画するターミナルプロトコルに取り組んできました。これはGhosttyのパッチ(およびその前のRioでの初期バージョン)として機能しており、Ratatuiでデモアプリを構築しました。ターミナルおよびTUIの作者からのフィードバックを求めています。
[画像: ペイン、タブ、フォームフィールド、ボタンの境界線としてセルの境界線を使用した、Ratatuiで構築されたタイリングウィンドウマネージャーのデモ]
このスクリーンショットのすべての線はセルの境界線です。どれも行または列を消費しません。タブラベルは各ペインの上端に配置され、テキストフィールドはテキストのすぐ下の線にアンダーラインが引かれ、ボタンは1行の高さで丸みを帯びています。
以下は、ボックス描画文字にフォールバックする、セルの境界線がないターミナルでの同じアプリです。
各ペインは、すべての側で1行と1列を失うため、ログペインは2行少なく表示され、メモの折り返しも異なります。タブラベルはフレームの内側に移動します。テキストフィールドは代わりにアンダーライン属性を使用し、チェックボックスとボタンは角括弧に変わります。
私がこれを使うであろう用途
- 明らかに境界線。すべての側で1行と1列を消費しないペインとパネル。
- 他のコンテンツの上に配置され、依然として上に配置されているように見えるメニューとポップアップ。
- レイアウトがそれぞれエッジを必要とする領域のセットであるパネルスタイルのアプリ。
- テキストフィールド、ボタン、チェックボックスなどのウィジェット。これらはテキストのすぐ隣に線が必要です。
- 全般的に物事をよりきれいに見せるため。パネルの背景の外縁にある境界線ははるかにきれいに見え、テキストはそのすぐ近くまで実行できます。
クローズアップ
設定フォーム。セルの境界線を使用した場合と、ボックス描画のフォールバックを使用した場合です。
[画像: セルの境界線で描画された、アンダーライン付きテキストフィールド、チェックボックス、丸みを帯びたボタンを備えたフォーム]
[画像: アンダーライン属性と角括弧付きボタンを使用した同じフォーム]
タブも同様です。セルの境界線を使用すると、ペインの上端に配置されます。ボックス文字を使用すると、フレーム内に独自の行が必要になります。
[画像: セルの境界線でペインの上端に描画されたペインタブ]
チャート
セル間の線はチャートにも機能します。btopスタイルのブライユグラフはすべてのセルをドットで埋めるため、行を1つ犠牲にすることなくグリッド線や平均線を入れる場所がありません。セルの境界線を使用すると、それらはドット間のセルの端に配置されます。これはRatatuiで構築された、そのスタイルのモニターです。
[画像: セルの端に描画されたグリッド線と平均線を持つブライユCPUグラフ]
そしてフォールバック。グリッド線を省略する必要があります。
動作中の様子
ここでは、タイリングペインのデモがペインを移動させ、メニューとダイアログを開いています。
[画像: ペインがドラッグ、分割、再タイリングされ、メニューとダイアログが表示されるアニメーション]
途中で、セルの市松模様をオンにします。これにより、すべてがグリッドにどのように整列しているかがわかります。ここで切り替えます。
セルのグリッドを表示 [画像: セルの境界線で描画された2つのペイン] [画像: 代替セルがシェーディングされた同じペイン。境界線がセルの端にあることがわかります]
ボックス文字ができないこと
根本的な問題は、ボックス描画文字がテキストであるということです。各線は1つのセル全体を占めるグリフであり、それに関する厄介なことのほとんどはそこから生じます。
スペースは明白な問題です。私が読めるフォントで16インチラップトップを使用している場合、ターミナルは約200x50(設定によって多少変動します)です。列はこのサイズではほとんど問題ありません。行はそうではありません。数レベルのネストされたパネルを持つレイアウトでは、線のためだけに50行のうち6行または8行を簡単に費やすことができます。装飾のために画面をそれだけ譲るのは大きなことです。
また、両方に何かがある2つのセルの間に線を入れることはできません。そのため、テキストフィールドをそのすぐ下でアンダーラインしたり、ボタンをアウトラインしたりすることは、周囲にパディングを追加しない限り不可能です。丸い角は機能しますが、角のグリフは1つの背景色を持ち、パネルの背景が周囲と異なる場合、各角に間違った色の小さな四角が表示されます。そして、線自体はフォントが決定するものであり、太さや位置も含まれます。
次にコピー&ペーストです。ボックス内のテキストを選択すると、ボックスも一緒に取得されます。SlackにTUIから貼り付けたことがある人なら誰でも、あの小さな│のクリーンアップダンスを知っています。時にはボックスが必要な場合もあります(たとえば、チャットにテーブルを貼り付ける場合)が、ほとんどの場合は不要なものです。セルの境界線はテキストではないため、コピーされることはありません。これは両方の側面があります。
仕組み
セルの境界線は、背景色のようなセルの属性です。各セルは最大12本の線分を保持できます。つまり、4つのエッジそれぞれの半分と、中心からの4つのアームです。各セグメントには独自の色、幅、配置、スタイルがあり、ターミナルはそれらをセルグリッド上に描画します。境界線はセル内に格納されるため、テキストと一緒にスクロール、消去、挿入、リフローされます。消去またはスクロール時に何が起こるかについては、色の場合と同じようにすでに答えがあります。
エッジは半分に分割されているため、境界線は象限ブロック文字(▖▗▘▝など)と整列します。これにより、グリッドから半セル内にある形状を描画し、その周りにきれいな境界線を配置することが容易になります。はい、それでも塗りつぶしには文字を使用しており、その部分にはより良い方法があるかもしれません。一度に一つの問題です。
同じアイデアは、デザインが必要とする場合に、六分円や八分円、または四分の一幅や八分の一幅に拡張できます。
スタイルと結合
[画像: 実線、二重線、破線、点線、丸い角、フォーク、結合を示すギャラリースクリプト]
[画像: 外側の塗りつぶし色ありとなしの丸いパネル。最初のものには、角に四角い背景パッチがあります]
線は実線、二重線、破線、点線にすることができます。各角とセルの中心は、設定可能な半径とアンチエイリアス処理されたアークを持つ、四角形または丸形にすることができます。丸い角は外側の色を指定できるため、パネルの背景が背後のものと異なる場合に、アークの外側の領域が正しくペイントされます。
隣接する2つのセルが共有エッジに線を描画すると、それらは1本の線にマージされます。優先度が高いストロークが勝ち、次に幅が広いものが勝ち、次に右または下のものが勝ちます。これにより、フォーカスされたペインは、隣接するペインが描画された順序に関係なく、そのアウトライン全体を維持するために優先度を上げることができます。私の最初の試みは「右/下は常に勝つ」でしたが、フォーカスされたペインが隣接するペインにアウトラインの半分を失うまで続きました。
ワイヤーフォーマット
すべては、名前空間を持つ1つのDCS文字列です。
ESC P 1 + b cell-border ; OP ; FIELDS... ESC \
一般的なパスはペンであり、現在の背景色のようにカーソルに保持されます。それを設定し、テキストを印刷すると、印刷されたセルに境界線が適用されます。
ESC P 1 + b cell-border;pen;48;32;7aa2f7;0;0 ESC \ 下端、青: アンダーライン
hello
ESC [ 0 m SGR 0 はペンをクリアします
ペンに触れることなく既存のセルに境界線を設定またはクリアする長方形コマンドや、機能クエリもあります。アプリはクエリの後にDA1を送信します。DA1応答がcell-border応答なしで到着した場合、ターミナルはそれをサポートしていないため、アプリはボックス文字にフォールバックし、それらが必要とするスペースを予約します。DCSを理解しないターミナルは、未知のDCSと同様にそれを無視します。
ターミナルに必要な最小限のものは、ペン、長方形コマンド、および実線ストロークです。私は最初のカットを小さく保つように努めました。なぜなら、常に「...そしてこれ」というものが追加されるものであり、それは滑りやすい坂道だからです。
線のスタイル、丸い結合、優先度、外側の色は、機能応答にリストされた拡張フィールドであり、未知のフィールドは無視されるため、後で追加できます。初期の決定は可能な限り双方向のドアであってほしいです。
仕様ではバージョン1(DCS 1 + bの1)と呼んでいます。これは古い意味でのv1であり、semverにすべてが巻き込まれる前です。完了または安定しているという意味ではありません。私が書き留めることをいとわなかった最初のものであるという意味です。v0.1、ドラフト、またはあなたが好むものとして読んでください。
先行事例
これの一部は以前に行われています。
- DEC ruled lines: DECterm(DA1応答の拡張43)では、長方形の周りに線を描画します。それらはテキストと一緒にスクロールしますが、別レイヤーです。画面をクリアしてもそれらは残ります。そして、それらは常に通常のテキストカラーで1ピクセル幅です。
- SGR 51から65: フレーム、円、オーバーライン、および表意文字のサイドライン。一部のターミナルはそれらで境界線を描画しますが、それらはオン/オフ属性であり、色、幅、結合はなく、下端の属性もありません。
- Win32コンソールには、セルごとのグリッドフラグ(上、左、右エッジ用)があります。PDCursesおよびX/Open curses(
WA_TOP、WA_LEFTなど)にも同様の属性があります。これらはこのプロトコルに最も近いですが、下端(Win32)、色、幅、または半分がありません。 - IBM 3270ターミナルは、入力フィールド全体をアウトラインできます。
これらのいずれも、各エッジに独自の色と幅を持つ線を提供していません。理由書は、先行事例をより詳細にカバーし、プロトコル内の各選択肢を説明しています。
私自身の最初のプロトタイプはRio(raphamorim/rio#1947)にあり、APCではなくDCSを使用した仕様の初期バージョンでした。フィードバックにより、APCは再利用が安全ではないことが指摘されました。Kermit 95は90年代からAPCペイロードをKermitコマンドとして実行しています。DCSは構造化されたターミナルコマンドがすでに存在する場所であり、ターミナルは認識しないDCS文字列を無視するため、それに切り替えました。
厄介な(エッジ)ケース
この機能を見せ始めたとき、ほとんどの質問はこれらのケースに関するものでした。仕様ではすべて適切に扱われていますが、ここでは私が着地したおおよその場所を示します。
マルチプレクサは、人々が最初に尋ねたことでした。tmuxとその仲間は、セルグリッドに関する独自の考えからペインを再描画するため、これらのシーケンスを通過させると、境界線が間違った場所に配置されます。プロトコルを知らないマルチプレクサは、それらをドロップしてDA1自体に応答すべきであり、その中で実行されるアプリは、他の場所と同様にボックス文字にフォールバックします。それについて知っているものは、他の属性と同様に境界線を保存して再描画できます。
共有エッジでの競合する線は、ターミナルがレンダリングするときに、上記の優先度ルールを使用して解決されるため、アプリがセルを書き込んだ順序は関係ありません。
消去、挿入、削除はすべて、背景色の場合と同様に機能します。消去されたセルは現在のペンを取得し、挿入または削除された線は境界線も一緒に移動します。スクロールバック、代替画面、リフローは、境界線がセル内に存在するため、ほとんど無料で提供されます。
コストについて:Ghosttyの変更は約1,650行で、そのかなりの部分がテストです。各セルには16ビットの境界IDが与えられ、これはすでに存在していたパディングに収まるため、セルは大きくなることはなく、境界線のない画面は追加コストなしで済みます。IDは、ターミナル全体で共有される(約100バイト)個別の境界セットのテーブルを参照します。典型的なTUIは数個の個別のセットしか使用しませんが、テーブルは解放されないため、最悪の場合(65,535個すべてのIDが使用されている場合)は約10〜15 MBになります。
レンダリングは、境界線を持つセルに対してのみ追加の作業を行います。各セルは4つの隣接セルを見て共有エッジを解決するため、行を変更するとその両側の行も再構築されます。直線はセルあたり数個のソリッドクアッドです。丸い角は、アンチエイリアス処理されたアークが小さなクアッドの行として描画されるため、コストが高くなります。これはエッジピクセルあたり約1つです。まだこれを適切にベンチマークしておらず、最も注意を払ってほしい部分です。
試してみてください
仕様と理由書は私のGhosttyフォークにあります。Ghosttyブランチはバージョン1のすべてを実装しています。macOSでのみビルドおよび実行しましたが、GTKおよびOpenGLビルドはテストされていません。ビルドして実行するには(Zig 0.17とXcodeが必要です):
git clone -b joshka/cell-borders https://github.com/joshka/ghostty.git
cd ghostty
zig build -Doptimize=ReleaseFast -Dxcframework-target=native
open zig-out/Ghostty.app
そのGhostty内で、同じブランチのギャラリースクリプトが上記のスタイルギャラリーを描画します。最初にサポートを検出するため、他のターミナルの実装を確認する簡単な方法でもあります。
python3 scripts/cell-borders.py # デフォルトビュー
python3 scripts/cell-borders.py --styles # 線スタイル、結合、外側塗りつぶし
実行したら、キーでビューを切り替えることができます:p配置、c色、hブロック、j結合、e半分、sスタイル、lライブ。wはストローク幅を循環させ、bは境界線をオフにして比較できるようにし、qは終了します。各ビューには、開始時に使用する一致するフラグ(--placement、--stylesなど)もあります。
タイリングペインのデモはRatatuiブランチにあります。ターミナルがセルの境界線をサポートしていない場合、ボックス描画文字にフォールバックするため、上記の比較ショットを作成しました。
git clone -b joshka/cell-borders https://github.com/joshka/ratatui.git
cd ratatui
cargo run -p tiling-panes
マウスでペインをドラッグして再タイリングします。nとvで分割、xで閉じ、右クリックでペインメニューを開きます。セルの境界線とボックス描画を切り替えるにはbを押し、エッジの位置を確認するにはgを押します。
チャートのスクリーンショットのbtopスタイルのモニターは、同じブランチにあります。AIが書いた部分の多さを考えると、一時的にbslopと呼ぶことを検討しました。
[画像: セルの境界線で描画された完全なbtopスタイルのモニター。ホスト名はぼかされています]
実行するには:
cargo run -p cell-border-top
これは実際のシステムモニターです(CPU、メモリ、ネットワーク、プロセスを読み取ります)。そのため、ペインデモよりも、ビジーな画面での表示テストとして優れています。1から4でボックスを表示/非表示し、bとgはペインデモと同じように機能し、hまたは?で残りのキーを表示します。sysinfo依存関係のため、Ratatuiの他の部分よりも新しいRust(1.95)が必要です。
聞きたいこと
私はこれが正確な解決策であることに固執しているわけではありませんが、これは解決する価値のある問題だと考えており、単一のターミナルの機能(そして単一の週末のヤクシェービング以上のもの)にしたいと思っています。ターミナルで作業している方は、これを実装しますか?どの部分が高価に見えますか?TUIライブラリまたはアプリで作業している方は、どのウィジェットがこれを使用しますか?そして、ここにはないが何が必要ですか?コメントはGhosttyディスカッションで歓迎します。