Liquid Glass · 全機能実装 は何をしますか?
単一ファイルの WebGL 実装。ガラスの屈折、厚み、フレネル効果、分散、リム、内部発光をすべてフラグメントシェーダーで計算し、DOM はテキスト、ボタン、ドロップシャドウのみを担当。
シェーダーをゼロから書かないこと:90 行で動作しますが、400 行をゼロから書くのは成功率が極めて低いです。liquid-glass-all.html を改変してください。
0. 最速パス(1 分で効果を確認)
- Chrome / Edge で
liquid-glass-all.htmlを開きます。 - 右側のコントロールパネルには 5 つのスライダー(屈折 / 倍率 / リム / 分散 / 着色)と 4 つのプリセットボタンがあり、変更するとすぐに変化が反映されます。
- すべてのアクションが含まれています:カプセルをクリックして展開、押しながらドラッグ、長押しでバブル表示、右クリックで別のメニュー、ダブルクリックで浮上、Dock 分離キー、キーボードスペース/S/W/Esc。
- 検証は内蔵のセルフテストを使用:URL に
?selftest=1を追加すると、ページ左上に 13 個のPASS / FAILが直接表示されます。 - スクリーンショット撮影:
?pose=1で「展開+分離+バブル」を一度にセットアップ;?pose&wire=1で光路診断フィールドを重ねて表示。
chrome --headless=new --enable-unsafe-swiftshader --virtual-time-budget=6000 ^
--window-size=1280,800 --screenshot=out.png "file:///<絶対パス>/liquid-glass-all.html?selftest=1"
スクリーンショットを実際に確認し、左上が FAIL 0 であることを確認してください。コードだけを見て完了したと判断しないでください。
1. アセット
liquid-glass-all/
├── SKILL.md # このファイル:パス、アクション、光路、落とし穴、検証
├── liquid-glass-all.html # 全機能実装(唯一の実行成果物)
└── references/
├── action-matrix.md # 82 アクションの完全テーブル(トリガー / 変更内容 / パラメータ / 逆操作)
├── feature-matrix.md # 26 マテリアル特性 × 本実装の対応状況
├── optics-model.md # 光路物理モデルと定数(シェーダー記述前に必読)
└── interaction-playbook.md # ステートマシン、タイミング、ヒットテスト、検証
2. 82 アクションクイックリファレンス(9 カテゴリ)
完全なテーブルは references/action-matrix.md にあり、ここでは骨格のみを示します:
| カテゴリ | 数 | 内容 |
|---|---|---|
| A ポインター | 13 | ホバー侵入/移動/離脱、近傍減衰、プレス、リリース、シングルクリック、ドラッグ開始/追従/スプリングバック、端クランプ、右クリックメニュー、長押しメニュー |
| B ドラッグ慣性 | 6 | 方向伸張、弾性移動、変形減衰、慣性スライド、ドラッグ浮上、遅延ゴースト |
| C モーフィング | 10 | 展開/収納、メニュー項目フェードイン、角丸追従、分離/右片突き出し/結合、分割アクセント、ゼロ幅スキップ、融合接続ネック |
| D 押下フィードバック | 8 | 収縮、屈折増強、厚み増加、内部発光、隣接パネル波及、底アーク輝度上昇、方向ハイライト、フラッシュ誘導 |
| E 光学アニメーション | 8 | 3 種類の屈折モード、バリアント切り替え、着色マッピング、明暗反転、環境オーバーフロー色、アダプティブシャドウ、フォーカス喪失フェードアウト、背景光斑漂動 |
| F アダプティブ | 7 | 輝度/主色サンプリング、背景アップロード、アダプティブ解像度、光路更新、DPR 上限、機能低下チェーン |
| G システムとアクセシビリティ | 8 | リサイズ再配置、スクロール soft/hard、3 つのアクセシビリティスイッチ、ウィンドウフォーカス喪失、Tab フォーカスリング、スクリーンリーダーセマンティクス |
| H コントロール | 8 | メイン操作ボタン、5 スライダー、バリアントセグメント、モード 3 ボタン、4 スイッチ、4 プリセット、分離キー、展開ヘッダー |
| K キーボード | 7 | Space / S / W / Esc / Tab / ↑↓ / Enter |
アクションモニターバーはページ下部に表示:各アクションを記録し、最新 4 つを表示します。これにより「このアクションは本当にトリガーされたのか」を確認できます。
3. 光路の 7 ステップ(順序変更不可)
- 輪郭:
sdRoundBoxで符号付き距離dを取得;x = clamp(-d/band, 0, 1)、0=輪郭、1=中心、band = max(5, min(hx,hy)*0.30)。 - 凸面高さフィールド:
H(x)=sqrt(1-(1-x)²)、H'(x)=v/sqrt(1-v²)(v=clamp(1-x,0.02,0.9995))。pow ではなく sqrt を使用。 - 入射角:
sinI = min(H'/sqrt(1+H'²), 0.62)、thT = asin(sinI/1.5168)。0.62 はハード上限。0.93 にすると端が 200px 級に押し出され、全体が暗くなります。 - 厚み:
tpx = mdim*(0.05+0.28*H)*(1+0.40*thick)*vg、vg = 1+0.24*(1-smoothstep(-0.85,0.35,q.y))(下厚上薄)。 - 変位:
off = -dir*tan(thI-thT)*tpx*refract*Tf、さらに端の補正項を追加;最後にclamp(off,-10,10)。 - 焦点/リム:
focal = mag*magMul*(0.50*cW - 0.40*eW);1-focalは常に正である必要があります。そうしないと局所的に 180° 反転し、文字が逆さまになります。magMulはパネル別:lens 1.30 / capsule 0.85 / plate 0.55 / nav 0.90 / dock 0.80。 - 合成:
sp = c + rel*(1-focal) - off;RGB を±disp*7*eWで分離してサンプリング;さらに着色による輝度圧縮0.58*L+0.133、環境オーバーフロー色 0.10、フレネルリム、乳白色、上部鏡面、底部アーク、内部発光。
テクスチャの Y 軸は反転させる必要があります:uv0 = vec2(sp.x/uRes.x, 1.0 - sp.y/uRes.y)。この行がないと、ミラー画像と逆さまの文字になります。
4. ステートマシンと主要閾値
| アクション | 閾値 / パラメータ |
|---|---|
| hover | パネル内;パネル外 180px 以内では fade で減衰 |
| press | press→1(k=0.19/フレーム)、scale 0.965、屈折 ×1.3、底アーク ×1.75 |
| シングルクリック | pointerup かつ変位 ≤4px → 240ms 遅延してトリガー。ダブルクリックとの競合を回避 |
| ダブルクリック | 2 回の pointerdown 間隔 <300ms、2 回目の down で即座にシングルクリックタイマーをキャンセル |
| 長押し | pointerdown 後 500ms、移動 >4px でキャンセル;進捗ドットをタッチ点で拡大 |
| ドラッグ | 変位 >4px でドラッグに移行;clamp で 8px の内側余白 |
| 慣性 | リリース時の速度 >6px/イベント → v*1.05 で開始、毎フレーム ×0.94、<1px で終了しスナップ |
| 展開 | 136×48 → 236×296、底辺は不動:ty = lay.y + lay.h - 296;メニュー項目は高さ 110→250 でフェードイン、過半で pointerEvents を有効化 |
| 分離 | Dock 300 → 左 140;右片 tx を lay.x + lay.w - 140 に固定、幅 0→140 |
| 結合 | 右片は幅を先に収縮、位置は不動(「滑り出る」のを防ぐ) |
| 融合 | 分離後、2 つのピース間に 20px の隙間を維持、リムが相互に呼応;真のメタボール和集合には SDF smooth-min が必要だが、Web 単一パス版では未実装 |
| スプリング | 位置 ω=15、幅 ω=18.5、ζ=0.66、dt=1/60 → 約 0.45s、6% オーバーシュート |
5. パラメータプリセット
| 狙い | refract | mag | rim | disp | tint | thick |
|---|---|---|---|---|---|---|
| 厚いガラスのカプセル | 1.20 | 0.35 | 0.95 | 0.22 | 0.24 | ✓ |
| レンズで彩条を押しつぶす | 1.50 | 0.60 | 1.00 | 0.18 | 0.10 | ✓ |
| 厚いガラス蓋の小文字 | 1.25 | 0.42 | 0.80 | 0.30 | 0.16 | ✓ |
| トップナビゲーション(控えめ) | 0.90 | 0.20 | 0.60 | 0.15 | 0.10 | ✗ |
| コントロールパネル(可読性重視) | 1.00 | 0.15 | 0.55 | 0.12 | 0.14 | ✗ |
調整順序:refract で変位 → mag でリム → rim で端 → disp/tint で質感。逆順にすると必ずパラメータ同士が干渉します。
6. 絶対にハマる 8 つの落とし穴
- uniform 配列が信頼できない:
uGeo[12]は ANGLE/D3D 上で代入してもエラーにならないが、値が反映されない → パネルごとに 1 回の draw call。 - ループ内の uniform 分岐は最適化で消える:ループ内では
mix/stepを使った分岐のない記述を推奨。 - 宣言されても未使用の uniform は最適化で消去され、
getUniformLocationが null を返し、uniform 不足と誤報告される。 gl.getUniform(prog, null)は TypeError をスローし、その後のコードはすべてスキップされる(フリーズしたように見える)。- テクスチャ Y 軸:反転しないとミラー画像+逆さま文字。
clickのみのバインドではイベントが欠落する:pointerdown + pointerup + 変位閾値を使用。halfは GLSL ES の予約語:vec2 halfと書くとコンパイルエラーになり、ログには syntax error としか表示されない。同様の危険語:filter/input/output/long/short/packed。- 逆順の smoothstep は未定義動作:
smoothstep(1.0,-1.0,d)はマシンが変わると結果が異なる。必ず1.0 - smoothstep(小, 大, x)と記述。
さらにアクション層固有の落とし穴:
- 長押し後のリリースはシングルクリックと見なさない(
longFiredフラグが必要)。そうしないと、長押しメニューを開いた直後に展開が発生する。 - 右クリックは
pointerdownの前にブロックする(e.button !== 0で即 return)。そうしないと、右クリックがドラッグを開始してしまう。
7. 検証(変更のたびに実行)
?selftest=1 は 13 項目をカバー:シングルクリック展開/収納、長押しバブル、Esc でバブル消去、右クリックで別のメニュー、Dock 分離と結合、融合ネック、方向キー選択、Esc で全体収納、ダブルクリック浮上、慣性、W 光路場。
さらに手動で確認:
- ガラス内部のコンテンツの向きが正しい(逆さま、ミラーなし)
- 端一周のリム、上部鏡面、底部輝線アークがすべて揃っている
- 暗い背景でもガラス内部が真っ黒になっていない(もやっとしたグレーがある)
- ドラッグ時にゴーストが遅れて追従し、リリース時に慣性が働いてからスナップする
- 分離時は「裂ける」ように見え、「引き離される」ようには見えない
- スクロールテキストが端でフェードアウトし、端まで来るとハードな髪の毛のような線に切り替わる
- 3 つのアクセシビリティスイッチがすべて機能する(透明度低下 / コントラスト強化 / モーション抑制)
8. パフォーマンス予算
| 項目 | 予算 |
|---|---|
| 同画面のガラス | ≤10 個(本実装は 10 個、必要に応じて出現する幅 0 のバブル/ブリッジを含む) |
| draw call | 2 つの program + 各ガラスにつき 1 回の AABB draw |
| 背景アップロード | 5 フレームに 1 回;静止時は 8 フレームに 1 回 |
| 輝度サンプリング | 10 フレームに 1 回、w*h>24000 のパネルのみサンプリング |
| レンダリング倍率 | <42fps → 0.72、>56fps → 1.0、DPR 上限 2 |
| 機能低下チェーン | パネル削減 → 倍率低下 → アップロード頻度低下 → 分散オフ → CSS 版にフォールバック |
9. レッドラインとプラットフォーム境界
- ガラスはナビゲーション層のみに適用;コンテンツ層にはガラスを敷かない。
- ガラスの重ね掛けは禁止(屈折の参照を失い、汚れのように見える);Regular と Clear は同じ画面で混用しない。
- 着色はメイン操作のみに適用;ハイライトは控えめに、
rim > 1.2は不自然に見える。 - Web ではできないこと:ガラス上のテキスト/アイコンは自身の屈折を受けられない(iOS 26 のシステム合成パイプラインが必要);CSS フォールバックではピクセル単位のレンズリムと分散は再現できない。
- 自描画版では未対応:真のメタボール和集合(本実装では細いネックで近似)、デバイス傾きによる照明、リアルタイムビデオのフレーム単位の主色統計。