Khatt: animierte arabische Kalligraphie
Khatt formt den Text mit HarfBuzz (Buchstaben verbunden, von rechts nach links, Markierungen an Ort und Stelle), legt ihn aus und animiert ihn mit reinem CSS in einer einzigen SVG-Datei. Kein Netzwerk, keine Installation: Das Skript, seine Schriftarten und die Schriftengine befinden sich alle in diesem Ordner.
Erstellen einer Zeichnung
node scripts/khatt.mjs "النص" --style ruqaa --layout line --effect ink -o out.svg
Führen Sie es aus dem Ordner dieses Skills aus, oder verwenden Sie den vollständigen Pfad zu scripts/khatt.mjs. Schreiben Sie die Ausgabe dorthin, wo der Benutzer sie haben möchte (sein Projektordner, Desktop, …).
| Option | Werte |
|---|---|
--style | ruqaa (alltäglich, schräg), naskh (klassische Buchhand), kufi (eckig), nastaliq (hängendes Persisch), kano (dickes Rohr), blaka (fett, geometrisch) |
--layout | line (Linie), arc (Bogen), circle (Ring mit Stern in der Mitte), mirror (klassisch gespiegelt musanna) |
--effect | ink (Tinte), gold (Gold), bleed (Verlauf), mosaic (Mosaik), sand (Sand), neon (Neon), stars (Sterne), lantern (Laterne), rise (Aufstieg), stamp (Stempel), reveal (Enthüllung), wave (Welle) oder ein Pfad zu einer .mjs-Effektdatei |
--palette | paper (Papier), night (Nacht), neon (Neon), zellige (Zellige), desert (Wüste), clear (transparent) |
--ink, --accent, --bg | Farben überschreiben, z. B. --ink "#0b3d2e" --bg none |
--still | Einfrieren auf der fertigen Zeichnung (gut für Logos und Druck) |
-o | .svg für die Datei selbst, .html für eine Seite, die bei Klick erneut abspielt |
Führen Sie node scripts/khatt.mjs --list aus, um alles mit kurzen Beschreibungen zu sehen. Verwenden Sie \n im Text für eine zweite Zeile (bis zu vier Zeilen).
Gut auswählen
- Namen und englische Wörter: Khatt zeichnet nur arabische Schrift. Transkribieren Sie zuerst (Sara → سارة, Kamangir → كمنجير) und zeigen Sie dem Benutzer, wenn die Schreibweise mehrere Möglichkeiten hat, Ihre Schreibweise vor dem Rendern.
- Ramadan oder Eid:
lanternodergoldmitnight, Stilnaskhoderruqaa. - Hochzeiten und formelle Karten:
gold,riseoderink; versuchen Sie--layout mirror. - Logos:
--still, Stilkufioderblaka,--palette clear. - Social-Media-Beiträge: Eine animierte
.svgDatei wird überall dort abgespielt, wo ein Browser läuft. Für ein Video verweisen Sie den Benutzer auf das Studio (https://m-alkassem.github.io/khatt/), das MP4 exportiert. - Kurze Texte sehen am besten aus. Lange Sätze:
line-Layout, zwei oder drei Zeilen.
Öffnen Sie das Ergebnis für den Benutzer, wenn möglich (z. B. open out.html unter macOS).
Einen neuen Effekt erstellen
Wenn keiner der zwölf Effekte passt („Lass die Buchstaben brennen“, „Eine Ramadan-Laterne, die schaukelt“), schreiben Sie einen neuen. Beginnen Sie mit examples/ripple.mjs. Ein Effekt ist ein einfaches Objekt ohne Importe:
export default {
id: "my-effect", name: "My effect", nameAr: "…", blurb: "…",
palette: "night", // Standard-Paletten-ID
loop: false, // true, wenn es sich weiterbewegt
render(ctx) {
// return { css, defs?, body, duration, poster? }
},
};
render(ctx) erhält:
ctx.pieces: ein Eintrag pro Glyphe:d(SVG-Pfad),order(Lesereihenfolge, 0 = erster Buchstabe),box{x0,y0,x1,y1},cx,cy. Gespiegelte Kopien teilen sich eine Reihenfolge.ctx.steps,ctx.box(Textbox),ctx.view(gesamte Leinwand),ctx.em(Schriftgröße, 100),ctx.palette(bg,ink,accent),ctx.rng()(seeded random).ctx.stagger(order, spread?): Verzögerung für einen Buchstaben, verteilt überspreadSekunden.ctx.sample(piece, count): Zufallspunkte innerhalb eines Buchstabens für Partikel.ctx.inside(piece, x, y),ctx.area(piece).ctx.anim(name, seconds, { ease, loop, alternate }): Animations-CSS für eine Klasse.ctx.at(seconds, extraStyle?): der Inline-Stil, der die Verzögerung eines Elements setzt.ctx.n(number): Rundet Zahlen für kompakte Ausgabe.ctx.p: ein eindeutiges Präfix. Verwenden Sie es für jede Klasse, ID und Keyframe-Bezeichnung.
Regeln, die das Zeichnen in jedem Frame pausierbar halten (davon hängen Standbilder und Videoexport ab):
- Jedes animierte Element erhält
class="${p}-a ..."undstyle="${at(seconds)}". - Verwenden Sie
ctx.anim(...)in Ihren Klassenregeln. Schreiben Sie niemals die Kurzformanimation:oder setzen Sieanimation-delayselbst. - Benennen Sie Keyframes
${p}-something. Fügen Sie${p}-bzu einem Element hinzu, um es um seinen eigenen Mittelpunkt zu skalieren oder zu drehen. - Animieren Sie nur CSS-Eigenschaften (
opacity,transform,stroke-dashoffset,fill-opacity, …). SMIL<animate>und Skripte werden nicht korrekt einfrieren. - Halten Sie es leicht: höchstens ein paar tausend Elemente.
Dann führen Sie es aus:
node scripts/khatt.mjs "نار" --effect ./my-effect.mjs -o fire.html
Wenn es dem Benutzer gefällt, schlagen Sie vor, es als Pull-Request auf https://github.com/M-Alkassem/khatt zu teilen (Effekte leben in src/effects/).