omd-cjk-type-shader — 먹 번짐:CJKディスプレイタイプを墨で和紙に刷ったように は何をしますか?
インクが紙に染み込むというイメージは、韓国語・日本語・中国語の書記に共通するものです。このスキルは、大きなCJK見出しを、まるで墨で和紙(韓紙)に刷ったり筆で書いたように見せます。ひと目見れば、フィルターではなく、書道のポスターのように感じられるはずです。
仕組み。 見出しは通常のDOMテキストで、インク色で表示され、最初のフレームから読み取り・選択可能です。このスキルは、ブラウザがレイアウトしたすべてのグリフをトレースし、そのマスクから3つのフィールド(ストロークの外側の距離、内側の距離、局所的なインクカバレッジ)を構築します。テキストの上に描画されるWebGL2レイヤーは、本物のインクが行うことだけを追加します。
- ウェット→ドライ: ストロークは光沢のある暗い状態で始まり、周囲にソフトなブルームが広がり、インクが乾くにつれてブルームは縮小します。
- プーリング: ストロークの縁、端、凸状の角(局所カバレッジが低い部分)にインクが暗く溜まります。
- かすれ: 乾いた後、太いストロークの中央から紙の繊維が透けて見えます。
- にじみ: 低周波ノイズで選ばれた一部のエッジで、毛管現象による滲みが紙の繊維に沿って数本だけ発生します。すべてのグリフの周りに均一なリングとして現れることはありません。
- 紙: ページ上にプロシージャルな和紙テクスチャ(SVGのfeTurbulence、画像は不使用)を適用します。
暗い背景では、同じシグネチャが自動的に金泥(金色)と紺紙(藍染め紙)の表現に切り替わります。 高麗経の写字生は、藍染め紙に金粉を混ぜた膠(にかわ)で書きました。顔料はインクのように紙に染み込まないため、このバリアントには滲みもブルームもありません。ウェットな膠はくすんで少し暗く見えます。乾くにつれて粒子が落ち着き、光を捉えます(まばらな輝き)。線の上をゆっくりとした光沢が横切り、筆が止まった端や角はより豊かに見え、細い部分からは藍色が透けます。見出しの色が最も近い塗りつぶし背景よりも明るい場合に自動的に有効になります(data-ink-ground="dark" または "light" で強制可能)。描画されるすべての色は、見出し自身の色(暗くまたは明るくしたもの)、または背景色です。
エフェクトは見出しがビューポートに入ったときに一度だけ再生され、その後レンダーループは停止します。行の折り返し、keep-all、フォントの変更やリサイズは再トレースされます。
動作例:examples/demo.html(単一ファイル、韓国語・日本語・繁体字中国語、和紙と紺紙セクション)。検証:[scripts/verify.mjs](./scripts/verify.mjs)。
1. 使用すべき場合 / 避けるべき場合
使用すべき場合:
- 韓国語・日本語・中国語のディスプレイ見出し(40px以上、ヒーロー、ローンチタイトル、キャンペーンライン、セクションオープナー)を、インクで書かれた、書道的な、「和紙 / 韓紙 / 宣紙に印刷された」ような印象にしたい場合。
- ブランドのインクと紙の色がわかっている場合(DESIGN.mdのforeground/canvas、または見出しの計算された
colorと最も近い塗りつぶし背景)。暗い背景では金泥バリアントが適用されます:暗くなる余地のある暖かく明るいテキスト色を使用してください(デモの#d4b062on#1a2440は7.4:1)。
避けるべき場合:
- 本文、ラベル、ボタン、ナビゲーション、32px未満のテキスト(プーリングとにじみにはストローク幅が必要)。
- ラテン文字のみの見出し(機能はしますが、文化的な意味が失われます)。
- 1ページに2つ以上の見出し。一箇所に大胆さを集中させる(tf-shadersのルール)。
2. エフェクトとその2つのパラメータ
| パラメータ | 範囲 | デフォルト | 説明 |
|---|---|---|---|
bleed | 0–1 | 0.7 | 毛管現象による滲みが繊維に沿って進む距離(最大 0.12em × bleed、ノイズで選ばれたエッジのみ)、およびウェットブルームの大きさ。0.4 = かすかに、0.8 = 濡れた筆。 |
duration | 秒 | 2.6 | ウェットからドライまでの時間。ブルームは早くピークに達して縮小し、プーリングと繊維の透けは乾くにつれて現れます。1.5秒未満ではフラッシュのように見え、4秒超ではローディング状態のように見えます。 |
その他はすべて意図的に固定されています。インク = 見出しの計算されたcolorを25%暗くしたもの(プール用)、紙 = ページの背景色。テキストのインクは、スミグレーブラック(純粋な黒ではない、デモでは#3a3530 on #f3eee4、約10:1)にしてください。そうすることで、暗いプールが表現される余地が生まれます。一つのシグネチャであって、コントロールパネルではありません。
3. テキストをテキストのままにする契約
- 見出しは、実際のテキストを持つ通常の
<h1>/<h2>です。inkBleed()はテキストを.ink-textでラップし、その上にaria-hidden="true"、pointer-events: noneのレイヤーを挿入します(z-index 2)。このレイヤーは、すでにあるものを暗くしたり、明るくしたり、拡張したりするだけです。グリフを置き換えたり再描画したりすることはなく、レイヤーを削除しても見出しは完全なままです。 - 見出しは最初のフレームから表示されます。
opacity: 0、クリップ、シェーダー待ちはありません。tf-shadersは、ヒーローコピーがシェーダーを待つ場合、LCPが7.8秒になることを計測しました。 - 選択、コピー、ページ内検索、翻訳、スクリーンリーダー、SEOはプレーンテキストを見ます。
verify.mjsは、見出しを選択するとすべてのパスで完全なテキストが返されることを確認します。 - 見出しの周囲に約0.4emのクリアスペースを残してください(デモでは
margin-bottom: 0.4emを使用)。滲みとブルームはグリフの外側に最大約0.3emまで広がります。 - CJK見出しをcanvasや
Textシェーダーコンポーネントで描画しないでください。Canvasテキストは、選択、アクセシビリティ、インデックス、正しいCJKシェイピングを失います(tf-shadersの「禁止」リスト)。
4. CJKタイポグラフィ(シェーダーの前に適用)
/hangul(HGルール)より、韓国語用。ja/zhは別スコープで、韓国語ルールが漏れないようにします:
.ink:lang(ko) { word-break: keep-all; overflow-wrap: anywhere; /* HG-10、:lang(ko)にスコープ */
letter-spacing: -0.02em; /* HG-7:ディスプレイで-0.03emを下回らない */
line-height: 1.3; } /* HG-5:折り返しディスプレイ >= 1.3 */
.ink:lang(ja), .ink:lang(zh-Hant) {
line-break: strict; /* 禁則処理:行頭に小さな仮名/閉じ約物を禁止 */
word-break: keep-all; overflow-wrap: anywhere; /* あなたが配置した<wbr>句境界でのみ改行 */
letter-spacing: 0; line-height: 1.4; }
:lang(ko), :lang(ja), :lang(zh) { font-synthesis: none; } /* CJKで疑似太字/斜体を無効化 */
- 日本語/中国語の句境界は
<wbr>でマークします(BudouXスタイル:墨がにじむように、<wbr>名前が<wbr>紙に染みこむ。)。ヘッドレスChrome 149では、word-break: auto-phraseは正しく計算されましたが、このデモでは句境界を生成しなかったため、これに依存しないでください。 - 韓国語:語節間のスペースでのみ改行し、音節ごとには改行しません。コピーライターが気にする場合は、手動でディスプレイ改行を配置します(tf-shaders
cjk-type.md)。 - 見出しに
langを設定します(ko、ja、zh-Hant/zh-Hans)。これにより、共有漢字コードポイントに適切なグリフバリアントが選択され、上記のルールがスコープされます。 - フォント:指定したウェイトを提供するフェイスを使用します(HG-12)。デモでは、Google FontsのNoto Serif KR / JP / TC 700を使用しており、ページが使用するグリフスライスのみを読み込みます。明朝/明朝/宋体フェイスはインクに適しています。Pretendardでも動作します。
document.fonts.readyの後にトレースすることで、フィールドがフォールバックではなく実際のフェイスに従うようにします。
5. ライブラリ、ライセンス、予算
ライブラリ:@paper-design/shaders(バニラShaderMount)、ピン留め0.0.82(2026-10-21;dispose()がWebGLコンテキストを解放)、WebGL2。 決定記録(2026-10-13にnpm tarballのLICENSEファイル、npmメタデータ、GitHubライセンスAPIから確認):
@paper-design/shaders 0.0.81 | shaders 4.0.4(shaders.com) | |
|---|---|---|
| ライセンス | Apache-2.0(LICENSE + NOTICE「Paper Shaders, Copyright 2026 Paper」) | MIT(© 2026 Shader Effects Inc.);依存typegpu 0.12.3 MIT(Software Mansion) |
| スキル/テンプレートでの再配布 | 許可;コードをベンダリングする場合はNOTICEを保持 | 許可 |
| ランタイム | WebGL2:現在のすべてのデスクトップおよびモバイルブラウザ | WebGPUのみ、フォールバックなし(Chrome/Edge、Android 12+ Chrome、Safari 26+、最近のFirefox) |
| このエフェクトのJSサイズ | 17.5 KiB min / 5.3 KiB gzip(esbuild、ShaderMountのみ);CDN per-file +esm 16.4 KiB / 5.0 KiB gzip | 2,535 KiB min / 710 KiB gzip(esbuild、shaders/reactのShader+MeshGradient) |
| テレメトリー | なし(唯一のfetch()はローカルblobのコンテンツタイプを読み取るのみ) | デフォルトでオン:セッションの5%をshaders.com/api/telemetryにサンプリング;disableTelemetryで無効化可能 |
| カスタムGLSL + テクスチャ | 可(ShaderMount(el, frag, uniforms)、画像uniform) | コンポーネントグラフ経由 |
このエフェクトにはカスタムフラグメントシェーダーと1つのテクスチャが必要であり、まさにShaderMountが提供する機能です。WebGPUランタイムの1/130の重量で、ブラウザのリーチは2倍です。デモはPaperをjsDelivrからインポートし(ピン留め、per-fileビルド)、ベンダリングしていないため、NOTICEコピーは不要です。Paperのファイルをベンダリングする場合は、NOTICEを一緒にコピーしてください。プロジェクトがすでにshadersを出荷している場合でも、このエフェクトはPaper上で動作します。1ページに両方のランタイムをロードしないでください。
1つの見出しに対する予算:
- JS: 5.0–5.3 KiB gzipライブラリ + 5.3 KiB gzipエフェクトコード(シェーダー、2つの距離変換、カバレッジブラー、トレース;コメント付きの非圧縮で計測)。
- GPU: 1つのクワッド、1つのテクスチャルックアップ、ピクセルあたり7回のバリューノイズコール、見出しボックス+≤0.32emパディング、
minPixelRatio: 1、1920×1080 pxでキャップ。durationだけ実行され、その後setSpeed(0)でrAFループが停止します。Paperはオフスクリーンや非表示タブでも一時停止します。 - CPU: レイアウト変更ごとに(フォント変更、リサイズ、折り返し変更;120msでデバウンス)、2つのユークリッド距離変換(ストロークの外側と内側)と1つの分離可能なボックスブラー。64px以上のタイプでは半解像度で実行。
- ペーパーテクスチャ:
html上のインラインSVGfeTurbulencedata URI(約600バイト)、画像リクエストなし。 - フォントが実際のコストです。 CJKフェイスは大きいです。表示ウェイトのみを、unicode-rangeスライスとしてロードしてください。
6. フォールバックとモーション軽減
- WebGL2非対応(マウント前に
canvas.getContext('webgl2')をプローブ;ShaderMountはコンテキスト取得またはプログラムリンクに失敗するとスロー):レイヤーは挿入されず、見出しには.ink-static(薄いCSStext-shadow)が適用されます。見出しはすでにテクスチャ付きの紙にインクで表示されているため、シェーダーなしでも完全です。verify.mjsはgetContextをスタブ化してこのパスを強制します。 prefers-reduced-motion: reduce: 速度0の乾燥フレームでマウントします。読者は最終的なインク状態を1つの静止フレームとして取得し、モーションやrAFループはありません。- シェーダーコンパイル失敗(このビルド中に発生したもの:Paperの頂点シェーダーとの精度の不一致):同じ
.ink-staticパスを取ります。独自のGLSLでは、uniform mediump vec2 u_resolution;と宣言してください。精度がPaperの頂点シェーダーと一致する必要があるためです。
7. 実GPUで検証
next buildやlintのパスだけでは、シェーダーにとって何の証明にもなりません(tf-shadersルール)。以下を実行してください:
npm i -D playwright-core && npx playwright-core install chromium # 新しいPlaywright Chromium。自分のChromeは使用しないでください
node <skill>/scripts/verify.mjs path/to/page.html ./ink-verify --frames 36
このスクリプトは、ヘッドレスChromiumを--enable-gpu --ignore-gpu-blocklist --use-angle=metal(macOS)で起動し、3つのパス(GPU、モーション軽減、WebGLなし)を実行します。各背景(data-ink-ground="light" と "dark")の最初の見出しを計測します。そして:
- WebGLレンダラー文字列を記録し、フレームを描画したのが実GPUかSwiftShaderかを確認します。
- シェーダークロックを決定的に進め、フレームを保存します(ffmpegに渡してデモGIF/MP4を生成するため)。
- ピクセルでレンダリングを証明します:見出しボックス内のシェーダーオン vs シェーダーオフ、および最初のフレーム vs 乾燥フレーム。
- エフェクト全体を通しての可読性を測定します:各サンプリングフレームで描画されたグリフコア(テキストあり vs テキスト透明)とその背後にある紙のコントラスト。10パーセンタイルを使用してアンチエイリアスエッジが判定を左右しないようにし、最悪のフレームを採用します。ディスプレイ見出しはWCAGのlargeテキストに該当するため、基準は3:1です。
- 選択テキストが見出しテキストと一致すること、レイヤーが
aria-hidden+pointer-events: noneであること、モーション軽減時に静止していること、WebGLなしではcanvasが残らないことを確認します。
2026-11-06に計測(ヘッドレスChromium、ANGLE Metal Renderer: Apple M5 Pro、SwiftShaderではありません)、すべてのチェックに合格:
| 背景 | シェーダーによって変更された見出しボックスピクセル | ウェット vs ドライ | グリフ可読性(p10、最悪フレーム) |
|---|---|---|---|
明るい(和紙に墨、#3a3530 on #f3eee4) | 10.2% | 5.9% | 8.01:1 |
暗い(紺紙に金泥、#d4b062 on #1a2440) | 8.8% | 8.7% | 4.58:1 |
| とにかくフレームをフルサイズで見てください:フィールドの位置ずれ(ベースラインの誤り)はプーリングがストロークからずれて見え、強すぎる滲み設定は毛羽立ちのように見えます。あなたの目だけがそれらを捉えられます。 |
8. Next.js / React ポート
'use client'リーフで同じ関数とライフサイクルを維持します:useEffect(() => { let h; document.fonts.ready.then(async () => { const { ShaderMount } = await import('@paper-design/shaders'); h = await inkBleed(ref.current, { bleed, duration }); }); return () => h?.mount.dispose(); }, [])。見出しはサーバーサイドでプレーンテキストとしてレンダリングし、シェーダーはハイドレーション後にのみ装飾します。ここでは@paper-design/shaders-reactの<ShaderMount>を使用しないでください。WebGL2プローブ、フォールバッククラス、フィールドの再トレース制御が提供されないためです。
9. 帰属
予算優先のフレーミング、フォールバックはデザインのルール、ファーストフレームLCPルール、語節(어절)ではなく音節での分割の禁止、keep-all、実GPUスクリーンショットループは、所有者のtf-shaders実験(skill/shader-landing/SKILL.md、references/cjk-type.md、scripts/shoot.mjs、RESEARCH.md、2026-10)に由来します。韓国語のタイポグラフィ値はOmDの/hangulスキルから来ています。距離変換はFelzenszwalb & Huttenlocherの線形時間EDTで、ここで新しく記述されました。暗い背景のバリアントは、Leonxlnx/taste-skillのprint3d.js(MIT)に記載されたパターン「暗い紙の上ではインクが光となる」に従います:処理は反転し、単なる色変更ではありません。コードはコピーされていません。金のモデルは、감지금니(紺紙金泥)の慣行から新しく記述されています。
禁止事項
- シェーダーの準備ができるまで見出しを非表示にしないでください。テキストがコンテンツであり、インクはフレームです。
- 音節ごとにアニメーションさせないでください。また、ハングルを表示のために文字ごとのスパンに分割しないでください。
- ループを永遠に実行しないでください。乾燥したインクのエフェクトはコストがかかりませんが、ループするものはバッテリーを消耗します。
- 1つの見出しのために1ページに2つのランタイム(Paper +
shaders)を配置しないでください。 - すべてのエッジを滲ませたり、均一なハローを描画したりしないでください。各グリフの周りに均一なリングがあると、インクではなくステッカーのように見えます。滲みは一部のエッジにのみ属します。
- 純粋な黒のテキストインクを使用しないでください。プールにはより暗い値が必要であり、墨はグレーブラックです。 …
[翻訳のため省略]