Khatt: caligrafía árabe animada
Khatt da forma al texto con HarfBuzz (letras unidas, de derecha a izquierda, marcas en su lugar), lo diseña y lo anima con CSS puro dentro de un único archivo SVG. Sin red, sin instalación: el script, sus fuentes y el motor de composición están todos en esta carpeta.
Crear un dibujo
node scripts/khatt.mjs "النص" --style ruqaa --layout line --effect ink -o out.svg
Ejecútalo desde la carpeta de esta habilidad, o usa la ruta completa a scripts/khatt.mjs. Escribe la salida donde el usuario quiera (su carpeta de proyecto, Escritorio, …).
| Opción | Valores |
|---|---|
--style | ruqaa (cotidiano, inclinado), naskh (manuscrito clásico), kufi (angular), nastaliq (persa colgante), kano (pluma de caña gruesa), blaka (geométrico audaz) |
--layout | line, arc, circle (un anillo con una estrella en el medio), mirror (el clásico musanna espejado) |
--effect | ink, gold, bleed, mosaic, sand, neon, stars, lantern, rise, stamp, reveal, wave, o una ruta a un efecto .mjs |
--palette | paper, night, neon, zellige, desert, clear (transparente) |
--ink, --accent, --bg | sustituir colores, p.ej. --ink "#0b3d2e" --bg none |
--still | congelar en el dibujo terminado (bueno para logos e impresión) |
-o | .svg para el archivo en sí, .html para una página que se reproduce al hacer clic |
Ejecuta node scripts/khatt.mjs --list para ver todo con descripciones breves. Usa \n dentro del texto para una segunda línea (hasta cuatro líneas).
Elegir bien
- Nombres y palabras en inglés: Khatt solo dibuja escritura árabe. Transcribe primero (Sara → سارة, Kamangir → كمنجير) y, cuando la ortografía pueda ser ambigua, muestra al usuario tu transcripción antes de renderizar.
- Ramadán o Eid:
lanternogoldconnight, estilonaskhoruqaa. - Bodas y tarjetas formales:
gold,riseoink; prueba--layout mirror. - Logos:
--still, estilokufioblaka,--palette clear. - Publicaciones en redes: un
.svganimado se reproduce en cualquier navegador. Para un video, dirige al usuario al estudio (https://m-alkassem.github.io/khatt/), que exporta MP4. - El texto corto se ve mejor. Frases largas: diseño
line, dos o tres líneas.
Abre el resultado para el usuario cuando puedas (p. ej. open out.html en macOS).
Crear un nuevo efecto
Cuando ninguno de los doce efectos se ajuste («haz que las letras ardan», «una linterna de Ramadán que se balancee»), escribe uno nuevo. Comienza desde examples/ripple.mjs. Un efecto es un objeto simple sin importaciones:
export default {
id: "mi-efecto", name: "Mi efecto", nameAr: "…", blurb: "…",
palette: "night", // id de paleta por defecto
loop: false, // true si sigue moviéndose
render(ctx) {
// return { css, defs?, body, duration, poster? }
},
};
render(ctx) recibe:
ctx.pieces: una entrada por glifo:d(trayecto SVG),order(orden de lectura, 0 = primera letra),box{x0,y0,x1,y1},cx,cy. Las copias espejadas comparten un orden.ctx.steps,ctx.box(caja de texto),ctx.view(lienzo completo),ctx.em(tamaño de fuente, 100),ctx.palette(bg,ink,accent),ctx.rng()(aleatorio con semilla).ctx.stagger(order, spread?): retardo para una letra, distribuido enspreadsegundos.ctx.sample(piece, count): puntos aleatorios dentro de una letra, para partículas.ctx.inside(piece, x, y),ctx.area(piece).ctx.anim(name, seconds, { ease, loop, alternate }): CSS de animación para una clase.ctx.at(seconds, extraStyle?): el estilo en línea que establece el retardo de un elemento.ctx.n(number): redondea números para una salida compacta.ctx.p: un prefijo único. Úsalo para cada clase, id y nombre de keyframe.
Reglas que mantienen el dibujo pausable en cualquier fotograma (las exportaciones estáticas y de video dependen de ello):
- Cada elemento animado recibe
class="${p}-a ..."ystyle="${at(seconds)}". - Usa
ctx.anim(...)en tus reglas de clase. Nunca escribas la abreviaturaanimation:ni establezcasanimation-delaytú mismo. - Nombra los keyframes
${p}-algo. Añade${p}-ba un elemento para escalarlo o rotarlo alrededor de su propio centro. - Anima solo propiedades CSS (
opacity,transform,stroke-dashoffset,fill-opacity, …). Las etiquetas SMIL<animate>y los scripts no se congelarán correctamente. - Mantenlo ligero: como máximo unos pocos miles de elementos.
Luego ejecútalo:
node scripts/khatt.mjs "نار" --effect ./mi-efecto.mjs -o fuego.html
Si al usuario le gusta, sugiérele que lo comparta como una pull request en https://github.com/M-Alkassem/khatt (los efectos viven en src/effects/).