omd-cjk-type-shader — 먹 번짐: CJK-Überschrift als Sumi-Tinte auf Hanji
Tinte, die in Papier einzieht, ist das eine Bild, das koreanische, japanische und chinesische Schrift gemeinsam haben. Dieses Skill lässt eine große CJK-Überschrift so aussehen, als wäre sie mit Sumi-Tinte auf Hanji gedruckt oder gepinselt worden. Auf den ersten Blick sollte sie wie ein Kalligraphie-Plakat wirken, nicht wie ein Filter.
So funktioniert es. Die Überschrift ist gewöhnlicher DOM-Text in Tintenfarbe, von der ersten Bildwiederholung an lesbar und auswählbar. Das Skill verfolgt jedes vom Browser gesetzte Graphem und erstellt aus dieser Maske drei Felder: den Abstand außerhalb der Striche, den Abstand innerhalb der Striche und die lokale Tintenabdeckung. Eine WebGL2-Schicht, die über den Text gezeichnet wird, fügt dann nur das hinzu, was echte Tinte tut:
- Nass → trocken: der Strich beginnt glänzend-dunkel mit einem sanften Leuchten um ihn herum, und das Leuchten schrumpft, während die Tinte trocknet;
- Ansammlung: Tinte sammelt sich dunkler entlang des Strichrands und an Strich-Enden und konvexen Ecken (geringe lokale Abdeckung);
- Kasure: Papierfasern scheinen nach dem Trocknen durch die Mitte dicker Striche hindurch;
- Nijimi: kapillares Verlaufen läuft entlang einiger Papierfasern an manchen Rändern, gesteuert durch niederfrequentes Rauschen, niemals als gleichmäßiger Ring um jedes Zeichen;
- Papier: eine prozedurale Hanji-Textur (SVG-Turbulenz, kein Bild) auf der Seite.
Auf dunklem Grund wechselt die gleiche Signatur automatisch zu 금니 (Goldpigment) auf 감지 (Indigopapier). Goryeo-Schreiber schrieben in Goldpulver, gemischt mit Leim, auf mit Indigo gefärbtem Papier. Pigment zieht nicht so ein wie Tinte, daher hat diese Variante kein Verlaufen und kein Leuchten. Nasser Leim wirkt matt und etwas dunkler; beim Trocknen setzen sich die Körner ab und fangen das Licht ein (ein spärlicher Glitzer), ein langsamer Schimmer zieht über die Linie, Enden und Ecken, wo der Pinsel verweilte, wirken reicher, und dünne Passagen lassen das Indigo durchscheinen. Es wird automatisch aktiviert, wenn die Farbe der Überschrift heller ist als der nächstgelegene gemalte Hintergrund (data-ink-ground="dark" oder "light" erzwingt es). Jede Farbe, die es zeichnet, ist die eigene Farbe der Überschrift, dunkler oder heller, oder die des Hintergrunds.
Es läuft einmal, wenn die Überschrift in den Ansichtsbereich kommt, dann stoppt die Render-Schleife. Zeilenumbrüche, keep-all, Schriftwechsel und Größenänderungen werden neu verfolgt.
Funktionierendes Beispiel: examples/demo.html (Einzeldatei, Koreanisch + Japanisch + Traditionelles Chinesisch, auf Hanji und auf einem 감지-Abschnitt). Nachweis: scripts/verify.mjs.
1. Wann verwenden / wann nicht
Verwenden, wenn:
- eine koreanische, japanische oder chinesische Display-Überschrift (≥ 40px; Hero, Launch-Titel, Kampagnenzeile, Abschnittseröffner) sich wie getuscht, kalligraphisch, "auf Hanji / Washi / 宣紙 gedruckt" anfühlen soll;
- die Tinten- und Papierfarben der Marke bekannt sind (DESIGN.md Vordergrund/Hintergrund, oder die berechnete
colorder Überschrift und der nächstgelegene gemalte Hintergrund). Dunkle Hintergründe erhalten die 금니-Variante: Verwenden Sie eine warme helle Textfarbe mit Spielraum nach unten (das Demo verwendet#d4b062auf#1a2440mit 7,4:1).
Nicht verwenden für:
- Fließtext, Labels, Buttons, Navigation, alles unter ~32px (Ansammlung und Verlaufen benötigen Strichbreite, um lesbar zu sein);
- rein lateinische Überschriften (es funktioniert, aber der kulturelle Bezug geht verloren);
- mehr als eine oder zwei Überschriften pro Seite. Stärke an einer Stelle (tf-shaders-Regel).
2. Der Effekt und seine zwei Parameter
| Parameter | Bereich | Standard | Wirkung |
|---|---|---|---|
bleed | 0–1 | 0,7 | Wie weit das kapillare Verlaufen entlang der Fasern reicht (bis zu 0,12em × bleed, an den vom Rauschen ausgewählten Rändern) und wie groß das nasse Leuchten wird. 0,4 = kaum sichtbar, 0,8 = nasser Pinsel. |
duration | s | 2,6 | Zeit von nass bis trocken. Das Leuchten erreicht seinen Höhepunkt früh und schrumpft; Ansammlung und Faser-Durchscheinen kommen beim Trocknen hinzu. Unter 1,5s wirkt es wie ein Blitz, über 4s wie ein Ladezustand. |
Alles andere ist bewusst festgelegt. Tinte = die berechnete color der Überschrift, für Ansammlungen auf 25% abgedunkelt; Papier = die Hintergrundfarbe der Seite. Texttinte sollte ein Sumi-Grauschwarz sein, nicht reines Schwarz (das Demo verwendet #3a3530 auf #f3eee4, etwa 10:1), damit die dunkleren Ansammlungen Platz haben, sich zu zeigen. Eine Signatur, kein Bedienfeld.
3. Der Vertrag, der Text als Text erhält
- Die Überschrift ist eine normale
<h1>/<h2>mit ihrem echten Text.inkBleed()umschließt den Text mit.ink-textund fügt einearia-hidden="true",pointer-events: none-Schicht darüber ein (z-index 2). Die Schicht verdunkelt, hellt auf oder erweitert nur, was bereits da ist. Sie ersetzt oder zeichnet die Zeichen nie neu, und ohne die Schicht ist die Überschrift immer noch vollständig. - Die Überschrift erscheint im ersten Frame. Kein
opacity: 0, kein Clip, kein Warten auf den Shader. tf-shaders hat LCP auf 7,8s gemessen, als Hero-Text auf einen Shader wartete. - Auswahl, Kopieren, Im-Seite-suchen, Übersetzung, Screenreader und SEO sehen Klartext.
verify.mjsprüft, ob die Auswahl der Überschrift in jedem Durchlauf ihren vollständigen Text zurückgibt. - Lassen Sie ~0,4em freien Raum um die Überschrift (das Demo verwendet
margin-bottom: 0,4em). Verlaufen und Leuchten erstrecken sich bis zu ~0,3em über die Zeichen hinaus. - Zeichnen Sie CJK-Überschriften niemals mit einer Canvas/
Text-Shader-Komponente. Canvas-Text verliert Auswahl, Barrierefreiheit, Indizierung und korrekte CJK-Formgebung (tf-shaders "Don't"-Liste).
4. CJK-Typografie (gilt vor dem Shader)
Aus /hangul (HG-Regeln) für Koreanisch; ja/zh getrennt, damit koreanische Regeln nicht übergreifen:
.ink:lang(ko) { word-break: keep-all; overflow-wrap: anywhere; /* HG-10, auf :lang(ko) beschränkt */
letter-spacing: -0.02em; /* HG-7: Display nie unter -0.03em */
line-height: 1.3; } /* HG-5: Umbruch Display >= 1.3 */
.ink:lang(ja), .ink:lang(zh-Hant) {
line-break: strict; /* Kinsoku: keine kleinen Kana/Schlusszeichen am Zeilenanfang */
word-break: keep-all; overflow-wrap: anywhere; /* Nur an <wbr>-Phrasenmarkierungen umbrechen */
letter-spacing: 0; line-height: 1.4; }
:lang(ko), :lang(ja), :lang(zh) { font-synthesis: none; } /* Kein künstliches Fett/Kursiv für CJK */
- Markieren Sie japanische/chinesische Phrasengrenzen mit
<wbr>(BudouX-Stil: 墨がにじむように、<wbr>名前が<wbr>紙に染みこむ。). In headless Chrome 149 wurdeword-break: auto-phrasekorrekt berechnet, erzeugte aber in diesem Demo keine Phrasenumbrüche, verlassen Sie sich also nicht darauf. - Koreanisch: Zeilenumbrüche nur an Leerzeichen zwischen 어절, nie Silbe für Silbe. Platzieren Sie Display-Zeilenumbrüche manuell, wenn der Texter Wert darauf legt (tf-shaders
cjk-type.md). - Setzen Sie
langauf der Überschrift (ko,ja,zh-Hant/zh-Hans). Es wählt die richtigen Zeichenvarianten für gemeinsame Han-Codepunkte und beschränkt die obigen Regeln. - Schriften: Verwenden Sie eine Schriftart, die die gewünschte Strichstärke mitbringt (HG-12). Das Demo verwendet Noto Serif KR / JP / TC 700 von Google Fonts, das nur die von der Seite genutzten Zeichenbereiche lädt. Eine Myeongjo/Mincho/Song-Schriftart passt zu Tinte. Pretendard funktioniert auch. Verfolgen Sie nach
document.fonts.ready, damit das Feld der echten Schriftart folgt, nicht dem Fallback.
5. Bibliothek, Lizenz, Budget
Bibliothek: @paper-design/shaders (Vanilla ShaderMount), festgenagelt auf 0.0.82 (2026-10-21; dispose() gibt jetzt den WebGL-Kontext frei), WebGL2. Entscheidungsdokumentation (verifiziert am 2026-10-13 aus den LICENSE-Dateien der npm-Tarballs, npm-Metadaten und der GitHub-Lizenz-API):
@paper-design/shaders 0.0.81 | shaders 4.0.4 (shaders.com) | |
|---|---|---|
| Lizenz | Apache-2.0 (LICENSE + NOTICE "Paper Shaders, Copyright 2026 Paper") | MIT (© 2026 Shader Effects Inc.); Abhängigkeit typegpu 0.12.3 MIT (Software Mansion) |
| Weiterverteilung in einem Skill/Template | erlaubt; NOTICE beibehalten, wenn Code ausgeliefert wird | erlaubt |
| Laufzeit | WebGL2: jeder aktuelle Desktop- und Mobilbrowser | Nur WebGPU, kein Fallback (Chrome/Edge, Android 12+ Chrome, Safari 26+, aktuelles Firefox) |
| JS für diesen Effekt | 17,5 KiB min / 5,3 KiB gzip (esbuild, nur ShaderMount); CDN pro Datei +esm 16,4 KiB / 5,0 KiB gzip | 2.535 KiB min / 710 KiB gzip (esbuild, Shader+MeshGradient von shaders/react) |
| Telemetrie | keine (der einzige fetch() liest den Inhaltstyp eines lokalen Blobs) | standardmäßig aktiv: beprobt 5% der Sitzungen an shaders.com/api/telemetry; übergeben Sie disableTelemetry |
| Benutzerdefiniertes GLSL + Texturen | ja (ShaderMount(el, frag, uniforms), Bild-Uniforms) | über seinen Komponentengraphen |
Der Effekt benötigt einen benutzerdefinierten Fragment-Shader und eine Textur, was genau das ist, wofür ShaderMount gemacht ist, bei 1/130tel der Größe der WebGPU-Laufzeit und doppelter Browser-Reichweite. Das Demo importiert Paper von jsDelivr (festgenagelter, dateiweiser Build) und liefert es nicht aus, daher ist keine NOTICE-Kopie erforderlich. Wenn Sie Paper-Dateien ausliefern, kopieren Sie seine NOTICE daneben. Wenn ein Projekt bereits shaders verwendet, läuft dieser Effekt trotzdem auf Paper. Laden Sie nicht beide Laufzeiten auf einer Seite.
Budget für eine Überschrift:
- JS: 5,0–5,3 KiB gzip Bibliothek + 5,3 KiB gzip Effekt-Code (Shader, zwei Distanztransformationen, Abdeckungsunschärfe, Verfolgung; gemessen unminimiert mit Kommentaren).
- GPU: ein Quad, eine Textur-Abfrage und 7 Wert-Rausch-Aufrufe pro Pixel, über dem Überschrift-Box plus einem ≤0,32em Rand,
minPixelRatio: 1, begrenzt auf 1920×1080 px. Es läuft fürdurationund dann stopptsetSpeed(0)die rAF-Schleife. Paper pausiert es auch außerhalb des Bildschirms und in versteckten Tabs. - CPU: pro Layout-Änderung (Schriftwechsel, Größenänderung, Neuumbruch; entprellt 120ms), zwei euklidische Distanztransformationen (außerhalb und innerhalb der Striche) und eine separable Box-Unschärfe, bei halber Auflösung für Schriftgrößen über 64px.
- Papier-Textur: ein Inline-SVG mit
feTurbulence-Daten-URI aufhtml(~600 Bytes), keine Bildanfrage. - Schriften sind die eigentlichen Kosten. CJK-Schriftarten sind groß. Laden Sie nur die Display-Strichstärke, als Unicode-Bereichsausschnitte.
6. Fallback und reduzierte Bewegung
- Kein WebGL2 (prüfen Sie
canvas.getContext('webgl2')vor dem Einbinden;ShaderMountwirft einen Fehler, wenn es keinen Kontext erhalten oder das Programm nicht verlinken kann): keine Schicht wird eingefügt, die Überschrift erhält.ink-static(ein dezenter CSS-text-shadow). Die Überschrift ist bereits in Tinte auf strukturiertem Papier, also ist sie ohne den Shader vollständig.verify.mjserzwingt diesen Pfad, indem esgetContextstubt. prefers-reduced-motion: reduce: Einbinden im getrockneten Frame mit Geschwindigkeit 0. Der Leser erhält den endgültigen Tintenzustand als Einzelbild, ohne Bewegung und ohne rAF-Schleife.- Shader-Kompilierungsfehler (einer ist beim Bauen aufgetreten: ein Präzisionskonflikt mit dem Vertex-Shader von Paper) führt zum gleichen
.ink-static-Pfad. Deklarieren Sie in Ihrem eigenen GLSLuniform mediump vec2 u_resolution;, da die Präzision mit dem Vertex-Shader von Paper übereinstimmen muss.
7. Auf einer echten GPU verifizieren
next build oder ein bestandener Lint beweist nichts für Shader (tf-shaders-Regel). Führen Sie aus:
npm i -D playwright-core && npx playwright-core install chromium # Ein frisches Playwright-Chromium, nicht Ihr eigenes Chrome
node <skill>/scripts/verify.mjs path/to/page.html ./ink-verify --frames 36
Es startet headless Chromium mit --enable-gpu --ignore-gpu-blocklist --use-angle=metal (macOS) und führt drei Durchläufe aus: GPU, reduzierte Bewegung, kein WebGL. Es misst die erste Überschrift auf jedem Grund (data-ink-ground="light" und "dark"). Dann:
- zeichnet es den WebGL-Renderer-String auf, damit Sie wissen, ob eine echte GPU oder SwiftShader die Frames gezeichnet hat;
- durchläuft es die Shader-Uhr deterministisch und speichert Frames (führen Sie sie ffmpeg zu, um das Demo-GIF/MP4 zu erstellen);
- beweist es das Rendern mit Pixeln: Shader-an vs Shader-aus innerhalb der Überschrift-Box, und erster Frame vs getrockneter Frame;
- misst es die Lesbarkeit während des gesamten Effekts: die Zeichenkerne (Text an vs Text transparent) wie in jedem abgetasteten Frame gegen das Papier dahinter gezeichnet, 10. Perzentil, damit Anti-Aliasing-Kanten nicht entscheiden, schlechtester Frame. Display-Überschriften sind WCAG-Großtext, daher liegt die Grenze bei 3:1;
- prüft es, ob der ausgewählte Text dem Überschrift-Text entspricht, die Schicht
aria-hidden+pointer-events: noneist, reduzierte Bewegung still ist und kein WebGL kein Canvas hinterlässt.
Gemerkt am 2026-11-06 (headless Chromium, ANGLE Metal Renderer: Apple M5 Pro, nicht SwiftShader), alle Prüfungen bestanden:
| Grund | Überschrift-Box-Pixel vom Shader geändert | Nass vs Trocken | Zeichen-Lesbarkeit (p10, schlechtester Frame) |
|---|---|---|---|
hell (Sumi auf Hanji, #3a3530 auf #f3eee4) | 10,2% | 5,9% | 8,01:1 |
dunkel (금니 auf 감지, #d4b062 auf #1a2440) | 8,8% | 8,7% | 4,58:1 |
| Sehen Sie sich die Frames trotzdem an, in voller Größe: Ein falsch ausgerichtetes Feld (falsche Grundlinie) zeigt sich als Ansammlung, die von den Strichen versetzt ist, und eine zu starke Verlaufseinstellung wirkt wie Fell. Nur Ihre Augen bemerken diese. |
8. Next.js / React-Port
Behalten Sie die gleiche Funktion und den gleichen Lebenszyklus in einem 'use client'-Leaf: 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(); }, []). Rendern Sie die Überschrift serverseitig als Klartext, damit der Shader sie erst nach der Hydration dekoriert. Verwenden Sie hier nicht das <ShaderMount> von @paper-design/shaders-react: Es gibt Ihnen weder die WebGL2-Prüfung, noch die Fallback-Klasse oder die Kontrolle darüber, wann das Feld neu verfolgt wird.
9. Namensnennung
Die Budget-zuerst-Rahmung, die Fallback-ist-Design-Regel, die Erster-Frame-LCP-Regel, die 어절-nicht-Silbe-Aufdeckungen, keep-all und die echte-GPU-Screenshot-Schleife stammen aus dem tf-shaders-Experiment des Eigentümers (skill/shader-landing/SKILL.md, references/cjk-type.md, scripts/shoot.mjs, RESEARCH.md, 2026-10). Koreanische Typografie-Werte stammen aus OmDs /hangul-Skill. Die Distanztransformation ist die lineare EDT von Felzenszwalb & Huttenlocher, hier frisch geschrieben. Die dunkle-Hintergrund-Variante folgt einem in Leonxlnx/taste-skill's print3d.js (MIT) beschriebenen Muster, "auf dunklem Papier ist die Tinte das Licht": die Behandlung kehrt sich um, sie färbt nicht nur neu. Es wurde kein Code kopiert; das Gold-Modell ist frisch aus der 감지금니-Praxis geschrieben.
Nicht tun
- Verstecken Sie die Überschrift nicht, bis der Shader bereit ist. Der Text ist der Inhalt; die Tinte ist der Rahmen.
- Animieren Sie nicht Silbe für Silbe, und teilen Sie Hangul nicht in zeichenweise Spannen für eine Enthüllung.
- Lassen Sie die Schleife nicht ewig laufen. Ein getrockneter Tinteneffekt kostet nichts; eine endlos laufende leert den Akku.
- Setzen Sie nicht zwei Laufzeiten (Paper +
shaders) auf eine Seite für eine Überschrift. - Lassen Sie nicht jede Kante auslaufen oder zeichnen Sie einen gleichmäßigen Halo. Ein gleichmäßiger Ring um jedes Zeichen wirkt wie ein Aufkleber, nicht wie Tinte; das Verlaufen gehört zu einigen wenigen Kanten.
- Verwenden Sie nicht reine schwarze Texttinte. Ansammlungen brauchen einen dunkleren Wert, um sichtbar zu sein, und Sumi ist grauschwarz, nicht schwarz. Das Demo verwendet
#3a3530. Reines Schwarz lässt den Effekt flach wirken und verhindert das Durchscheinen von Fasern. - Verlassen Sie sich nicht auf
auto-phrase; setzen Sie<wbr>für japanische und chinesische Anzeigetexte. - Animieren Sie nicht über das Trocknen hinaus. Der getrocknete Zustand ist statisch; sobald
durationerreicht ist, stoppen Sie die Schleife. - Vergleichen Sie das Rendern auf einem echten GPU-Gerät nicht mit dem auf Software-Rendering (SwiftShader). SwiftShader zeichnet den komplexen Effekt möglicherweise anders, und der Shader kann korrekt aussehen, aber auf der echten GPU falsche Ergebnisse liefern. Das Verifizierungsskript warnt, wenn SwiftShader aktiv ist, und zeichnet den Renderer-String auf.
- Vergessen Sie nicht, die Schrift-Ladung zu verfolgen. Wenn Sie die Verfolgung vor
document.fonts.readystarten, werden Fallback-Schriftmaße verwendet, und der Effekt ist auf den Strichen einer anderen Schriftart falsch ausgerichtet. Das Verifizierungsskript simuliert dies, indem esfonts.readyverzögert.
Dieses Skill wird vom AI-Agenten als Anleitung verwendet. Es beschreibt das Verhalten und die Implementierung, ersetzt aber keine Lizenz- oder Nutzungsbedingungen der zugrunde liegenden Bibliotheken.