Communitygithub.com

omd-cjk-type-shader — 먹 번짐:CJKディスプレイタイプを墨で和紙に刷ったように

一つのエフェクトを極める:韓国語・日本語・中国語の大きな見出しを、墨で和紙に刷ったように見せるWebGL2シェーダー。テキストは最初のフレームから選択可能なDOMテキストのままで、インクの滲み、紙の質感、金泥表現を追加します。

omd-cjk-type-shader — 먹 번짐:CJKディスプレイタイプを墨で和紙に刷ったように とは?

このスキルは、CJK(韓国語・日本語・中国語)の大きな見出しテキストに、本物の墨と和紙のような質感を加えるWebGL2シェーダーエフェクトです。テキストは常に通常のDOM要素として保持され、選択・コピー・スクリーンリーダー・SEO対応が可能です。エフェクトはテキストの上に重ねられたレイヤーで動作し、インクが紙に染み込む過程(ウェットからドライへの変化、縁でのインク溜まり、紙繊維の透け、毛管現象による滲み)を再現します。暗い背景では自動的に金泥(金色の顔料)と紺紙(藍染めの紙)の表現に切り替わり、滲みの代わりに粒子が沈殿する効果になります。パラメータは「bleed」(滲みの度合い)と「duration」(乾くまでの時間)の2つだけで、シンプルながら深い表現が可能です。約5.3 KiB gzipの軽量ライブラリで動作し、WebGL2非対応環境では静的なフォールバック、prefers-reduced-motion設定にも対応。実際のGPUで検証するスクリプトも含まれています。使用時は、40px以上のCJKディスプレイ見出し(ヒーロー、ローンチタイトル、キャンペーンライン、セクションオープナーなど)が対象で、複数ページに1~2個の見出しに限定するのが推奨されます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nococn/omd-cjk-type-shader/tree/main

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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と最も近い塗りつぶし背景)。暗い背景では金泥バリアントが適用されます:暗くなる余地のある暖かく明るいテキスト色を使用してください(デモの#d4b062 on #1a2440は7.4:1)。

避けるべき場合:

  • 本文、ラベル、ボタン、ナビゲーション、32px未満のテキスト(プーリングとにじみにはストローク幅が必要)。
  • ラテン文字のみの見出し(機能はしますが、文化的な意味が失われます)。
  • 1ページに2つ以上の見出し。一箇所に大胆さを集中させる(tf-shadersのルール)。

2. エフェクトとその2つのパラメータ

パラメータ範囲デフォルト説明
bleed0–10.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.81shaders 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 gzip2,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上のインラインSVG feTurbulence data URI(約600バイト)、画像リクエストなし。
  • フォントが実際のコストです。 CJKフェイスは大きいです。表示ウェイトのみを、unicode-rangeスライスとしてロードしてください。

6. フォールバックとモーション軽減

  • WebGL2非対応(マウント前にcanvas.getContext('webgl2')をプローブ;ShaderMountはコンテキスト取得またはプログラムリンクに失敗するとスロー):レイヤーは挿入されず、見出しには.ink-static(薄いCSS text-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)を配置しないでください。
  • すべてのエッジを滲ませたり、均一なハローを描画したりしないでください。各グリフの周りに均一なリングがあると、インクではなくステッカーのように見えます。滲みは一部のエッジにのみ属します。
  • 純粋な黒のテキストインクを使用しないでください。プールにはより暗い値が必要であり、墨はグレーブラックです。 …

[翻訳のため省略]

関連スキル