ewdernaandClaude Opus 5
bbea89798d
フットプリントの選択はPCB設計ツール側の仕事で、Beyond KLEはその手前までを扱う。 前の決定で品種を持つ根拠にした「3pinの明示」はKiCadに渡す情報の話だったため、 端子配置とソケット方式を落とし、解釈しない部品グループのラベルと向きだけを残す。 キーごとの検出方式はELCが持つ(2端子前提ではHEの配線を組めないため)。 未知の端子配置の問い(P-9)は、品種を持たなくなったので消滅。 Journal: journal/2026-09-20-switch-terminal-reversal.md Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RCUFZ7vmSqQyGAPUFNWoiz
250 lines
14 KiB
Markdown
250 lines
14 KiB
Markdown
# PHYレイヤー
|
||
|
||
## 概要
|
||
|
||
PHYレイヤーは、キースイッチやキーキャップ、その他周辺部品の物理的な配置に関する情報を提供する。
|
||
付加的な情報として、matrix情報(ELCレイヤー)や入力キー情報(MAP/IMEレイヤー)を含ませることができるが、必須ではない。
|
||
|
||
## 構造
|
||
|
||
### キースイッチ/キーキャップの配置
|
||
|
||
各キーはスイッチ・キャップの情報を統合された状態で持つ。
|
||
スイッチ位置は、キャップの (w, h) 矩形の中心からのオフセットとしてキーごとに持つ(既定値0、単位U、キーのローカル座標系)。
|
||
Stepped Caps Lockのようにスイッチがキャップ中心からずれるキーがあり、キャップ形状だけではスイッチ位置が決まらないため。
|
||
以下、単に「キー」と呼ぶ場合、キーキャップの位置・サイズを表すオブジェクトをさすこととする。
|
||
|
||
### プロファイル設定
|
||
|
||
1ファイル内に複数のプロファイルを持たせることができる。
|
||
ユニットサイズ(1Uが何mmか、x軸・y軸それぞれ)を規定。
|
||
ビジュアル表現として、内側へのオフセット位置及びオフセット距離(mm or U単位)・R(U単位)を規定。
|
||
|
||
### 座標と回転
|
||
|
||
各ノードは、親ノードから見た相対的な配置を持つ。絶対座標は保持しない。
|
||
クラスター単位の移動・回転を親ノード1つの書き換えで済ませるため、相対座標を正本とする。
|
||
|
||
配置は「親の座標系で θ 回転してから (x, y) 平行移動」と定義する。
|
||
|
||
```txt
|
||
p_parent = Translate(x, y) · Rotate(θ) · p_child
|
||
```
|
||
|
||
この定義により、(x, y) は自分のローカル原点が親座標系のどこに来るかを表し、θ は自分の向きを表す。
|
||
回転軸は常に自分自身のローカル原点であり、パラメータとしては持たない。
|
||
キーもクラスターも同じ変換を持つため、キーごとに向きが異なる配置のためにクラスターを作る必要はない。
|
||
|
||
ローカル原点はキーキャップの左上角とする。座標単位はU。1Uのサイズはプロファイルで指定する。
|
||
|
||
座標・回転角度は、ローカル座標系で0.25U単位・15度単位でスナップするが正規化しない。
|
||
|
||
KLE JSONやPCB向けの出力は、階層を畳んで絶対座標に変換した導出物として生成する。
|
||
|
||
### キーのサイズ
|
||
|
||
0.25U単位でスナップするが正規化しない。
|
||
サイズはローカルの値であり、親の変換を受けない。
|
||
|
||
ISO Enterのように長方形でないキーは、サイズに2つ目の矩形(x2, y2, w2, h2)を加えて表す。
|
||
2つ目の矩形の位置は、キーのローカル原点からの相対値とする。
|
||
|
||
### 部品グループとスイッチの向き
|
||
|
||
PHYはスイッチの品種(MX-3pin、Choc V1 など)もソケット方式も持たない。
|
||
どのフットプリントを使うかはPCB設計ツール側の選択であり、Beyond KLEはその手前までを扱う。
|
||
|
||
キーが持つのは次の2つ。
|
||
|
||
- 部品グループ(partGroup): 同じ部品を使うキーをまとめるラベル。省略可
|
||
- スイッチの向き(orientation): 0/90/180/270の4方向。キーのローカル座標系に対する値で、既定は0。90度と270度は別物として扱う
|
||
|
||
部品グループの中身はBeyond KLEが解釈しない。穴・パッドの配置も、低背かどうかも持たない。
|
||
グループごとの実フットプリントはPCB出力時に割り当てる。
|
||
不均一な構成で「どのキーが同じ部品か」という設計者の意図だけを保存するために持つ。
|
||
|
||
スイッチのブランドも持たない。同じボードに対して利用者が好きなスイッチを選べるため、ボード設計の情報ではない。
|
||
|
||
キーごとの検出方式(接点マトリクス / アナログ / 光学)はELCが持ち、PHYは持たない。
|
||
ホールセンサのように端子数も配線トポロジも接点スイッチと異なるものがあり、これは電気的な性質のため。
|
||
|
||
### デカールとゴースト
|
||
|
||
デカールとゴーストはキーとして扱い、フラグで区別する。KLEの d, g に対応する。
|
||
|
||
### ラベル
|
||
|
||
キーはラベルを参考情報として持つ。KLE JSONの取り込みでは照合に使う。
|
||
|
||
### グルーピング
|
||
|
||
複数のキーを「クラスター」としてまとめて運用することができる。
|
||
クラスターのみにフォーカスして編集が可能。
|
||
クラスターの原点が、配下のノードの回転中心になる。
|
||
|
||
**内部処理での利用**：
|
||
|
||
- クラスターごとの一括編集・移動・回転
|
||
- 階層構造による管理（クラスターの入れ子構造）
|
||
- 編集時のフォーカス制御
|
||
- 回転中心を保存したい場合はクラスターにする（ノード自身は回転中心を持たないため）
|
||
|
||
**外部連携での扱い**：
|
||
|
||
- クラスター構造はBeyond KLEのデータにのみ存在する。外部形式へは階層を畳んだキー配置だけを出力する
|
||
|
||
## 保存形式
|
||
|
||
各ノードは親から見た変換を持つ。キーとクラスターを混在させた木構造として保持する。
|
||
|
||
`phase1-json-schema.md` のPHYスキーマは、この節の Key 型(x2〜h2, decal, ghost, labels, switchOffset, partGroup, orientation)にまだ追従していない。
|
||
|
||
```ts
|
||
type Transform = {
|
||
x: number, // 親座標系での位置
|
||
y: number,
|
||
rotation: number // 親座標系での回転角度（度）
|
||
}
|
||
type Size = {
|
||
w: number, // ローカル値。親の変換を受けない
|
||
h: number,
|
||
x2?: number, // 長方形でないキーの2つ目の矩形。ローカル原点からの相対値
|
||
y2?: number,
|
||
w2?: number,
|
||
h2?: number
|
||
}
|
||
type Key = {
|
||
transform: Transform,
|
||
size: Size,
|
||
profile: Profile,
|
||
decal?: boolean,
|
||
ghost?: boolean,
|
||
labels?: string[], // 参考情報
|
||
switchOffset?: { x: number, y: number }, // (w, h) 矩形の中心から。省略時は0
|
||
partGroup?: string, // 同じ部品を使うキーをまとめるラベル。中身は解釈しない
|
||
orientation?: 0 | 90 | 180 | 270 // スイッチの向き。キーのローカル座標系。省略時は0
|
||
}
|
||
type Cluster = {
|
||
transform: Transform,
|
||
children: (Key | Cluster)[]
|
||
}
|
||
const root: (Key | Cluster)[] = []
|
||
```
|
||
|
||
## 連携用出力形式
|
||
|
||
### KLEとの関係
|
||
|
||
KLEは、PHYデータを表示できる既存のビュワーとして扱う。
|
||
KLEで編集された時点で、そのデータはBeyond KLEのデータではない。
|
||
|
||
- KLE JSONにはBeyond KLE固有の情報(キーID、クラスター構造など)を含めない。出力は素のKLE JSONで、KLE JSONを読む他ツールにそのまま渡せる
|
||
- KLE JSONの取り込みは、手元のPHYデータとの照合で行う。IDや埋め込み情報には頼らない
|
||
- 過去のKLE JSONは、PHYデータがなくても読み込めなければならない。変換を伴ってよい
|
||
|
||
### KLE JSON出力
|
||
|
||
階層を畳んで絶対座標に変換し、標準的なKLE JSON形式で出力する。
|
||
|
||
```ts
|
||
type ConfigObject = {
|
||
x?: number,
|
||
y?: number,
|
||
w?: number,
|
||
h?: number,
|
||
x2?: number,
|
||
y2?: number,
|
||
w2?: number,
|
||
h2?: number,
|
||
r?: number, // 回転角度
|
||
rx?: number, // 回転中心
|
||
ry?: number,
|
||
l?: boolean,
|
||
n?: boolean,
|
||
d?: boolean,
|
||
c?: string,
|
||
t?: string,
|
||
g?: boolean,
|
||
a?: number,
|
||
f?: number,
|
||
f2?: number,
|
||
fa?: number[],
|
||
p?: string,
|
||
sm?: string,
|
||
sb?: string,
|
||
st?: string
|
||
}
|
||
|
||
type KeyLabel = string // 表示用ラベルのみ。識別情報は含めない
|
||
const kleData = (ConfigObject | KeyLabel)[][]
|
||
```
|
||
|
||
- 回転角度は正規化せずそのまま出力する。KLEのデータは任意の角度を受け付け、15度刻みはKLEのUI上の操作単位にすぎない
|
||
- rx, ry はPHYに持たないので、出力時に選ぶ
|
||
- ユニットサイズ(mm)、ビジュアルオフセット、クラスター構造はKLE JSONに出力されない
|
||
- 部品グループ・スイッチの向きはKLE JSONに出力しない。sm, sb, st には取り込み時に保持した値をそのまま書き戻す
|
||
- KLEの `p` はキーキャップのプロファイル名(SA、DCSなど)であり、PHYのプロファイルとは対応させない
|
||
|
||
### KLE JSONの取り込み
|
||
|
||
既存のPHYデータを畳んだ配置に対して、KLE JSONの各キーを形状(位置・サイズ・回転)とラベルで照合する。
|
||
|
||
- 照合できたキーは元のノードとして扱う。KLE側で配置が変わっていれば、元の親から見た相対座標に戻して反映する
|
||
- 照合できないキーは root 直下に新規キーとして置く。クラスターへの割り当てはユーザーが行う
|
||
- 構造の復元は保証しない。KLE側での編集が大きいほど、クラスター構造は失われる
|
||
- 配列の順番は照合に使わない。KLEは保存時にキーを「角度 → rx → ry → y → x」の順に並べ替えるため、順番は形状から決まる以上の情報を持たない
|
||
|
||
KLEの rx, ry, r はキーの絶対配置 (x, y, rotation) に変換して取り込む。元の rx, ry は保持しない。
|
||
|
||
見た目の属性(c, t, p, a, f, f2, fa, l, n)は、KLE JSONへ書き戻せるように保持する。どの層で持つかは決まっていない。
|
||
|
||
KLEの sm, sb, st(ファイル単位では switchMount, switchBrand, switchType)も同様に、不透明なまま保持して書き戻す。
|
||
Beyond KLEはスイッチの品種を持たないため、対応づける先がない。
|
||
|
||
## 検討済み・非採用
|
||
|
||
- ノードごとの回転中心パラメータ (journal/2026-09-18-phy-coordinate-model.md)
|
||
- KLE JSONへの識別・構造情報の埋め込み(labelのID、`_beyondkle` メタデータ、ゴーストキー) (journal/2026-09-18-kle-roundtrip.md)
|
||
- KLEのデカール・ゴースト・見た目属性を取り込み時に捨てる (journal/2026-09-19-kle-key-attributes.md)
|
||
- スイッチのブランドをPHYで持つ (journal/2026-09-20-switch-terminal.md)
|
||
- スイッチの品種・ソケット方式をPHYで持つ (journal/2026-09-20-switch-terminal-reversal.md)
|
||
|
||
## 未確認事項
|
||
|
||
### P-1 KLE JSONへ書き出した配置が行のまとまりを保てるか
|
||
|
||
- 位置づけ: 本文が前提にしているものではない。連携用出力形式の設計に関わる未解決の問い
|
||
- 現状の認識: 階層を畳んでKLEに読み込ませると行のまとまりが崩れる。他レイヤーの情報を使ってでも行ごとにまとめたいが、方法は未検討
|
||
- 手がかり: KLEは r, rx, ry が同じで y が等しいキーを1行にまとめる。同じ絶対角度を持つキーに共通の rx, ry(例えばクラスターの原点)を選べば、行にまとめられる見込み
|
||
- 格上げ条件: 回転を含むPHYデータをKLE JSONに変換してKLE本家に読み込ませ、rotation groupと行配列がどう再構成されるかを確認する
|
||
|
||
### P-2 KLE JSON取り込み時の照合基準
|
||
|
||
- 位置づけ: 本文「KLE JSONの取り込み」の具体化に必要な未解決の問い
|
||
- 現状の認識: 形状の許容誤差、ラベルの扱い、複数候補がある場合の決め方が未定
|
||
- 格上げ条件: 照合規則を決めたうえで、KLE本家でキーの移動・追加・削除をしたJSONを取り込み、意図どおりに対応づくことを確認する
|
||
|
||
### P-3 KLE JSON取り込み時のクラスター自動推定
|
||
|
||
- 位置づけ: 未解決の問い。PHYデータなしで過去のKLE JSONを取り込むとき、座標の近さや角度からクラスターを推定するか
|
||
- 現状の認識: 採用しない可能性が高い。ただし代わりに欲しい機能があり、それを思い出すきっかけとして残している
|
||
- 格上げ条件: 代わりの機能を定義し、この推定を採るか捨てるかをユーザーが決める
|
||
|
||
### P-6 キーキャップの見た目情報を持つ層
|
||
|
||
- 位置づけ: 本文「見た目の属性は保持する。どの層で持つかは決まっていない」の未解決部分
|
||
- 現状の認識: c, t, p, a, f系に加え、l, n もキーキャップの見た目属性であり、PHYとは別の層が要りそう。退避だけして書き戻す sm, sb, st も同じ置き場の問題を持つ。そもそもキーキャップは設計時に決める必要が薄く、カスタムキーボードの文脈に属するため、Beyond KLEの扱う範囲かどうかも未定。ファイル単位の backcolor, radii, background, css も同じ問いに含まれる
|
||
- 格上げ条件: キーキャップの情報をBeyond KLEの範囲に含めるかをユーザーが決め、保持する層を決める
|
||
|
||
### P-8 ラベルをMAPに適用するか
|
||
|
||
- 位置づけ: 未解決の問い。本文ではラベルを参考情報として持つことだけを決めている
|
||
- 現状の認識: どのラベルがMAPに適用できるかは、おそらく機械的には判断できない。自動で適用してユーザーが不要なものを落とす方式も考えられる
|
||
- 格上げ条件: 適用するか、する場合は自動適用とユーザーによる取捨の流れをユーザーが決める
|
||
|
||
### P-10 LEDを独立したノードとして持つか
|
||
|
||
- 位置づけ: 未解決の問い。LED用の穴をどう表すか
|
||
- 現状の認識: LEDの配置は設計者が決め、色や実装するかは利用者が選ぶ。位置と向き(表裏を含む)を持つ要素なのでPHYに入りそうだが、独立ノードにするかは未検討
|
||
- 格上げ条件: LEDの配置がスイッチに従属するか独立するかをユーザーが決め、ノードにするかを決める
|